@bitgo/wasm-utxo 1.21.0 → 1.23.0

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

@@ -1,9 +1,59 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+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 __wbg_wrappsbt_free: (a: number, b: number) => void;
+export const wasmtransaction_from_bytes: (a: number, b: number, c: 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_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 wrappsbt_clone: (a: number) => number;
+export const wrappsbt_deserialize: (a: number, b: number, c: number) => void;
+export const wrappsbt_finalize: (a: number, b: number) => void;
+export const wrappsbt_serialize: (a: number, b: 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_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 __wbg_addressnamespace_free: (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_wasmbip32_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 __wbg_wasmecpair_free: (a: number, b: number) => void;
+export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
+export const __wbg_wasmrootwalletkeys_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 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;
+export const bip322namespace_verify_bip322_psbt_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+export const bip322namespace_verify_bip322_psbt_input_with_pubkeys: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
+export const bip322namespace_verify_bip322_tx_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) => void;
+export const bip322namespace_verify_bip322_tx_input_with_pubkeys: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
 export const bitgopsbt_add_input: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number, k: number) => void;
 export const bitgopsbt_add_output: (a: number, b: number, c: number, d: number, e: bigint) => void;
 export const bitgopsbt_add_output_with_address: (a: number, b: number, c: number, d: number, e: bigint) => void;
@@ -34,8 +84,11 @@ export const bitgopsbt_verify_signature_with_xpub: (a: number, b: number, c: num
 export const bitgopsbt_version: (a: number) => number;
 export const bitgopsbt_version_group_id: (a: number) => number;
 export const fixedscriptwalletnamespace_address: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const fixedscriptwalletnamespace_chain_code_table: () => number;
 export const fixedscriptwalletnamespace_output_script: (a: number, b: number, c: number, d: number, e: 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 wasmbip32_chain_code: (a: number) => number;
 export const wasmbip32_depth: (a: number) => number;
 export const wasmbip32_derive: (a: number, b: number, c: number) => void;
@@ -56,9 +109,22 @@ 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 wasmbip32_from_bip32_properties: (a: number, b: number) => void;
-export const __wbg_wasmecpair_free: (a: number, b: number) => void;
-export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
+export const wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
+export const wasmdashtransaction_to_bytes: (a: number, b: number) => void;
+export const wasmdimensions_empty: () => number;
+export const wasmdimensions_from_input: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmdimensions_from_input_script_type: (a: number, b: number, c: number) => void;
+export const wasmdimensions_from_output_script: (a: number, b: number) => number;
+export const wasmdimensions_from_psbt: (a: number, b: number) => void;
+export const wasmdimensions_get_input_vsize: (a: number, b: number, c: number) => number;
+export const wasmdimensions_get_input_weight: (a: number, b: number, c: number) => number;
+export const wasmdimensions_get_output_vsize: (a: number) => number;
+export const wasmdimensions_get_output_weight: (a: number) => number;
+export const wasmdimensions_get_vsize: (a: number, b: number, c: number) => number;
+export const wasmdimensions_get_weight: (a: number, b: number, c: number) => number;
+export const wasmdimensions_has_segwit: (a: number) => number;
+export const wasmdimensions_plus: (a: number, b: number) => number;
+export const wasmdimensions_times: (a: number, b: number) => number;
 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;
@@ -72,66 +138,12 @@ export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
 export const wasmreplayprotection_from_addresses: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmreplayprotection_from_output_scripts: (a: number, b: number) => number;
 export const wasmreplayprotection_from_public_keys: (a: number, b: number, c: 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_wasmdimensions_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 __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 wasmdimensions_empty: () => number;
-export const wasmdimensions_from_input: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wasmdimensions_from_input_script_type: (a: number, b: number, c: number) => void;
-export const wasmdimensions_from_output_script: (a: number, b: number) => number;
-export const wasmdimensions_from_psbt: (a: number, b: number) => void;
-export const wasmdimensions_get_vsize: (a: number, b: number, c: number) => number;
-export const wasmdimensions_get_weight: (a: number, b: number, c: number) => number;
-export const wasmdimensions_has_segwit: (a: number) => number;
-export const wasmdimensions_plus: (a: number, b: number) => number;
-export const wasmtransaction_from_bytes: (a: number, b: number, c: 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_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 wrappsbt_clone: (a: number) => number;
-export const wrappsbt_deserialize: (a: number, b: number, c: number) => void;
-export const wrappsbt_finalize: (a: number, b: number) => void;
-export const wrappsbt_serialize: (a: number, b: 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_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 __wbg_wasmrootwalletkeys_free: (a: number, b: number) => void;
 export const wasmrootwalletkeys_backup_key: (a: number) => number;
 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_wasmdashtransaction_free: (a: number, b: number) => void;
-export const wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
-export const wasmdashtransaction_to_bytes: (a: number, b: number) => void;
+export const wasmbip32_from_bip32_properties: (a: number, b: number) => void;
 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/bip322/index.d.ts

@@ -0,0 +1,236 @@
+/**
+ * BIP-0322 Generic Signed Message Format
+ *
+ * This module implements BIP-0322 for BitGo fixed-script wallets.
+ * It allows proving control of wallet addresses by signing arbitrary messages.
+ *
+ * @example
+ * ```typescript
+ * import { bip322, fixedScriptWallet } from '@bitgo/wasm-utxo';
+ *
+ * // Create wallet keys
+ * const walletKeys = fixedScriptWallet.RootWalletKeys.from([userXpub, backupXpub, bitgoXpub]);
+ *
+ * // Create an empty PSBT for BIP-0322 (version 0 required)
+ * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys, { version: 0 });
+ *
+ * // Add BIP-0322 inputs
+ * const idx0 = bip322.addBip322Input(psbt, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ *
+ * // Sign the input
+ * psbt.sign(idx0, userXpriv);
+ * psbt.sign(idx0, bitgoXpriv);
+ *
+ * // Verify the input
+ * bip322.verifyBip322PsbtInput(psbt, idx0, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ * ```
+ */
+import { BitGoPsbt, type NetworkName, type ScriptId, type SignPath } from "../fixedScriptWallet/BitGoPsbt.js";
+import { type WalletKeysArg } from "../fixedScriptWallet/RootWalletKeys.js";
+import { type OutputScriptType } from "../fixedScriptWallet/scriptType.js";
+import { Transaction } from "../transaction.js";
+export type { OutputScriptType };
+/**
+ * Parameters for adding a BIP-0322 input to a PSBT
+ */
+export type AddBip322InputParams = {
+    /** The message to sign (UTF-8 string) */
+    message: string;
+    /** The wallet script location (chain and index) */
+    scriptId: ScriptId;
+    /** The wallet's root keys */
+    rootWalletKeys: WalletKeysArg;
+    /**
+     * Sign path for taproot inputs (required for p2tr/p2trMusig2).
+     * Specifies which two keys will sign the message.
+     */
+    signPath?: SignPath;
+    /** Custom tag for message hashing (default: "BIP0322-signed-message") */
+    tag?: string;
+};
+/**
+ * Parameters for verifying a BIP-0322 input
+ */
+export type VerifyBip322InputParams = {
+    /** The message that was signed */
+    message: string;
+    /** The wallet script location (chain and index) */
+    scriptId: ScriptId;
+    /** The wallet's root keys */
+    rootWalletKeys: WalletKeysArg;
+    /** Custom tag if one was used during signing */
+    tag?: string;
+};
+/**
+ * Parameters for verifying a BIP-0322 transaction input
+ */
+export type VerifyBip322TxInputParams = VerifyBip322InputParams & {
+    /** Network name (default: "bitcoin") */
+    network?: NetworkName;
+};
+/**
+ * Add a BIP-0322 message input to an existing BitGoPsbt
+ *
+ * The PSBT must have version 0 per BIP-0322 specification. Use
+ * `BitGoPsbt.createEmpty(network, walletKeys, { version: 0 })` to create one.
+ *
+ * On the first input added, this also adds the required OP_RETURN output.
+ *
+ * @param psbt - The BitGoPsbt to add the input to (must have version 0)
+ * @param params - Input parameters including message, scriptId, and wallet keys
+ * @returns The index of the added input
+ *
+ * @example
+ * ```typescript
+ * // Create a BIP-0322 PSBT
+ * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys, { version: 0 });
+ *
+ * // Add inputs
+ * const idx0 = bip322.addBip322Input(psbt, {
+ *   message: "I control this address",
+ *   scriptId: { chain: 10, index: 5 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ *
+ * // Sign with user and bitgo keys
+ * psbt.sign(idx0, userXpriv);
+ * psbt.sign(idx0, bitgoXpriv);
+ * ```
+ */
+export declare function addBip322Input(psbt: BitGoPsbt, params: AddBip322InputParams): number;
+/**
+ * Verify a single input of a BIP-0322 transaction proof
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address corresponding to the given message.
+ *
+ * @param tx - The signed transaction
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, scriptId, and wallet keys
+ * @throws Error if verification fails
+ *
+ * @example
+ * ```typescript
+ * // Extract and verify the transaction
+ * psbt.finalizeAllInputs();
+ * const txBytes = psbt.extractTransaction();
+ * const tx = Transaction.fromBytes(txBytes, "bitcoin");
+ *
+ * bip322.verifyBip322TxInput(tx, 0, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ *   network: "bitcoin",
+ * });
+ * ```
+ */
+export declare function verifyBip322TxInput(tx: Transaction, inputIndex: number, params: VerifyBip322TxInputParams): void;
+/** Signer key name */
+export type SignerName = "user" | "backup" | "bitgo";
+/** Triple of hex-encoded pubkeys [user, backup, bitgo] */
+export type PubkeyTriple = [string, string, string];
+/**
+ * Parameters for verifying a BIP-0322 input with pubkeys
+ */
+export type VerifyBip322WithPubkeysParams = {
+    /** The message that was signed */
+    message: string;
+    /** Hex-encoded pubkeys [user, backup, bitgo] */
+    pubkeys: PubkeyTriple;
+    /** Script type */
+    scriptType: OutputScriptType;
+    /** For taproot types, whether script path was used */
+    isScriptPath?: boolean;
+    /** Custom tag if one was used during signing */
+    tag?: string;
+};
+/**
+ * Parameters for verifying a BIP-0322 transaction input with pubkeys
+ */
+export type VerifyBip322TxWithPubkeysParams = VerifyBip322WithPubkeysParams;
+/**
+ * Verify a single input of a BIP-0322 PSBT proof
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address by checking:
+ * - The PSBT structure follows BIP-0322 (version 0, OP_RETURN output)
+ * - The input references the correct virtual to_spend transaction
+ * - At least one valid signature exists from the wallet keys
+ *
+ * @param psbt - The signed PSBT
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, scriptId, and wallet keys
+ * @returns An array of signer names ("user", "backup", "bitgo") that have valid signatures
+ * @throws Error if verification fails or no valid signatures found
+ *
+ * @example
+ * ```typescript
+ * // Verify the signed PSBT input
+ * const signers = bip322.verifyBip322PsbtInput(psbt, 0, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ * console.log(signers); // ["user", "bitgo"]
+ * ```
+ */
+export declare function verifyBip322PsbtInput(psbt: BitGoPsbt, inputIndex: number, params: VerifyBip322InputParams): SignerName[];
+/**
+ * Verify a single input of a BIP-0322 PSBT proof using pubkeys directly
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address by checking:
+ * - The PSBT structure follows BIP-0322 (version 0, OP_RETURN output)
+ * - The input references the correct virtual to_spend transaction
+ * - At least one valid signature exists from the provided pubkeys
+ *
+ * @param psbt - The signed PSBT
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, pubkeys, and script type
+ * @returns An array of pubkey indices (0, 1, 2) that have valid signatures
+ * @throws Error if verification fails or no valid signatures found
+ *
+ * @example
+ * ```typescript
+ * // Verify the signed PSBT input with pubkeys
+ * const signerIndices = bip322.verifyBip322PsbtInputWithPubkeys(psbt, 0, {
+ *   message: "Hello, World!",
+ *   pubkeys: [userPubkey, backupPubkey, bitgoPubkey],
+ *   scriptType: "p2shP2wsh",
+ * });
+ * console.log(signerIndices); // [0, 2] for user+bitgo
+ * ```
+ */
+export declare function verifyBip322PsbtInputWithPubkeys(psbt: BitGoPsbt, inputIndex: number, params: VerifyBip322WithPubkeysParams): number[];
+/**
+ * Verify a single input of a BIP-0322 transaction proof using pubkeys directly
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address corresponding to the given message.
+ *
+ * @param tx - The signed transaction
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, pubkeys, and script type
+ * @returns An array of pubkey indices (0, 1, 2) that have valid signatures
+ * @throws Error if verification fails
+ *
+ * @example
+ * ```typescript
+ * // Verify the signed transaction input with pubkeys
+ * const signerIndices = bip322.verifyBip322TxInputWithPubkeys(tx, 0, {
+ *   message: "Hello, World!",
+ *   pubkeys: [userPubkey, backupPubkey, bitgoPubkey],
+ *   scriptType: "p2wsh",
+ * });
+ * console.log(signerIndices); // [0, 2] for user+bitgo
+ * ```
+ */
+export declare function verifyBip322TxInputWithPubkeys(tx: Transaction, inputIndex: number, params: VerifyBip322TxWithPubkeysParams): number[];

package/dist/esm/js/bip322/index.js

@@ -0,0 +1,186 @@
+/**
+ * BIP-0322 Generic Signed Message Format
+ *
+ * This module implements BIP-0322 for BitGo fixed-script wallets.
+ * It allows proving control of wallet addresses by signing arbitrary messages.
+ *
+ * @example
+ * ```typescript
+ * import { bip322, fixedScriptWallet } from '@bitgo/wasm-utxo';
+ *
+ * // Create wallet keys
+ * const walletKeys = fixedScriptWallet.RootWalletKeys.from([userXpub, backupXpub, bitgoXpub]);
+ *
+ * // Create an empty PSBT for BIP-0322 (version 0 required)
+ * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys, { version: 0 });
+ *
+ * // Add BIP-0322 inputs
+ * const idx0 = bip322.addBip322Input(psbt, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ *
+ * // Sign the input
+ * psbt.sign(idx0, userXpriv);
+ * psbt.sign(idx0, bitgoXpriv);
+ *
+ * // Verify the input
+ * bip322.verifyBip322PsbtInput(psbt, idx0, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ * ```
+ */
+import { Bip322Namespace } from "../wasm/wasm_utxo.js";
+import { RootWalletKeys } from "../fixedScriptWallet/RootWalletKeys.js";
+/**
+ * Add a BIP-0322 message input to an existing BitGoPsbt
+ *
+ * The PSBT must have version 0 per BIP-0322 specification. Use
+ * `BitGoPsbt.createEmpty(network, walletKeys, { version: 0 })` to create one.
+ *
+ * On the first input added, this also adds the required OP_RETURN output.
+ *
+ * @param psbt - The BitGoPsbt to add the input to (must have version 0)
+ * @param params - Input parameters including message, scriptId, and wallet keys
+ * @returns The index of the added input
+ *
+ * @example
+ * ```typescript
+ * // Create a BIP-0322 PSBT
+ * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys, { version: 0 });
+ *
+ * // Add inputs
+ * const idx0 = bip322.addBip322Input(psbt, {
+ *   message: "I control this address",
+ *   scriptId: { chain: 10, index: 5 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ *
+ * // Sign with user and bitgo keys
+ * psbt.sign(idx0, userXpriv);
+ * psbt.sign(idx0, bitgoXpriv);
+ * ```
+ */
+export function addBip322Input(psbt, params) {
+    const keys = RootWalletKeys.from(params.rootWalletKeys);
+    return Bip322Namespace.add_bip322_input(psbt.wasm, params.message, params.scriptId.chain, params.scriptId.index, keys.wasm, params.signPath?.signer, params.signPath?.cosigner, params.tag);
+}
+/**
+ * Verify a single input of a BIP-0322 transaction proof
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address corresponding to the given message.
+ *
+ * @param tx - The signed transaction
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, scriptId, and wallet keys
+ * @throws Error if verification fails
+ *
+ * @example
+ * ```typescript
+ * // Extract and verify the transaction
+ * psbt.finalizeAllInputs();
+ * const txBytes = psbt.extractTransaction();
+ * const tx = Transaction.fromBytes(txBytes, "bitcoin");
+ *
+ * bip322.verifyBip322TxInput(tx, 0, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ *   network: "bitcoin",
+ * });
+ * ```
+ */
+export function verifyBip322TxInput(tx, inputIndex, params) {
+    const keys = RootWalletKeys.from(params.rootWalletKeys);
+    const network = params.network ?? "bitcoin";
+    Bip322Namespace.verify_bip322_tx_input(tx.wasm, inputIndex, params.message, params.scriptId.chain, params.scriptId.index, keys.wasm, network, params.tag);
+}
+/**
+ * Verify a single input of a BIP-0322 PSBT proof
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address by checking:
+ * - The PSBT structure follows BIP-0322 (version 0, OP_RETURN output)
+ * - The input references the correct virtual to_spend transaction
+ * - At least one valid signature exists from the wallet keys
+ *
+ * @param psbt - The signed PSBT
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, scriptId, and wallet keys
+ * @returns An array of signer names ("user", "backup", "bitgo") that have valid signatures
+ * @throws Error if verification fails or no valid signatures found
+ *
+ * @example
+ * ```typescript
+ * // Verify the signed PSBT input
+ * const signers = bip322.verifyBip322PsbtInput(psbt, 0, {
+ *   message: "Hello, World!",
+ *   scriptId: { chain: 10, index: 0 },
+ *   rootWalletKeys: walletKeys,
+ * });
+ * console.log(signers); // ["user", "bitgo"]
+ * ```
+ */
+export function verifyBip322PsbtInput(psbt, inputIndex, params) {
+    const keys = RootWalletKeys.from(params.rootWalletKeys);
+    return Bip322Namespace.verify_bip322_psbt_input(psbt.wasm, inputIndex, params.message, params.scriptId.chain, params.scriptId.index, keys.wasm, params.tag);
+}
+/**
+ * Verify a single input of a BIP-0322 PSBT proof using pubkeys directly
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address by checking:
+ * - The PSBT structure follows BIP-0322 (version 0, OP_RETURN output)
+ * - The input references the correct virtual to_spend transaction
+ * - At least one valid signature exists from the provided pubkeys
+ *
+ * @param psbt - The signed PSBT
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, pubkeys, and script type
+ * @returns An array of pubkey indices (0, 1, 2) that have valid signatures
+ * @throws Error if verification fails or no valid signatures found
+ *
+ * @example
+ * ```typescript
+ * // Verify the signed PSBT input with pubkeys
+ * const signerIndices = bip322.verifyBip322PsbtInputWithPubkeys(psbt, 0, {
+ *   message: "Hello, World!",
+ *   pubkeys: [userPubkey, backupPubkey, bitgoPubkey],
+ *   scriptType: "p2shP2wsh",
+ * });
+ * console.log(signerIndices); // [0, 2] for user+bitgo
+ * ```
+ */
+export function verifyBip322PsbtInputWithPubkeys(psbt, inputIndex, params) {
+    return Array.from(Bip322Namespace.verify_bip322_psbt_input_with_pubkeys(psbt.wasm, inputIndex, params.message, params.pubkeys, params.scriptType, params.isScriptPath, params.tag));
+}
+/**
+ * Verify a single input of a BIP-0322 transaction proof using pubkeys directly
+ *
+ * This verifies that the specified input correctly proves control of the
+ * wallet address corresponding to the given message.
+ *
+ * @param tx - The signed transaction
+ * @param inputIndex - The index of the input to verify
+ * @param params - Verification parameters including message, pubkeys, and script type
+ * @returns An array of pubkey indices (0, 1, 2) that have valid signatures
+ * @throws Error if verification fails
+ *
+ * @example
+ * ```typescript
+ * // Verify the signed transaction input with pubkeys
+ * const signerIndices = bip322.verifyBip322TxInputWithPubkeys(tx, 0, {
+ *   message: "Hello, World!",
+ *   pubkeys: [userPubkey, backupPubkey, bitgoPubkey],
+ *   scriptType: "p2wsh",
+ * });
+ * console.log(signerIndices); // [0, 2] for user+bitgo
+ * ```
+ */
+export function verifyBip322TxInputWithPubkeys(tx, inputIndex, params) {
+    return Array.from(Bip322Namespace.verify_bip322_tx_input_with_pubkeys(tx.wasm, inputIndex, params.message, params.pubkeys, params.scriptType, params.isScriptPath, params.tag));
+}

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

@@ -47,6 +47,10 @@ export declare class Dimensions {
      * Combine with another Dimensions instance
      */
     plus(other: Dimensions): Dimensions;
+    /**
+     * Multiply dimensions by a scalar
+     */
+    times(n: number): Dimensions;
     /**
      * Whether any inputs are segwit (affects overhead calculation)
      */
@@ -61,5 +65,23 @@ export declare class Dimensions {
      * @param size - "min" or "max", defaults to "max"
      */
     getVSize(size?: "min" | "max"): number;
+    /**
+     * Get input weight only (min or max)
+     * @param size - "min" or "max", defaults to "max"
+     */
+    getInputWeight(size?: "min" | "max"): number;
+    /**
+     * Get input virtual size (min or max)
+     * @param size - "min" or "max", defaults to "max"
+     */
+    getInputVSize(size?: "min" | "max"): number;
+    /**
+     * Get output weight
+     */
+    getOutputWeight(): number;
+    /**
+     * Get output virtual size
+     */
+    getOutputVSize(): number;
 }
 export {};

package/dist/esm/js/fixedScriptWallet/Dimensions.js

@@ -56,6 +56,12 @@ export class Dimensions {
     plus(other) {
         return new Dimensions(this._wasm.plus(other._wasm));
     }
+    /**
+     * Multiply dimensions by a scalar
+     */
+    times(n) {
+        return new Dimensions(this._wasm.times(n));
+    }
     /**
      * Whether any inputs are segwit (affects overhead calculation)
      */
@@ -76,4 +82,30 @@ export class Dimensions {
     getVSize(size = "max") {
         return this._wasm.get_vsize(size);
     }
+    /**
+     * Get input weight only (min or max)
+     * @param size - "min" or "max", defaults to "max"
+     */
+    getInputWeight(size = "max") {
+        return this._wasm.get_input_weight(size);
+    }
+    /**
+     * Get input virtual size (min or max)
+     * @param size - "min" or "max", defaults to "max"
+     */
+    getInputVSize(size = "max") {
+        return this._wasm.get_input_vsize(size);
+    }
+    /**
+     * Get output weight
+     */
+    getOutputWeight() {
+        return this._wasm.get_output_weight();
+    }
+    /**
+     * Get output virtual size
+     */
+    getOutputVSize() {
+        return this._wasm.get_output_vsize();
+    }
 }