@bitgo/wasm-utxo 1.14.1 → 1.16.0

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

@@ -1,22 +1,43 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_wrapdescriptor_free: (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 __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_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_paygo_attestation: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const bitgopsbt_add_replay_protection_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number) => void;
+export const bitgopsbt_add_wallet_input: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number) => void;
+export const bitgopsbt_add_wallet_output: (a: number, b: number, c: number, d: number, e: bigint, f: number) => void;
 export const bitgopsbt_combine_musig2_nonces: (a: number, b: number, c: number) => void;
+export const bitgopsbt_create_empty: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const bitgopsbt_create_empty_zcash: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+export const bitgopsbt_create_empty_zcash_at_height: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
+export const bitgopsbt_expiry_height: (a: number) => number;
 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_lock_time: (a: number) => number;
 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;
@@ -27,10 +48,30 @@ 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 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_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;
@@ -41,9 +82,6 @@ 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;
@@ -57,47 +95,21 @@ 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 __wbg_wasmbip32_free: (a: number, b: number) => void;
-export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
+export const wasmbip32_from_bip32_properties: (a: number, b: number) => void;
+export const __wbg_wasmreplayprotection_free: (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_utxolibcompatnamespace_free: (a: number, b: number) => void;
 export const __wbg_wrapminiscript_free: (a: number, b: 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;
-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 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 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 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/fixedScriptWallet/BitGoPsbt.d.ts

@@ -1,3 +1,4 @@
+import { BitGoPsbt as WasmBitGoPsbt } from "../wasm/wasm_utxo.js";
 import { type WalletKeysArg } from "./RootWalletKeys.js";
 import { type ReplayProtectionArg } from "./ReplayProtection.js";
 import { type BIP32Arg } from "../bip32.js";
@@ -21,6 +22,7 @@ export type ParsedInput = {
     value: bigint;
     scriptId: ScriptId | null;
     scriptType: InputScriptType;
+    sequence: number;
 };
 export type ParsedOutput = {
     address: string | null;
@@ -36,9 +38,79 @@ export type ParsedTransaction = {
     minerFee: bigint;
     virtualSize: number;
 };
+export type CreateEmptyOptions = {
+    /** Transaction version (default: 2) */
+    version?: number;
+    /** Lock time (default: 0) */
+    lockTime?: number;
+};
+export type AddInputOptions = {
+    /** Previous transaction ID (hex string) */
+    txid: string;
+    /** Output index being spent */
+    vout: number;
+    /** Value in satoshis (for witness_utxo) */
+    value: bigint;
+    /** Sequence number (default: 0xFFFFFFFE for RBF) */
+    sequence?: number;
+    /** Full previous transaction (for non-segwit strict compliance) */
+    prevTx?: Uint8Array;
+};
+export type AddOutputOptions = {
+    /** Output script (scriptPubKey) */
+    script: Uint8Array;
+    /** Value in satoshis */
+    value: bigint;
+};
+/** Key identifier for signing ("user", "backup", or "bitgo") */
+export type SignerKey = "user" | "backup" | "bitgo";
+/** Specifies signer and cosigner for Taproot inputs */
+export type SignPath = {
+    /** Key that will sign */
+    signer: SignerKey;
+    /** Key that will co-sign */
+    cosigner: SignerKey;
+};
+export type AddWalletInputOptions = {
+    /** Script location in wallet (chain + index) */
+    scriptId: ScriptId;
+    /** Sign path - required for p2tr/p2trMusig2 (chains 30-41) */
+    signPath?: SignPath;
+};
+export type AddWalletOutputOptions = {
+    /** Chain code (0/1=p2sh, 10/11=p2shP2wsh, 20/21=p2wsh, 30/31=p2tr, 40/41=p2trMusig2) */
+    chain: number;
+    /** Derivation index */
+    index: number;
+    /** Value in satoshis */
+    value: bigint;
+};
 export declare class BitGoPsbt {
-    private wasm;
-    private constructor();
+    protected wasm: WasmBitGoPsbt;
+    protected constructor(wasm: WasmBitGoPsbt);
+    /**
+     * Create an empty PSBT for the given network with wallet keys
+     *
+     * The wallet keys are used to set global xpubs in the PSBT, which identifies
+     * the keys that will be used for signing.
+     *
+     * For Zcash networks, use ZcashBitGoPsbt.createEmpty() instead.
+     *
+     * @param network - Network name (utxolib name like "bitcoin" or coin name like "btc")
+     * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
+     * @param options - Optional transaction parameters (version, lockTime)
+     * @returns A new empty BitGoPsbt instance
+     *
+     * @example
+     * ```typescript
+     * // Create empty PSBT with wallet keys
+     * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys);
+     *
+     * // Create with custom version and lockTime
+     * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys, { version: 1, lockTime: 500000 });
+     * ```
+     */
+    static createEmpty(network: NetworkName, walletKeys: WalletKeysArg, options?: CreateEmptyOptions): BitGoPsbt;
     /**
      * Deserialize a PSBT from bytes
      * @param bytes - The PSBT bytes
@@ -46,11 +118,147 @@ export declare class BitGoPsbt {
      * @returns A BitGoPsbt instance
      */
     static fromBytes(bytes: Uint8Array, network: NetworkName): BitGoPsbt;
+    /**
+     * Add an input to the PSBT
+     *
+     * This adds a transaction input and corresponding PSBT input metadata.
+     * The witness_utxo is automatically populated for modern signing compatibility.
+     *
+     * @param options - Input options (txid, vout, value, sequence)
+     * @param script - Output script of the UTXO being spent
+     * @returns The index of the newly added input
+     *
+     * @example
+     * ```typescript
+     * const inputIndex = psbt.addInput({
+     *   txid: "abc123...",
+     *   vout: 0,
+     *   value: 100000n,
+     * }, outputScript);
+     * ```
+     */
+    addInput(options: AddInputOptions, script: Uint8Array): number;
+    /**
+     * Add an output to the PSBT
+     *
+     * @param options - Output options (script, value)
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * const outputIndex = psbt.addOutput({
+     *   script: outputScript,
+     *   value: 50000n,
+     * });
+     * ```
+     */
+    addOutput(options: AddOutputOptions): number;
+    /**
+     * Add a wallet input with full PSBT metadata
+     *
+     * This is a higher-level method that adds an input and populates all required
+     * PSBT fields (scripts, derivation info, etc.) based on the wallet's chain type.
+     *
+     * For p2sh/p2shP2wsh/p2wsh: Sets bip32Derivation, witnessScript, redeemScript (signPath not needed)
+     * For p2tr/p2trMusig2 script path: Sets tapLeafScript, tapBip32Derivation (signPath required)
+     * For p2trMusig2 key path: Sets tapInternalKey, tapMerkleRoot, tapBip32Derivation, musig2 participants (signPath required)
+     *
+     * @param inputOptions - Common input options (txid, vout, value, sequence)
+     * @param walletKeys - The wallet's root keys
+     * @param walletOptions - Wallet-specific options (scriptId, signPath, prevTx)
+     * @returns The index of the newly added input
+     *
+     * @example
+     * ```typescript
+     * // Add a p2shP2wsh input (signPath not needed)
+     * const inputIndex = psbt.addWalletInput(
+     *   { txid: "abc123...", vout: 0, value: 100000n },
+     *   walletKeys,
+     *   { scriptId: { chain: 10, index: 0 } },  // p2shP2wsh external
+     * );
+     *
+     * // Add a p2trMusig2 key path input (signPath required)
+     * const inputIndex = psbt.addWalletInput(
+     *   { txid: "def456...", vout: 1, value: 50000n },
+     *   walletKeys,
+     *   { scriptId: { chain: 40, index: 5 }, signPath: { signer: "user", cosigner: "bitgo" } },
+     * );
+     *
+     * // Add p2trMusig2 with backup key (script path spend)
+     * const inputIndex = psbt.addWalletInput(
+     *   { txid: "ghi789...", vout: 0, value: 75000n },
+     *   walletKeys,
+     *   { scriptId: { chain: 40, index: 3 }, signPath: { signer: "user", cosigner: "backup" } },
+     * );
+     * ```
+     */
+    addWalletInput(inputOptions: AddInputOptions, walletKeys: WalletKeysArg, walletOptions: AddWalletInputOptions): number;
+    /**
+     * Add a wallet output with full PSBT metadata
+     *
+     * This creates a verifiable wallet output (typically for change) with all required
+     * PSBT fields (scripts, derivation info) based on the wallet's chain type.
+     *
+     * For p2sh/p2shP2wsh/p2wsh: Sets bip32Derivation, witnessScript, redeemScript
+     * For p2tr/p2trMusig2: Sets tapInternalKey, tapBip32Derivation
+     *
+     * @param walletKeys - The wallet's root keys
+     * @param options - Output options including chain, index, and value
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * // Add a p2shP2wsh change output
+     * const outputIndex = psbt.addWalletOutput(walletKeys, {
+     *   chain: 11,  // p2shP2wsh internal (change)
+     *   index: 0,
+     *   value: 50000n,
+     * });
+     *
+     * // Add a p2trMusig2 change output
+     * const outputIndex = psbt.addWalletOutput(walletKeys, {
+     *   chain: 41,  // p2trMusig2 internal (change)
+     *   index: 5,
+     *   value: 25000n,
+     * });
+     * ```
+     */
+    addWalletOutput(walletKeys: WalletKeysArg, options: AddWalletOutputOptions): number;
+    /**
+     * Add a replay protection input to the PSBT
+     *
+     * Replay protection inputs are P2SH-P2PK inputs used on forked networks to prevent
+     * transaction replay attacks. They use a simple pubkey script without wallet derivation.
+     *
+     * @param inputOptions - Common input options (txid, vout, value, sequence)
+     * @param key - ECPair containing the public key for the replay protection input
+     * @returns The index of the newly added input
+     *
+     * @example
+     * ```typescript
+     * // Add a replay protection input using ECPair
+     * const inputIndex = psbt.addReplayProtectionInput(
+     *   { txid: "abc123...", vout: 0, value: 1000n },
+     *   replayProtectionKey,
+     * );
+     * ```
+     */
+    addReplayProtectionInput(inputOptions: AddInputOptions, key: ECPairArg): number;
     /**
      * Get the unsigned transaction ID
      * @returns The unsigned transaction ID
      */
     unsignedTxid(): string;
+    /**
+     * Get the transaction version
+     * @returns The transaction version number
+     */
+    get version(): number;
+    /**
+     * Get the transaction lock time
+     * @returns The transaction lock time
+     */
+    get lockTime(): number;
     /**
      * Parse transaction with wallet keys to identify wallet inputs/outputs
      * @param walletKeys - The wallet keys to use for identification

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

@@ -8,6 +8,33 @@ export class BitGoPsbt {
     constructor(wasm) {
         this.wasm = wasm;
     }
+    /**
+     * Create an empty PSBT for the given network with wallet keys
+     *
+     * The wallet keys are used to set global xpubs in the PSBT, which identifies
+     * the keys that will be used for signing.
+     *
+     * For Zcash networks, use ZcashBitGoPsbt.createEmpty() instead.
+     *
+     * @param network - Network name (utxolib name like "bitcoin" or coin name like "btc")
+     * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
+     * @param options - Optional transaction parameters (version, lockTime)
+     * @returns A new empty BitGoPsbt instance
+     *
+     * @example
+     * ```typescript
+     * // Create empty PSBT with wallet keys
+     * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys);
+     *
+     * // Create with custom version and lockTime
+     * const psbt = BitGoPsbt.createEmpty("bitcoin", walletKeys, { version: 1, lockTime: 500000 });
+     * ```
+     */
+    static createEmpty(network, walletKeys, options) {
+        const keys = RootWalletKeys.from(walletKeys);
+        const wasm = WasmBitGoPsbt.create_empty(network, keys.wasm, options?.version, options?.lockTime);
+        return new BitGoPsbt(wasm);
+    }
     /**
      * Deserialize a PSBT from bytes
      * @param bytes - The PSBT bytes
@@ -18,6 +45,145 @@ export class BitGoPsbt {
         const wasm = WasmBitGoPsbt.from_bytes(bytes, network);
         return new BitGoPsbt(wasm);
     }
+    /**
+     * Add an input to the PSBT
+     *
+     * This adds a transaction input and corresponding PSBT input metadata.
+     * The witness_utxo is automatically populated for modern signing compatibility.
+     *
+     * @param options - Input options (txid, vout, value, sequence)
+     * @param script - Output script of the UTXO being spent
+     * @returns The index of the newly added input
+     *
+     * @example
+     * ```typescript
+     * const inputIndex = psbt.addInput({
+     *   txid: "abc123...",
+     *   vout: 0,
+     *   value: 100000n,
+     * }, outputScript);
+     * ```
+     */
+    addInput(options, script) {
+        return this.wasm.add_input(options.txid, options.vout, options.value, script, options.sequence, options.prevTx);
+    }
+    /**
+     * Add an output to the PSBT
+     *
+     * @param options - Output options (script, value)
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * const outputIndex = psbt.addOutput({
+     *   script: outputScript,
+     *   value: 50000n,
+     * });
+     * ```
+     */
+    addOutput(options) {
+        return this.wasm.add_output(options.script, options.value);
+    }
+    /**
+     * Add a wallet input with full PSBT metadata
+     *
+     * This is a higher-level method that adds an input and populates all required
+     * PSBT fields (scripts, derivation info, etc.) based on the wallet's chain type.
+     *
+     * For p2sh/p2shP2wsh/p2wsh: Sets bip32Derivation, witnessScript, redeemScript (signPath not needed)
+     * For p2tr/p2trMusig2 script path: Sets tapLeafScript, tapBip32Derivation (signPath required)
+     * For p2trMusig2 key path: Sets tapInternalKey, tapMerkleRoot, tapBip32Derivation, musig2 participants (signPath required)
+     *
+     * @param inputOptions - Common input options (txid, vout, value, sequence)
+     * @param walletKeys - The wallet's root keys
+     * @param walletOptions - Wallet-specific options (scriptId, signPath, prevTx)
+     * @returns The index of the newly added input
+     *
+     * @example
+     * ```typescript
+     * // Add a p2shP2wsh input (signPath not needed)
+     * const inputIndex = psbt.addWalletInput(
+     *   { txid: "abc123...", vout: 0, value: 100000n },
+     *   walletKeys,
+     *   { scriptId: { chain: 10, index: 0 } },  // p2shP2wsh external
+     * );
+     *
+     * // Add a p2trMusig2 key path input (signPath required)
+     * const inputIndex = psbt.addWalletInput(
+     *   { txid: "def456...", vout: 1, value: 50000n },
+     *   walletKeys,
+     *   { scriptId: { chain: 40, index: 5 }, signPath: { signer: "user", cosigner: "bitgo" } },
+     * );
+     *
+     * // Add p2trMusig2 with backup key (script path spend)
+     * const inputIndex = psbt.addWalletInput(
+     *   { txid: "ghi789...", vout: 0, value: 75000n },
+     *   walletKeys,
+     *   { scriptId: { chain: 40, index: 3 }, signPath: { signer: "user", cosigner: "backup" } },
+     * );
+     * ```
+     */
+    addWalletInput(inputOptions, walletKeys, walletOptions) {
+        const keys = RootWalletKeys.from(walletKeys);
+        return this.wasm.add_wallet_input(inputOptions.txid, inputOptions.vout, inputOptions.value, keys.wasm, walletOptions.scriptId.chain, walletOptions.scriptId.index, walletOptions.signPath?.signer, walletOptions.signPath?.cosigner, inputOptions.sequence, inputOptions.prevTx);
+    }
+    /**
+     * Add a wallet output with full PSBT metadata
+     *
+     * This creates a verifiable wallet output (typically for change) with all required
+     * PSBT fields (scripts, derivation info) based on the wallet's chain type.
+     *
+     * For p2sh/p2shP2wsh/p2wsh: Sets bip32Derivation, witnessScript, redeemScript
+     * For p2tr/p2trMusig2: Sets tapInternalKey, tapBip32Derivation
+     *
+     * @param walletKeys - The wallet's root keys
+     * @param options - Output options including chain, index, and value
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * // Add a p2shP2wsh change output
+     * const outputIndex = psbt.addWalletOutput(walletKeys, {
+     *   chain: 11,  // p2shP2wsh internal (change)
+     *   index: 0,
+     *   value: 50000n,
+     * });
+     *
+     * // Add a p2trMusig2 change output
+     * const outputIndex = psbt.addWalletOutput(walletKeys, {
+     *   chain: 41,  // p2trMusig2 internal (change)
+     *   index: 5,
+     *   value: 25000n,
+     * });
+     * ```
+     */
+    addWalletOutput(walletKeys, options) {
+        const keys = RootWalletKeys.from(walletKeys);
+        return this.wasm.add_wallet_output(options.chain, options.index, options.value, keys.wasm);
+    }
+    /**
+     * Add a replay protection input to the PSBT
+     *
+     * Replay protection inputs are P2SH-P2PK inputs used on forked networks to prevent
+     * transaction replay attacks. They use a simple pubkey script without wallet derivation.
+     *
+     * @param inputOptions - Common input options (txid, vout, value, sequence)
+     * @param key - ECPair containing the public key for the replay protection input
+     * @returns The index of the newly added input
+     *
+     * @example
+     * ```typescript
+     * // Add a replay protection input using ECPair
+     * const inputIndex = psbt.addReplayProtectionInput(
+     *   { txid: "abc123...", vout: 0, value: 1000n },
+     *   replayProtectionKey,
+     * );
+     * ```
+     */
+    addReplayProtectionInput(inputOptions, key) {
+        const ecpair = ECPair.from(key);
+        return this.wasm.add_replay_protection_input(ecpair.wasm, inputOptions.txid, inputOptions.vout, inputOptions.value, inputOptions.sequence);
+    }
     /**
      * Get the unsigned transaction ID
      * @returns The unsigned transaction ID
@@ -25,6 +191,20 @@ export class BitGoPsbt {
     unsignedTxid() {
         return this.wasm.unsigned_txid();
     }
+    /**
+     * Get the transaction version
+     * @returns The transaction version number
+     */
+    get version() {
+        return this.wasm.version();
+    }
+    /**
+     * Get the transaction lock time
+     * @returns The transaction lock time
+     */
+    get lockTime() {
+        return this.wasm.lock_time();
+    }
     /**
      * Parse transaction with wallet keys to identify wallet inputs/outputs
      * @param walletKeys - The wallet keys to use for identification