@bitgo/wasm-utxo 4.26.0 → 4.28.0

package/dist/cjs/js/fixedScriptWallet/ZcashV6Transaction.d.ts

@@ -0,0 +1,45 @@
+import { ZcashV6Transaction as WasmZcashV6Transaction } from "../wasm/wasm_utxo.js";
+/**
+ * A parsed Zcash v6 (Ironwood / NU6.3) transaction — for inspection and txid.
+ *
+ * The transaction id is an instance method ({@link getId}) returning the canonical
+ * display-order hex, consistent with the `getId()` convention on the other
+ * transaction/PSBT wrappers. Callers never pass raw bytes to a txid function or have
+ * to reverse internal byte order themselves.
+ *
+ * @example
+ * ```typescript
+ * const tx = ZcashV6Transaction.fromBytes(rawV6Bytes);
+ * tx.getId();                 // canonical (display-order) txid hex
+ * tx.ironwoodActionCount;     // 0 when the Ironwood slot is empty
+ * ```
+ */
+export declare class ZcashV6Transaction {
+    private _wasm;
+    private constructor();
+    /**
+     * Decode a v6 transaction from raw wire bytes.
+     * @throws If the bytes are not a valid v6 (Ironwood) transaction
+     */
+    static fromBytes(bytes: Uint8Array): ZcashV6Transaction;
+    /** Serialize back to raw v6 wire bytes. */
+    toBytes(): Uint8Array;
+    /** The canonical (display-order) ZIP-244 txid as a lowercase hex string. */
+    getId(): string;
+    /** The ZIP-244 txid in internal (non-reversed) byte order. */
+    txidBytes(): Uint8Array;
+    /** Consensus branch id carried in the v6 header. */
+    get consensusBranchId(): number;
+    /** Expiry height. */
+    get expiryHeight(): number;
+    /** Number of Ironwood actions (0 when the Ironwood slot is empty). */
+    get ironwoodActionCount(): number;
+    /** Net value crossing the Ironwood pool boundary (0 when there is no bundle). */
+    get ironwoodValueBalance(): bigint;
+    /** The Ironwood bundle flag byte, or `undefined` when there is no bundle. */
+    get ironwoodFlags(): number | undefined;
+    /** The Ironwood note-commitment tree anchor (32 bytes), or `undefined`. */
+    get ironwoodAnchor(): Uint8Array | undefined;
+    /** @internal */
+    get wasm(): WasmZcashV6Transaction;
+}

package/dist/cjs/js/fixedScriptWallet/ZcashV6Transaction.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZcashV6Transaction = void 0;
+const wasm_utxo_js_1 = require("../wasm/wasm_utxo.js");
+/**
+ * A parsed Zcash v6 (Ironwood / NU6.3) transaction — for inspection and txid.
+ *
+ * The transaction id is an instance method ({@link getId}) returning the canonical
+ * display-order hex, consistent with the `getId()` convention on the other
+ * transaction/PSBT wrappers. Callers never pass raw bytes to a txid function or have
+ * to reverse internal byte order themselves.
+ *
+ * @example
+ * ```typescript
+ * const tx = ZcashV6Transaction.fromBytes(rawV6Bytes);
+ * tx.getId();                 // canonical (display-order) txid hex
+ * tx.ironwoodActionCount;     // 0 when the Ironwood slot is empty
+ * ```
+ */
+class ZcashV6Transaction {
+    _wasm;
+    constructor(_wasm) {
+        this._wasm = _wasm;
+    }
+    /**
+     * Decode a v6 transaction from raw wire bytes.
+     * @throws If the bytes are not a valid v6 (Ironwood) transaction
+     */
+    static fromBytes(bytes) {
+        return new ZcashV6Transaction(wasm_utxo_js_1.ZcashV6Transaction.fromBytes(bytes));
+    }
+    /** Serialize back to raw v6 wire bytes. */
+    toBytes() {
+        return this._wasm.toBytes();
+    }
+    /** The canonical (display-order) ZIP-244 txid as a lowercase hex string. */
+    getId() {
+        return this._wasm.getId();
+    }
+    /** The ZIP-244 txid in internal (non-reversed) byte order. */
+    txidBytes() {
+        return this._wasm.txidBytes();
+    }
+    /** Consensus branch id carried in the v6 header. */
+    get consensusBranchId() {
+        return this._wasm.consensusBranchId;
+    }
+    /** Expiry height. */
+    get expiryHeight() {
+        return this._wasm.expiryHeight;
+    }
+    /** Number of Ironwood actions (0 when the Ironwood slot is empty). */
+    get ironwoodActionCount() {
+        return this._wasm.ironwoodActionCount;
+    }
+    /** Net value crossing the Ironwood pool boundary (0 when there is no bundle). */
+    get ironwoodValueBalance() {
+        return this._wasm.ironwoodValueBalance;
+    }
+    /** The Ironwood bundle flag byte, or `undefined` when there is no bundle. */
+    get ironwoodFlags() {
+        return this._wasm.ironwoodFlags;
+    }
+    /** The Ironwood note-commitment tree anchor (32 bytes), or `undefined`. */
+    get ironwoodAnchor() {
+        return this._wasm.ironwoodAnchor;
+    }
+    /** @internal */
+    get wasm() {
+        return this._wasm;
+    }
+}
+exports.ZcashV6Transaction = ZcashV6Transaction;

package/dist/cjs/js/fixedScriptWallet/index.d.ts

@@ -10,6 +10,7 @@ export { BitGoPsbt, getWalletKeysFromPsbt, type NetworkName, type ScriptId, type
 export { BitGoKeySubtype, type PsbtKvKey } from "./BitGoKeySubtype.js";
 export { ZcashBitGoPsbt, type ZcashNetworkName, type CreateEmptyZcashOptions, } from "./ZcashBitGoPsbt.js";
 export { ZcashUnifiedAddress } from "./ZcashUnifiedAddress.js";
+export { ZcashV6Transaction } from "./ZcashV6Transaction.js";
 import type { ScriptType } from "./scriptType.js";
 /**
  * Check if a network supports a given fixed-script wallet script type

package/dist/cjs/js/fixedScriptWallet/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZcashUnifiedAddress = exports.ZcashBitGoPsbt = exports.BitGoKeySubtype = exports.getWalletKeysFromPsbt = exports.BitGoPsbt = exports.requiresPrevTxForP2sh = exports.assertChainCode = exports.chainCodes = exports.ChainCode = exports.inputScriptTypes = exports.outputScriptTypes = exports.Dimensions = exports.address = exports.outputScript = exports.ReplayProtection = exports.RootWalletKeys = void 0;
+exports.ZcashV6Transaction = exports.ZcashUnifiedAddress = exports.ZcashBitGoPsbt = exports.BitGoKeySubtype = exports.getWalletKeysFromPsbt = exports.BitGoPsbt = exports.requiresPrevTxForP2sh = exports.assertChainCode = exports.chainCodes = exports.ChainCode = exports.inputScriptTypes = exports.outputScriptTypes = exports.Dimensions = exports.address = exports.outputScript = exports.ReplayProtection = exports.RootWalletKeys = void 0;
 exports.supportsScriptType = supportsScriptType;
 exports.createOpReturnScript = createOpReturnScript;
 exports.p2shP2pkOutputScript = p2shP2pkOutputScript;
@@ -36,6 +36,9 @@ Object.defineProperty(exports, "ZcashBitGoPsbt", { enumerable: true, get: functi
 // Zcash ZIP-316 Unified Address
 var ZcashUnifiedAddress_js_1 = require("./ZcashUnifiedAddress.js");
 Object.defineProperty(exports, "ZcashUnifiedAddress", { enumerable: true, get: function () { return ZcashUnifiedAddress_js_1.ZcashUnifiedAddress; } });
+// Zcash v6 (Ironwood / NU6.3) transaction
+var ZcashV6Transaction_js_1 = require("./ZcashV6Transaction.js");
+Object.defineProperty(exports, "ZcashV6Transaction", { enumerable: true, get: function () { return ZcashV6Transaction_js_1.ZcashV6Transaction; } });
 /**
  * Check if a network supports a given fixed-script wallet script type
  *

package/dist/cjs/js/wasm/wasm_utxo.d.ts

@@ -1621,6 +1621,64 @@ export class ZcashUnifiedAddress {
     readonly transparentScript: Uint8Array | undefined;
 }
 
+/**
+ * A parsed Zcash v6 (Ironwood / NU6.3) transaction — for inspection and txid.
+ *
+ * This wraps the raw v6 wire codec. The transaction id is exposed as an instance
+ * method [`ZcashV6Transaction::get_id`] (canonical display-order hex), matching the
+ * `getId()` convention used by the other transaction/PSBT wrappers, so callers never
+ * pass raw bytes to a txid function or juggle internal vs display byte order.
+ */
+export class ZcashV6Transaction {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Decode a v6 transaction from raw wire bytes. Throws if the bytes are not a
+     * valid v6 (Ironwood) transaction.
+     */
+    static fromBytes(bytes: Uint8Array): ZcashV6Transaction;
+    /**
+     * The canonical (display-order) ZIP-244 txid as a lowercase hex string.
+     *
+     * `Txid`'s `Display` emits display-order (byte-reversed) hex, matching how a
+     * transaction id is printed everywhere else in the codebase.
+     */
+    getId(): string;
+    /**
+     * Serialize back to raw v6 wire bytes.
+     */
+    toBytes(): Uint8Array;
+    /**
+     * The ZIP-244 txid in internal (non-reversed) byte order.
+     */
+    txidBytes(): Uint8Array;
+    /**
+     * Consensus branch id carried in the v6 header.
+     */
+    readonly consensusBranchId: number;
+    /**
+     * Expiry height.
+     */
+    readonly expiryHeight: number;
+    /**
+     * Number of Ironwood actions (0 when the Ironwood slot is empty).
+     */
+    readonly ironwoodActionCount: number;
+    /**
+     * The Ironwood note-commitment tree anchor (32 bytes), or `undefined`.
+     */
+    readonly ironwoodAnchor: Uint8Array | undefined;
+    /**
+     * The Ironwood bundle flag byte, or `undefined` when there is no bundle.
+     */
+    readonly ironwoodFlags: number | undefined;
+    /**
+     * Net value crossing the Ironwood pool boundary (0 when there is no bundle).
+     */
+    readonly ironwoodValueBalance: bigint;
+}
+
 /**
  * Check if the inspect feature is enabled.
  *

package/dist/cjs/js/wasm/wasm_utxo.js

@@ -6355,6 +6355,181 @@ class ZcashUnifiedAddress {
 if (Symbol.dispose) ZcashUnifiedAddress.prototype[Symbol.dispose] = ZcashUnifiedAddress.prototype.free;
 exports.ZcashUnifiedAddress = ZcashUnifiedAddress;
 
+/**
+ * A parsed Zcash v6 (Ironwood / NU6.3) transaction — for inspection and txid.
+ *
+ * This wraps the raw v6 wire codec. The transaction id is exposed as an instance
+ * method [`ZcashV6Transaction::get_id`] (canonical display-order hex), matching the
+ * `getId()` convention used by the other transaction/PSBT wrappers, so callers never
+ * pass raw bytes to a txid function or juggle internal vs display byte order.
+ */
+class ZcashV6Transaction {
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(ZcashV6Transaction.prototype);
+        obj.__wbg_ptr = ptr;
+        ZcashV6TransactionFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        ZcashV6TransactionFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_zcashv6transaction_free(ptr, 0);
+    }
+    /**
+     * Consensus branch id carried in the v6 header.
+     * @returns {number}
+     */
+    get consensusBranchId() {
+        const ret = wasm.zcashv6transaction_consensusBranchId(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * Expiry height.
+     * @returns {number}
+     */
+    get expiryHeight() {
+        const ret = wasm.zcashv6transaction_expiryHeight(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * Decode a v6 transaction from raw wire bytes. Throws if the bytes are not a
+     * valid v6 (Ironwood) transaction.
+     * @param {Uint8Array} bytes
+     * @returns {ZcashV6Transaction}
+     */
+    static fromBytes(bytes) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.zcashv6transaction_fromBytes(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return ZcashV6Transaction.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The canonical (display-order) ZIP-244 txid as a lowercase hex string.
+     *
+     * `Txid`'s `Display` emits display-order (byte-reversed) hex, matching how a
+     * transaction id is printed everywhere else in the codebase.
+     * @returns {string}
+     */
+    getId() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.zcashv6transaction_getId(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * Number of Ironwood actions (0 when the Ironwood slot is empty).
+     * @returns {number}
+     */
+    get ironwoodActionCount() {
+        const ret = wasm.zcashv6transaction_ironwoodActionCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * The Ironwood note-commitment tree anchor (32 bytes), or `undefined`.
+     * @returns {Uint8Array | undefined}
+     */
+    get ironwoodAnchor() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.zcashv6transaction_ironwoodAnchor(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            let v1;
+            if (r0 !== 0) {
+                v1 = getArrayU8FromWasm0(r0, r1).slice();
+                wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            }
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The Ironwood bundle flag byte, or `undefined` when there is no bundle.
+     * @returns {number | undefined}
+     */
+    get ironwoodFlags() {
+        const ret = wasm.zcashv6transaction_ironwoodFlags(this.__wbg_ptr);
+        return ret === 0xFFFFFF ? undefined : ret;
+    }
+    /**
+     * Net value crossing the Ironwood pool boundary (0 when there is no bundle).
+     * @returns {bigint}
+     */
+    get ironwoodValueBalance() {
+        const ret = wasm.zcashv6transaction_ironwoodValueBalance(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * Serialize back to raw v6 wire bytes.
+     * @returns {Uint8Array}
+     */
+    toBytes() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.zcashv6transaction_toBytes(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v1 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The ZIP-244 txid in internal (non-reversed) byte order.
+     * @returns {Uint8Array}
+     */
+    txidBytes() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.zcashv6transaction_txidBytes(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var v1 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+}
+if (Symbol.dispose) ZcashV6Transaction.prototype[Symbol.dispose] = ZcashV6Transaction.prototype.free;
+exports.ZcashV6Transaction = ZcashV6Transaction;
+
 /**
  * Check if the inspect feature is enabled.
  *
@@ -6858,6 +7033,9 @@ const WrapPsbtFinalization = (typeof FinalizationRegistry === 'undefined')
 const ZcashUnifiedAddressFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_zcashunifiedaddress_free(ptr >>> 0, 1));
+const ZcashV6TransactionFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_zcashv6transaction_free(ptr >>> 0, 1));
 
 function addHeapObject(obj) {
     if (heap_next === heap.length) heap.push(heap.length + 1);