Publish

- @transia/ripple-binary-codec@1.4.6-alpha.3
 - @transia/xrpl@2.7.3-alpha.12

package-lock.json

@@ -17188,7 +17188,7 @@
     },
     "packages/xrpl": {
       "name": "@transia/xrpl",
-      "version": "2.7.3-alpha.3",
+      "version": "2.7.3-alpha.5",
       "license": "ISC",
       "dependencies": {
         "@transia/ripple-address-codec": "^4.2.8-alpha.0",

packages/ripple-binary-codec/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transia/ripple-binary-codec",
-  "version": "1.4.6-alpha.2",
+  "version": "1.4.6-alpha.3",
   "description": "XRP Ledger binary codec",
   "files": [
     "dist/*",

packages/ripple-binary-codec/src/enums/definitions.json

@@ -37,6 +37,7 @@
     "LedgerHashes": 104,
     "Amendments": 102,
     "FeeSettings": 115,
+    "ImportVlseq": 73,
     "Escrow": 117,
     "PayChannel": 120,
     "Check": 67,
@@ -796,6 +797,16 @@
         "type": "UInt32"
       }
     ],
+    [
+      "XahauActivationLgrSeq",
+      {
+        "nth": 96,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt32"
+      }
+    ],
     [
       "ImportSequence",
       {
@@ -806,6 +817,36 @@
         "type": "UInt32"
       }
     ],
+    [
+      "RewardTime",
+      {
+        "nth": 98,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt32"
+      }
+    ],
+    [
+      "RewardLgrFirst",
+      {
+        "nth": 99,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt32"
+      }
+    ],
+    [
+      "RewardLgrLast",
+      {
+        "nth": 100,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt32"
+      }
+    ],
     [
       "IndexNext",
       {
@@ -966,6 +1007,36 @@
         "type": "UInt64"
       }
     ],
+    [
+      "AccountIndex",
+      {
+        "nth": 98,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt64"
+      }
+    ],
+    [
+      "AccountCount",
+      {
+        "nth": 99,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt64"
+      }
+    ],
+    [
+      "RewardAccumulator",
+      {
+        "nth": 100,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "UInt64"
+      }
+    ],
     [
       "EmailHash",
       {
@@ -1356,6 +1427,36 @@
         "type": "Hash256"
       }
     ],
+    [
+      "GovernanceFlags",
+      {
+        "nth": 99,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "Hash256"
+      }
+    ],
+    [
+      "GovernanceMarks",
+      {
+        "nth": 98,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "Hash256"
+      }
+    ],
+    [
+      "EmittedTxnID",
+      {
+        "nth": 97,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "Hash256"
+      }
+    ],
     [
       "Amount",
       {
@@ -2166,6 +2267,46 @@
         "type": "STObject"
       }
     ],
+    [
+      "GenesisMint",
+      {
+        "nth": 96,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STObject"
+      }
+    ],
+    [
+      "ActiveValidator",
+      {
+        "nth": 95,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STObject"
+      }
+    ],
+    [
+      "ImportVLKey",
+      {
+        "nth": 94,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STObject"
+      }
+    ],
+    [
+      "HookEmission",
+      {
+        "nth": 93,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STObject"
+      }
+    ],
     [
       "Signers",
       {
@@ -2305,6 +2446,46 @@
         "isSigningField": true,
         "type": "STArray"
       }
+    ],
+    [
+      "GenesisMints",
+      {
+        "nth": 96,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STArray"
+      }
+    ],
+    [
+      "ActiveValidators",
+      {
+        "nth": 95,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STArray"
+      }
+    ],
+    [
+      "ImportVLKeys",
+      {
+        "nth": 94,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STArray"
+      }
+    ],
+    [
+      "HookEmissions",
+      {
+        "nth": 93,
+        "isVLEncoded": false,
+        "isSerialized": true,
+        "isSigningField": true,
+        "type": "STArray"
+      }
     ]
   ],
   "TRANSACTION_RESULTS": {
@@ -2399,6 +2580,7 @@
     "tefNO_TICKET": -180,
     "tefNFTOKEN_IS_NOT_TRANSFERABLE": -179,
     "tefPAST_IMPORT_SEQ": -178,
+    "tefPAST_IMPORT_VL_SEQ": -177,
 
     "terRETRY": -99,
     "terFUNDS_SPENT": -98,
@@ -2526,11 +2708,14 @@
     "URITokenBuy": 47,
     "URITokenCreateSellOffer": 48,
     "URITokenCancelSellOffer": 49,
+    "GenesisMint": 96,
     "Import": 97,
+    "ClaimReward": 98,
     "Invoke": 99,
     "EnableAmendment": 100,
     "SetFee": 101,
     "UNLModify": 102,
-    "EmitFailure": 103
+    "EmitFailure": 103,
+    "UNLReport": 104
   }
 }

packages/ripple-binary-codec/test/definitions.test.js

@@ -44,7 +44,7 @@ describe('encode and decode using new types as a parameter', function () {
     definitions.FIELDS.push([
       'NewFieldDefinition',
       {
-        nth: 100,
+        nth: 101,
         isVLEncoded: false,
         isSerialized: true,
         isSigningField: true,

packages/xrpl/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transia/xrpl",
-  "version": "2.7.3-alpha.5",
+  "version": "2.7.3-alpha.12",
   "license": "ISC",
   "description": "A TypeScript/JavaScript API for interacting with the XRP Ledger in Node.js and the browser",
   "files": [
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "@transia/ripple-address-codec": "^4.2.8-alpha.0",
-    "@transia/ripple-binary-codec": "^1.4.6-alpha.2",
+    "@transia/ripple-binary-codec": "^1.4.6-alpha.3",
     "@transia/ripple-keypairs": "^1.1.8-alpha.0",
     "bignumber.js": "^9.0.0",
     "bip32": "^2.0.6",

packages/xrpl/src/models/ledger/URIToken.ts

@@ -3,11 +3,11 @@ import { Amount } from '../common'
 import BaseLedgerEntry from './BaseLedgerEntry'
 
 /**
- * The HookState object type contains the
+ * The URIToken object type contains the
  *
  * @category Ledger Entries
  */
-export default interface HookState extends BaseLedgerEntry {
+export default interface URIToken extends BaseLedgerEntry {
   LedgerEntryType: 'URIToken'
 
   /**

packages/xrpl/src/models/transactions/accountSet.ts

@@ -48,6 +48,7 @@ export enum AccountSetAsfFlags {
    */
   asfAuthorizedNFTokenMinter = 10,
   /** asf 11 is reserved for Hooks amendment */
+  asfTshCollect = 11,
   /** Disallow other accounts from creating incoming NFTOffers */
   asfDisallowIncomingNFTokenOffer = 12,
   /** Disallow other accounts from creating incoming Checks */

packages/xrpl/src/models/transactions/claimReward.ts

@@ -0,0 +1,28 @@
+import { ValidationError } from '../../errors'
+
+import { BaseTransaction, validateBaseTransaction } from './common'
+
+/**
+ * ClaimReward is a transaction model that allows an account to claim rewards.
+ *
+ * @category Transaction Models
+ */
+export interface ClaimReward extends BaseTransaction {
+  TransactionType: 'ClaimReward'
+  /** The unique address of the issuer where the reward.c hook is installed. */
+  Issuer?: string
+}
+
+/**
+ * Verify the form and type of an ClaimReward at runtime.
+ *
+ * @param tx - An ClaimReward Transaction.
+ * @throws When the ClaimReward is Malformed.
+ */
+export function validateClaimReward(tx: Record<string, unknown>): void {
+  validateBaseTransaction(tx)
+
+  if (tx.Issuer !== undefined && typeof tx.Issuer !== 'string') {
+    throw new ValidationError('ClaimReward: invalid Issuer')
+  }
+}

packages/xrpl/src/models/transactions/import.ts

@@ -1,3 +1,5 @@
+import { ValidationError } from '../../errors'
+
 import { BaseTransaction, validateBaseTransaction } from './common'
 
 /**
@@ -7,6 +9,10 @@ import { BaseTransaction, validateBaseTransaction } from './common'
  */
 export interface Import extends BaseTransaction {
   TransactionType: 'Import'
+  /**
+   *
+   */
+  Issuer?: string
   /**
    * Hex value representing a VL Blob.
    */
@@ -21,4 +27,12 @@ export interface Import extends BaseTransaction {
  */
 export function validateImport(tx: Record<string, unknown>): void {
   validateBaseTransaction(tx)
+
+  if (tx.Issuer !== undefined && typeof tx.Issuer !== 'string') {
+    throw new ValidationError('Import: Issuer must be a string')
+  }
+
+  if (tx.Account === tx.Issuer) {
+    throw new ValidationError('Import: Issuer and Account must not be equal')
+  }
 }

packages/xrpl/src/models/transactions/index.ts

@@ -10,6 +10,7 @@ export { AccountDelete } from './accountDelete'
 export { CheckCancel } from './checkCancel'
 export { CheckCash } from './checkCash'
 export { CheckCreate } from './checkCreate'
+export { ClaimReward } from './claimReward'
 export { DepositPreauth } from './depositPreauth'
 export { EscrowCancel } from './escrowCancel'
 export { EscrowCreate } from './escrowCreate'

packages/xrpl/src/models/transactions/metadata.ts

@@ -8,7 +8,7 @@ export interface HookExecution {
     HookHash: string
     HookInstructionCount: string
     HookResult: number
-    HookReturnCode: number
+    HookReturnCode: string
     HookReturnString: string
     HookStateChangeCount: number
   }

packages/xrpl/src/models/transactions/setHook.ts

@@ -14,10 +14,10 @@ export enum SetHookFlags {
   hsfOverride = 0x00000001,
   /**
    */
-  hsfNSDelete = 0x00000010,
+  hsfNSDelete = 0x0000002,
   /**
    */
-  hsfCollect = 0x00000100,
+  hsfCollect = 0x00000004,
 }
 
 export interface SetHookFlagsInterface extends GlobalFlags {

packages/xrpl/src/models/transactions/signerListSet.ts

@@ -23,7 +23,7 @@ export interface SignerListSet extends BaseTransaction {
    * more than 32 members. No address may appear more than once in the list, nor
    * may the Account submitting the transaction appear in the list.
    */
-  SignerEntries: SignerEntry[]
+  SignerEntries?: SignerEntry[]
 }
 
 const MAX_SIGNERS = 32
@@ -36,6 +36,7 @@ const HEX_WALLET_LOCATOR_REGEX = /^[0-9A-Fa-f]{64}$/u
  * @param tx - An SignerListSet Transaction.
  * @throws When the SignerListSet is Malformed.
  */
+// eslint-disable-next-line complexity -- validation can be complex
 export function validateSignerListSet(tx: Record<string, unknown>): void {
   validateBaseTransaction(tx)
 
@@ -47,6 +48,10 @@ export function validateSignerListSet(tx: Record<string, unknown>): void {
     throw new ValidationError('SignerListSet: invalid SignerQuorum')
   }
 
+  if (tx.SignerQuorum === 0) {
+    return
+  }
+
   if (tx.SignerEntries === undefined) {
     throw new ValidationError('SignerListSet: missing field SignerEntries')
   }

packages/xrpl/src/models/transactions/transaction.ts

@@ -9,6 +9,7 @@ import { AccountSet, validateAccountSet } from './accountSet'
 import { CheckCancel, validateCheckCancel } from './checkCancel'
 import { CheckCash, validateCheckCash } from './checkCash'
 import { CheckCreate, validateCheckCreate } from './checkCreate'
+import { ClaimReward, validateClaimReward } from './claimReward'
 import { DepositPreauth, validateDepositPreauth } from './depositPreauth'
 import { EscrowCancel, validateEscrowCancel } from './escrowCancel'
 import { EscrowCreate, validateEscrowCreate } from './escrowCreate'
@@ -71,6 +72,7 @@ export type Transaction =
   | CheckCancel
   | CheckCash
   | CheckCreate
+  | ClaimReward
   | DepositPreauth
   | EscrowCancel
   | EscrowCreate
@@ -146,6 +148,10 @@ export function validate(transaction: Record<string, unknown>): void {
       validateCheckCreate(tx)
       break
 
+    case 'ClaimReward':
+      validateClaimReward(tx)
+      break
+
     case 'DepositPreauth':
       validateDepositPreauth(tx)
       break

packages/xrpl/src/utils/hashes/hashLedger.ts

@@ -83,7 +83,11 @@ export function hashSignedTx(tx: Transaction | string): string {
     txObject = tx
   }
 
-  if (!txObject.EmitDetails && txObject.TxnSignature === undefined && txObject.Signers === undefined) {
+  if (
+    !txObject.EmitDetails &&
+    txObject.TxnSignature === undefined &&
+    txObject.Signers === undefined
+  ) {
     throw new ValidationError('The transaction must be signed to hash it.')
   }
 

packages/xrpl/test/integration/transactions/signerListSet.test.ts

@@ -18,8 +18,9 @@ describe('SignerListSet', function () {
   })
   afterEach(async () => teardownClient(testContext))
 
+  // Add signerlist
   it(
-    'base',
+    'add',
     async () => {
       const tx: SignerListSet = {
         TransactionType: 'SignerListSet',
@@ -44,4 +45,18 @@ describe('SignerListSet', function () {
     },
     TIMEOUT,
   )
+
+  // Remove signerlist
+  it(
+    'remove',
+    async () => {
+      const tx: SignerListSet = {
+        TransactionType: 'SignerListSet',
+        Account: testContext.wallet.classicAddress,
+        SignerQuorum: 0,
+      }
+      await testTransaction(testContext.client, tx, testContext.wallet)
+    },
+    TIMEOUT,
+  )
 })