@tari-project/ootle-wasm 0.37.0 → 0.39.0

package/ootle_wasm.d.ts

@@ -157,6 +157,22 @@ export function aggregateInputMasks(masks_concat: Uint8Array): Uint8Array;
  */
 export function borEncodeTransaction(transaction_json: string): string;
 
+/**
+ * Build a script-path `SpendWitness` revealing `leaf` from the committed `conditions` set, optionally
+ * supplying a witness `data` blob the leaf's predicate interprets (e.g. a hashlock preimage). Returns a
+ * JSON object: `{ "witness": <SpendWitness>, "condition_root": <Hash32> }`.
+ *
+ * `conditions_json` is the JSON array of `SpendCondition` leaves exactly as passed to
+ * `createStealthOutputWitness`'s `PayTo::Conditions` when the output was created; `leaf_json` is the
+ * single leaf being revealed. The returned `condition_root` must match the `Script` root recorded in
+ * that output's `SpendAuthorization` -- record it against the spent input via
+ * `buildStealthInputsStatementFromInputs`.
+ *
+ * Pass an empty `data` array for a leaf whose predicate needs no spender-supplied data (e.g. a plain
+ * timelock refund).
+ */
+export function buildScriptPathWitness(conditions_json: string, leaf_json: string, data: Uint8Array): string;
+
 /**
  * Build a `StealthInputsStatement` JSON from raw input commitments and a revealed amount.
  *
@@ -168,6 +184,43 @@ export function borEncodeTransaction(transaction_json: string): string;
  */
 export function buildStealthInputsStatement(input_commitments: Uint8Array, revealed_amount_microtari: bigint): string;
 
+/**
+ * Build a `StealthInputsStatement` JSON from a JSON array of per-input `{commitment, witness}` pairs
+ * and a revealed amount.
+ *
+ * Unlike `buildStealthInputsStatement`, which only builds key-path inputs from raw commitment bytes,
+ * this accepts a caller-supplied `witness` per input -- the only way to spend an output committed with
+ * `PayTo::Conditions` (e.g. claiming or refunding an HTLC-style hashlock/timelock output). Build each
+ * script-path input's witness with `buildScriptPathWitness` first; a plain key-path input can still be
+ * included in the same call, either with `"witness":"KeyPath"` or by omitting `witness` entirely
+ * (defaults to key path).
+ *
+ * `inputs_json` shape: `[{ "commitment": <hex 32 bytes>, "witness"?: <SpendWitness> }, ...]`.
+ */
+export function buildStealthInputsStatementFromInputs(inputs_json: string, revealed_amount_microtari: bigint): string;
+
+/**
+ * Build a complete `StealthTransferStatement` JSON from unblinded input/output witnesses.
+ *
+ * Unlike `generateStealthOutputsStatement` / `buildStealthInputsStatementFromInputs` +
+ * `generateStealthBalanceProofSignature`, which build and sign each half of a transfer
+ * separately, this wraps the single primitive that produces the *entire*, internally-consistent
+ * statement in one call, including a covenant balance-integrity proof for any script-path input
+ * whose revealed leaf gates on `Covenant::BalancePreserved` (see `ootle_wasm_core::stealth::
+ * transfer::build_stealth_transfer_statement` for when a claim is and isn't needed).
+ *
+ * `input_witnesses_json` is a JSON array of `{ "mask_and_value": { "value": <u64>, "mask": <hex
+ * 32 bytes> }, "witness"?: <SpendWitness>, "condition_root"?: <Hash32> }` -- each entry's
+ * `witness`/`condition_root` are the exact pair `buildScriptPathWitness` returns, for a
+ * script-path input; omit both for a plain key-path input. Mixing key-path and script-path
+ * inputs in one call is supported.
+ *
+ * `output_witnesses_json` is a JSON array of the same `{ "witness": {...}, "auth": ..., "tag":
+ * ... }` shape `createStealthOutputWitness` returns -- collect one entry per output (including
+ * change).
+ */
+export function buildStealthTransferStatement(input_witnesses_json: string, revealed_input_amount_microtari: bigint, output_witnesses_json: string, revealed_output_amount_microtari: bigint): string;
+
 /**
  * Build a single stealth output witness entirely client-side (sender side), mirroring the wallet
  * daemon's `create_output_witness`.

package/ootle_wasm.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./ootle_wasm_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    DecryptedOutputResult, KeypairResult, OotlePublicKey, OotleSecretKey, ParsedOotleAddress, SchnorrSignatureResult, StealthOutputsResult, addTransactionSigner, aggregateInputMasks, borEncodeTransaction, buildStealthInputsStatement, createStealthOutputWitness, decryptElgamalViewableBalance, encryptedDataDhKdfAead, generateElgamalViewableBalanceProof, generateExtendedBulletProof, generateKeypair, generateOotleAddress, generateOotleSecretKey, generateStealthBalanceProofSignature, generateStealthOutputsStatement, hashUnsignedTransaction, on_start, ootlePublicKeyFromSecretKey, parseOotleAddress, publicKeyFromSecretKey, schnorrSign, sealTransaction, stealthDhSecret, unblindOutput, validateBalanceProofSignature, validateStealthTransfer
+    DecryptedOutputResult, KeypairResult, OotlePublicKey, OotleSecretKey, ParsedOotleAddress, SchnorrSignatureResult, StealthOutputsResult, addTransactionSigner, aggregateInputMasks, borEncodeTransaction, buildScriptPathWitness, buildStealthInputsStatement, buildStealthInputsStatementFromInputs, buildStealthTransferStatement, createStealthOutputWitness, decryptElgamalViewableBalance, encryptedDataDhKdfAead, generateElgamalViewableBalanceProof, generateExtendedBulletProof, generateKeypair, generateOotleAddress, generateOotleSecretKey, generateStealthBalanceProofSignature, generateStealthOutputsStatement, hashUnsignedTransaction, on_start, ootlePublicKeyFromSecretKey, parseOotleAddress, publicKeyFromSecretKey, schnorrSign, sealTransaction, stealthDhSecret, unblindOutput, validateBalanceProofSignature, validateStealthTransfer
 } from "./ootle_wasm_bg.js";

package/ootle_wasm_bg.js

@@ -575,6 +575,49 @@ export function borEncodeTransaction(transaction_json) {
     }
 }
 
+/**
+ * Build a script-path `SpendWitness` revealing `leaf` from the committed `conditions` set, optionally
+ * supplying a witness `data` blob the leaf's predicate interprets (e.g. a hashlock preimage). Returns a
+ * JSON object: `{ "witness": <SpendWitness>, "condition_root": <Hash32> }`.
+ *
+ * `conditions_json` is the JSON array of `SpendCondition` leaves exactly as passed to
+ * `createStealthOutputWitness`'s `PayTo::Conditions` when the output was created; `leaf_json` is the
+ * single leaf being revealed. The returned `condition_root` must match the `Script` root recorded in
+ * that output's `SpendAuthorization` -- record it against the spent input via
+ * `buildStealthInputsStatementFromInputs`.
+ *
+ * Pass an empty `data` array for a leaf whose predicate needs no spender-supplied data (e.g. a plain
+ * timelock refund).
+ * @param {string} conditions_json
+ * @param {string} leaf_json
+ * @param {Uint8Array} data
+ * @returns {string}
+ */
+export function buildScriptPathWitness(conditions_json, leaf_json, data) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(conditions_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(leaf_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ret = wasm.buildScriptPathWitness(ptr0, len0, ptr1, len1, ptr2, len2);
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
 /**
  * Build a `StealthInputsStatement` JSON from raw input commitments and a revealed amount.
  *
@@ -608,6 +651,91 @@ export function buildStealthInputsStatement(input_commitments, revealed_amount_m
     }
 }
 
+/**
+ * Build a `StealthInputsStatement` JSON from a JSON array of per-input `{commitment, witness}` pairs
+ * and a revealed amount.
+ *
+ * Unlike `buildStealthInputsStatement`, which only builds key-path inputs from raw commitment bytes,
+ * this accepts a caller-supplied `witness` per input -- the only way to spend an output committed with
+ * `PayTo::Conditions` (e.g. claiming or refunding an HTLC-style hashlock/timelock output). Build each
+ * script-path input's witness with `buildScriptPathWitness` first; a plain key-path input can still be
+ * included in the same call, either with `"witness":"KeyPath"` or by omitting `witness` entirely
+ * (defaults to key path).
+ *
+ * `inputs_json` shape: `[{ "commitment": <hex 32 bytes>, "witness"?: <SpendWitness> }, ...]`.
+ * @param {string} inputs_json
+ * @param {bigint} revealed_amount_microtari
+ * @returns {string}
+ */
+export function buildStealthInputsStatementFromInputs(inputs_json, revealed_amount_microtari) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(inputs_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.buildStealthInputsStatementFromInputs(ptr0, len0, revealed_amount_microtari);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Build a complete `StealthTransferStatement` JSON from unblinded input/output witnesses.
+ *
+ * Unlike `generateStealthOutputsStatement` / `buildStealthInputsStatementFromInputs` +
+ * `generateStealthBalanceProofSignature`, which build and sign each half of a transfer
+ * separately, this wraps the single primitive that produces the *entire*, internally-consistent
+ * statement in one call, including a covenant balance-integrity proof for any script-path input
+ * whose revealed leaf gates on `Covenant::BalancePreserved` (see `ootle_wasm_core::stealth::
+ * transfer::build_stealth_transfer_statement` for when a claim is and isn't needed).
+ *
+ * `input_witnesses_json` is a JSON array of `{ "mask_and_value": { "value": <u64>, "mask": <hex
+ * 32 bytes> }, "witness"?: <SpendWitness>, "condition_root"?: <Hash32> }` -- each entry's
+ * `witness`/`condition_root` are the exact pair `buildScriptPathWitness` returns, for a
+ * script-path input; omit both for a plain key-path input. Mixing key-path and script-path
+ * inputs in one call is supported.
+ *
+ * `output_witnesses_json` is a JSON array of the same `{ "witness": {...}, "auth": ..., "tag":
+ * ... }` shape `createStealthOutputWitness` returns -- collect one entry per output (including
+ * change).
+ * @param {string} input_witnesses_json
+ * @param {bigint} revealed_input_amount_microtari
+ * @param {string} output_witnesses_json
+ * @param {bigint} revealed_output_amount_microtari
+ * @returns {string}
+ */
+export function buildStealthTransferStatement(input_witnesses_json, revealed_input_amount_microtari, output_witnesses_json, revealed_output_amount_microtari) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const ptr0 = passStringToWasm0(input_witnesses_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(output_witnesses_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.buildStealthTransferStatement(ptr0, len0, revealed_input_amount_microtari, ptr1, len1, revealed_output_amount_microtari);
+        var ptr3 = ret[0];
+        var len3 = ret[1];
+        if (ret[3]) {
+            ptr3 = 0; len3 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_free(deferred4_0, deferred4_1, 1);
+    }
+}
+
 /**
  * Build a single stealth output witness entirely client-side (sender side), mirroring the wallet
  * daemon's `create_output_witness`.

package/package.json

@@ -5,7 +5,7 @@
     "The Tari Development Community"
   ],
   "description": "WASM bindings for Tari Ootle client-side crypto — thin wasm-bindgen shell over ootle-wasm-core",
-  "version": "0.37.0",
+  "version": "0.39.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",