@bitgo/wasm-utxo 1.35.0 → 1.37.0

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

@@ -1,6 +1,51 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_addressnamespace_free: (a: number, b: number) => void;
+export const __wbg_messagenamespace_free: (a: number, b: number) => void;
+export const __wbg_wasmecpair_free: (a: number, b: number) => void;
+export const __wbg_wrappsbt_free: (a: number, b: number) => void;
+export const addressnamespace_from_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const addressnamespace_to_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number) => void;
+export const messagenamespace_sign_message: (a: number, b: number, c: number, d: number) => void;
+export const messagenamespace_verify_message: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmecpair_from_private_key: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_public_key: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif_mainnet: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif_testnet: (a: number, b: number, c: number) => void;
+export const wasmecpair_private_key: (a: number) => number;
+export const wasmecpair_public_key: (a: number) => number;
+export const wasmecpair_to_wif: (a: number, b: number) => void;
+export const wasmecpair_to_wif_mainnet: (a: number, b: number) => void;
+export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
+export const wrappsbt_addInput: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number) => void;
+export const wrappsbt_addOutput: (a: number, b: number, c: number, d: bigint) => number;
+export const wrappsbt_clone: (a: number) => number;
+export const wrappsbt_deserialize: (a: number, b: number, c: number) => void;
+export const wrappsbt_extractTransaction: (a: number, b: number) => void;
+export const wrappsbt_finalize: (a: number, b: number) => void;
+export const wrappsbt_getInputs: (a: number, b: number) => void;
+export const wrappsbt_getOutputs: (a: number, b: number) => void;
+export const wrappsbt_getOutputsWithAddress: (a: number, b: number, c: number, d: number) => void;
+export const wrappsbt_getPartialSignatures: (a: number, b: number, c: number) => void;
+export const wrappsbt_getUnsignedTx: (a: number, b: number) => void;
+export const wrappsbt_hasPartialSignatures: (a: number, b: number, c: number) => void;
+export const wrappsbt_inputCount: (a: number) => number;
+export const wrappsbt_lockTime: (a: number) => number;
+export const wrappsbt_new: (a: number, b: number) => number;
+export const wrappsbt_outputCount: (a: number) => number;
+export const wrappsbt_serialize: (a: number, b: number) => void;
+export const wrappsbt_signAll: (a: number, b: number, c: number) => void;
+export const wrappsbt_signAllWithEcpair: (a: number, b: number, c: number) => void;
+export const wrappsbt_signWithPrv: (a: number, b: number, c: number, d: number) => void;
+export const wrappsbt_signWithXprv: (a: number, b: number, c: number, d: number) => void;
+export const wrappsbt_unsignedTxId: (a: number, b: number) => void;
+export const wrappsbt_updateInputWithDescriptor: (a: number, b: number, c: number, d: number) => void;
+export const wrappsbt_updateOutputWithDescriptor: (a: number, b: number, c: number, d: number) => void;
+export const wrappsbt_validateSignatureAtInput: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrappsbt_verifySignatureWithKey: (a: number, b: number, c: number, d: number) => void;
+export const wrappsbt_version: (a: number) => number;
 export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
 export const __wbg_wasmrootwalletkeys_free: (a: number, b: number) => void;
 export const wasmreplayprotection_from_addresses: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -11,9 +56,65 @@ export const wasmrootwalletkeys_bitgo_key: (a: number) => number;
 export const wasmrootwalletkeys_new: (a: number, b: number, c: number, d: number) => void;
 export const wasmrootwalletkeys_user_key: (a: number) => number;
 export const wasmrootwalletkeys_with_derivation_prefixes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const __wbg_inscriptionsnamespace_free: (a: number, b: number) => void;
+export const __wbg_wasmbip32_free: (a: number, b: number) => void;
+export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
+export const __wbg_wasmzcashtransaction_free: (a: number, b: number) => void;
+export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
+export const __wbg_wrapminiscript_free: (a: number, b: number) => void;
+export const inscriptionsnamespace_create_inscription_reveal_data: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const inscriptionsnamespace_sign_reveal_transaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint) => void;
+export const wasmbip32_chain_code: (a: number) => number;
+export const wasmbip32_depth: (a: number) => number;
+export const wasmbip32_derive: (a: number, b: number, c: number) => void;
+export const wasmbip32_derive_hardened: (a: number, b: number, c: number) => void;
+export const wasmbip32_derive_path: (a: number, b: number, c: number, d: number) => void;
+export const wasmbip32_equals: (a: number, b: number) => number;
+export const wasmbip32_fingerprint: (a: number) => number;
+export const wasmbip32_from_base58: (a: number, b: number, c: number) => void;
+export const wasmbip32_from_bip32_interface: (a: number, b: number) => void;
+export const wasmbip32_from_seed: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmbip32_from_seed_sha256: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmbip32_from_xprv: (a: number, b: number, c: number) => void;
+export const wasmbip32_from_xpub: (a: number, b: number, c: number) => void;
+export const wasmbip32_identifier: (a: number) => number;
+export const wasmbip32_index: (a: number) => number;
+export const wasmbip32_is_neutered: (a: number) => number;
+export const wasmbip32_neutered: (a: number) => number;
+export const wasmbip32_parent_fingerprint: (a: number) => number;
+export const wasmbip32_private_key: (a: number) => number;
+export const wasmbip32_public_key: (a: number) => number;
+export const wasmbip32_to_base58: (a: number, b: number) => void;
+export const wasmbip32_to_wif: (a: number, b: number) => void;
+export const wasmtransaction_from_bytes: (a: number, b: number, c: number) => void;
+export const wasmtransaction_get_txid: (a: number, b: number) => void;
+export const wasmtransaction_get_vsize: (a: number) => number;
+export const wasmtransaction_to_bytes: (a: number, b: number) => void;
+export const wasmzcashtransaction_from_bytes: (a: number, b: number, c: number) => void;
+export const wasmzcashtransaction_get_txid: (a: number, b: number) => void;
+export const wasmzcashtransaction_to_bytes: (a: number, b: number) => void;
+export const wrapdescriptor_atDerivationIndex: (a: number, b: number, c: number) => void;
+export const wrapdescriptor_descType: (a: number, b: number) => void;
+export const wrapdescriptor_encode: (a: number, b: number) => void;
+export const wrapdescriptor_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapdescriptor_fromStringDetectType: (a: number, b: number, c: number) => void;
+export const wrapdescriptor_hasWildcard: (a: number) => number;
+export const wrapdescriptor_maxWeightToSatisfy: (a: number, b: number) => void;
+export const wrapdescriptor_node: (a: number, b: number) => void;
+export const wrapdescriptor_scriptPubkey: (a: number, b: number) => void;
+export const wrapdescriptor_toAsmString: (a: number, b: number) => void;
+export const wrapdescriptor_toString: (a: number, b: number) => void;
+export const wrapminiscript_encode: (a: number, b: number) => void;
+export const wrapminiscript_fromBitcoinScript: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapminiscript_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapminiscript_node: (a: number, b: number) => void;
+export const wrapminiscript_toAsmString: (a: number, b: number) => void;
+export const wrapminiscript_toString: (a: number, b: number) => void;
+export const wasmbip32_from_bip32_properties: (a: number, b: number) => void;
 export const __wbg_bip322namespace_free: (a: number, b: number) => void;
 export const __wbg_bitgopsbt_free: (a: number, b: number) => void;
 export const __wbg_fixedscriptwalletnamespace_free: (a: number, b: number) => void;
+export const __wbg_utxolibcompatnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmdashtransaction_free: (a: number, b: number) => void;
 export const __wbg_wasmdimensions_free: (a: number, b: number) => void;
 export const bip322namespace_add_bip322_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
@@ -69,6 +170,8 @@ export const fixedscriptwalletnamespace_create_op_return_script: (a: number, b:
 export const fixedscriptwalletnamespace_output_script: (a: number, b: number, c: number, d: number, e: number) => void;
 export const fixedscriptwalletnamespace_output_script_with_network_str: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const fixedscriptwalletnamespace_supports_script_type: (a: number, b: number, c: number, d: number, e: number) => void;
+export const utxolibcompatnamespace_from_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const utxolibcompatnamespace_to_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
 export const wasmdashtransaction_get_txid: (a: number, b: number) => void;
 export const wasmdashtransaction_to_bytes: (a: number, b: number) => void;
@@ -90,104 +193,6 @@ export const wasmdimensions_times: (a: number, b: number) => number;
 export const bitgopsbt_sign_wallet_input: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_all_with_xpriv: (a: number, b: number, c: number) => void;
 export const bitgopsbt_sign_replay_protection_inputs: (a: number, b: number, c: number) => void;
-export const __wbg_inscriptionsnamespace_free: (a: number, b: number) => void;
-export const __wbg_wasmbip32_free: (a: number, b: number) => void;
-export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
-export const __wbg_wasmzcashtransaction_free: (a: number, b: number) => void;
-export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
-export const __wbg_wrapminiscript_free: (a: number, b: number) => void;
-export const inscriptionsnamespace_create_inscription_reveal_data: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const inscriptionsnamespace_sign_reveal_transaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint) => void;
-export const wasmbip32_chain_code: (a: number) => number;
-export const wasmbip32_depth: (a: number) => number;
-export const wasmbip32_derive: (a: number, b: number, c: number) => void;
-export const wasmbip32_derive_hardened: (a: number, b: number, c: number) => void;
-export const wasmbip32_derive_path: (a: number, b: number, c: number, d: number) => void;
-export const wasmbip32_fingerprint: (a: number) => number;
-export const wasmbip32_from_base58: (a: number, b: number, c: number) => void;
-export const wasmbip32_from_bip32_interface: (a: number, b: number) => void;
-export const wasmbip32_from_seed: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wasmbip32_from_seed_sha256: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wasmbip32_from_xprv: (a: number, b: number, c: number) => void;
-export const wasmbip32_from_xpub: (a: number, b: number, c: number) => void;
-export const wasmbip32_identifier: (a: number) => number;
-export const wasmbip32_index: (a: number) => number;
-export const wasmbip32_is_neutered: (a: number) => number;
-export const wasmbip32_neutered: (a: number) => number;
-export const wasmbip32_parent_fingerprint: (a: number) => number;
-export const wasmbip32_private_key: (a: number) => number;
-export const wasmbip32_public_key: (a: number) => number;
-export const wasmbip32_to_base58: (a: number, b: number) => void;
-export const wasmbip32_to_wif: (a: number, b: number) => void;
-export const wasmtransaction_from_bytes: (a: number, b: number, c: number) => void;
-export const wasmtransaction_get_txid: (a: number, b: number) => void;
-export const wasmtransaction_get_vsize: (a: number) => number;
-export const wasmtransaction_to_bytes: (a: number, b: number) => void;
-export const wasmzcashtransaction_from_bytes: (a: number, b: number, c: number) => void;
-export const wasmzcashtransaction_get_txid: (a: number, b: number) => void;
-export const wasmzcashtransaction_to_bytes: (a: number, b: number) => void;
-export const wrapdescriptor_atDerivationIndex: (a: number, b: number, c: number) => void;
-export const wrapdescriptor_descType: (a: number, b: number) => void;
-export const wrapdescriptor_encode: (a: number, b: number) => void;
-export const wrapdescriptor_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapdescriptor_fromStringDetectType: (a: number, b: number, c: number) => void;
-export const wrapdescriptor_hasWildcard: (a: number) => number;
-export const wrapdescriptor_maxWeightToSatisfy: (a: number, b: number) => void;
-export const wrapdescriptor_node: (a: number, b: number) => void;
-export const wrapdescriptor_scriptPubkey: (a: number, b: number) => void;
-export const wrapdescriptor_toAsmString: (a: number, b: number) => void;
-export const wrapdescriptor_toString: (a: number, b: number) => void;
-export const wrapminiscript_encode: (a: number, b: number) => void;
-export const wrapminiscript_fromBitcoinScript: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapminiscript_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapminiscript_node: (a: number, b: number) => void;
-export const wrapminiscript_toAsmString: (a: number, b: number) => void;
-export const wrapminiscript_toString: (a: number, b: number) => void;
-export const wasmbip32_from_bip32_properties: (a: number, b: number) => void;
-export const __wbg_addressnamespace_free: (a: number, b: number) => void;
-export const __wbg_utxolibcompatnamespace_free: (a: number, b: number) => void;
-export const __wbg_wasmecpair_free: (a: number, b: number) => void;
-export const __wbg_wrappsbt_free: (a: number, b: number) => void;
-export const addressnamespace_from_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const addressnamespace_to_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number) => void;
-export const utxolibcompatnamespace_from_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const utxolibcompatnamespace_to_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wasmecpair_from_private_key: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_public_key: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif_mainnet: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif_testnet: (a: number, b: number, c: number) => void;
-export const wasmecpair_private_key: (a: number) => number;
-export const wasmecpair_public_key: (a: number) => number;
-export const wasmecpair_to_wif: (a: number, b: number) => void;
-export const wasmecpair_to_wif_mainnet: (a: number, b: number) => void;
-export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
-export const wrappsbt_addInput: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number) => void;
-export const wrappsbt_addOutput: (a: number, b: number, c: number, d: bigint) => number;
-export const wrappsbt_clone: (a: number) => number;
-export const wrappsbt_deserialize: (a: number, b: number, c: number) => void;
-export const wrappsbt_extractTransaction: (a: number, b: number) => void;
-export const wrappsbt_finalize: (a: number, b: number) => void;
-export const wrappsbt_getInputs: (a: number, b: number) => void;
-export const wrappsbt_getOutputs: (a: number, b: number) => void;
-export const wrappsbt_getPartialSignatures: (a: number, b: number, c: number) => void;
-export const wrappsbt_getUnsignedTx: (a: number, b: number) => void;
-export const wrappsbt_hasPartialSignatures: (a: number, b: number, c: number) => void;
-export const wrappsbt_inputCount: (a: number) => number;
-export const wrappsbt_lockTime: (a: number) => number;
-export const wrappsbt_new: (a: number, b: number) => number;
-export const wrappsbt_outputCount: (a: number) => number;
-export const wrappsbt_serialize: (a: number, b: number) => void;
-export const wrappsbt_signAll: (a: number, b: number, c: number) => void;
-export const wrappsbt_signAllWithEcpair: (a: number, b: number, c: number) => void;
-export const wrappsbt_signWithPrv: (a: number, b: number, c: number, d: number) => void;
-export const wrappsbt_signWithXprv: (a: number, b: number, c: number, d: number) => void;
-export const wrappsbt_unsignedTxId: (a: number, b: number) => void;
-export const wrappsbt_updateInputWithDescriptor: (a: number, b: number, c: number, d: number) => void;
-export const wrappsbt_updateOutputWithDescriptor: (a: number, b: number, c: number, d: number) => void;
-export const wrappsbt_validateSignatureAtInput: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrappsbt_verifySignatureWithKey: (a: number, b: number, c: number, d: number) => void;
-export const wrappsbt_version: (a: number) => number;
 export const rustsecp256k1_v0_10_0_context_create: (a: number) => number;
 export const rustsecp256k1_v0_10_0_context_destroy: (a: number) => void;
 export const rustsecp256k1_v0_10_0_default_error_callback_fn: (a: number, b: number) => void;

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

@@ -140,6 +140,25 @@ export declare class BIP32 implements BIP32Interface {
      * @returns A new BIP32 instance for the derived key
      */
     derivePath(path: string): BIP32;
+    /**
+     * Check equality with another BIP32 key.
+     * Two keys are equal if they have the same type (public/private) and identical
+     * BIP32 metadata (depth, parent fingerprint, child index, chain code, key data).
+     * This is a fast comparison that does not require serialization.
+     *
+     * @param other - The other key to compare with. Accepts BIP32, or any BIP32Interface.
+     * @returns True if the keys are equal
+     */
+    equals(other: BIP32Interface): boolean;
+    /**
+     * Custom JSON representation for debugging.
+     * Always serializes the public key (xpub) to avoid leaking private keys.
+     * Includes a `hasPrivateKey` flag to indicate whether the key is neutered.
+     */
+    toJSON(): {
+        xpub: string;
+        hasPrivateKey: boolean;
+    };
     /**
      * Get the underlying WASM instance (internal use only)
      * @internal

package/dist/esm/js/bip32.js

@@ -174,6 +174,35 @@ export class BIP32 {
         const wasm = this._wasm.derive_path(path);
         return new BIP32(wasm);
     }
+    /**
+     * Check equality with another BIP32 key.
+     * Two keys are equal if they have the same type (public/private) and identical
+     * BIP32 metadata (depth, parent fingerprint, child index, chain code, key data).
+     * This is a fast comparison that does not require serialization.
+     *
+     * @param other - The other key to compare with. Accepts BIP32, or any BIP32Interface.
+     * @returns True if the keys are equal
+     */
+    equals(other) {
+        const otherWasm = other instanceof BIP32 ? other._wasm : BIP32.from(other)._wasm;
+        return this._wasm.equals(otherWasm);
+    }
+    /**
+     * Custom JSON representation for debugging.
+     * Always serializes the public key (xpub) to avoid leaking private keys.
+     * Includes a `hasPrivateKey` flag to indicate whether the key is neutered.
+     */
+    toJSON() {
+        return { xpub: this.neutered().toBase58(), hasPrivateKey: !this.isNeutered() };
+    }
+    /**
+     * Custom inspect representation for Node.js util.inspect and console.log.
+     * Always shows the public key (xpub) to avoid leaking private keys.
+     */
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        const flag = this.isNeutered() ? "" : ", hasPrivateKey";
+        return `BIP32(${this.neutered().toBase58()}${flag})`;
+    }
     /**
      * Get the underlying WASM instance (internal use only)
      * @internal

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

@@ -2,16 +2,16 @@ export * as address from "./address.js";
 export * as ast from "./ast/index.js";
 export * as bip322 from "./bip322/index.js";
 export * as inscriptions from "./inscriptions.js";
+export * as message from "./message.js";
 export * as utxolibCompat from "./utxolibCompat.js";
 export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
 export * as descriptorWallet from "./descriptorWallet/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";
-export type { CoinName } from "./coinName.js";
+export type { CoinName, getMainnet, isMainnet, isTestnet, isCoinName } from "./coinName.js";
 export type { Triple } from "./triple.js";
 export type { AddressFormat } from "./address.js";
 export type { TapLeafScript, PreparedInscriptionRevealData } from "./inscriptions.js";
@@ -60,6 +60,10 @@ declare module "./wasm/wasm_utxo.js" {
         bip32Derivation: PsbtBip32Derivation[];
         tapBip32Derivation: PsbtBip32Derivation[];
     }
+    /** PSBT output data with resolved address, returned by getOutputsWithAddress() */
+    interface PsbtOutputDataWithAddress extends PsbtOutputData {
+        address: string;
+    }
     interface WrapPsbt {
         signWithXprv(this: WrapPsbt, xprv: string): SignPsbtResult;
         signWithPrv(this: WrapPsbt, prv: Uint8Array): SignPsbtResult;
@@ -69,6 +73,7 @@ declare module "./wasm/wasm_utxo.js" {
         outputCount(): number;
         getInputs(): PsbtInputData[];
         getOutputs(): PsbtOutputData[];
+        getOutputsWithAddress(coin: import("./coinName.js").CoinName): PsbtOutputDataWithAddress[];
         getPartialSignatures(inputIndex: number): Array<{
             pubkey: Uint8Array;
             signature: Uint8Array;

package/dist/esm/js/index.js

@@ -8,12 +8,12 @@ export * as address from "./address.js";
 export * as ast from "./ast/index.js";
 export * as bip322 from "./bip322/index.js";
 export * as inscriptions from "./inscriptions.js";
+export * as message from "./message.js";
 export * as utxolibCompat from "./utxolibCompat.js";
 export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
 export * as descriptorWallet from "./descriptorWallet/index.js";
 export * as bip32 from "./bip32.js";
 export * as ecpair from "./ecpair.js";
-export * as testutils from "./testutils/index.js";
 // Only the most commonly used classes and types are exported at the top level for convenience
 export { ECPair } from "./ecpair.js";
 export { BIP32 } from "./bip32.js";

package/dist/esm/js/message.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Bitcoin message signing and verification (BIP-137)
+ *
+ * This module provides functions for signing and verifying Bitcoin messages
+ * using the standard Bitcoin Signed Message format (BIP-137).
+ *
+ * @example
+ * ```typescript
+ * import { message, ECPair } from '@bitgo/wasm-utxo';
+ *
+ * // Sign a message
+ * const key = ECPair.fromWIF('L1TnU2zbNaAqMoVh65Cyvmcjzbrj41Gs9iTLcWbpJCpV1iNMXpuR');
+ * const signature = message.signMessage('Hello, Bitcoin!', key);
+ *
+ * // Verify a message
+ * const isValid = message.verifyMessage('Hello, Bitcoin!', key, signature);
+ * ```
+ */
+import { type ECPairArg } from "./ecpair.js";
+/**
+ * Sign a message using Bitcoin message signing (BIP-137)
+ *
+ * @param message - The message to sign
+ * @param key - The key to sign with (must have a private key)
+ * @returns 65-byte signature (1-byte header + 64-byte signature)
+ */
+export declare function signMessage(message: string, key: ECPairArg): Uint8Array;
+/**
+ * Verify a Bitcoin message signature (BIP-137)
+ *
+ * @param message - The message that was signed
+ * @param key - The key to verify against
+ * @param signature - 65-byte signature (1-byte header + 64-byte signature)
+ * @returns True if the signature is valid for this key
+ */
+export declare function verifyMessage(message: string, key: ECPairArg, signature: Uint8Array): boolean;

package/dist/esm/js/message.js

@@ -0,0 +1,43 @@
+/**
+ * Bitcoin message signing and verification (BIP-137)
+ *
+ * This module provides functions for signing and verifying Bitcoin messages
+ * using the standard Bitcoin Signed Message format (BIP-137).
+ *
+ * @example
+ * ```typescript
+ * import { message, ECPair } from '@bitgo/wasm-utxo';
+ *
+ * // Sign a message
+ * const key = ECPair.fromWIF('L1TnU2zbNaAqMoVh65Cyvmcjzbrj41Gs9iTLcWbpJCpV1iNMXpuR');
+ * const signature = message.signMessage('Hello, Bitcoin!', key);
+ *
+ * // Verify a message
+ * const isValid = message.verifyMessage('Hello, Bitcoin!', key, signature);
+ * ```
+ */
+import { MessageNamespace } from "./wasm/wasm_utxo.js";
+import { ECPair } from "./ecpair.js";
+/**
+ * Sign a message using Bitcoin message signing (BIP-137)
+ *
+ * @param message - The message to sign
+ * @param key - The key to sign with (must have a private key)
+ * @returns 65-byte signature (1-byte header + 64-byte signature)
+ */
+export function signMessage(message, key) {
+    const ecpair = ECPair.from(key);
+    return new Uint8Array(MessageNamespace.sign_message(ecpair.wasm, message));
+}
+/**
+ * Verify a Bitcoin message signature (BIP-137)
+ *
+ * @param message - The message that was signed
+ * @param key - The key to verify against
+ * @param signature - 65-byte signature (1-byte header + 64-byte signature)
+ * @returns True if the signature is valid for this key
+ */
+export function verifyMessage(message, key, signature) {
+    const ecpair = ECPair.from(key);
+    return MessageNamespace.verify_message(ecpair.wasm, message, signature);
+}

package/dist/esm/js/testutils/descriptor/descriptors.d.ts

@@ -0,0 +1,27 @@
+import type { BIP32Interface } from "../../bip32.js";
+import { Descriptor, Miniscript, ast } from "../../index.js";
+import type { Triple } from "../../triple.js";
+import { DescriptorMap, PsbtParams } from "../../descriptorWallet/index.js";
+type KeyTriple = Triple<BIP32Interface>;
+export type DescriptorTemplate = "Wsh2Of3" | "Tr1Of3-NoKeyPath-Tree" | "Tr1Of3-NoKeyPath-Tree-Plain" | "Tr2Of3-NoKeyPath" | "Wsh2Of2"
+/**
+ * Wrapped segwit 2of3 multisig with a relative locktime OP_DROP
+ * (requiring a miniscript extension). Used in CoreDao staking transactions.
+ */
+ | "Wsh2Of3CltvDrop";
+/**
+ * Get the BIP-341 "Nothing Up My Sleeve" (NUMS) unspendable key.
+ * This is the x-only public key with unknown discrete logarithm
+ * constructed by hashing the uncompressed secp256k1 base point G.
+ *
+ * @see https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki#constructing-and-spending-taproot-outputs
+ */
+export declare function getUnspendableKey(): string;
+export declare function getDefaultXPubs(seed?: string): Triple<string>;
+export declare function getPsbtParams(t: DescriptorTemplate): Partial<PsbtParams>;
+export declare function getDescriptorNode(template: DescriptorTemplate, keys?: KeyTriple | string[], path?: string): ast.DescriptorNode;
+export declare function containsKey(script: Miniscript | ast.MiniscriptNode, key: BIP32Interface | string): boolean;
+export declare function getTapLeafScripts(d: Descriptor): string[];
+export declare function getDescriptor(template: DescriptorTemplate, keys?: KeyTriple | string[], path?: string): Descriptor;
+export declare function getDescriptorMap(template: DescriptorTemplate, keys?: KeyTriple | string[]): DescriptorMap;
+export {};

package/dist/esm/js/testutils/descriptor/descriptors.js

@@ -0,0 +1,150 @@
+/**
+ * Descriptor test utilities for building common descriptor templates.
+ * Ported from @bitgo/utxo-core/testutil/descriptor/descriptors.ts.
+ */
+import assert from "assert";
+import { BIP32 } from "../../bip32.js";
+import { Descriptor, Miniscript, ast } from "../../index.js";
+import { getKeyTriple } from "../keys.js";
+/**
+ * Get the BIP-341 "Nothing Up My Sleeve" (NUMS) unspendable key.
+ * This is the x-only public key with unknown discrete logarithm
+ * constructed by hashing the uncompressed secp256k1 base point G.
+ *
+ * @see https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki#constructing-and-spending-taproot-outputs
+ */
+export function getUnspendableKey() {
+    return "50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0";
+}
+export function getDefaultXPubs(seed) {
+    return getKeyTriple(seed ?? "default").map((k) => k.neutered().toBase58());
+}
+function toDescriptorMap(v) {
+    return new Map(Object.entries(v).map(([k, v]) => [k, Descriptor.fromString(v, "derivable")]));
+}
+function toXPub(k, path) {
+    if (typeof k === "string") {
+        return k + "/" + path;
+    }
+    return k.neutered().toBase58() + "/" + path;
+}
+function toPlain(k, { xonly = false } = {}) {
+    if (typeof k === "string") {
+        if (k.startsWith("xpub") || k.startsWith("xprv")) {
+            return toPlain(BIP32.fromBase58(k), { xonly });
+        }
+        return k;
+    }
+    return toHex(k.publicKey.subarray(xonly ? 1 : 0));
+}
+function toHex(bytes) {
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function toXOnly(k) {
+    return toPlain(k, { xonly: true });
+}
+function multiArgs(m, n, keys, path) {
+    if (n < m) {
+        throw new Error(`Cannot create ${m} of ${n} multisig`);
+    }
+    if (keys.length < n) {
+        throw new Error(`Not enough keys for ${m} of ${n} multisig: keys.length=${keys.length}`);
+    }
+    keys = keys.slice(0, n);
+    return [m, ...keys.map((k) => toXPub(k, path))];
+}
+export function getPsbtParams(t) {
+    switch (t) {
+        case "Wsh2Of3CltvDrop":
+            return { locktime: 1 };
+        default:
+            return {};
+    }
+}
+export function getDescriptorNode(template, keys = getDefaultXPubs(), path = "0/*") {
+    switch (template) {
+        case "Wsh2Of3":
+            return {
+                wsh: { multi: multiArgs(2, 3, keys, path) },
+            };
+        case "Wsh2Of3CltvDrop": {
+            const { locktime } = getPsbtParams(template);
+            assert(locktime);
+            return {
+                wsh: {
+                    and_v: [{ "r:after": locktime }, { multi: multiArgs(2, 3, keys, path) }],
+                },
+            };
+        }
+        case "Wsh2Of2":
+            return {
+                wsh: { multi: multiArgs(2, 2, keys, path) },
+            };
+        case "Tr2Of3-NoKeyPath":
+            return {
+                tr: [getUnspendableKey(), { multi_a: multiArgs(2, 3, keys, path) }],
+            };
+        case "Tr1Of3-NoKeyPath-Tree":
+            return {
+                tr: [
+                    getUnspendableKey(),
+                    [
+                        { pk: toXPub(keys[0], path) },
+                        [{ pk: toXPub(keys[1], path) }, { pk: toXPub(keys[2], path) }],
+                    ],
+                ],
+            };
+        case "Tr1Of3-NoKeyPath-Tree-Plain":
+            return {
+                tr: [
+                    getUnspendableKey(),
+                    [{ pk: toXOnly(keys[0]) }, [{ pk: toXOnly(keys[1]) }, { pk: toXOnly(keys[2]) }]],
+                ],
+            };
+    }
+    throw new Error(`Unknown descriptor template: ${template}`);
+}
+function getTapLeafScriptNodes(t) {
+    if (Array.isArray(t)) {
+        if (t.length !== 2) {
+            throw new Error(`expected tuple, got: ${JSON.stringify(t)}`);
+        }
+        return t.map((v) => (Array.isArray(v) ? getTapLeafScriptNodes(v) : v)).flat();
+    }
+    if (typeof t === "object") {
+        const node = t;
+        if (!("tr" in node)) {
+            throw new Error(`TapLeafScripts are only supported for Taproot descriptors, got: ${JSON.stringify(t)}`);
+        }
+        if (!Array.isArray(node.tr) || node.tr.length !== 2) {
+            throw new Error(`expected tuple, got: ${JSON.stringify(node.tr)}`);
+        }
+        const tapscript = node.tr[1];
+        if (!Array.isArray(tapscript)) {
+            throw new Error(`expected tapscript to be an array, got: ${JSON.stringify(tapscript)}`);
+        }
+        return getTapLeafScriptNodes(tapscript);
+    }
+    throw new Error(`Invalid input: ${JSON.stringify(t)}`);
+}
+export function containsKey(script, key) {
+    if (script instanceof Miniscript) {
+        script = ast.fromMiniscript(script);
+    }
+    if ("pk" in script) {
+        return script.pk === toXOnly(key);
+    }
+    throw new Error(`Unsupported script type: ${JSON.stringify(script)}`);
+}
+export function getTapLeafScripts(d) {
+    return getTapLeafScriptNodes(ast.fromDescriptor(d)).map((n) => Miniscript.fromString(ast.formatNode(n), "tap").toString());
+}
+export function getDescriptor(template, keys = getDefaultXPubs(), path = "0/*") {
+    return Descriptor.fromStringDetectType(ast.formatNode(getDescriptorNode(template, keys, path)));
+}
+export function getDescriptorMap(template, keys = getDefaultXPubs()) {
+    return toDescriptorMap({
+        external: getDescriptor(template, keys, "0/*").toString(),
+        internal: getDescriptor(template, keys, "1/*").toString(),
+    });
+}

package/dist/esm/js/testutils/descriptor/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./descriptors.js";
+export * from "./mockPsbt.js";

package/dist/esm/js/testutils/descriptor/index.js

@@ -0,0 +1,2 @@
+export * from "./descriptors.js";
+export * from "./mockPsbt.js";

package/dist/esm/js/testutils/descriptor/mockPsbt.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Mock PSBT utilities for descriptor wallet testing.
+ * Ported from @bitgo/utxo-core/testutil/descriptor/mock.utils.ts.
+ *
+ * Key difference from utxo-core: returns wasm-utxo Psbt instances directly
+ * instead of utxolib.bitgo.UtxoPsbt. PsbtParams does not require a network field.
+ */
+import { Descriptor, Miniscript, Psbt } from "../../index.js";
+import { PsbtParams, DerivedDescriptorTransactionInput } from "../../descriptorWallet/index.js";
+import { DescriptorTemplate } from "./descriptors.js";
+type MockOutputIdParams = {
+    hash?: string;
+    vout?: number;
+};
+type BaseMockDescriptorOutputParams = {
+    id?: MockOutputIdParams;
+    index?: number;
+    value?: bigint;
+    sequence?: number;
+    selectTapLeafScript?: Miniscript;
+};
+export declare function mockDerivedDescriptorWalletOutput(descriptor: Descriptor, outputParams?: BaseMockDescriptorOutputParams): DerivedDescriptorTransactionInput;
+type MockInput = BaseMockDescriptorOutputParams & {
+    index: number;
+    descriptor: Descriptor;
+    selectTapLeafScript?: Miniscript;
+};
+type MockOutput = {
+    descriptor: Descriptor;
+    index: number;
+    value: bigint;
+    external?: boolean;
+};
+export declare function mockPsbt(inputs: MockInput[], outputs: MockOutput[], params?: Partial<PsbtParams>): Psbt;
+export declare function mockPsbtDefault({ descriptorSelf, descriptorOther, params, }?: {
+    descriptorSelf?: Descriptor;
+    descriptorOther?: Descriptor;
+    params?: Partial<PsbtParams>;
+}): Psbt;
+export declare function mockPsbtDefaultWithDescriptorTemplate(t: DescriptorTemplate, params?: Partial<PsbtParams>): Psbt;
+export {};