@bitgo/wasm-utxo 1.6.0 → 1.8.0

package/dist/esm/js/fixedScriptWallet/BitGoPsbt.js

@@ -0,0 +1,270 @@
+import { BitGoPsbt as WasmBitGoPsbt } from "../wasm/wasm_utxo.js";
+import { RootWalletKeys } from "./RootWalletKeys.js";
+import { ReplayProtection } from "./ReplayProtection.js";
+import { BIP32 } from "../bip32.js";
+import { ECPair } from "../ecpair.js";
+export class BitGoPsbt {
+    wasm;
+    constructor(wasm) {
+        this.wasm = wasm;
+    }
+    /**
+     * Deserialize a PSBT from bytes
+     * @param bytes - The PSBT bytes
+     * @param network - The network to use for deserialization (either utxolib name like "bitcoin" or coin name like "btc")
+     * @returns A BitGoPsbt instance
+     */
+    static fromBytes(bytes, network) {
+        const wasm = WasmBitGoPsbt.from_bytes(bytes, network);
+        return new BitGoPsbt(wasm);
+    }
+    /**
+     * Get the unsigned transaction ID
+     * @returns The unsigned transaction ID
+     */
+    unsignedTxid() {
+        return this.wasm.unsigned_txid();
+    }
+    /**
+     * Parse transaction with wallet keys to identify wallet inputs/outputs
+     * @param walletKeys - The wallet keys to use for identification
+     * @param replayProtection - Scripts that are allowed as inputs without wallet validation
+     * @returns Parsed transaction information
+     */
+    parseTransactionWithWalletKeys(walletKeys, replayProtection) {
+        const keys = RootWalletKeys.from(walletKeys);
+        const rp = ReplayProtection.from(replayProtection, this.wasm.network());
+        return this.wasm.parse_transaction_with_wallet_keys(keys.wasm, rp.wasm);
+    }
+    /**
+     * Parse outputs with wallet keys to identify which outputs belong to a wallet
+     * with the given wallet keys.
+     *
+     * This is useful in cases where we want to identify outputs that belong to a different
+     * wallet than the inputs.
+     *
+     * @param walletKeys - The wallet keys to use for identification
+     * @returns Array of parsed outputs
+     * @note This method does NOT validate wallet inputs. It only parses outputs.
+     */
+    parseOutputsWithWalletKeys(walletKeys) {
+        const keys = RootWalletKeys.from(walletKeys);
+        return this.wasm.parse_outputs_with_wallet_keys(keys.wasm);
+    }
+    /**
+     * Verify if a valid signature exists for a given key at the specified input index.
+     *
+     * This method can verify signatures using either:
+     * - Extended public key (xpub): Derives the public key using the derivation path from PSBT
+     * - ECPair (private key): Extracts the public key and verifies directly
+     *
+     * When using xpub, it supports:
+     * - ECDSA signatures (for legacy/SegWit inputs)
+     * - Schnorr signatures (for Taproot script path inputs)
+     * - MuSig2 partial signatures (for Taproot keypath MuSig2 inputs)
+     *
+     * When using ECPair, it supports:
+     * - ECDSA signatures (for legacy/SegWit inputs)
+     * - Schnorr signatures (for Taproot script path inputs)
+     * Note: MuSig2 inputs require xpubs for derivation
+     *
+     * @param inputIndex - The index of the input to check (0-based)
+     * @param key - Either an extended public key (base58 string, BIP32 instance, or WasmBIP32) or an ECPair (private key Buffer, ECPair instance, or WasmECPair)
+     * @returns true if a valid signature exists, false if no signature exists
+     * @throws Error if input index is out of bounds, key is invalid, or verification fails
+     *
+     * @example
+     * ```typescript
+     * // Verify wallet input signature with xpub
+     * const hasUserSig = psbt.verifySignature(0, userXpub);
+     *
+     * // Verify signature with ECPair (private key)
+     * const ecpair = ECPair.fromPrivateKey(privateKeyBuffer);
+     * const hasReplaySig = psbt.verifySignature(1, ecpair);
+     *
+     * // Or pass private key directly
+     * const hasReplaySig2 = psbt.verifySignature(1, privateKeyBuffer);
+     * ```
+     */
+    verifySignature(inputIndex, key) {
+        // Try to parse as BIP32Arg first (string or BIP32 instance)
+        if (typeof key === "string" || ("derive" in key && typeof key.derive === "function")) {
+            const wasmKey = BIP32.from(key).wasm;
+            return this.wasm.verify_signature_with_xpub(inputIndex, wasmKey);
+        }
+        // Otherwise it's an ECPairArg (Uint8Array, ECPair, or WasmECPair)
+        const wasmECPair = ECPair.from(key).wasm;
+        return this.wasm.verify_signature_with_pub(inputIndex, wasmECPair);
+    }
+    /**
+     * Sign a single input with a private key
+     *
+     * This method signs a specific input using the provided key. It accepts either:
+     * - An xpriv (BIP32Arg: base58 string, BIP32 instance, or WasmBIP32) for wallet inputs - derives the key and signs
+     * - A raw privkey (ECPairArg: Buffer, ECPair instance, or WasmECPair) for replay protection inputs - signs directly
+     *
+     * This method automatically detects and handles different input types:
+     * - For regular inputs: uses standard PSBT signing
+     * - For MuSig2 inputs: uses the FirstRound state stored by generateMusig2Nonces()
+     * - For replay protection inputs: signs with legacy P2SH sighash
+     *
+     * @param inputIndex - The index of the input to sign (0-based)
+     * @param key - Either an xpriv (BIP32Arg) or a raw privkey (ECPairArg)
+     * @throws Error if signing fails, or if generateMusig2Nonces() was not called first for MuSig2 inputs
+     *
+     * @example
+     * ```typescript
+     * // Parse transaction to identify input types
+     * const parsed = psbt.parseTransactionWithWalletKeys(walletKeys, replayProtection);
+     *
+     * // Sign regular wallet inputs with xpriv
+     * for (let i = 0; i < parsed.inputs.length; i++) {
+     *   const input = parsed.inputs[i];
+     *   if (input.scriptId !== null && input.scriptType !== "p2shP2pk") {
+     *     psbt.sign(i, userXpriv);
+     *   }
+     * }
+     *
+     * // Sign replay protection inputs with raw privkey
+     * const userPrivkey = bip32.fromBase58(userXpriv).privateKey!;
+     * for (let i = 0; i < parsed.inputs.length; i++) {
+     *   const input = parsed.inputs[i];
+     *   if (input.scriptType === "p2shP2pk") {
+     *     psbt.sign(i, userPrivkey);
+     *   }
+     * }
+     * ```
+     */
+    sign(inputIndex, key) {
+        // Detect key type
+        // If string or has 'derive' method → BIP32Arg
+        // Otherwise → ECPairArg
+        if (typeof key === "string" ||
+            (typeof key === "object" &&
+                key !== null &&
+                "derive" in key &&
+                typeof key.derive === "function")) {
+            // It's a BIP32Arg
+            const wasmKey = BIP32.from(key);
+            this.wasm.sign_with_xpriv(inputIndex, wasmKey.wasm);
+        }
+        else {
+            // It's an ECPairArg
+            const wasmKey = ECPair.from(key);
+            this.wasm.sign_with_privkey(inputIndex, wasmKey.wasm);
+        }
+    }
+    /**
+     * @deprecated - use verifySignature with the replay protection key instead
+     *
+     * Verify if a replay protection input has a valid signature.
+     *
+     * This method checks if a given input is a replay protection input (like P2shP2pk) and verifies
+     * the signature. Replay protection inputs don't use standard derivation paths, so this method
+     * verifies signatures without deriving from xpub.
+     *
+     * For P2PK replay protection inputs, this:
+     * - Extracts the signature from final_script_sig
+     * - Extracts the public key from redeem_script
+     * - Computes the legacy P2SH sighash
+     * - Verifies the ECDSA signature cryptographically
+     *
+     * @param inputIndex - The index of the input to check (0-based)
+     * @param replayProtection - Scripts that identify replay protection inputs (same format as parseTransactionWithWalletKeys)
+     * @returns true if the input is a replay protection input and has a valid signature, false if no valid signature
+     * @throws Error if the input is not a replay protection input, index is out of bounds, or scripts are invalid
+     */
+    verifyReplayProtectionSignature(inputIndex, replayProtection) {
+        const rp = ReplayProtection.from(replayProtection, this.wasm.network());
+        return this.wasm.verify_replay_protection_signature(inputIndex, rp.wasm);
+    }
+    /**
+     * Serialize the PSBT to bytes
+     *
+     * @returns The serialized PSBT as a byte array
+     */
+    serialize() {
+        return this.wasm.serialize();
+    }
+    /**
+     * Generate and store MuSig2 nonces for all MuSig2 inputs
+     *
+     * This method generates nonces using the State-Machine API and stores them in the PSBT.
+     * The nonces are stored as proprietary fields in the PSBT and will be included when serialized.
+     * After ALL participants have generated their nonces, you can sign MuSig2 inputs using
+     * sign().
+     *
+     * @param key - The extended private key (xpriv) for signing. Can be a base58 string, BIP32 instance, or WasmBIP32
+     * @param sessionId - Optional 32-byte session ID for nonce generation. **Only allowed on testnets**.
+     *                    On mainnets, a secure random session ID is always generated automatically.
+     *                    Must be unique per signing session.
+     * @throws Error if nonce generation fails, sessionId length is invalid, or custom sessionId is
+     *         provided on a mainnet (security restriction)
+     *
+     * @security The sessionId MUST be cryptographically random and unique for each signing session.
+     * Never reuse a sessionId with the same key! On mainnets, sessionId is always randomly
+     * generated for security. Custom sessionId is only allowed on testnets for testing purposes.
+     *
+     * @example
+     * ```typescript
+     * // Phase 1: Both parties generate nonces (with auto-generated session ID)
+     * psbt.generateMusig2Nonces(userXpriv);
+     * // Nonces are stored in the PSBT
+     * // Send PSBT to counterparty
+     *
+     * // Phase 2: After receiving counterparty PSBT with their nonces
+     * const counterpartyPsbt = BitGoPsbt.fromBytes(counterpartyPsbtBytes, network);
+     * psbt.combineMusig2Nonces(counterpartyPsbt);
+     * // Sign MuSig2 key path inputs
+     * const parsed = psbt.parseTransactionWithWalletKeys(walletKeys, replayProtection);
+     * for (let i = 0; i < parsed.inputs.length; i++) {
+     *   if (parsed.inputs[i].scriptType === "p2trMusig2KeyPath") {
+     *     psbt.sign(i, userXpriv);
+     *   }
+     * }
+     * ```
+     */
+    generateMusig2Nonces(key, sessionId) {
+        const wasmKey = BIP32.from(key);
+        this.wasm.generate_musig2_nonces(wasmKey.wasm, sessionId);
+    }
+    /**
+     * Combine/merge data from another PSBT into this one
+     *
+     * This method copies MuSig2 nonces and signatures (proprietary key-value pairs) from the
+     * source PSBT to this PSBT. This is useful for merging PSBTs during the nonce exchange
+     * and signature collection phases.
+     *
+     * @param sourcePsbt - The source PSBT containing data to merge
+     * @throws Error if networks don't match
+     *
+     * @example
+     * ```typescript
+     * // After receiving counterparty's PSBT with their nonces
+     * const counterpartyPsbt = BitGoPsbt.fromBytes(counterpartyPsbtBytes, network);
+     * psbt.combineMusig2Nonces(counterpartyPsbt);
+     * // Now can sign with all nonces present
+     * psbt.sign(0, userXpriv);
+     * ```
+     */
+    combineMusig2Nonces(sourcePsbt) {
+        this.wasm.combine_musig2_nonces(sourcePsbt.wasm);
+    }
+    /**
+     * Finalize all inputs in the PSBT
+     *
+     * @throws Error if any input failed to finalize
+     */
+    finalizeAllInputs() {
+        this.wasm.finalize_all_inputs();
+    }
+    /**
+     * Extract the final transaction from a finalized PSBT
+     *
+     * @returns The serialized transaction bytes
+     * @throws Error if the PSBT is not fully finalized or extraction fails
+     */
+    extractTransaction() {
+        return this.wasm.extract_transaction();
+    }
+}

package/dist/esm/js/fixedScriptWallet/ReplayProtection.d.ts

@@ -0,0 +1,58 @@
+import { WasmReplayProtection } from "../wasm/wasm_utxo.js";
+import { type ECPairArg } from "../ecpair.js";
+/**
+ * ReplayProtectionArg represents the various forms that replay protection can take
+ * before being converted to a WasmReplayProtection instance
+ */
+export type ReplayProtectionArg = ReplayProtection | WasmReplayProtection | {
+    publicKeys: ECPairArg[];
+} | {
+    /** @deprecated - use publicKeys instead */
+    outputScripts: Uint8Array[];
+} | {
+    /** @deprecated - use publicKeys instead */
+    addresses: string[];
+};
+/**
+ * ReplayProtection wrapper class for PSBT replay protection inputs
+ */
+export declare class ReplayProtection {
+    private _wasm;
+    private constructor();
+    /**
+     * Create a ReplayProtection instance from a WasmReplayProtection instance (internal use)
+     * @internal
+     */
+    static fromWasm(wasm: WasmReplayProtection): ReplayProtection;
+    /**
+     * Convert ReplayProtectionArg to ReplayProtection instance
+     * @param arg - The replay protection in various formats
+     * @param network - Optional network string (required for addresses variant)
+     * @returns ReplayProtection instance
+     */
+    static from(arg: ReplayProtectionArg, network?: string): ReplayProtection;
+    /**
+     * Create from public keys (derives P2SH-P2PK output scripts)
+     * @param publicKeys - Array of ECPair instances or arguments
+     * @returns ReplayProtection instance
+     */
+    static fromPublicKeys(publicKeys: ECPairArg[]): ReplayProtection;
+    /**
+     * Create from output scripts
+     * @param outputScripts - Array of output script buffers
+     * @returns ReplayProtection instance
+     */
+    static fromOutputScripts(outputScripts: Uint8Array[]): ReplayProtection;
+    /**
+     * Create from addresses
+     * @param addresses - Array of address strings
+     * @param network - Network string (e.g., "bitcoin", "testnet", "btc", "tbtc")
+     * @returns ReplayProtection instance
+     */
+    static fromAddresses(addresses: string[], network: string): ReplayProtection;
+    /**
+     * Get the underlying WASM instance (internal use only)
+     * @internal
+     */
+    get wasm(): WasmReplayProtection;
+}

package/dist/esm/js/fixedScriptWallet/ReplayProtection.js

@@ -0,0 +1,85 @@
+import { WasmReplayProtection } from "../wasm/wasm_utxo.js";
+import { ECPair } from "../ecpair.js";
+/**
+ * ReplayProtection wrapper class for PSBT replay protection inputs
+ */
+export class ReplayProtection {
+    _wasm;
+    constructor(_wasm) {
+        this._wasm = _wasm;
+    }
+    /**
+     * Create a ReplayProtection instance from a WasmReplayProtection instance (internal use)
+     * @internal
+     */
+    static fromWasm(wasm) {
+        return new ReplayProtection(wasm);
+    }
+    /**
+     * Convert ReplayProtectionArg to ReplayProtection instance
+     * @param arg - The replay protection in various formats
+     * @param network - Optional network string (required for addresses variant)
+     * @returns ReplayProtection instance
+     */
+    static from(arg, network) {
+        // Short-circuit if already a ReplayProtection instance
+        if (arg instanceof ReplayProtection) {
+            return arg;
+        }
+        // If it's a WasmReplayProtection instance, wrap it
+        if (arg instanceof WasmReplayProtection) {
+            return new ReplayProtection(arg);
+        }
+        // Handle object variants
+        if ("publicKeys" in arg) {
+            // Convert ECPairArg to public key bytes
+            const publicKeyBytes = arg.publicKeys.map((key) => ECPair.from(key).publicKey);
+            const wasm = WasmReplayProtection.from_public_keys(publicKeyBytes);
+            return new ReplayProtection(wasm);
+        }
+        if ("outputScripts" in arg) {
+            const wasm = WasmReplayProtection.from_output_scripts(arg.outputScripts);
+            return new ReplayProtection(wasm);
+        }
+        if ("addresses" in arg) {
+            if (!network) {
+                throw new Error("Network is required when using addresses variant");
+            }
+            const wasm = WasmReplayProtection.from_addresses(arg.addresses, network);
+            return new ReplayProtection(wasm);
+        }
+        throw new Error("Invalid ReplayProtectionArg type");
+    }
+    /**
+     * Create from public keys (derives P2SH-P2PK output scripts)
+     * @param publicKeys - Array of ECPair instances or arguments
+     * @returns ReplayProtection instance
+     */
+    static fromPublicKeys(publicKeys) {
+        return ReplayProtection.from({ publicKeys });
+    }
+    /**
+     * Create from output scripts
+     * @param outputScripts - Array of output script buffers
+     * @returns ReplayProtection instance
+     */
+    static fromOutputScripts(outputScripts) {
+        return ReplayProtection.from({ outputScripts });
+    }
+    /**
+     * Create from addresses
+     * @param addresses - Array of address strings
+     * @param network - Network string (e.g., "bitcoin", "testnet", "btc", "tbtc")
+     * @returns ReplayProtection instance
+     */
+    static fromAddresses(addresses, network) {
+        return ReplayProtection.from({ addresses }, network);
+    }
+    /**
+     * Get the underlying WASM instance (internal use only)
+     * @internal
+     */
+    get wasm() {
+        return this._wasm;
+    }
+}

package/dist/esm/js/fixedScriptWallet/RootWalletKeys.d.ts

@@ -0,0 +1,66 @@
+import type { BIP32Interface } from "../bip32.js";
+import { BIP32 } from "../bip32.js";
+import { Triple } from "../triple.js";
+import { WasmRootWalletKeys } from "../wasm/wasm_utxo.js";
+/**
+ * IWalletKeys represents the various forms that wallet keys can take
+ * before being converted to a RootWalletKeys instance
+ */
+export type IWalletKeys = {
+    triple: Triple<BIP32Interface>;
+    derivationPrefixes: Triple<string>;
+};
+export type WalletKeysArg = 
+/** Just an xpub triple, will assume default derivation prefixes  */
+Triple<string>
+/** Compatible with utxolib RootWalletKeys */
+ | IWalletKeys
+/** RootWalletKeys instance */
+ | RootWalletKeys;
+/**
+ * RootWalletKeys represents a set of three extended public keys with their derivation prefixes
+ */
+export declare class RootWalletKeys {
+    private _wasm;
+    private constructor();
+    /**
+     * Create a RootWalletKeys from various input formats
+     * @param keys - Can be a triple of xpub strings, an IWalletKeys object, or another RootWalletKeys instance
+     * @returns A RootWalletKeys instance
+     */
+    static from(keys: WalletKeysArg): RootWalletKeys;
+    /**
+     * Create a RootWalletKeys from three xpub strings
+     * Uses default derivation prefix of m/0/0 for all three keys
+     * @param xpubs - Triple of xpub strings
+     * @returns A RootWalletKeys instance
+     */
+    static fromXpubs(xpubs: Triple<string>): RootWalletKeys;
+    /**
+     * Create a RootWalletKeys from three xpub strings with custom derivation prefixes
+     * @param xpubs - Triple of xpub strings
+     * @param derivationPrefixes - Triple of derivation path strings (e.g., ["0/0", "0/0", "0/0"])
+     * @returns A RootWalletKeys instance
+     */
+    static withDerivationPrefixes(xpubs: Triple<string>, derivationPrefixes: Triple<string>): RootWalletKeys;
+    /**
+     * Get the user key (first xpub)
+     * @returns The user key as a BIP32 instance
+     */
+    userKey(): BIP32;
+    /**
+     * Get the backup key (second xpub)
+     * @returns The backup key as a BIP32 instance
+     */
+    backupKey(): BIP32;
+    /**
+     * Get the BitGo key (third xpub)
+     * @returns The BitGo key as a BIP32 instance
+     */
+    bitgoKey(): BIP32;
+    /**
+     * Get the underlying WASM instance (internal use only)
+     * @internal
+     */
+    get wasm(): WasmRootWalletKeys;
+}

package/dist/esm/js/fixedScriptWallet/RootWalletKeys.js

@@ -0,0 +1,104 @@
+import { BIP32 } from "../bip32.js";
+import { WasmRootWalletKeys, WasmBIP32 } from "../wasm/wasm_utxo.js";
+/**
+ * Convert WalletKeysArg to a triple of BIP32 instances
+ */
+function toBIP32Triple(keys) {
+    if (keys instanceof RootWalletKeys) {
+        return [keys.userKey(), keys.backupKey(), keys.bitgoKey()];
+    }
+    // Check if it's an IWalletKeys object
+    if (typeof keys === "object" && "triple" in keys) {
+        // Extract BIP32 keys from the triple
+        return keys.triple.map((key) => BIP32.from(key));
+    }
+    // Otherwise it's a triple of strings (xpubs)
+    return keys.map((xpub) => BIP32.fromWasm(WasmBIP32.from_xpub(xpub)));
+}
+/**
+ * Extract derivation prefixes from WalletKeysArg, if present
+ */
+function extractDerivationPrefixes(keys) {
+    if (typeof keys === "object" && "derivationPrefixes" in keys) {
+        return keys.derivationPrefixes;
+    }
+    return null;
+}
+/**
+ * RootWalletKeys represents a set of three extended public keys with their derivation prefixes
+ */
+export class RootWalletKeys {
+    _wasm;
+    constructor(_wasm) {
+        this._wasm = _wasm;
+    }
+    /**
+     * Create a RootWalletKeys from various input formats
+     * @param keys - Can be a triple of xpub strings, an IWalletKeys object, or another RootWalletKeys instance
+     * @returns A RootWalletKeys instance
+     */
+    static from(keys) {
+        if (keys instanceof RootWalletKeys) {
+            return keys;
+        }
+        const [user, backup, bitgo] = toBIP32Triple(keys);
+        const derivationPrefixes = extractDerivationPrefixes(keys);
+        const wasm = derivationPrefixes
+            ? WasmRootWalletKeys.with_derivation_prefixes(user.wasm, backup.wasm, bitgo.wasm, derivationPrefixes[0], derivationPrefixes[1], derivationPrefixes[2])
+            : new WasmRootWalletKeys(user.wasm, backup.wasm, bitgo.wasm);
+        return new RootWalletKeys(wasm);
+    }
+    /**
+     * Create a RootWalletKeys from three xpub strings
+     * Uses default derivation prefix of m/0/0 for all three keys
+     * @param xpubs - Triple of xpub strings
+     * @returns A RootWalletKeys instance
+     */
+    static fromXpubs(xpubs) {
+        const [user, backup, bitgo] = xpubs.map((xpub) => WasmBIP32.from_xpub(xpub));
+        const wasm = new WasmRootWalletKeys(user, backup, bitgo);
+        return new RootWalletKeys(wasm);
+    }
+    /**
+     * Create a RootWalletKeys from three xpub strings with custom derivation prefixes
+     * @param xpubs - Triple of xpub strings
+     * @param derivationPrefixes - Triple of derivation path strings (e.g., ["0/0", "0/0", "0/0"])
+     * @returns A RootWalletKeys instance
+     */
+    static withDerivationPrefixes(xpubs, derivationPrefixes) {
+        const [user, backup, bitgo] = xpubs.map((xpub) => WasmBIP32.from_xpub(xpub));
+        const wasm = WasmRootWalletKeys.with_derivation_prefixes(user, backup, bitgo, derivationPrefixes[0], derivationPrefixes[1], derivationPrefixes[2]);
+        return new RootWalletKeys(wasm);
+    }
+    /**
+     * Get the user key (first xpub)
+     * @returns The user key as a BIP32 instance
+     */
+    userKey() {
+        const wasm = this._wasm.user_key();
+        return BIP32.fromWasm(wasm);
+    }
+    /**
+     * Get the backup key (second xpub)
+     * @returns The backup key as a BIP32 instance
+     */
+    backupKey() {
+        const wasm = this._wasm.backup_key();
+        return BIP32.fromWasm(wasm);
+    }
+    /**
+     * Get the BitGo key (third xpub)
+     * @returns The BitGo key as a BIP32 instance
+     */
+    bitgoKey() {
+        const wasm = this._wasm.bitgo_key();
+        return BIP32.fromWasm(wasm);
+    }
+    /**
+     * Get the underlying WASM instance (internal use only)
+     * @internal
+     */
+    get wasm() {
+        return this._wasm;
+    }
+}

package/dist/esm/js/fixedScriptWallet/address.d.ts

@@ -0,0 +1,20 @@
+import { type WalletKeysArg } from "./RootWalletKeys.js";
+import type { UtxolibNetwork } from "../utxolibCompat.js";
+import { AddressFormat } from "../address.js";
+/**
+ * Create the output script for a given wallet keys and chain and index
+ */
+export declare function outputScript(keys: WalletKeysArg, chain: number, index: number, network: UtxolibNetwork): Uint8Array;
+/**
+ * Create the address for a given wallet keys and chain and index and network.
+ * Wrapper for outputScript that also encodes the script to an address.
+ * @param keys - The wallet keys to use.
+ * @param chain - The chain to use.
+ * @param index - The index to use.
+ * @param network - The network to use.
+ * @param addressFormat - The address format to use.
+ *   Only relevant for Bitcoin Cash and eCash networks, where:
+ *   - "default" means base58check,
+ *   - "cashaddr" means cashaddr.
+ */
+export declare function address(keys: WalletKeysArg, chain: number, index: number, network: UtxolibNetwork, addressFormat?: AddressFormat): string;

package/dist/esm/js/fixedScriptWallet/address.js

@@ -0,0 +1,25 @@
+import { FixedScriptWalletNamespace } from "../wasm/wasm_utxo.js";
+import { RootWalletKeys } from "./RootWalletKeys.js";
+/**
+ * Create the output script for a given wallet keys and chain and index
+ */
+export function outputScript(keys, chain, index, network) {
+    const walletKeys = RootWalletKeys.from(keys);
+    return FixedScriptWalletNamespace.output_script(walletKeys.wasm, chain, index, network);
+}
+/**
+ * Create the address for a given wallet keys and chain and index and network.
+ * Wrapper for outputScript that also encodes the script to an address.
+ * @param keys - The wallet keys to use.
+ * @param chain - The chain to use.
+ * @param index - The index to use.
+ * @param network - The network to use.
+ * @param addressFormat - The address format to use.
+ *   Only relevant for Bitcoin Cash and eCash networks, where:
+ *   - "default" means base58check,
+ *   - "cashaddr" means cashaddr.
+ */
+export function address(keys, chain, index, network, addressFormat) {
+    const walletKeys = RootWalletKeys.from(keys);
+    return FixedScriptWalletNamespace.address(walletKeys.wasm, chain, index, network, addressFormat);
+}

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

@@ -0,0 +1,4 @@
+export { RootWalletKeys, type WalletKeysArg, type IWalletKeys } from "./RootWalletKeys.js";
+export { ReplayProtection, type ReplayProtectionArg } from "./ReplayProtection.js";
+export { outputScript, address } from "./address.js";
+export { BitGoPsbt, type NetworkName, type ScriptId, type InputScriptType, type ParsedInput, type ParsedOutput, type ParsedTransaction, } from "./BitGoPsbt.js";

package/dist/esm/js/fixedScriptWallet/index.js

@@ -0,0 +1,4 @@
+export { RootWalletKeys } from "./RootWalletKeys.js";
+export { ReplayProtection } from "./ReplayProtection.js";
+export { outputScript, address } from "./address.js";
+export { BitGoPsbt, } from "./BitGoPsbt.js";

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

@@ -1,7 +1,11 @@
 export * as address from "./address.js";
 export * as ast from "./ast/index.js";
 export * as utxolibCompat from "./utxolibCompat.js";
-export * as fixedScriptWallet from "./fixedScriptWallet.js";
+export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
+export * as bip32 from "./bip32.js";
+export * as ecpair from "./ecpair.js";
+export { ECPair } from "./ecpair.js";
+export { BIP32 } from "./bip32.js";
 export type { CoinName } from "./coinName.js";
 export type { Triple } from "./triple.js";
 export type { AddressFormat } from "./address.js";

package/dist/esm/js/index.js

@@ -2,10 +2,17 @@ import * as wasm from "./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
 void wasm;
+// Most exports are namespaced to avoid polluting the top-level namespace
+// and to make imports more explicit (e.g., `import { address } from '@bitgo/wasm-utxo'`)
 export * as address from "./address.js";
 export * as ast from "./ast/index.js";
 export * as utxolibCompat from "./utxolibCompat.js";
-export * as fixedScriptWallet from "./fixedScriptWallet.js";
+export * as fixedScriptWallet from "./fixedScriptWallet/index.js";
+export * as bip32 from "./bip32.js";
+export * as ecpair from "./ecpair.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";
 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";