XRPLF · mvadari · May 3, 2024 · May 7, 2024 · May 8, 2024 · May 8, 2024
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -3,6 +3,8 @@
     "cSpell.words": [
         "altnet",
         "Autofills",
+        "Batchnet",
+        "bignumber",
         "Clawback",
         "hostid",
         "keypair",
@@ -15,7 +17,8 @@
         "secp256k1",
         "Setf",
         "Sidechains",
-        "xchain"
+        "xchain",
+        "xrplf"
     ],
     "[javascript]": {
         "editor.defaultFormatter": "esbenp.prettier-vscode",

diff --git a/packages/ripple-binary-codec/HISTORY.md b/packages/ripple-binary-codec/HISTORY.md
@@ -2,10 +2,13 @@
 
 ## Unreleased
 
+### Added
+* Support for the `Batch` amendment (XLS-56).
+
 ## 2.2.0 (2024-12-23)
 
 ### Added
-* Support for the Multi-Purpose Token amendment (XLS-33)
+* Support for the Multi-Purpose Token amendment (XLS-33).
 
 ## 2.1.0 (2024-06-03)
 

diff --git a/packages/ripple-binary-codec/src/binary.ts b/packages/ripple-binary-codec/src/binary.ts
@@ -177,11 +177,50 @@ function multiSigningData(
   })
 }
 
+/**
+ * Interface describing fields required for a Batch signer
+ */
+interface BatchObject extends JsonObject {
+  flags: number
+  txIDs: string[]
+}
+
+/**
+ * Serialize a signingClaim
+ *
+ * @param batch A Batch object to serialize
+ * @param opts.definitions Custom rippled types to use instead of the default. Used for sidechains and amendments.
+ * @returns the serialized object with appropriate prefix
+ */
+function signingBatchData(batch: BatchObject): Uint8Array {
+  if (batch.flags == null) {
+    throw Error("No field `flags'")
+  }
+  if (batch.txIDs == null) {
+    throw Error('No field `txIDs`')
+  }
+  const prefix = HashPrefix.batch
+  const flags = coreTypes.UInt32.from(batch.flags).toBytes()
+  const txIDsLength = coreTypes.UInt32.from(batch.txIDs.length).toBytes()
+
+  const bytesList = new BytesList()
+
+  bytesList.put(prefix)
+  bytesList.put(flags)
+  bytesList.put(txIDsLength)
+  batch.txIDs.forEach((txID: string) => {
+    bytesList.put(coreTypes.Hash256.from(txID).toBytes())
+  })
-  batch.txIDs.forEach((txID: string) => {
-    bytesList.put(coreTypes.Hash256.from(txID).toBytes())
-  })
+  batch.txIDs.forEach((txID: string) => {
+    if (!/^[A-F0-9]{64}$/i.test(txID)) {
+      throw new Error(`Invalid transaction ID format: ${txID}`)
+    }
+    bytesList.put(coreTypes.Hash256.from(txID).toBytes())
+  })
-  batch.txIDs.forEach((txID: string) => {
-    bytesList.put(coreTypes.Hash256.from(txID).toBytes())
-  })
+  batch.txIDs.forEach((txID: string) => {
+    if (!/^[A-F0-9]{64}$/i.test(txID)) {
+      throw new Error(`Invalid transaction ID format: ${txID}`)
+    }
+    bytesList.put(coreTypes.Hash256.from(txID).toBytes())
+  })
+
+  return bytesList.toBytes()
+}
+
 export {
   BinaryParser,
   BinarySerializer,
   BytesList,
   ClaimObject,
+  BatchObject,
   makeParser,
   serializeObject,
   readJSON,
@@ -191,4 +230,5 @@ export {
   binaryToJSON,
   sha512Half,
   transactionID,
+  signingBatchData,
 }