@btc-vision/bitcoin 6.5.5 → 7.0.0-alpha.0

package/browser/payments/p2tr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p2tr.d.ts","sourceRoot":"","sources":["../../src/payments/p2tr.ts"],"names":[],"mappings":"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"}

package/browser/payments/p2wpkh.d.ts

@@ -1,2 +1,162 @@
-import { P2WPKHPayment, PaymentOpts } from './types.js';
+import { Network } from '../networks.js';
+import { Bytes20, PublicKey, Script, Signature } from '../types.js';
+import { PaymentType, P2WPKHPayment, PaymentOpts } from './types.js';
+/**
+ * Pay-to-Witness-Public-Key-Hash (P2WPKH) payment class.
+ *
+ * Creates locking scripts of the form: `OP_0 {hash160(pubkey)}`
+ * Spending witness: `[{signature}, {pubkey}]`
+ *
+ * @example
+ * ```typescript
+ * import { P2WPKH } from '@btc-vision/bitcoin';
+ *
+ * // Create from public key
+ * const payment = P2WPKH.fromPubkey(pubkey);
+ * console.log(payment.address); // bc1q... bech32 address
+ * console.log(payment.output); // scriptPubKey
+ *
+ * // Create from bech32 address
+ * const fromAddr = P2WPKH.fromAddress('bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4');
+ * console.log(fromAddr.hash); // 20-byte witness program
+ * ```
+ */
+export declare class P2WPKH {
+    #private;
+    static readonly NAME: "p2wpkh";
+    /**
+     * Creates a new P2WPKH payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.address - Bech32 encoded address
+     * @param params.hash - 20-byte witness program (pubkey hash)
+     * @param params.pubkey - The public key (must be 33 bytes compressed)
+     * @param params.signature - DER-encoded signature
+     * @param params.output - The scriptPubKey
+     * @param params.witness - The witness stack [signature, pubkey]
+     * @param params.network - Network parameters (defaults to mainnet)
+     * @param opts - Payment options
+     * @param opts.validate - Whether to validate inputs (default: true)
+     *
+     * @throws {TypeError} If validation is enabled and data is invalid
+     */
+    constructor(params: {
+        address?: string | undefined;
+        hash?: Uint8Array | undefined;
+        pubkey?: Uint8Array | undefined;
+        signature?: Uint8Array | undefined;
+        output?: Uint8Array | undefined;
+        witness?: Uint8Array[] | undefined;
+        network?: Network | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): typeof PaymentType.P2WPKH;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * Bech32 encoded address (bc1q... for mainnet).
+     */
+    get address(): string | undefined;
+    /**
+     * 20-byte witness program (RIPEMD160(SHA256(pubkey))).
+     */
+    get hash(): Bytes20 | undefined;
+    /**
+     * The public key (33 bytes compressed).
+     */
+    get pubkey(): PublicKey | undefined;
+    /**
+     * The DER-encoded signature.
+     */
+    get signature(): Signature | undefined;
+    /**
+     * The scriptPubKey: `OP_0 {20-byte hash}`
+     */
+    get output(): Script | undefined;
+    /**
+     * The scriptSig (always empty for native SegWit).
+     */
+    get input(): Script | undefined;
+    /**
+     * Witness stack: `[signature, pubkey]`
+     */
+    get witness(): Uint8Array[] | undefined;
+    /**
+     * Creates a P2WPKH payment from a compressed public key.
+     *
+     * @param pubkey - The public key (must be 33 bytes compressed)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WPKH payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2WPKH.fromPubkey(pubkey);
+     * const address = payment.address; // bc1q...
+     * ```
+     */
+    static fromPubkey(pubkey: PublicKey, network?: Network): P2WPKH;
+    /**
+     * Creates a P2WPKH payment from a bech32 address.
+     *
+     * @param address - Bech32 encoded address
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WPKH payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2WPKH.fromAddress('bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4');
+     * const hash = payment.hash;
+     * ```
+     */
+    static fromAddress(address: string, network?: Network): P2WPKH;
+    /**
+     * Creates a P2WPKH payment from a 20-byte witness program.
+     *
+     * @param hash - 20-byte witness program (pubkey hash)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WPKH payment instance
+     */
+    static fromHash(hash: Bytes20, network?: Network): P2WPKH;
+    /**
+     * Creates a P2WPKH payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WPKH payment instance
+     */
+    static fromOutput(output: Uint8Array, network?: Network): P2WPKH;
+    /**
+     * Converts to a plain P2WPKHPayment object for backwards compatibility.
+     *
+     * @returns A P2WPKHPayment object
+     */
+    toPayment(): P2WPKHPayment;
+}
+/**
+ * Creates a Pay-to-Witness-Public-Key-Hash (P2WPKH) payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the P2WPKH class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The P2WPKH payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2wpkh } from '@btc-vision/bitcoin';
+ *
+ * // Create from public key
+ * const payment = p2wpkh({ pubkey });
+ *
+ * // Create from address
+ * const fromAddr = p2wpkh({ address: 'bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4' });
+ * ```
+ */
 export declare function p2wpkh(a: Omit<P2WPKHPayment, 'name'>, opts?: PaymentOpts): P2WPKHPayment;
+//# sourceMappingURL=p2wpkh.d.ts.map

package/browser/payments/p2wpkh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p2wpkh.d.ts","sourceRoot":"","sources":["../../src/payments/p2wpkh.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAK/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,MAAM;;IAEf,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAsB;IAoC1C;;;;;;;;;;;;;;;OAeG;gBAEC,MAAM,EAAE;QACJ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAC9B,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QACnC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAChC,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;QACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACjC,EACD,IAAI,CAAC,EAAE,WAAW;IAwBtB;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,WAAW,CAAC,MAAM,CAEpC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAMhC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,GAAG,SAAS,CAM9B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,GAAG,SAAS,CAMlC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,GAAG,SAAS,CAMrC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAM/B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAM9B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,UAAU,EAAE,GAAG,SAAS,CAMtC;IAID;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM;IAI/D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM;IAI9D;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM;IAIzD;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM;IAuLhE;;;;OAIG;IACH,SAAS,IAAI,aAAa;CAa7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAoBxF"}

package/browser/payments/p2wsh.d.ts

@@ -1,2 +1,147 @@
-import { P2WSHPayment, PaymentOpts } from './types.js';
+import { Network } from '../networks.js';
+import { Bytes32, Script } from '../types.js';
+import { P2WSHPayment, PaymentOpts, ScriptRedeem } from './types.js';
+/**
+ * Pay-to-Witness-Script-Hash (P2WSH) payment class.
+ *
+ * Creates locking scripts of the form: `OP_0 {sha256(redeemScript)}`
+ * Spending witness: `[{redeemScriptSig...}, {redeemScript}]`
+ *
+ * @example
+ * ```typescript
+ * import { P2WSH, P2MS } from '@btc-vision/bitcoin';
+ *
+ * // Wrap a multisig in P2WSH
+ * const multisig = P2MS.fromPubkeys(2, [pubkey1, pubkey2, pubkey3]);
+ * const p2wsh = P2WSH.fromRedeem({ output: multisig.output });
+ * console.log(p2wsh.address); // bc1q... bech32 address
+ *
+ * // Decode an existing output
+ * const decoded = P2WSH.fromOutput(scriptPubKey);
+ * console.log(decoded.hash); // 32-byte witness program
+ * ```
+ */
+export declare class P2WSH {
+    #private;
+    static readonly NAME: "p2wsh";
+    /**
+     * Creates a new P2WSH payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.address - Bech32 encoded address
+     * @param params.hash - 32-byte witness program (SHA256 of script)
+     * @param params.output - The scriptPubKey
+     * @param params.redeem - The redeem script information
+     * @param params.witness - The witness stack
+     * @param params.network - Network parameters (defaults to mainnet)
+     * @param opts - Payment options
+     * @param opts.validate - Whether to validate inputs (default: true)
+     *
+     * @throws {TypeError} If validation is enabled and data is invalid
+     */
+    constructor(params: {
+        address?: string | undefined;
+        hash?: Uint8Array | undefined;
+        output?: Uint8Array | undefined;
+        redeem?: ScriptRedeem | undefined;
+        witness?: Uint8Array[] | undefined;
+        network?: Network | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): string;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * Bech32 encoded address (bc1q... for mainnet).
+     */
+    get address(): string | undefined;
+    /**
+     * 32-byte witness program (SHA256 of redeem script).
+     */
+    get hash(): Bytes32 | undefined;
+    /**
+     * The scriptPubKey: `OP_0 {32-byte hash}`
+     */
+    get output(): Script | undefined;
+    /**
+     * The scriptSig (always empty for native SegWit).
+     */
+    get input(): Script | undefined;
+    /**
+     * The redeem script information.
+     */
+    get redeem(): ScriptRedeem | undefined;
+    /**
+     * Witness stack: `[{scriptSig...}, {redeemScript}]`
+     */
+    get witness(): Uint8Array[] | undefined;
+    /**
+     * Creates a P2WSH payment from a redeem script.
+     *
+     * @param redeem - The redeem script information
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WSH payment instance
+     *
+     * @example
+     * ```typescript
+     * const p2wsh = P2WSH.fromRedeem({ output: redeemScript });
+     * ```
+     */
+    static fromRedeem(redeem: ScriptRedeem, network?: Network): P2WSH;
+    /**
+     * Creates a P2WSH payment from a bech32 address.
+     *
+     * @param address - Bech32 encoded address
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WSH payment instance
+     */
+    static fromAddress(address: string, network?: Network): P2WSH;
+    /**
+     * Creates a P2WSH payment from a 32-byte witness program.
+     *
+     * @param hash - 32-byte witness program (SHA256 of script)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WSH payment instance
+     */
+    static fromHash(hash: Bytes32, network?: Network): P2WSH;
+    /**
+     * Creates a P2WSH payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2WSH payment instance
+     */
+    static fromOutput(output: Uint8Array, network?: Network): P2WSH;
+    /**
+     * Converts to a plain P2WSHPayment object for backwards compatibility.
+     *
+     * @returns A P2WSHPayment object
+     */
+    toPayment(): P2WSHPayment;
+}
+/**
+ * Creates a Pay-to-Witness-Script-Hash (P2WSH) payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the P2WSH class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The P2WSH payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2wsh, p2ms } from '@btc-vision/bitcoin';
+ *
+ * // Wrap a multisig in P2WSH
+ * const multisig = p2ms({ m: 2, pubkeys: [pk1, pk2, pk3] });
+ * const payment = p2wsh({ redeem: multisig });
+ * ```
+ */
 export declare function p2wsh(a: Omit<P2WSHPayment, 'name'>, opts?: PaymentOpts): P2WSHPayment;
+//# sourceMappingURL=p2wsh.d.ts.map

package/browser/payments/p2wsh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p2wsh.d.ts","sourceRoot":"","sources":["../../src/payments/p2wsh.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAejG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,KAAK;;IAEd,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAqB;IAqCzC;;;;;;;;;;;;;;OAcG;gBAEC,MAAM,EAAE;QACJ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAC9B,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;QAClC,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;QACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACjC,EACD,IAAI,CAAC,EAAE,WAAW;IA4BtB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAMjB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAMhC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,GAAG,SAAS,CAM9B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAM/B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAM9B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,YAAY,GAAG,SAAS,CAMrC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,UAAU,EAAE,GAAG,SAAS,CAMtC;IAID;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAIjE;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAI7D;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAIxD;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAuP/D;;;;OAIG;IACH,SAAS,IAAI,YAAY;CAe5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,CAqBrF"}

package/browser/payments/types.d.ts

@@ -1,93 +1,123 @@
 import { Network } from '../networks.js';
-import { Taptree } from '../types.js';
-export declare enum PaymentType {
-    P2PK = "p2pk",
-    P2PKH = "p2pkh",
-    P2SH = "p2sh",
-    P2MS = "p2ms",
-    P2WPKH = "p2wpkh",
-    P2WSH = "p2wsh",
-    P2TR = "p2tr",
-    P2OP = "p2op",
-    Embed = "embed",
-    ScriptRedeem = "scriptRedeem"
-}
+import { Bytes20, Bytes32, PublicKey, Script, Signature, SchnorrSignature, Taptree, XOnlyPublicKey } from '../types.js';
+export declare const PaymentType: {
+    readonly P2PK: "p2pk";
+    readonly P2PKH: "p2pkh";
+    readonly P2SH: "p2sh";
+    readonly P2MS: "p2ms";
+    readonly P2WPKH: "p2wpkh";
+    readonly P2WSH: "p2wsh";
+    readonly P2TR: "p2tr";
+    readonly P2OP: "p2op";
+    readonly Embed: "embed";
+    readonly ScriptRedeem: "scriptRedeem";
+};
+export type PaymentType = (typeof PaymentType)[keyof typeof PaymentType];
 export interface BasePayment {
-    name?: PaymentType;
-    network?: Network;
-    output?: Buffer;
-    input?: Buffer;
-    address?: string;
-    witness?: Buffer[];
-    redeem?: ScriptRedeem;
-    useHybrid?: boolean;
-    useUncompressed?: boolean;
+    /** Convenience label, also the discriminant for the union. Can be dynamic for nested types. */
+    readonly name?: string | undefined;
+    /** Network parameters (mainnet if omitted). */
+    readonly network?: Network | undefined;
+    /** Fully-assembled scriptPubKey (if already known). */
+    readonly output?: Script | undefined;
+    /** Raw scriptSig (legacy script types only). */
+    readonly input?: Script | undefined;
+    /** Human-readable address (if already known). */
+    readonly address?: string | undefined;
+    /** Segwit stack (empty for legacy). */
+    readonly witness?: Uint8Array[] | undefined;
+    /** Script template for P2SH, P2WSH, P2TR, etc. */
+    readonly redeem?: ScriptRedeem | undefined;
+    /** Non-standard options used by some wallets. */
+    readonly useHybrid?: boolean | undefined;
+    readonly useUncompressed?: boolean | undefined;
 }
+/** Helper used by redeeming script-template outputs (P2SH, P2WSH). */
 export interface ScriptRedeem extends BasePayment {
-    output?: Buffer;
-    redeemVersion?: number;
-    network?: Network;
+    readonly output?: Script | undefined;
+    readonly redeemVersion?: number | undefined;
+    readonly network?: Network | undefined;
 }
 export interface P2PKPayment extends BasePayment {
-    name: PaymentType.P2PK;
-    pubkey?: Buffer;
-    signature?: Buffer;
+    readonly name: typeof PaymentType.P2PK;
+    readonly pubkey?: PublicKey | undefined;
+    /** DER-encoded sig – empty until signed. */
+    readonly signature?: Signature | undefined;
 }
 export interface P2PKHPayment extends BasePayment {
-    name: PaymentType.P2PKH;
-    hash?: Buffer;
-    pubkey?: Buffer;
-    signature?: Buffer;
+    readonly name: typeof PaymentType.P2PKH;
+    /** RIPEMD-160(SHA-256(pubkey)) – 20 bytes. */
+    readonly hash?: Bytes20 | undefined;
+    readonly pubkey?: PublicKey | undefined;
+    readonly signature?: Signature | undefined;
 }
 export interface P2SHPayment extends BasePayment {
-    name: PaymentType.P2SH;
-    hash?: Buffer;
-    signatures?: Buffer[];
+    /** Dynamic name like 'p2sh' or 'p2sh-p2wpkh' for nested types */
+    readonly name: string;
+    /** Hash160 of a redeem script. */
+    readonly hash?: Bytes20 | undefined;
+    /** The entire signature stack when spending a P2SH (non-segwit). */
+    readonly signatures?: Uint8Array[] | undefined;
 }
 export interface P2MSPayment extends BasePayment {
-    name: PaymentType.P2MS;
-    m?: number;
-    n?: number;
-    pubkeys?: Buffer[];
-    signatures?: Buffer[];
+    /** Dynamic name like 'p2ms' or 'p2ms(2 of 3)' with M-of-N parameters */
+    readonly name: string;
+    /** M-of-N parameters. */
+    readonly m?: number | undefined;
+    readonly n?: number | undefined;
+    readonly pubkeys?: PublicKey[] | undefined;
+    readonly signatures?: Signature[] | undefined;
 }
 export interface P2WPKHPayment extends BasePayment {
-    name: PaymentType.P2WPKH;
-    hash?: Buffer;
-    pubkey?: Buffer;
-    signature?: Buffer;
+    readonly name: typeof PaymentType.P2WPKH;
+    /** 20-byte witness program. */
+    readonly hash?: Bytes20 | undefined;
+    readonly pubkey?: PublicKey | undefined;
+    readonly signature?: Signature | undefined;
 }
 export interface P2WSHPayment extends BasePayment {
-    name: PaymentType.P2WSH;
-    hash?: Buffer;
-    redeem?: ScriptRedeem;
+    /** Dynamic name like 'p2wsh' or 'p2wsh-p2pk' for nested types */
+    readonly name: string;
+    /** 32-byte witness program. */
+    readonly hash?: Bytes32 | undefined;
+    readonly redeem?: ScriptRedeem | undefined;
 }
 export interface P2TRPayment extends BasePayment {
-    name: PaymentType.P2TR;
-    pubkey?: Buffer;
-    internalPubkey?: Buffer;
-    hash?: Buffer;
-    scriptTree?: Taptree;
-    signature?: Buffer;
-    redeemVersion?: number;
-    redeem?: ScriptRedeem;
+    readonly name: typeof PaymentType.P2TR;
+    /** x-only pubkey that commits to the tree. */
+    readonly pubkey?: XOnlyPublicKey | undefined;
+    /** Internal (untweaked) x-only pubkey. */
+    readonly internalPubkey?: XOnlyPublicKey | undefined;
+    /** Merkle-root tweak, present when a script path exists. */
+    readonly hash?: Bytes32 | undefined;
+    /** Full taptree description (optional, dev-side). */
+    readonly scriptTree?: Taptree | undefined;
+    /** Key-path sig or leading stack elem. */
+    readonly signature?: SchnorrSignature | undefined;
+    readonly redeemVersion?: number | undefined;
+    readonly redeem?: ScriptRedeem | undefined;
 }
 export interface P2OPPayment extends BasePayment {
-    name: PaymentType.P2OP;
-    program?: Buffer;
-    deploymentVersion: number | undefined;
-    hash160?: Buffer;
+    readonly name: typeof PaymentType.P2OP;
+    /** <deploymentVersion || HASH160(payload)> (2–40 bytes). */
+    readonly program?: Uint8Array | undefined;
+    readonly deploymentVersion?: number | undefined;
+    /** Convenience slice of `program` (20 bytes for current spec). */
+    readonly hash160?: Bytes20 | undefined;
 }
 export interface P2OPPaymentParams extends Omit<P2OPPayment, 'name' | 'deploymentVersion'> {
-    deploymentVersion?: number;
+    readonly deploymentVersion?: number | undefined;
 }
+/** OP_RETURN data-carrying output */
 export interface EmbedPayment extends BasePayment {
-    name: PaymentType.Embed;
-    data: Buffer[];
+    readonly name: typeof PaymentType.Embed;
+    /** Raw pushed chunks after OP_RETURN. */
+    readonly data: Uint8Array[];
 }
 export type Payment = P2PKPayment | P2PKHPayment | P2SHPayment | P2MSPayment | P2WPKHPayment | P2WSHPayment | P2TRPayment | P2OPPayment | EmbedPayment | ScriptRedeem;
 export type PaymentCreator = <T extends BasePayment>(a: T, opts?: PaymentOpts) => T;
 export interface PaymentOpts {
-    validate?: boolean;
-    allowIncomplete?: boolean;
+    readonly validate?: boolean;
+    readonly allowIncomplete?: boolean;
 }
+//# sourceMappingURL=types.d.ts.map

package/browser/payments/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/payments/types.ts"],"names":[],"mappings":"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"}

package/browser/psbt/bip371.d.ts

@@ -1,19 +1,45 @@
-import { PsbtInput, PsbtOutput, TapLeaf } from 'bip174/src/lib/interfaces.js';
+import { PsbtInput, PsbtOutput, TapLeaf } from 'bip174';
 import { Taptree } from '../types.js';
 interface PsbtOutputWithScript extends PsbtOutput {
-    script?: Buffer;
+    script?: Uint8Array;
 }
-export declare function tapScriptFinalizer(inputIndex: number, input: PsbtInput, tapLeafHashToFinalize?: Buffer): {
-    finalScriptWitness: Buffer | undefined;
+/**
+ * Default tapscript finalizer. It searches for the `tapLeafHashToFinalize` if provided.
+ * Otherwise it will search for the tapleaf that has at least one signature and has the shortest path.
+ * @param inputIndex the position of the PSBT input.
+ * @param input the PSBT input.
+ * @param tapLeafHashToFinalize optional, if provided the finalizer will search for a tapleaf that has this hash
+ *                              and will try to build the finalScriptWitness.
+ * @returns the finalScriptWitness or throws an exception if no tapleaf found.
+ */
+export declare function tapScriptFinalizer(inputIndex: number, input: PsbtInput, tapLeafHashToFinalize?: Uint8Array): {
+    finalScriptWitness: Uint8Array | undefined;
 };
-export declare function serializeTaprootSignature(sig: Buffer, sighashType?: number): Buffer;
+export declare function serializeTaprootSignature(sig: Uint8Array, sighashType?: number): Uint8Array;
 export declare function isTaprootInput(input: PsbtInput): boolean;
-export declare function isTaprootOutput(output: PsbtOutput, script?: Buffer): boolean;
+export declare function isTaprootOutput(output: PsbtOutput, script?: Uint8Array): boolean;
 export declare function checkTaprootInputFields(inputData: PsbtInput, newInputData: PsbtInput, action: string): void;
 export declare function checkTaprootOutputFields(outputData: PsbtOutputWithScript, newOutputData: PsbtOutput, action: string): void;
-export declare function tweakInternalPubKey(inputIndex: number, input: PsbtInput): Buffer;
+export declare function tweakInternalPubKey(inputIndex: number, input: PsbtInput): Uint8Array;
+/**
+ * Convert a binary tree to a BIP371 type list. Each element of the list is (according to BIP371):
+ * One or more tuples representing the depth, leaf version, and script for a leaf in the Taproot tree,
+ * allowing the entire tree to be reconstructed. The tuples must be in depth first search order so that
+ * the tree is correctly reconstructed.
+ * @param tree the binary tap tree
+ * @returns a list of BIP 371 tapleaves
+ */
 export declare function tapTreeToList(tree: Taptree): TapLeaf[];
+/**
+ * Convert a BIP371 TapLeaf list to a TapTree (binary).
+ * @param leaves a list of tapleaves where each element of the list is (according to BIP371):
+ * One or more tuples representing the depth, leaf version, and script for a leaf in the Taproot tree,
+ * allowing the entire tree to be reconstructed. The tuples must be in depth first search order so that
+ * the tree is correctly reconstructed.
+ * @returns the corresponding taptree, or throws an exception if the tree cannot be reconstructed
+ */
 export declare function tapTreeFromList(leaves?: TapLeaf[]): Taptree;
 export declare function checkTaprootInputForSigs(input: PsbtInput, action: string): boolean;
-export declare function getTapKeySigFromWitness(finalScriptWitness?: Buffer): Buffer | undefined;
+export declare function getTapKeySigFromWitness(finalScriptWitness?: Uint8Array): Uint8Array | undefined;
 export {};
+//# sourceMappingURL=bip371.d.ts.map

package/browser/psbt/bip371.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bip371.d.ts","sourceRoot":"","sources":["../../src/psbt/bip371.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,UAAU,EAEV,OAAO,EAIV,MAAM,QAAQ,CAAC;AAWhB,OAAO,KAAK,EAAW,OAAO,EAA2B,MAAM,aAAa,CAAC;AAS7E,UAAU,oBAAqB,SAAQ,UAAU;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,qBAAqB,CAAC,EAAE,UAAU,GACnC;IACC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9C,CAYA;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAI3F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAWxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAUhF;AAED,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,SAAS,EACvB,MAAM,EAAE,MAAM,GACf,IAAI,CAGN;AAED,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,oBAAoB,EAChC,aAAa,EAAE,UAAU,EACzB,MAAM,EAAE,MAAM,GACf,IAAI,CAGN;AA6BD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAgBpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAQ/D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGlF;AA2BD,wBAAgB,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAM/F"}