xrpl 4.1.0 → 4.2.0-batch.0

package/dist/npm/utils/hashes/hashLedger.js

@@ -31,6 +31,8 @@ const utils_1 = require("@xrplf/isomorphic/utils");
 const bignumber_js_1 = __importDefault(require("bignumber.js"));
 const ripple_binary_codec_1 = require("ripple-binary-codec");
 const errors_1 = require("../../errors");
+const common_1 = require("../../models/transactions/common");
+const flags_1 = require("../../models/utils/flags");
 const HashPrefix_1 = __importDefault(require("./HashPrefix"));
 const sha512Half_1 = __importDefault(require("./sha512Half"));
 const SHAMap_1 = __importStar(require("./SHAMap"));
@@ -77,7 +79,8 @@ function hashSignedTx(tx) {
     }
     if (txObject.TxnSignature === undefined &&
         txObject.Signers === undefined &&
-        txObject.SigningPubKey === undefined) {
+        txObject.SigningPubKey === undefined &&
+        !(0, flags_1.hasFlag)(txObject, common_1.GlobalFlags.tfInnerBatchTxn)) {
         throw new errors_1.ValidationError('The transaction must be signed to hash it.');
     }
     const prefix = HashPrefix_1.default.TRANSACTION_ID.toString(16).toUpperCase();

package/dist/npm/utils/hashes/hashLedger.js.map

@@ -1 +1 @@
-{"version":3,"file":"hashLedger.js","sourceRoot":"","sources":["../../../../src/utils/hashes/hashLedger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,mDAAoD;AACpD,gEAAoC;AACpC,6DAAoD;AAEpD,yCAAyD;AAMzD,8DAAqC;AACrC,8DAAqC;AACrC,mDAA2C;AAE3C,MAAM,GAAG,GAAG,EAAE,CAAA;AAMd,SAAS,QAAQ,CAAC,OAAe,EAAE,UAAkB;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;SACxB,QAAQ,CAAC,GAAG,CAAC;SACb,QAAQ,CAAC,UAAU,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IAEhC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,WAAW,CAClB,aAA0C,EAC1C,UAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,sBAAS,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IACtD,OAAO,GAAG,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7B,IAAI,MAAM,IAAI,GAAG,EAAE;QACjB,OAAO,IAAA,kBAAU,EAAC,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAA;KAClC;IACD,IAAI,MAAM,IAAI,KAAK,EAAE;QACnB,MAAM,MAAM,GAAG,MAAM,GAAG,GAAG,CAAA;QAC3B,OAAO,IAAA,kBAAU,EAAC,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAA;KAC/D;IACD,IAAI,MAAM,IAAI,MAAM,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;QAC7B,OAAO,CACL,IAAA,kBAAU,EAAC;YACT,GAAG,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC;YACrB,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,IAAI;YACrB,MAAM,GAAG,IAAI;SACd,CAAC,GAAG,GAAG,CACT,CAAA;KACF;IACD,MAAM,IAAI,kBAAS,CAAC,4BAA4B,CAAC,CAAA;AACnD,CAAC;AAUD,SAAgB,YAAY,CAAC,EAAwB;IACnD,IAAI,MAAc,CAAA;IAClB,IAAI,QAAqB,CAAA;IACzB,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE;QAC1B,MAAM,GAAG,EAAE,CAAA;QAEX,QAAQ,GAAG,IAAA,4BAAM,EAAC,EAAE,CAA2B,CAAA;KAChD;SAAM;QACL,MAAM,GAAG,IAAA,4BAAM,EAAC,EAAE,CAAC,CAAA;QACnB,QAAQ,GAAG,EAAE,CAAA;KACd;IAED,IACE,QAAQ,CAAC,YAAY,KAAK,SAAS;QACnC,QAAQ,CAAC,OAAO,KAAK,SAAS;QAC9B,QAAQ,CAAC,aAAa,KAAK,SAAS,EACpC;QACA,MAAM,IAAI,wBAAe,CAAC,4CAA4C,CAAC,CAAA;KACxE;IAED,MAAM,MAAM,GAAG,oBAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACnE,OAAO,IAAA,oBAAU,EAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;AAC1C,CAAC;AAtBD,oCAsBC;AASD,SAAgB,gBAAgB,CAC9B,YAA0C;IAE1C,MAAM,MAAM,GAAG,oBAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;IAE5D,MAAM,MAAM,GACV,MAAM;QACN,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC9C,WAAW,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QACxC,YAAY,CAAC,WAAW;QACxB,YAAY,CAAC,gBAAgB;QAC7B,YAAY,CAAC,YAAY;QACzB,QAAQ,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC3C,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;QACpC,QAAQ,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAC/C,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAEvC,OAAO,IAAA,oBAAU,EAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAlBD,4CAkBC;AASD,SAAgB,UAAU,CACxB,YAAqE;;IAErE,MAAM,MAAM,GAAG,IAAI,gBAAM,EAAE,CAAA;IAC3B,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE;QACjC,MAAM,SAAS,GAAG,IAAA,4BAAM,EAAC,MAAM,CAAC,CAAA;QAChC,MAAM,OAAO,GAAG,IAAA,4BAAM,EAAC,MAAA,MAAM,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QAClE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAQ,CAAC,oBAAoB,CAAC,CAAA;KAC5D;IAED,OAAO,MAAM,CAAC,IAAI,CAAA;AACpB,CAAC;AAbD,gCAaC;AASD,SAAgB,aAAa,CAAC,OAAsB;IAClD,MAAM,MAAM,GAAG,IAAI,gBAAM,EAAE,CAAA;IAE3B,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,IAAA,4BAAM,EAAC,WAAW,CAAC,CAAA;QAChC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,iBAAQ,CAAC,aAAa,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,IAAI,CAAA;AACpB,CAAC;AATD,sCASC;AAED,SAAS,sBAAsB,CAC7B,MAAoC,EACpC,OAAgC;IAEhC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAA;IAEnC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;QAC9B,OAAO,gBAAgB,CAAA;KACxB;IAED,IAAI,MAAM,CAAC,YAAY,IAAI,IAAI,EAAE;QAC/B,MAAM,IAAI,wBAAe,CAAC,yCAAyC,CAAC,CAAA;KACrE;IAED,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IAEvD,IAAI,gBAAgB,KAAK,eAAe,EAAE;QACxC,MAAM,IAAI,wBAAe,CACvB,2BAA2B;YACzB,+CAA+C,EACjD;YACE,uBAAuB,EAAE,gBAAgB;YACzC,0BAA0B,EAAE,eAAe;SAC5C,CACF,CAAA;KACF;IAED,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAoC,EACpC,OAAgC;IAEhC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAA;IAE/B,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;QAC9B,OAAO,YAAY,CAAA;KACpB;IAED,IAAI,MAAM,CAAC,YAAY,IAAI,IAAI,EAAE;QAC/B,MAAM,IAAI,wBAAe,CAAC,yCAAyC,CAAC,CAAA;KACrE;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IAEpD,IAAI,YAAY,KAAK,SAAS,EAAE;QAC9B,MAAM,IAAI,wBAAe,CACvB,2DAA2D,CAC5D,CAAA;KACF;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAWD,SAAS,UAAU,CACjB,MAAoC,EACpC,UAEI,EAAE;IAEN,MAAM,SAAS,GAAG;QAChB,gBAAgB,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC;QACzD,YAAY,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC;KAChD,CAAA;IACD,OAAO,gBAAgB,iCAAM,MAAM,GAAK,SAAS,EAAG,CAAA;AACtD,CAAC;AAED,kBAAe,UAAU,CAAA"}
+{"version":3,"file":"hashLedger.js","sourceRoot":"","sources":["../../../../src/utils/hashes/hashLedger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xrpl",
-  "version": "4.1.0",
+  "version": "4.2.0-batch.0",
   "license": "ISC",
   "description": "A TypeScript/JavaScript API for interacting with the XRP Ledger in Node.js and the browser",
   "files": [
@@ -29,7 +29,7 @@
     "bignumber.js": "^9.0.0",
     "eventemitter3": "^5.0.1",
     "ripple-address-codec": "^5.0.0",
-    "ripple-binary-codec": "^2.2.0",
+    "ripple-binary-codec": "^2.3.0-batch.0",
     "ripple-keypairs": "^2.0.0"
   },
   "devDependencies": {
@@ -43,7 +43,7 @@
     "lodash": "^4.17.4",
     "react": "^19.0.0",
     "run-s": "^0.0.0",
-    "typedoc": "0.26.11",
+    "typedoc": "0.27.6",
     "ws": "^8.14.2"
   },
   "resolutions": {
@@ -64,7 +64,7 @@
     "test": "jest --config=jest.config.unit.js --verbose false --silent=false",
     "test:integration": "TS_NODE_PROJECT=tsconfig.build.json jest --config=jest.config.integration.js --verbose false --silent=false --runInBand",
     "test:browser": "npm run build && npm run build:browserTests && karma start ./karma.config.js",
-    "test:watch": "jest --watch --verbose false --silent=false --runInBand ./test/**/*.test.ts --testPathIgnorePatterns=./test/integration --testPathIgnorePatterns=./test/fixtures",
+    "test:watch": "jest --watch --config=jest.config.unit.js --verbose false --silent=false",
     "format": "prettier --write '{src,test}/**/*.ts'",
     "lint": "eslint . --ext .ts --max-warnings 0",
     "perf": "./scripts/perf_test.sh",
@@ -88,5 +88,5 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "gitHead": "11e724253bd87a3fcd15949e66786778adaa4640"
+  "gitHead": "3c563434d49d4d656f8b62933f035082733af560"
 }

package/src/Wallet/batchSigner.ts

@@ -0,0 +1,222 @@
+import { bytesToHex } from '@xrplf/isomorphic/utils'
+import BigNumber from 'bignumber.js'
+import { decodeAccountID } from 'ripple-address-codec'
+import { decode, encode, encodeForSigningBatch } from 'ripple-binary-codec'
+import { sign } from 'ripple-keypairs'
+
+import { ValidationError } from '../errors'
+import { Batch, Transaction, validate } from '../models'
+import { BatchSigner, validateBatch } from '../models/transactions/batch'
+import { hashSignedTx } from '../utils/hashes'
+
+import { Wallet } from '.'
+
+/**
+ * Sign a multi-account Batch transaction.
+ *
+ * @param wallet - Wallet instance.
+ * @param transaction - The Batch transaction to sign.
+ * @param opts - Additional options for regular key and multi-signing complexity.
+ * @param opts.batchAccount - The account submitting the inner Batch transaction, on behalf of which is this signature.
+ * @param opts.multisign - Specify true/false to use multisign or actual address (classic/x-address) to make multisign tx request.
+ *                       The actual address is only needed in the case of regular key usage.
+ * @throws ValidationError if the transaction is malformed.
+ */
+// eslint-disable-next-line max-lines-per-function -- TODO: refactor
+export function signMultiBatch(
+  wallet: Wallet,
+  transaction: Batch,
+  opts: { batchAccount?: string; multisign?: boolean | string } = {},
+): void {
+  const batchAccount = opts.batchAccount ?? wallet.classicAddress
+  let multisignAddress: boolean | string = false
+  if (typeof opts.multisign === 'string') {
+    multisignAddress = opts.multisign
+  } else if (opts.multisign) {
+    multisignAddress = wallet.classicAddress
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- needed for JS
+  if (transaction.TransactionType !== 'Batch') {
+    throw new ValidationError('Must be a Batch transaction.')
+  }
+
+  const involvedAccounts = transaction.RawTransactions.map(
+    (raw) => raw.RawTransaction.Account,
+  )
+  if (!involvedAccounts.includes(batchAccount)) {
+    throw new ValidationError(
+      'Must be signing for an address included in the Batch.',
+    )
+  }
+  /*
+   * This will throw a more clear error for JS users if the supplied transaction has incorrect formatting
+   */
+  // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- validate does not accept Transaction type
+  validate(transaction as unknown as Record<string, unknown>)
+  const fieldsToSign = {
+    flags: transaction.Flags,
+    txIDs: transaction.RawTransactions.map((rawTx) =>
+      hashSignedTx(rawTx.RawTransaction),
+    ),
+  }
+  let batchSigner: BatchSigner
+  if (multisignAddress) {
+    batchSigner = {
+      BatchSigner: {
+        Account: batchAccount,
+        Signers: [
+          {
+            Signer: {
+              Account: multisignAddress,
+              SigningPubKey: wallet.publicKey,
+              TxnSignature: sign(
+                encodeForSigningBatch(fieldsToSign),
+                wallet.privateKey,
+              ),
+            },
+          },
+        ],
+      },
+    }
+  } else {
+    batchSigner = {
+      BatchSigner: {
+        Account: batchAccount,
+        SigningPubKey: wallet.publicKey,
+        TxnSignature: sign(
+          encodeForSigningBatch(fieldsToSign),
+          wallet.privateKey,
+        ),
+      },
+    }
+  }
+
+  // eslint-disable-next-line no-param-reassign -- okay for signing
+  transaction.BatchSigners = [batchSigner]
+}
+
+/**
+ * Takes several transactions with BatchSigners fields (in object or blob form) and creates a
+ * single transaction with all BatchSigners that then gets signed and returned.
+ *
+ * @param transactions The transactions to combine `BatchSigners` values on.
+ * @returns A single signed Transaction which has all BatchSigners from transactions within it.
+ * @throws ValidationError if:
+ * - There were no transactions given to sign
+ * @category Signing
+ */
+export function combineBatchSigners(
+  transactions: Array<Batch | string>,
+): string {
+  if (transactions.length === 0) {
+    throw new ValidationError('There are 0 transactions to combine.')
+  }
+
+  const decodedTransactions: Transaction[] = transactions.map((txOrBlob) => {
+    return getDecodedTransaction(txOrBlob)
+  })
+
+  decodedTransactions.forEach((tx) => {
+    if (tx.TransactionType !== 'Batch') {
+      throw new ValidationError('TransactionType must be `Batch`.')
+    }
+    /*
+     * This will throw a more clear error for JS users if any of the supplied transactions has incorrect formatting
+     */
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- validate does not accept Transaction type
+    validateBatch(tx as unknown as Record<string, unknown>)
+    if (tx.BatchSigners == null || tx.BatchSigners.length === 0) {
+      throw new ValidationError(
+        'For combining Batch transaction signatures, all transactions must include a BatchSigners field containing an array of signatures.',
+      )
+    }
+
+    if (tx.TxnSignature != null || tx.Signers != null) {
+      throw new ValidationError('Batch transaction must be unsigned.')
+    }
+  })
+
+  // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- checked above
+  const batchTransactions = decodedTransactions as Batch[]
+
+  validateBatchTransactionEquivalence(batchTransactions)
+
+  return encode(getTransactionWithAllBatchSigners(batchTransactions))
+}
+
+/**
+ * The transactions should all be equal except for the 'Signers' field.
+ *
+ * @param transactions - An array of Transactions which are expected to be equal other than 'Signers'.
+ * @throws ValidationError if the transactions are not equal in any field other than 'Signers'.
+ */
+function validateBatchTransactionEquivalence(transactions: Batch[]): void {
+  const exampleTransaction = JSON.stringify({
+    flags: transactions[0].Flags,
+    transactionIDs: transactions[0].RawTransactions.map((rawTx) =>
+      hashSignedTx(rawTx.RawTransaction),
+    ),
+  })
+  if (
+    transactions.slice(1).some(
+      (tx) =>
+        JSON.stringify({
+          flags: tx.Flags,
+          transactionIDs: tx.RawTransactions.map((rawTx) =>
+            hashSignedTx(rawTx.RawTransaction),
+          ),
+        }) !== exampleTransaction,
+    )
+  ) {
+    throw new ValidationError(
+      'Flags and transaction hashes are not the same for all provided transactions.',
+    )
+  }
+}
+
+function getTransactionWithAllBatchSigners(transactions: Batch[]): Batch {
+  // Signers must be sorted in the combined transaction - See compareSigners' documentation for more details
+  const sortedSigners: BatchSigner[] = transactions
+    .flatMap((tx) => tx.BatchSigners ?? [])
+    .filter((signer) => signer.BatchSigner.Account !== transactions[0].Account)
+    .sort(compareBatchSigners)
+
+  return { ...transactions[0], BatchSigners: sortedSigners }
+}
+
+/**
+ * If presented in binary form, the BatchSigners array must be sorted based on
+ * the numeric value of the signer addresses, with the lowest value first.
+ * (If submitted as JSON, the submit_multisigned method handles this automatically.)
+ * https://xrpl.org/multi-signing.html.
+ *
+ * @param left - A BatchSigner to compare with.
+ * @param right - A second BatchSigner to compare with.
+ * @returns 1 if left \> right, 0 if left = right, -1 if left \< right, and null if left or right are NaN.
+ */
+function compareBatchSigners(left: BatchSigner, right: BatchSigner): number {
+  return addressToBigNumber(left.BatchSigner.Account).comparedTo(
+    addressToBigNumber(right.BatchSigner.Account),
+  )
+}
+
+// copied from signer.ts
+// TODO: refactor
+const NUM_BITS_IN_HEX = 16
+
+function addressToBigNumber(address: string): BigNumber {
+  const hex = bytesToHex(decodeAccountID(address))
+  return new BigNumber(hex, NUM_BITS_IN_HEX)
+}
+
+function getDecodedTransaction(txOrBlob: Transaction | string): Transaction {
+  if (typeof txOrBlob === 'object') {
+    // We need this to handle X-addresses in multisigning
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- We are casting here to get strong typing
+    return decode(encode(txOrBlob)) as unknown as Transaction
+  }
+
+  // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- We are casting here to get strong typing
+  return decode(txOrBlob) as unknown as Transaction
+}

package/src/Wallet/defaultFaucets.ts

@@ -14,11 +14,13 @@ export interface FaucetWallet {
 export enum FaucetNetwork {
   Testnet = 'faucet.altnet.rippletest.net',
   Devnet = 'faucet.devnet.rippletest.net',
+  Batchnet = 'batch.faucet.nerdnest.xyz',
 }
 
 export const FaucetNetworkPaths: Record<string, string> = {
   [FaucetNetwork.Testnet]: '/accounts',
   [FaucetNetwork.Devnet]: '/accounts',
+  [FaucetNetwork.Batchnet]: '/accounts',
 }
 
 /**
@@ -36,6 +38,10 @@ export function getFaucetHost(client: Client): FaucetNetwork | undefined {
     return FaucetNetwork.Testnet
   }
 
+  if (connectionUrl.includes('batchnet')) {
+    return FaucetNetwork.Batchnet
+  }
+
   if (connectionUrl.includes('sidechain-net2')) {
     throw new XRPLFaucetError(
       'Cannot fund an account on an issuing chain. Accounts must be created via the bridge.',

package/src/Wallet/index.ts

@@ -24,6 +24,8 @@ import {
 import ECDSA from '../ECDSA'
 import { ValidationError } from '../errors'
 import { Transaction, validate } from '../models/transactions'
+import { GlobalFlags } from '../models/transactions/common'
+import { hasFlag } from '../models/utils/flags'
 import { ensureClassicAddress } from '../sugar/utils'
 import { omitBy } from '../utils/collections'
 import { hashSignedTx } from '../utils/hashes/hashLedger'
@@ -367,6 +369,7 @@ export class Wallet {
    * @param this - Wallet instance.
    * @param transaction - A transaction to be signed offline.
    * @param multisign - Specify true/false to use multisign or actual address (classic/x-address) to make multisign tx request.
+   *                    The actual address is only needed in the case of regular key usage.
    * @returns A signed transaction.
    * @throws ValidationError if the transaction is already signed or does not encode/decode to same result.
    * @throws XrplError if the issued currency being signed is XRP ignoring case.
@@ -381,7 +384,7 @@ export class Wallet {
     hash: string
   } {
     let multisignAddress: boolean | string = false
-    if (typeof multisign === 'string' && multisign.startsWith('X')) {
+    if (typeof multisign === 'string') {
       multisignAddress = multisign
     } else if (multisign) {
       multisignAddress = this.classicAddress
@@ -407,12 +410,14 @@ export class Wallet {
      */
     // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- validate does not accept Transaction type
     validate(tx as unknown as Record<string, unknown>)
+    if (hasFlag(tx, GlobalFlags.tfInnerBatchTxn)) {
+      throw new ValidationError('Cannot sign a Batch inner transaction.')
+    }
 
     const txToSignAndEncode = { ...tx }
 
-    txToSignAndEncode.SigningPubKey = multisignAddress ? '' : this.publicKey
-
     if (multisignAddress) {
+      txToSignAndEncode.SigningPubKey = ''
       const signer = {
         Account: multisignAddress,
         SigningPubKey: this.publicKey,
@@ -424,6 +429,7 @@ export class Wallet {
       }
       txToSignAndEncode.Signers = [{ Signer: signer }]
     } else {
+      txToSignAndEncode.SigningPubKey = this.publicKey
       txToSignAndEncode.TxnSignature = computeSignature(
         txToSignAndEncode,
         this.privateKey,

package/src/client/RequestManager.ts

@@ -175,6 +175,7 @@ export default class RequestManager {
    * @param response - The response to handle.
    * @throws ResponseFormatError if the response format is invalid, RippledError if rippled returns an error.
    */
+  // eslint-disable-next-line complexity -- handling a response is complex
   public handleResponse(
     response: Partial<Response<APIVersion> | ErrorResponse>,
   ): void {
@@ -195,7 +196,9 @@ export default class RequestManager {
       // eslint-disable-next-line @typescript-eslint/consistent-type-assertions -- We know this must be true
       const errorResponse = response as Partial<ErrorResponse>
       const error = new RippledError(
-        errorResponse.error_message ?? errorResponse.error,
+        errorResponse.error_message ??
+          errorResponse.error_exception ??
+          errorResponse.error,
         errorResponse,
       )
       this.reject(response.id, error)

package/src/client/connection.ts

@@ -349,7 +349,6 @@ export class Connection extends EventEmitter {
       try {
         this.requestManager.handleResponse(data)
       } catch (error) {
-        // eslint-disable-next-line max-depth -- okay here
         if (error instanceof Error) {
           this.emit('error', 'badMessage', error.message, message)
         } else {

package/src/client/index.ts

@@ -40,14 +40,19 @@ import type {
   MarkerRequest,
   MarkerResponse,
   SubmitResponse,
+  SimulateRequest,
 } from '../models/methods'
 import type { BookOffer, BookOfferCurrency } from '../models/methods/bookOffers'
+import {
+  SimulateBinaryResponse,
+  SimulateJsonResponse,
+} from '../models/methods/simulate'
 import type {
   EventTypes,
   OnEventToListenerMap,
 } from '../models/methods/subscribe'
 import type { SubmittableTransaction } from '../models/transactions'
-import { setTransactionFlagsToNumber } from '../models/utils/flags'
+import { convertTxFlagsToNumber } from '../models/utils/flags'
 import {
   ensureClassicAddress,
   submitRequest,
@@ -62,6 +67,8 @@ import {
   setLatestValidatedLedgerSequence,
   checkAccountDeleteBlockers,
   txNeedsNetworkID,
+  autofillBatchTxn,
+  handleDeliverMax,
 } from '../sugar/autofill'
 import { formatBalances } from '../sugar/balances'
 import {
@@ -657,7 +664,6 @@ class Client extends EventEmitter<EventTypes> {
    * @throws ValidationError If Amount and DeliverMax fields are not identical in a Payment Transaction
    */
 
-  // eslint-disable-next-line complexity -- handling Payment transaction API v2 requires more logic
   public async autofill<T extends SubmittableTransaction>(
     transaction: T,
     signersCount?: number,
@@ -665,7 +671,7 @@ class Client extends EventEmitter<EventTypes> {
     const tx = { ...transaction }
 
     setValidAddresses(tx)
-    setTransactionFlagsToNumber(tx)
+    tx.Flags = convertTxFlagsToNumber(tx)
 
     const promises: Array<Promise<void>> = []
     if (tx.NetworkID == null) {
@@ -683,33 +689,11 @@ class Client extends EventEmitter<EventTypes> {
     if (tx.TransactionType === 'AccountDelete') {
       promises.push(checkAccountDeleteBlockers(this, tx))
     }
-
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- ignore type-assertions on the DeliverMax property
-    // @ts-expect-error -- DeliverMax property exists only at the RPC level, not at the protocol level
-    if (tx.TransactionType === 'Payment' && tx.DeliverMax != null) {
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- This is a valid null check for Amount
-      if (tx.Amount == null) {
-        // If only DeliverMax is provided, use it to populate the Amount field
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- ignore type-assertions on the DeliverMax property
-        // @ts-expect-error -- DeliverMax property exists only at the RPC level, not at the protocol level
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- DeliverMax is a known RPC-level property
-        tx.Amount = tx.DeliverMax
-      }
-
-      // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- ignore type-assertions on the DeliverMax property
-      // @ts-expect-error -- DeliverMax property exists only at the RPC level, not at the protocol level
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- This is a valid null check for Amount
-      if (tx.Amount != null && tx.Amount !== tx.DeliverMax) {
-        return Promise.reject(
-          new ValidationError(
-            'PaymentTransaction: Amount and DeliverMax fields must be identical when both are provided',
-          ),
-        )
-      }
-
-      // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- ignore type-assertions on the DeliverMax property
-      // @ts-expect-error -- DeliverMax property exists only at the RPC level, not at the protocol level
-      delete tx.DeliverMax
+    if (tx.TransactionType === 'Batch') {
+      promises.push(autofillBatchTxn(this, tx))
+    }
+    if (tx.TransactionType === 'Payment') {
+      handleDeliverMax(tx)
     }
 
     return Promise.all(promises).then(() => tx)
@@ -764,6 +748,41 @@ class Client extends EventEmitter<EventTypes> {
     return submitRequest(this, signedTx, opts?.failHard)
   }
 
+  /**
+   * Simulates an unsigned transaction.
+   * Steps performed on a transaction:
+   *    1. Autofill.
+   *    2. Sign & Encode.
+   *    3. Submit.
+   *
+   * @category Core
+   *
+   * @param transaction - A transaction to autofill, sign & encode, and submit.
+   * @param opts - (Optional) Options used to sign and submit a transaction.
+   * @param opts.binary - If true, return the metadata in a binary encoding.
+   *
+   * @returns A promise that contains SimulateResponse.
+   * @throws RippledError if the simulate request fails.
+   */
+
+  public async simulate<Binary extends boolean = false>(
+    transaction: SubmittableTransaction | string,
+    opts?: {
+      // If true, return the binary-encoded representation of the results.
+      binary?: Binary
+    },
+  ): Promise<
+    Binary extends true ? SimulateBinaryResponse : SimulateJsonResponse
+  > {
+    // send request
+    const binary = opts?.binary ?? false
+    const request: SimulateRequest =
+      typeof transaction === 'string'
+        ? { command: 'simulate', tx_blob: transaction, binary }
+        : { command: 'simulate', tx_json: transaction, binary }
+    return this.request(request)
+  }
+
   /**
    * Asynchronously submits a transaction and verifies that it has been included in a
    * validated ledger (or has errored/will not be included for some reason).

package/src/models/index.ts

@@ -8,8 +8,9 @@
  */
 export * as LedgerEntry from './ledger'
 export {
-  setTransactionFlagsToNumber,
   parseAccountRootFlags,
+  setTransactionFlagsToNumber,
+  convertTxFlagsToNumber,
   parseTransactionFlags,
 } from './utils/flags'
 export * from './methods'

package/src/models/ledger/Credential.ts

@@ -1,8 +1,8 @@
-import { GlobalFlags } from '../transactions/common'
+import { GlobalFlagsInterface } from '../transactions/common'
 
 import { BaseLedgerEntry, HasPreviousTxnID } from './BaseLedgerEntry'
 
-export interface CredentialFlags extends GlobalFlags {
+export interface CredentialFlags extends GlobalFlagsInterface {
   lsfAccepted?: boolean
 }
 

package/src/models/ledger/LedgerEntry.ts

@@ -13,6 +13,7 @@ import NegativeUNL from './NegativeUNL'
 import Offer from './Offer'
 import Oracle from './Oracle'
 import PayChannel from './PayChannel'
+import PermissionedDomain from './PermissionedDomain'
 import RippleState from './RippleState'
 import SignerList from './SignerList'
 import Ticket from './Ticket'
@@ -35,6 +36,7 @@ type LedgerEntry =
   | Offer
   | Oracle
   | PayChannel
+  | PermissionedDomain
   | RippleState
   | SignerList
   | Ticket
@@ -61,6 +63,7 @@ type LedgerEntryFilter =
   | 'offer'
   | 'oracle'
   | 'payment_channel'
+  | 'permissioned_domain'
   | 'signer_list'
   | 'state'
   | 'ticket'

package/src/models/ledger/PermissionedDomain.ts

@@ -0,0 +1,29 @@
+import { AuthorizeCredential } from '../common'
+
+import { BaseLedgerEntry, HasPreviousTxnID } from './BaseLedgerEntry'
+
+export default interface PermissionedDomain
+  extends BaseLedgerEntry,
+    HasPreviousTxnID {
+  /* The ledger object's type (PermissionedDomain). */
+  LedgerEntryType: 'PermissionedDomain'
+
+  /* The account that controls the settings of the domain. */
+  Owner: string
+
+  /* The credentials that are accepted by the domain.
+  Ownership of one of these credentials automatically
+  makes you a member of the domain. */
+  AcceptedCredentials: AuthorizeCredential[]
+
+  /*  Flag values associated with this object. */
+  Flags: 0
+
+  /* Owner account's directory page containing the PermissionedDomain object. */
+  OwnerNode: string
+
+  /* The Sequence value of the PermissionedDomainSet
+  transaction that created this domain. Used in combination
+  with the Account to identify this domain. */
+  Sequence: number
+}

package/src/models/ledger/RippleState.ts

@@ -77,4 +77,8 @@ export enum RippleStateFlags {
   lsfHighFreeze = 0x00800000,
   // True, trust line to AMM. Used by client apps to identify payments via AMM.
   lsfAMMNode = 0x01000000,
+  // True, low side has set deep freeze flag
+  lsfLowDeepFreeze = 0x02000000,
+  // True, high side has set deep freeze flag
+  lsfHighDeepFreeze = 0x04000000,
 }

package/src/models/methods/baseMethod.ts

@@ -53,6 +53,7 @@ export interface ErrorResponse {
   error: string
   error_code?: string
   error_message?: string
+  error_exception?: string
   request: Request
   api_version?: number
 }