Publish

- @transia/xrpl@2.7.3-alpha.13

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.8",
+  "version": "2.7.3-alpha.13",
   "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/AccountRoot.ts

@@ -72,6 +72,10 @@ export default interface AccountRoot extends BaseLedgerEntry {
    * account to each other.
    */
   TransferRate?: number
+  ImportSequence?: string
+  GovernanceFlags?: string
+  GovernanceMarks?: string
+  AccountIndex?: number
 }
 
 /**

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

@@ -24,4 +24,6 @@ export default interface FeeSettings extends BaseLedgerEntry {
    * type.
    */
   Flags: number
+  XahauActivationLgrSeq?: number
+  AccountCount?: number
 }

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

@@ -0,0 +1,19 @@
+import BaseLedgerEntry from './BaseLedgerEntry'
+
+/**
+ *
+ *
+ *
+ * @category Ledger Entries
+ */
+export default interface ImportVLSequence extends BaseLedgerEntry {
+  LedgerEntryType: 'ImportVLSequence'
+  /**
+   *
+   */
+  PublicKey: string
+  /**
+   *
+   */
+  ImportSequence: string
+}

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

@@ -0,0 +1,38 @@
+import BaseLedgerEntry from './BaseLedgerEntry'
+
+interface ImportVLKey {
+  PublicKey: string
+  Account?: string
+}
+interface ActiveValidators {
+  PublicKey: string
+  Account?: string
+}
+
+/**
+ *
+ *
+ *
+ * @category Ledger Entries
+ */
+export default interface UNLReport extends BaseLedgerEntry {
+  LedgerEntryType: 'UNLReport'
+  /**
+   *
+   */
+  ImportVLKeys?: ImportVLKey[]
+  /**
+   *
+   */
+  ActiveValidators?: ActiveValidators[]
+  /**
+   * The identifying hash of the transaction that most recently modified this
+   * object.
+   */
+  PreviousTxnID: string
+  /**
+   * The index of the ledger that contains the transaction that most recently
+   * modified this object.
+   */
+  PreviousTxnLgrSeq: number
+}

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

@@ -12,6 +12,7 @@ import FeeSettings from './FeeSettings'
 import Hook from './Hook'
 import HookDefinition from './HookDefinition'
 import HookState from './HookState'
+import ImportVLSequence from './ImportVLSequence'
 import Ledger from './Ledger'
 import LedgerEntry from './LedgerEntry'
 import LedgerHashes from './LedgerHashes'
@@ -21,6 +22,7 @@ import PayChannel from './PayChannel'
 import RippleState, { RippleStateFlags } from './RippleState'
 import SignerList, { SignerListFlags } from './SignerList'
 import Ticket from './Ticket'
+import UNLReport from './UNLReport'
 import URIToken from './URIToken'
 
 export {
@@ -37,6 +39,7 @@ export {
   Hook,
   HookDefinition,
   HookState,
+  ImportVLSequence,
   Ledger,
   LedgerEntry,
   LedgerHashes,
@@ -50,4 +53,5 @@ export {
   SignerListFlags,
   Ticket,
   URIToken,
+  UNLReport,
 }

packages/xrpl/src/models/methods/accountObjects.ts

@@ -3,6 +3,7 @@ import {
   Check,
   DepositPreauth,
   Escrow,
+  Hook,
   Offer,
   PayChannel,
   RippleState,
@@ -17,6 +18,7 @@ type AccountObjectType =
   | 'check'
   | 'deposit_preauth'
   | 'escrow'
+  | 'hook'
   | 'nft_offer'
   | 'offer'
   | 'payment_channel'
@@ -75,6 +77,7 @@ type AccountObject =
   | Check
   | DepositPreauth
   | Escrow
+  | Hook
   | Offer
   | PayChannel
   | SignerList

packages/xrpl/src/models/methods/ledgerEntry.ts

@@ -127,6 +127,17 @@ export interface LedgerEntryRequest extends BaseRequest {
     namespace_id: string
   }
 
+  /**
+   * The Import VL Sequence object to retrieve. If a string, must be the object ID of the VLSequence.
+   * If an object, requires `public_key` sub-field.
+   */
+  import_vlseq?:
+    | {
+        /** The public_key of the Import VL Sequence object. */
+        public_key: string
+      }
+    | string
+
   /**
    * The Offer object to retrieve. If a string, interpret as the unique object
    * ID to the Offer. If an object, requires the sub-fields `account` and `seq`

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/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

@@ -48,7 +48,6 @@ export function validateSignerListSet(tx: Record<string, unknown>): void {
     throw new ValidationError('SignerListSet: invalid SignerQuorum')
   }
 
-  // All other checks are for if SignerQuorum is greater than 0
   if (tx.SignerQuorum === 0) {
     return
   }

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.')
   }