@tari-project/ootle-wasm 0.31.0 → 0.32.0

package/ootle_wasm.d.ts

@@ -168,6 +168,41 @@ export function borEncodeTransaction(transaction_json: string): string;
  */
 export function buildStealthInputsStatement(input_commitments: Uint8Array, revealed_amount_microtari: bigint): string;
 
+/**
+ * Build a single stealth output witness entirely client-side (sender side), mirroring the wallet
+ * daemon's `create_output_witness`.
+ *
+ * A fresh commitment mask and ephemeral nonce are generated internally; the recipient recovers the
+ * value and mask by decrypting `encrypted_data`. Returns one witness as a JSON string with the shape:
+ * ```text
+ * {
+ *   "witness": {
+ *     "amount": <u64>,
+ *     "mask": <hex 32 bytes>,
+ *     "sender_public_nonce": <hex 32 bytes>,
+ *     "minimum_value_promise": <u64>,
+ *     "encrypted_data": <hex variable-length>,
+ *     "resource_view_key": <hex 32 bytes | null>
+ *   },
+ *   "spend_condition": <SpendCondition>,
+ *   "tag": <u32>
+ * }
+ * ```
+ * Collect one witness per output (including change) into a JSON array and pass it to
+ * `generateStealthOutputsStatement`.
+ *
+ * - `network` is the network byte (0x00 = MainNet, 0x10 = LocalNet, 0x26 = Esmeralda, ...).
+ * - `destination_account_public_key` / `destination_view_public_key` are the recipient's 32-byte keys.
+ * - `resource_address` is the `resource_<hex>` string of the resource being sent.
+ * - `resource_view_key` is the resource view-key holder's 32-byte public key, or `null` for resources without a
+ *   viewable balance (when set, the output receives an ElGamal proof at statement time).
+ * - `memo_json` is an optional JSON-encoded `Memo` to embed in the encrypted payload.
+ * - `pay_to_json` is an optional JSON-encoded `PayTo`: `"StealthPublicKey"` (the default when `null`, producing a
+ *   one-time stealth spend key) or `{"AccessRule": <AccessRule>}`.
+ * - `minimum_value_promise` is the range-proof lower bound and must be `<= amount` (use `0` normally).
+ */
+export function createStealthOutputWitness(network: number, destination_account_public_key: Uint8Array, destination_view_public_key: Uint8Array, amount: bigint, resource_address: string, resource_view_key: Uint8Array | null | undefined, memo_json: string | null | undefined, pay_to_json: string | null | undefined, minimum_value_promise: bigint): string;
+
 /**
  * Brute-force decrypt an ElGamal viewable-balance proof to recover the bound value.
  *

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, 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, buildStealthInputsStatement, 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

@@ -608,6 +608,80 @@ export function buildStealthInputsStatement(input_commitments, revealed_amount_m
     }
 }
 
+/**
+ * Build a single stealth output witness entirely client-side (sender side), mirroring the wallet
+ * daemon's `create_output_witness`.
+ *
+ * A fresh commitment mask and ephemeral nonce are generated internally; the recipient recovers the
+ * value and mask by decrypting `encrypted_data`. Returns one witness as a JSON string with the shape:
+ * ```text
+ * {
+ *   "witness": {
+ *     "amount": <u64>,
+ *     "mask": <hex 32 bytes>,
+ *     "sender_public_nonce": <hex 32 bytes>,
+ *     "minimum_value_promise": <u64>,
+ *     "encrypted_data": <hex variable-length>,
+ *     "resource_view_key": <hex 32 bytes | null>
+ *   },
+ *   "spend_condition": <SpendCondition>,
+ *   "tag": <u32>
+ * }
+ * ```
+ * Collect one witness per output (including change) into a JSON array and pass it to
+ * `generateStealthOutputsStatement`.
+ *
+ * - `network` is the network byte (0x00 = MainNet, 0x10 = LocalNet, 0x26 = Esmeralda, ...).
+ * - `destination_account_public_key` / `destination_view_public_key` are the recipient's 32-byte keys.
+ * - `resource_address` is the `resource_<hex>` string of the resource being sent.
+ * - `resource_view_key` is the resource view-key holder's 32-byte public key, or `null` for resources without a
+ *   viewable balance (when set, the output receives an ElGamal proof at statement time).
+ * - `memo_json` is an optional JSON-encoded `Memo` to embed in the encrypted payload.
+ * - `pay_to_json` is an optional JSON-encoded `PayTo`: `"StealthPublicKey"` (the default when `null`, producing a
+ *   one-time stealth spend key) or `{"AccessRule": <AccessRule>}`.
+ * - `minimum_value_promise` is the range-proof lower bound and must be `<= amount` (use `0` normally).
+ * @param {number} network
+ * @param {Uint8Array} destination_account_public_key
+ * @param {Uint8Array} destination_view_public_key
+ * @param {bigint} amount
+ * @param {string} resource_address
+ * @param {Uint8Array | null | undefined} resource_view_key
+ * @param {string | null | undefined} memo_json
+ * @param {string | null | undefined} pay_to_json
+ * @param {bigint} minimum_value_promise
+ * @returns {string}
+ */
+export function createStealthOutputWitness(network, destination_account_public_key, destination_view_public_key, amount, resource_address, resource_view_key, memo_json, pay_to_json, minimum_value_promise) {
+    let deferred8_0;
+    let deferred8_1;
+    try {
+        const ptr0 = passArray8ToWasm0(destination_account_public_key, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(destination_view_public_key, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(resource_address, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        var ptr3 = isLikeNone(resource_view_key) ? 0 : passArray8ToWasm0(resource_view_key, wasm.__wbindgen_malloc);
+        var len3 = WASM_VECTOR_LEN;
+        var ptr4 = isLikeNone(memo_json) ? 0 : passStringToWasm0(memo_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len4 = WASM_VECTOR_LEN;
+        var ptr5 = isLikeNone(pay_to_json) ? 0 : passStringToWasm0(pay_to_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len5 = WASM_VECTOR_LEN;
+        const ret = wasm.createStealthOutputWitness(network, ptr0, len0, ptr1, len1, amount, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, minimum_value_promise);
+        var ptr7 = ret[0];
+        var len7 = ret[1];
+        if (ret[3]) {
+            ptr7 = 0; len7 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred8_0 = ptr7;
+        deferred8_1 = len7;
+        return getStringFromWasm0(ptr7, len7);
+    } finally {
+        wasm.__wbindgen_free(deferred8_0, deferred8_1, 1);
+    }
+}
+
 /**
  * Brute-force decrypt an ElGamal viewable-balance proof to recover the bound value.
  *

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.31.0",
+  "version": "0.32.0",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",