@oobe-protocol-labs/synapse-sap-sdk 0.9.3 → 0.10.1

package/src/utils/hash.ts

@@ -55,3 +55,59 @@ export const sha256 = (input: string | Buffer | Uint8Array): Uint8Array => {
  * ```
  */
 export const hashToArray = (hash: Uint8Array): number[] => Array.from(hash);
+
+/**
+ * Compute the deterministic batch root used by `settle_batch` (v0.10.0).
+ *
+ * The on-chain program enforces:
+ *   `batch_root == sha256(s_0 || s_1 || ... || s_{N-1})`
+ * where each `s_i` is a 32-byte service hash, in the same order as the
+ * `settlements: Settlement[]` array passed to the instruction.
+ *
+ * Use this helper to derive the seed for the {@link deriveSettlementReceipt}
+ * PDA when batching settlements.
+ *
+ * @name computeBatchRoot
+ * @param serviceHashes - Array of 32-byte service hashes (Buffer/Uint8Array/number[]).
+ * @returns {Uint8Array} 32-byte batch root.
+ * @throws If any `serviceHashes[i]` is not exactly 32 bytes long.
+ * @category Utils
+ * @since v0.10.0
+ *
+ * @example
+ * ```ts
+ * import { computeBatchRoot, hashToArray } from "@synapse-sap/sdk/utils";
+ *
+ * const root = computeBatchRoot([h1, h2, h3]);
+ * await client.escrow.settleBatch(depositor, settlements, root);
+ * ```
+ */
+export const computeBatchRoot = (
+  serviceHashes: ReadonlyArray<Uint8Array | Buffer | number[]>,
+): Uint8Array => {
+  if (serviceHashes.length === 0) {
+    throw new Error("computeBatchRoot: serviceHashes must not be empty");
+  }
+  const hash = createHash("sha256");
+  for (let i = 0; i < serviceHashes.length; i++) {
+    const h = serviceHashes[i];
+    let buf: Buffer;
+    if (h instanceof Uint8Array) {
+      buf = Buffer.from(h);
+    } else if (Array.isArray(h)) {
+      buf = Buffer.from(h);
+    } else {
+      throw new Error(
+        `computeBatchRoot: serviceHashes[${i}] is undefined or unsupported type`,
+      );
+    }
+    if (buf.length !== 32) {
+      throw new Error(
+        `computeBatchRoot: serviceHashes[${i}] must be 32 bytes, got ${buf.length}`,
+      );
+    }
+    hash.update(buf);
+  }
+  return new Uint8Array(hash.digest());
+};
+

package/src/utils/index.ts

@@ -14,7 +14,7 @@
  * ```
  */
 
-export { sha256, hashToArray } from "./hash";
+export { sha256, hashToArray, computeBatchRoot } from "./hash";
 export { assert } from "./validation";
 export { serializeAccount, serializeValue } from "./serialization";