@bitgo/wasm-utxo 1.29.0 → 1.31.0

package/dist/cjs/js/bip32.d.ts

@@ -62,6 +62,14 @@ export declare class BIP32 implements BIP32Interface {
      * @returns A BIP32 instance
      */
     static fromSeed(seed: Uint8Array, network?: string | null): BIP32;
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * Useful for deterministic test key generation.
+     * @param seedString - The seed string to hash
+     * @param network - Optional network string
+     * @returns A BIP32 instance
+     */
+    static fromSeedSha256(seedString: string, network?: string | null): BIP32;
     /**
      * Get the chain code as a Uint8Array
      */

package/dist/cjs/js/bip32.js

@@ -63,6 +63,17 @@ class BIP32 {
         const wasm = wasm_utxo_js_1.WasmBIP32.from_seed(seed, network);
         return new BIP32(wasm);
     }
+    /**
+     * Create a BIP32 master key from a string by hashing it with SHA256.
+     * Useful for deterministic test key generation.
+     * @param seedString - The seed string to hash
+     * @param network - Optional network string
+     * @returns A BIP32 instance
+     */
+    static fromSeedSha256(seedString, network) {
+        const wasm = wasm_utxo_js_1.WasmBIP32.from_seed_sha256(seedString, network);
+        return new BIP32(wasm);
+    }
     /**
      * Get the chain code as a Uint8Array
      */

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

@@ -543,4 +543,30 @@ export declare class BitGoPsbt {
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
     extractTransaction(): Uint8Array;
+    /**
+     * Extract a half-signed transaction in legacy format for p2ms-based script types.
+     *
+     * This method extracts a transaction where each input has exactly one signature,
+     * formatted in the legacy style used by utxo-lib and bitcoinjs-lib. The legacy
+     * format places signatures in the correct position (0, 1, or 2) based on which
+     * key signed, with empty placeholders for unsigned positions.
+     *
+     * Requirements:
+     * - All inputs must be p2ms-based (p2sh, p2shP2wsh, or p2wsh)
+     * - Each input must have exactly 1 partial signature
+     *
+     * @returns The serialized half-signed transaction bytes
+     * @throws Error if any input is not a p2ms type (Taproot, replay protection, etc.)
+     * @throws Error if any input has 0 or more than 1 partial signature
+     *
+     * @example
+     * ```typescript
+     * // Sign with user key only
+     * psbt.sign(userXpriv);
+     *
+     * // Extract half-signed transaction in legacy format
+     * const halfSignedTx = psbt.getHalfSignedLegacyFormat();
+     * ```
+     */
+    getHalfSignedLegacyFormat(): Uint8Array;
 }

package/dist/cjs/js/fixedScriptWallet/BitGoPsbt.js

@@ -497,5 +497,33 @@ class BitGoPsbt {
     extractTransaction() {
         return this._wasm.extract_transaction();
     }
+    /**
+     * Extract a half-signed transaction in legacy format for p2ms-based script types.
+     *
+     * This method extracts a transaction where each input has exactly one signature,
+     * formatted in the legacy style used by utxo-lib and bitcoinjs-lib. The legacy
+     * format places signatures in the correct position (0, 1, or 2) based on which
+     * key signed, with empty placeholders for unsigned positions.
+     *
+     * Requirements:
+     * - All inputs must be p2ms-based (p2sh, p2shP2wsh, or p2wsh)
+     * - Each input must have exactly 1 partial signature
+     *
+     * @returns The serialized half-signed transaction bytes
+     * @throws Error if any input is not a p2ms type (Taproot, replay protection, etc.)
+     * @throws Error if any input has 0 or more than 1 partial signature
+     *
+     * @example
+     * ```typescript
+     * // Sign with user key only
+     * psbt.sign(userXpriv);
+     *
+     * // Extract half-signed transaction in legacy format
+     * const halfSignedTx = psbt.getHalfSignedLegacyFormat();
+     * ```
+     */
+    getHalfSignedLegacyFormat() {
+        return this._wasm.extract_half_signed_legacy_tx();
+    }
 }
 exports.BitGoPsbt = BitGoPsbt;

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

@@ -6,6 +6,7 @@ export * as utxolibCompat from "./utxolibCompat.js";
 export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
 export * as bip32 from "./bip32.js";
 export * as ecpair from "./ecpair.js";
+export * as testutils from "./testutils/index.js";
 export { ECPair } from "./ecpair.js";
 export { BIP32 } from "./bip32.js";
 export { Dimensions } from "./fixedScriptWallet/Dimensions.js";
@@ -38,9 +39,24 @@ declare module "./wasm/wasm_utxo.js" {
     interface WrapPsbt {
         signWithXprv(this: WrapPsbt, xprv: string): SignPsbtResult;
         signWithPrv(this: WrapPsbt, prv: Uint8Array): SignPsbtResult;
+        signAll(this: WrapPsbt, key: WasmBIP32): SignPsbtResult;
+        signAllWithEcpair(this: WrapPsbt, key: WasmECPair): SignPsbtResult;
+        inputCount(): number;
+        outputCount(): number;
+        getPartialSignatures(inputIndex: number): Array<{
+            pubkey: Uint8Array;
+            signature: Uint8Array;
+        }>;
+        hasPartialSignatures(inputIndex: number): boolean;
+        validateSignatureAtInput(inputIndex: number, pubkey: Uint8Array): boolean;
+        verifySignatureWithKey(inputIndex: number, key: WasmBIP32): boolean;
+        unsignedTxId(): string;
+        lockTime(): number;
+        version(): number;
     }
 }
 export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
 export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
+export { hasPsbtMagic } from "./psbt.js";

package/dist/cjs/js/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.Dimensions = exports.BIP32 = exports.ECPair = exports.ecpair = exports.bip32 = exports.fixedScriptWallet = exports.utxolibCompat = exports.inscriptions = exports.bip322 = exports.ast = exports.address = void 0;
+exports.hasPsbtMagic = exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.Dimensions = exports.BIP32 = exports.ECPair = exports.testutils = exports.ecpair = exports.bip32 = exports.fixedScriptWallet = exports.utxolibCompat = exports.inscriptions = exports.bip322 = exports.ast = exports.address = void 0;
 const wasm = __importStar(require("./wasm/wasm_utxo.js"));
 // we need to access the wasm module here, otherwise webpack gets all weird
 // and forgets to include it in the bundle
@@ -48,6 +48,7 @@ exports.utxolibCompat = __importStar(require("./utxolibCompat.js"));
 exports.fixedScriptWallet = __importStar(require("./fixedScriptWallet/index.js"));
 exports.bip32 = __importStar(require("./bip32.js"));
 exports.ecpair = __importStar(require("./ecpair.js"));
+exports.testutils = __importStar(require("./testutils/index.js"));
 // Only the most commonly used classes and types are exported at the top level for convenience
 var ecpair_js_1 = require("./ecpair.js");
 Object.defineProperty(exports, "ECPair", { enumerable: true, get: function () { return ecpair_js_1.ECPair; } });
@@ -65,3 +66,5 @@ var transaction_js_1 = require("./transaction.js");
 Object.defineProperty(exports, "DashTransaction", { enumerable: true, get: function () { return transaction_js_1.DashTransaction; } });
 Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_js_1.Transaction; } });
 Object.defineProperty(exports, "ZcashTransaction", { enumerable: true, get: function () { return transaction_js_1.ZcashTransaction; } });
+var psbt_js_1 = require("./psbt.js");
+Object.defineProperty(exports, "hasPsbtMagic", { enumerable: true, get: function () { return psbt_js_1.hasPsbtMagic; } });

package/dist/cjs/js/psbt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+export declare function hasPsbtMagic(bytes: Uint8Array): boolean;

package/dist/cjs/js/psbt.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasPsbtMagic = hasPsbtMagic;
+/** PSBT magic bytes: "psbt" (0x70 0x73 0x62 0x74) followed by separator 0xff */
+const PSBT_MAGIC = new Uint8Array([0x70, 0x73, 0x62, 0x74, 0xff]);
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+function hasPsbtMagic(bytes) {
+    if (bytes.length < PSBT_MAGIC.length) {
+        return false;
+    }
+    for (let i = 0; i < PSBT_MAGIC.length; i++) {
+        if (bytes[i] !== PSBT_MAGIC[i]) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/cjs/js/testutils/keys.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getKey = getKey;
 exports.getKeyTriple = getKeyTriple;
@@ -39,7 +6,6 @@ exports.getWalletKeysForSeed = getWalletKeysForSeed;
 exports.getDefaultWalletKeys = getDefaultWalletKeys;
 exports.getKeyName = getKeyName;
 exports.getDefaultCosigner = getDefaultCosigner;
-const crypto = __importStar(require("crypto"));
 const bip32_js_1 = require("../bip32.js");
 const RootWalletKeys_js_1 = require("../fixedScriptWallet/RootWalletKeys.js");
 /**
@@ -56,7 +22,7 @@ const RootWalletKeys_js_1 = require("../fixedScriptWallet/RootWalletKeys.js");
  * ```
  */
 function getKey(seed) {
-    return bip32_js_1.BIP32.fromSeed(crypto.createHash("sha256").update(seed).digest());
+    return bip32_js_1.BIP32.fromSeedSha256(seed);
 }
 /**
  * Generate a triple of BIP32 keys for a 2-of-3 multisig wallet.

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

@@ -537,6 +537,27 @@ export class BitGoPsbt {
    * - `Err(WasmUtxoError)` if signing fails
    */
   sign_single_input_with_xpriv(input_index: number, xpriv: WasmBIP32): void;
+  /**
+   * Extract a half-signed transaction in legacy format for p2ms-based script types.
+   *
+   * This method extracts a transaction where each input has exactly one signature,
+   * formatted in the legacy style used by utxo-lib and bitcoinjs-lib. The legacy
+   * format places signatures in the correct position (0, 1, or 2) based on which
+   * key signed, with empty placeholders for unsigned positions.
+   *
+   * # Requirements
+   * - All inputs must be p2ms-based (p2sh, p2shP2wsh, or p2wsh)
+   * - Each input must have exactly 1 partial signature
+   *
+   * # Returns
+   * - `Ok(Vec<u8>)` containing the serialized half-signed transaction bytes
+   * - `Err(WasmUtxoError)` if validation fails or extraction fails
+   *
+   * # Errors
+   * - Returns error if any input is not a p2ms type (Taproot, replay protection, etc.)
+   * - Returns error if any input has 0 or more than 1 partial signature
+   */
+  extract_half_signed_legacy_tx(): Uint8Array;
   /**
    * Sign all replay protection inputs with a raw private key.
    *
@@ -772,6 +793,11 @@ export class WasmBIP32 {
    * Derive a hardened child key (only works for private keys)
    */
   derive_hardened(index: number): WasmBIP32;
+  /**
+   * Create a BIP32 master key from a string by hashing it with SHA256.
+   * This is useful for deterministic test key generation.
+   */
+  static from_seed_sha256(seed_string: string, network?: string | null): WasmBIP32;
   /**
    * Create a BIP32 key from a BIP32Interface JavaScript object properties
    * Expects an object with: network.bip32.public, depth, parentFingerprint,
@@ -1160,9 +1186,21 @@ export class WrapPsbt {
    */
   addOutput(script: Uint8Array, value: bigint): number;
   static deserialize(psbt: Uint8Array): WrapPsbt;
+  /**
+   * Get the number of inputs in the PSBT
+   */
+  inputCount(): number;
   finalize(): void;
+  /**
+   * Get the number of outputs in the PSBT
+   */
+  outputCount(): number;
   signWithPrv(prv: Uint8Array): any;
   signWithXprv(xprv: string): any;
+  /**
+   * Get the unsigned transaction ID as a hex string
+   */
+  unsignedTxId(): string;
   /**
    * Get the unsigned transaction bytes
    *
@@ -1170,6 +1208,53 @@ export class WrapPsbt {
    * The serialized unsigned transaction
    */
   getUnsignedTx(): Uint8Array;
+  /**
+   * Sign all inputs with a WasmECPair key
+   *
+   * This method signs all inputs using the private key from the ECPair.
+   * Returns a map of input indices to the public keys that were signed.
+   *
+   * # Arguments
+   * * `key` - The WasmECPair key to sign with
+   *
+   * # Returns
+   * A SigningKeysMap converted to JsValue (object mapping input indices to signing keys)
+   */
+  signAllWithEcpair(key: WasmECPair): any;
+  /**
+   * Get partial signatures for an input
+   * Returns array of { pubkey: Uint8Array, signature: Uint8Array }
+   */
+  getPartialSignatures(input_index: number): any;
+  /**
+   * Check if an input has any partial signatures
+   */
+  hasPartialSignatures(input_index: number): boolean;
+  /**
+   * Verify a signature at a specific input using a WasmBIP32 key
+   *
+   * This method verifies if a valid signature exists for the given BIP32 key at the specified input.
+   * It handles both ECDSA (legacy/SegWit) and Schnorr (Taproot) signatures.
+   *
+   * Note: This method checks if the key's public key matches any signature in the input.
+   * For proper BIP32 verification, the key should be derived to the correct path first.
+   *
+   * # Arguments
+   * * `input_index` - The index of the input to check
+   * * `key` - The WasmBIP32 key to verify against
+   *
+   * # Returns
+   * `true` if a valid signature exists for the key, `false` otherwise
+   */
+  verifySignatureWithKey(input_index: number, key: WasmBIP32): boolean;
+  /**
+   * Validate a signature at a specific input against a pubkey
+   * Returns true if the signature is valid
+   *
+   * This method handles both ECDSA (legacy/SegWit) and Schnorr (Taproot) signatures.
+   * The pubkey should be provided as bytes (33 bytes for compressed ECDSA, 32 bytes for x-only Schnorr).
+   */
+  validateSignatureAtInput(input_index: number, pubkey: Uint8Array): boolean;
   updateInputWithDescriptor(input_index: number, descriptor: WrapDescriptor): void;
   updateOutputWithDescriptor(output_index: number, descriptor: WrapDescriptor): void;
   /**
@@ -1181,6 +1266,23 @@ export class WrapPsbt {
    */
   constructor(version?: number | null, lock_time?: number | null);
   clone(): WrapPsbt;
+  /**
+   * Get the transaction version
+   */
+  version(): number;
+  /**
+   * Sign all inputs with a WasmBIP32 key
+   *
+   * This method signs all inputs that match the BIP32 derivation paths in the PSBT.
+   * Returns a map of input indices to the public keys that were signed.
+   *
+   * # Arguments
+   * * `key` - The WasmBIP32 key to sign with
+   *
+   * # Returns
+   * A SigningKeysMap converted to JsValue (object mapping input indices to signing keys)
+   */
+  signAll(key: WasmBIP32): any;
   /**
    * Add an input to the PSBT
    *
@@ -1195,5 +1297,9 @@ export class WrapPsbt {
    * The index of the newly added input
    */
   addInput(txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null): number;
+  /**
+   * Get the transaction lock time
+   */
+  lockTime(): number;
   serialize(): Uint8Array;
 }