@bitgo/wasm-utxo 1.11.0 → 1.13.0

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

@@ -1,33 +1,36 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_addressnamespace_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_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 __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 bitgopsbt_add_paygo_attestation: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const bitgopsbt_combine_musig2_nonces: (a: number, b: number, c: number) => void;
+export const bitgopsbt_extract_transaction: (a: number, b: number) => void;
+export const bitgopsbt_finalize_all_inputs: (a: number, b: number) => void;
+export const bitgopsbt_from_bytes: (a: number, b: number, c: number, d: number, e: number) => void;
+export const bitgopsbt_generate_musig2_nonces: (a: number, b: number, c: number, d: number, e: number) => void;
+export const bitgopsbt_network: (a: number, b: number) => void;
+export const bitgopsbt_parse_outputs_with_wallet_keys: (a: number, b: number, c: number, d: number, e: number) => void;
+export const bitgopsbt_parse_transaction_with_wallet_keys: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const bitgopsbt_serialize: (a: number, b: number) => void;
+export const bitgopsbt_sign_with_privkey: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_sign_with_xpriv: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_unsigned_txid: (a: number, b: number) => void;
+export const bitgopsbt_verify_replay_protection_signature: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_verify_signature_with_pub: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_verify_signature_with_xpub: (a: number, b: number, c: number, d: number) => void;
+export const fixedscriptwalletnamespace_address: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const fixedscriptwalletnamespace_output_script: (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;
-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_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 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;
@@ -38,6 +41,9 @@ 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 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 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;
@@ -51,35 +57,29 @@ export const wrappsbt_signWithPrv: (a: number, b: number, c: number, d: number)
 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 wasmbip32_from_bip32_properties: (a: number, b: number) => void;
-export const __wbg_addressnamespace_free: (a: number, b: number) => void;
-export const __wbg_wasmreplayprotection_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 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_bitgopsbt_free: (a: number, b: number) => void;
-export const __wbg_fixedscriptwalletnamespace_free: (a: number, b: number) => void;
+export const __wbg_wasmbip32_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 bitgopsbt_combine_musig2_nonces: (a: number, b: number, c: number) => void;
-export const bitgopsbt_extract_transaction: (a: number, b: number) => void;
-export const bitgopsbt_finalize_all_inputs: (a: number, b: number) => void;
-export const bitgopsbt_from_bytes: (a: number, b: number, c: number, d: number, e: number) => void;
-export const bitgopsbt_generate_musig2_nonces: (a: number, b: number, c: number, d: number, e: number) => void;
-export const bitgopsbt_network: (a: number, b: number) => void;
-export const bitgopsbt_parse_outputs_with_wallet_keys: (a: number, b: number, c: number) => void;
-export const bitgopsbt_parse_transaction_with_wallet_keys: (a: number, b: number, c: number, d: number) => void;
-export const bitgopsbt_serialize: (a: number, b: number) => void;
-export const bitgopsbt_sign_with_privkey: (a: number, b: number, c: number, d: number) => void;
-export const bitgopsbt_sign_with_xpriv: (a: number, b: number, c: number, d: number) => void;
-export const bitgopsbt_unsigned_txid: (a: number, b: number) => void;
-export const bitgopsbt_verify_replay_protection_signature: (a: number, b: number, c: number, d: number) => void;
-export const bitgopsbt_verify_signature_with_pub: (a: number, b: number, c: number, d: number) => void;
-export const bitgopsbt_verify_signature_with_xpub: (a: number, b: number, c: number, d: number) => void;
-export const fixedscriptwalletnamespace_address: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const fixedscriptwalletnamespace_output_script: (a: number, b: number, c: number, d: number, e: 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;
+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_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 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;
@@ -97,12 +97,13 @@ export const wrapminiscript_fromString: (a: number, b: number, c: number, d: num
 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 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;
 export const rustsecp256k1_v0_10_0_default_illegal_callback_fn: (a: number, b: number) => void;
-export const __wbindgen_export_0: (a: number) => void;
-export const __wbindgen_export_1: (a: number, b: number) => number;
-export const __wbindgen_export_2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number) => void;
 export const __wbindgen_add_to_stack_pointer: (a: number) => number;
-export const __wbindgen_export_3: (a: number, b: number, c: number) => void;
+export const __wbindgen_export4: (a: number, b: number, c: number) => void;

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

@@ -27,6 +27,7 @@ export type ParsedOutput = {
     script: Uint8Array;
     value: bigint;
     scriptId: ScriptId | null;
+    paygo: boolean;
 };
 export type ParsedTransaction = {
     inputs: ParsedInput[];
@@ -54,9 +55,10 @@ export declare class BitGoPsbt {
      * 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
+     * @param payGoPubkeys - Optional public keys for PayGo attestation verification
      * @returns Parsed transaction information
      */
-    parseTransactionWithWalletKeys(walletKeys: WalletKeysArg, replayProtection: ReplayProtectionArg): ParsedTransaction;
+    parseTransactionWithWalletKeys(walletKeys: WalletKeysArg, replayProtection: ReplayProtectionArg, payGoPubkeys?: ECPairArg[]): ParsedTransaction;
     /**
      * Parse outputs with wallet keys to identify which outputs belong to a wallet
      * with the given wallet keys.
@@ -65,10 +67,23 @@ export declare class BitGoPsbt {
      * wallet than the inputs.
      *
      * @param walletKeys - The wallet keys to use for identification
+     * @param payGoPubkeys - Optional public keys for PayGo attestation verification
      * @returns Array of parsed outputs
      * @note This method does NOT validate wallet inputs. It only parses outputs.
      */
-    parseOutputsWithWalletKeys(walletKeys: WalletKeysArg): ParsedOutput[];
+    parseOutputsWithWalletKeys(walletKeys: WalletKeysArg, payGoPubkeys?: ECPairArg[]): ParsedOutput[];
+    /**
+     * Add a PayGo attestation to a PSBT output
+     *
+     * This adds a cryptographic proof that the output address was authorized by a signing authority.
+     * The attestation is stored in PSBT proprietary key-values and can be verified later.
+     *
+     * @param outputIndex - The index of the output to add the attestation to
+     * @param entropy - 64 bytes of entropy (must be exactly 64 bytes)
+     * @param signature - ECDSA signature bytes (typically 65 bytes in recoverable format)
+     * @throws Error if output index is out of bounds or entropy is not 64 bytes
+     */
+    addPayGoAttestation(outputIndex: number, entropy: Uint8Array, signature: Uint8Array): void;
     /**
      * Verify if a valid signature exists for a given key at the specified input index.
      *

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

@@ -29,12 +29,14 @@ export class BitGoPsbt {
      * 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
+     * @param payGoPubkeys - Optional public keys for PayGo attestation verification
      * @returns Parsed transaction information
      */
-    parseTransactionWithWalletKeys(walletKeys, replayProtection) {
+    parseTransactionWithWalletKeys(walletKeys, replayProtection, payGoPubkeys) {
         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);
+        const pubkeys = payGoPubkeys?.map((arg) => ECPair.from(arg).wasm);
+        return this.wasm.parse_transaction_with_wallet_keys(keys.wasm, rp.wasm, pubkeys);
     }
     /**
      * Parse outputs with wallet keys to identify which outputs belong to a wallet
@@ -44,12 +46,28 @@ export class BitGoPsbt {
      * wallet than the inputs.
      *
      * @param walletKeys - The wallet keys to use for identification
+     * @param payGoPubkeys - Optional public keys for PayGo attestation verification
      * @returns Array of parsed outputs
      * @note This method does NOT validate wallet inputs. It only parses outputs.
      */
-    parseOutputsWithWalletKeys(walletKeys) {
+    parseOutputsWithWalletKeys(walletKeys, payGoPubkeys) {
         const keys = RootWalletKeys.from(walletKeys);
-        return this.wasm.parse_outputs_with_wallet_keys(keys.wasm);
+        const pubkeys = payGoPubkeys?.map((arg) => ECPair.from(arg).wasm);
+        return this.wasm.parse_outputs_with_wallet_keys(keys.wasm, pubkeys);
+    }
+    /**
+     * Add a PayGo attestation to a PSBT output
+     *
+     * This adds a cryptographic proof that the output address was authorized by a signing authority.
+     * The attestation is stored in PSBT proprietary key-values and can be verified later.
+     *
+     * @param outputIndex - The index of the output to add the attestation to
+     * @param entropy - 64 bytes of entropy (must be exactly 64 bytes)
+     * @param signature - ECDSA signature bytes (typically 65 bytes in recoverable format)
+     * @throws Error if output index is out of bounds or entropy is not 64 bytes
+     */
+    addPayGoAttestation(outputIndex, entropy, signature) {
+        this.wasm.add_paygo_attestation(outputIndex, entropy, signature);
     }
     /**
      * Verify if a valid signature exists for a given key at the specified input index.

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

@@ -1,5 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
+
 export class AddressNamespace {
   private constructor();
   free(): void;
@@ -7,6 +8,7 @@ export class AddressNamespace {
   static to_output_script_with_coin(address: string, coin: string): Uint8Array;
   static from_output_script_with_coin(script: Uint8Array, coin: string, format?: string | null): string;
 }
+
 export class BitGoPsbt {
   private constructor();
   free(): void;
@@ -81,6 +83,19 @@ export class BitGoPsbt {
    * - `Err(WasmUtxoError)` if any input failed to finalize
    */
   finalize_all_inputs(): void;
+  /**
+   * Add a PayGo attestation to a PSBT output
+   *
+   * # Arguments
+   * - `output_index`: The index of the output to add the attestation to
+   * - `entropy`: 64 bytes of entropy
+   * - `signature`: ECDSA signature bytes
+   *
+   * # Returns
+   * - `Ok(())` if the attestation was successfully added
+   * - `Err(WasmUtxoError)` if the output index is out of bounds or entropy is invalid
+   */
+  add_paygo_attestation(output_index: number, entropy: Uint8Array, signature: Uint8Array): void;
   /**
    * Combine/merge data from another PSBT into this one
    *
@@ -171,11 +186,11 @@ export class BitGoPsbt {
    *
    * Note: This method does NOT validate wallet inputs. It only parses outputs.
    */
-  parse_outputs_with_wallet_keys(wallet_keys: WasmRootWalletKeys): any;
+  parse_outputs_with_wallet_keys(wallet_keys: WasmRootWalletKeys, paygo_pubkeys?: WasmECPair[] | null): any;
   /**
    * Parse transaction with wallet keys to identify wallet inputs/outputs
    */
-  parse_transaction_with_wallet_keys(wallet_keys: WasmRootWalletKeys, replay_protection: WasmReplayProtection): any;
+  parse_transaction_with_wallet_keys(wallet_keys: WasmRootWalletKeys, replay_protection: WasmReplayProtection, paygo_pubkeys?: WasmECPair[] | null): any;
   /**
    * Verify if a replay protection input has a valid signature
    *
@@ -206,6 +221,7 @@ export class BitGoPsbt {
    */
   serialize(): Uint8Array;
 }
+
 export class FixedScriptWalletNamespace {
   private constructor();
   free(): void;
@@ -213,6 +229,7 @@ export class FixedScriptWalletNamespace {
   static output_script(keys: WasmRootWalletKeys, chain: number, index: number, network: any): Uint8Array;
   static address(keys: WasmRootWalletKeys, chain: number, index: number, network: any, address_format?: string | null): string;
 }
+
 export class UtxolibCompatNamespace {
   private constructor();
   free(): void;
@@ -236,10 +253,7 @@ export class UtxolibCompatNamespace {
    */
   static from_output_script(script: Uint8Array, network: any, format?: string | null): string;
 }
-/**
- * WASM wrapper for BIP32 extended keys (Xpub/Xpriv)
- * Implements the BIP32Interface TypeScript interface
- */
+
 export class WasmBIP32 {
   private constructor();
   free(): void;
@@ -332,9 +346,7 @@ export class WasmBIP32 {
    */
   readonly index: number;
 }
-/**
- * WASM wrapper for elliptic curve key pairs (always uses compressed keys)
- */
+
 export class WasmECPair {
   private constructor();
   free(): void;
@@ -380,9 +392,7 @@ export class WasmECPair {
    */
   readonly private_key: Uint8Array | undefined;
 }
-/**
- * WASM wrapper for ReplayProtection
- */
+
 export class WasmReplayProtection {
   private constructor();
   free(): void;
@@ -400,10 +410,7 @@ export class WasmReplayProtection {
    */
   static from_output_scripts(output_scripts: Uint8Array[]): WasmReplayProtection;
 }
-/**
- * WASM wrapper for RootWalletKeys
- * Represents a set of three extended public keys with their derivation prefixes
- */
+
 export class WasmRootWalletKeys {
   free(): void;
   [Symbol.dispose](): void;
@@ -442,6 +449,7 @@ export class WasmRootWalletKeys {
    */
   bitgo_key(): WasmBIP32;
 }
+
 export class WrapDescriptor {
   private constructor();
   free(): void;
@@ -456,6 +464,7 @@ export class WrapDescriptor {
   descType(): any;
   toString(): string;
 }
+
 export class WrapMiniscript {
   private constructor();
   free(): void;
@@ -465,6 +474,7 @@ export class WrapMiniscript {
   encode(): Uint8Array;
   toString(): string;
 }
+
 export class WrapPsbt {
   private constructor();
   free(): void;