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

package/browser/payments/p2pk.d.ts

@@ -1,2 +1,155 @@
-import { P2PKPayment, PaymentOpts } from './types.js';
+import { Network } from '../networks.js';
+import { PublicKey, Script, Signature } from '../types.js';
+import { PaymentType, P2PKPayment, PaymentOpts } from './types.js';
+/**
+ * Pay-to-Public-Key (P2PK) payment class.
+ *
+ * Creates locking scripts of the form: `{pubKey} OP_CHECKSIG`
+ * Spending requires providing: `{signature}`
+ *
+ * @example
+ * ```typescript
+ * import { P2PK } from '@btc-vision/bitcoin';
+ *
+ * // Create from public key
+ * const payment = P2PK.fromPubkey(pubkey);
+ * console.log(payment.output); // scriptPubKey
+ *
+ * // Create from output script
+ * const decoded = P2PK.fromOutput(scriptPubKey);
+ * console.log(decoded.pubkey); // extracted public key
+ *
+ * // Legacy factory function still works
+ * const legacy = p2pk({ pubkey });
+ * ```
+ */
+export declare class P2PK {
+    #private;
+    static readonly NAME: "p2pk";
+    /**
+     * Creates a new P2PK payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.pubkey - The public key (33 or 65 bytes)
+     * @param params.signature - DER-encoded signature
+     * @param params.output - The scriptPubKey
+     * @param params.input - The scriptSig
+     * @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: {
+        pubkey?: Uint8Array | undefined;
+        signature?: Uint8Array | undefined;
+        output?: Uint8Array | undefined;
+        input?: Uint8Array | undefined;
+        network?: Network | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): typeof PaymentType.P2PK;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * The public key (33 or 65 bytes).
+     * Computed lazily from output if not provided directly.
+     */
+    get pubkey(): PublicKey | undefined;
+    /**
+     * The DER-encoded signature.
+     * Computed lazily from input if not provided directly.
+     */
+    get signature(): Signature | undefined;
+    /**
+     * The scriptPubKey: `{pubKey} OP_CHECKSIG`
+     * Computed lazily from pubkey if not provided directly.
+     */
+    get output(): Script | undefined;
+    /**
+     * The scriptSig: `{signature}`
+     * Computed lazily from signature if not provided directly.
+     */
+    get input(): Script | undefined;
+    /**
+     * Witness stack (empty for P2PK as it's not a SegWit type).
+     */
+    get witness(): Uint8Array[] | undefined;
+    /**
+     * Creates a P2PK payment from a public key.
+     *
+     * @param pubkey - The public key (33 or 65 bytes)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PK payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2PK.fromPubkey(pubkey);
+     * const scriptPubKey = payment.output;
+     * ```
+     */
+    static fromPubkey(pubkey: PublicKey, network?: Network): P2PK;
+    /**
+     * Creates a P2PK payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PK payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2PK.fromOutput(scriptPubKey);
+     * const pubkey = payment.pubkey;
+     * ```
+     */
+    static fromOutput(output: Uint8Array, network?: Network): P2PK;
+    /**
+     * Creates a P2PK payment from a signature (for spending).
+     *
+     * @param signature - The DER-encoded signature
+     * @param pubkey - The public key (optional, for validation)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PK payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2PK.fromSignature(signature, pubkey);
+     * const scriptSig = payment.input;
+     * ```
+     */
+    static fromSignature(signature: Signature, pubkey?: PublicKey, network?: Network): P2PK;
+    /**
+     * Converts to a plain P2PKPayment object for backwards compatibility.
+     *
+     * @returns A P2PKPayment object
+     */
+    toPayment(): P2PKPayment;
+}
+/**
+ * Creates a Pay-to-Public-Key (P2PK) payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the P2PK class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The P2PK payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2pk } from '@btc-vision/bitcoin';
+ *
+ * // Create from public key
+ * const payment = p2pk({ pubkey });
+ *
+ * // Create from output
+ * const decoded = p2pk({ output: scriptPubKey });
+ * ```
+ */
 export declare function p2pk(a: Omit<P2PKPayment, 'name'>, opts?: PaymentOpts): P2PKPayment;
+//# sourceMappingURL=p2pk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"p2pk.d.ts","sourceRoot":"","sources":["../../src/payments/p2pk.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAW,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,IAAI;;IAEb,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAoB;IA0BxC;;;;;;;;;;;;;OAaG;gBAEC,MAAM,EAAE;QACJ,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QACnC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAChC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACjC,EACD,IAAI,CAAC,EAAE,WAAW;IAsBtB;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,WAAW,CAAC,IAAI,CAElC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,SAAS,GAAG,SAAS,CAMlC;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,SAAS,GAAG,SAAS,CAMrC;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAM/B;IAED;;;OAGG;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,IAAI;IAI7D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAI9D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAkGvF;;;;OAIG;IACH,SAAS,IAAI,WAAW;CAW3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAkBlF"}

package/browser/payments/p2pkh.d.ts

@@ -1,2 +1,177 @@
-import { P2PKHPayment, PaymentOpts } from './types.js';
+import { Network } from '../networks.js';
+import { Bytes20, PublicKey, Script, Signature } from '../types.js';
+import { PaymentType, P2PKHPayment, PaymentOpts } from './types.js';
+/**
+ * Pay-to-Public-Key-Hash (P2PKH) payment class.
+ *
+ * Creates locking scripts of the form:
+ * `OP_DUP OP_HASH160 {hash160(pubkey)} OP_EQUALVERIFY OP_CHECKSIG`
+ *
+ * Spending requires providing: `{signature} {pubkey}`
+ *
+ * @example
+ * ```typescript
+ * import { P2PKH } from '@btc-vision/bitcoin';
+ *
+ * // Create from public key
+ * const payment = P2PKH.fromPubkey(pubkey);
+ * console.log(payment.address); // Bitcoin address
+ * console.log(payment.output); // scriptPubKey
+ *
+ * // Create from address
+ * const fromAddr = P2PKH.fromAddress('1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2');
+ * console.log(fromAddr.hash); // 20-byte pubkey hash
+ *
+ * // Create from hash
+ * const fromHash = P2PKH.fromHash(hash160);
+ * console.log(fromHash.address);
+ * ```
+ */
+export declare class P2PKH {
+    #private;
+    static readonly NAME: "p2pkh";
+    /**
+     * Creates a new P2PKH payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.address - Base58Check encoded address
+     * @param params.hash - 20-byte pubkey hash (RIPEMD160(SHA256(pubkey)))
+     * @param params.pubkey - The public key (33 or 65 bytes)
+     * @param params.signature - DER-encoded signature
+     * @param params.output - The scriptPubKey
+     * @param params.input - The scriptSig
+     * @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;
+        input?: Uint8Array | undefined;
+        network?: Network | undefined;
+        useHybrid?: boolean | undefined;
+        useUncompressed?: boolean | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): typeof PaymentType.P2PKH;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * Base58Check encoded Bitcoin address.
+     */
+    get address(): string | undefined;
+    /**
+     * 20-byte pubkey hash (RIPEMD160(SHA256(pubkey))).
+     */
+    get hash(): Bytes20 | undefined;
+    /**
+     * The public key (33 or 65 bytes).
+     */
+    get pubkey(): PublicKey | undefined;
+    /**
+     * The DER-encoded signature.
+     */
+    get signature(): Signature | undefined;
+    /**
+     * The scriptPubKey:
+     * `OP_DUP OP_HASH160 {hash} OP_EQUALVERIFY OP_CHECKSIG`
+     */
+    get output(): Script | undefined;
+    /**
+     * The scriptSig: `{signature} {pubkey}`
+     */
+    get input(): Script | undefined;
+    /**
+     * Witness stack (empty for P2PKH as it's not a SegWit type).
+     */
+    get witness(): Uint8Array[] | undefined;
+    /**
+     * Creates a P2PKH payment from a public key.
+     *
+     * @param pubkey - The public key (33 or 65 bytes)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PKH payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2PKH.fromPubkey(pubkey);
+     * const address = payment.address;
+     * ```
+     */
+    static fromPubkey(pubkey: PublicKey, network?: Network): P2PKH;
+    /**
+     * Creates a P2PKH payment from a Base58Check address.
+     *
+     * @param address - Base58Check encoded address
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PKH payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2PKH.fromAddress('1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2');
+     * const hash = payment.hash;
+     * ```
+     */
+    static fromAddress(address: string, network?: Network): P2PKH;
+    /**
+     * Creates a P2PKH payment from a 20-byte pubkey hash.
+     *
+     * @param hash - 20-byte pubkey hash
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PKH payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = P2PKH.fromHash(hash160);
+     * const address = payment.address;
+     * ```
+     */
+    static fromHash(hash: Bytes20, network?: Network): P2PKH;
+    /**
+     * Creates a P2PKH payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2PKH payment instance
+     */
+    static fromOutput(output: Uint8Array, network?: Network): P2PKH;
+    /**
+     * Converts to a plain P2PKHPayment object for backwards compatibility.
+     *
+     * @returns A P2PKHPayment object
+     */
+    toPayment(): P2PKHPayment;
+}
+/**
+ * Creates a Pay-to-Public-Key-Hash (P2PKH) payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the P2PKH class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The P2PKH payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2pkh } from '@btc-vision/bitcoin';
+ *
+ * // Create from public key
+ * const payment = p2pkh({ pubkey });
+ *
+ * // Create from address
+ * const fromAddr = p2pkh({ address: '1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2' });
+ * ```
+ */
 export declare function p2pkh(a: Omit<P2PKHPayment, 'name'>, opts?: PaymentOpts): P2PKHPayment;
+//# sourceMappingURL=p2pkh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"p2pkh.d.ts","sourceRoot":"","sources":["../../src/payments/p2pkh.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EAAW,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,KAAK;;IAEd,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAqB;IA4CzC;;;;;;;;;;;;;;;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,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC9B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAChC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACzC,EACD,IAAI,CAAC,EAAE,WAAW;IA0BtB;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,WAAW,CAAC,KAAK,CAEnC;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;;;OAGG;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,KAAK;IAI9D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAI7D;;;;;;;;;;;;OAYG;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;IAoP/D;;;;OAIG;IACH,SAAS,IAAI,YAAY;CAa5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,CAsBrF"}

package/browser/payments/p2sh.d.ts

@@ -1,2 +1,151 @@
-import { P2SHPayment, PaymentOpts } from './types.js';
+import { Network } from '../networks.js';
+import { Bytes20, Script } from '../types.js';
+import { P2SHPayment, PaymentOpts, ScriptRedeem } from './types.js';
+/**
+ * Pay-to-Script-Hash (P2SH) payment class.
+ *
+ * Creates locking scripts of the form:
+ * `OP_HASH160 {hash160(redeemScript)} OP_EQUAL`
+ *
+ * Spending requires: `{redeemScriptSig...} {redeemScript}`
+ *
+ * @example
+ * ```typescript
+ * import { P2SH, P2MS } from '@btc-vision/bitcoin';
+ *
+ * // Wrap a multisig in P2SH
+ * const multisig = P2MS.fromPubkeys(2, [pubkey1, pubkey2, pubkey3]);
+ * const p2sh = P2SH.fromRedeem({ output: multisig.output });
+ * console.log(p2sh.address); // 3... address
+ *
+ * // Decode an existing output
+ * const decoded = P2SH.fromOutput(scriptPubKey);
+ * console.log(decoded.hash); // 20-byte script hash
+ * ```
+ */
+export declare class P2SH {
+    #private;
+    static readonly NAME: "p2sh";
+    /**
+     * Creates a new P2SH payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.address - Base58Check encoded address (3...)
+     * @param params.hash - 20-byte script hash
+     * @param params.output - The scriptPubKey
+     * @param params.input - The scriptSig
+     * @param params.redeem - The redeem script information
+     * @param params.witness - The witness stack (for wrapped SegWit)
+     * @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;
+        input?: Uint8Array | undefined;
+        redeem?: ScriptRedeem | undefined;
+        witness?: Uint8Array[] | undefined;
+        network?: Network | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): string;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * Base58Check encoded address (3... for mainnet).
+     */
+    get address(): string | undefined;
+    /**
+     * 20-byte script hash (HASH160 of redeem script).
+     */
+    get hash(): Bytes20 | undefined;
+    /**
+     * The scriptPubKey: `OP_HASH160 {hash} OP_EQUAL`
+     */
+    get output(): Script | undefined;
+    /**
+     * The scriptSig: `{redeemScriptSig...} {redeemScript}`
+     */
+    get input(): Script | undefined;
+    /**
+     * The redeem script information.
+     */
+    get redeem(): ScriptRedeem | undefined;
+    /**
+     * The witness stack (for wrapped SegWit).
+     */
+    get witness(): Uint8Array[] | undefined;
+    /**
+     * Creates a P2SH payment from a redeem script.
+     *
+     * @param redeem - The redeem script information
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2SH payment instance
+     *
+     * @example
+     * ```typescript
+     * const p2sh = P2SH.fromRedeem({ output: redeemScript });
+     * ```
+     */
+    static fromRedeem(redeem: ScriptRedeem, network?: Network): P2SH;
+    /**
+     * Creates a P2SH payment from a Base58Check address.
+     *
+     * @param address - Base58Check encoded address
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2SH payment instance
+     */
+    static fromAddress(address: string, network?: Network): P2SH;
+    /**
+     * Creates a P2SH payment from a 20-byte script hash.
+     *
+     * @param hash - 20-byte script hash
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2SH payment instance
+     */
+    static fromHash(hash: Bytes20, network?: Network): P2SH;
+    /**
+     * Creates a P2SH payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2SH payment instance
+     */
+    static fromOutput(output: Uint8Array, network?: Network): P2SH;
+    /**
+     * Converts to a plain P2SHPayment object for backwards compatibility.
+     *
+     * @returns A P2SHPayment object
+     */
+    toPayment(): P2SHPayment;
+}
+/**
+ * Creates a Pay-to-Script-Hash (P2SH) payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the P2SH class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The P2SH payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2sh, p2ms } from '@btc-vision/bitcoin';
+ *
+ * // Wrap a multisig in P2SH
+ * const multisig = p2ms({ m: 2, pubkeys: [pk1, pk2, pk3] });
+ * const payment = p2sh({ redeem: multisig });
+ * ```
+ */
 export declare function p2sh(a: Omit<P2SHPayment, 'name'>, opts?: PaymentOpts): P2SHPayment;
+//# sourceMappingURL=p2sh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"p2sh.d.ts","sourceRoot":"","sources":["../../src/payments/p2sh.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,aAAa,CAAC;AAEjF,OAAO,EAEH,KAAK,WAAW,EAEhB,KAAK,WAAW,EAChB,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,IAAI;;IAEb,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAoB;IA0CxC;;;;;;;;;;;;;;;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,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAC/B,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;IA6BtB;;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,IAAI;IAIhE;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5D;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAIvD;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAgR9D;;;;OAIG;IACH,SAAS,IAAI,WAAW;CAY3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAoBlF"}

package/browser/payments/p2tr.d.ts

@@ -1,2 +1,186 @@
-import { P2TRPayment, PaymentOpts } from './types.js';
+import { Network } from '../networks.js';
+import { Bytes32, Script, SchnorrSignature, Taptree, XOnlyPublicKey } from '../types.js';
+import { PaymentType, P2TRPayment, PaymentOpts, ScriptRedeem } from './types.js';
+/**
+ * Pay-to-Taproot (P2TR) payment class.
+ *
+ * Creates locking scripts of the form: `OP_1 {x-only pubkey}`
+ *
+ * Key-path spending witness: `[signature]`
+ * Script-path spending witness: `[script inputs..., script, control block]`
+ *
+ * @example
+ * ```typescript
+ * import { P2TR } from '@btc-vision/bitcoin';
+ *
+ * // Key-path only (no scripts)
+ * const keyOnly = P2TR.fromInternalPubkey(internalPubkey);
+ * console.log(keyOnly.address); // bc1p... address
+ *
+ * // With script tree
+ * const withScripts = P2TR.fromInternalPubkey(internalPubkey, scriptTree);
+ *
+ * // Decode an existing output
+ * const decoded = P2TR.fromOutput(scriptPubKey);
+ * console.log(decoded.pubkey); // 32-byte x-only pubkey
+ * ```
+ */
+export declare class P2TR {
+    #private;
+    static readonly NAME: "p2tr";
+    /**
+     * Creates a new P2TR payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.address - Bech32m encoded address (bc1p...)
+     * @param params.pubkey - x-only output pubkey (32 bytes)
+     * @param params.internalPubkey - x-only internal pubkey (32 bytes)
+     * @param params.hash - Merkle root (32 bytes, or empty for key-path only)
+     * @param params.scriptTree - Full script tree definition
+     * @param params.signature - Schnorr signature (for key-path spending)
+     * @param params.output - The scriptPubKey
+     * @param params.witness - The witness stack
+     * @param params.redeem - Redeem script for script-path spending
+     * @param params.redeemVersion - Leaf version (defaults to LEAF_VERSION_TAPSCRIPT)
+     * @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;
+        pubkey?: Uint8Array | undefined;
+        internalPubkey?: Uint8Array | undefined;
+        hash?: Uint8Array | undefined;
+        scriptTree?: Taptree | undefined;
+        signature?: Uint8Array | undefined;
+        output?: Uint8Array | undefined;
+        witness?: Uint8Array[] | undefined;
+        redeem?: ScriptRedeem | undefined;
+        redeemVersion?: number | undefined;
+        network?: Network | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): typeof PaymentType.P2TR;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * Bech32m encoded address (bc1p... for mainnet).
+     */
+    get address(): string | undefined;
+    /**
+     * x-only output pubkey (32 bytes).
+     * This is the tweaked pubkey that appears in the output.
+     */
+    get pubkey(): XOnlyPublicKey | undefined;
+    /**
+     * x-only internal pubkey (32 bytes).
+     * This is the untweaked pubkey before adding the merkle root tweak.
+     */
+    get internalPubkey(): XOnlyPublicKey | undefined;
+    /**
+     * Merkle root hash (32 bytes).
+     * Present when a script tree is defined.
+     */
+    get hash(): Bytes32 | undefined;
+    /**
+     * Schnorr signature (for key-path spending).
+     */
+    get signature(): SchnorrSignature | undefined;
+    /**
+     * The scriptPubKey: `OP_1 {32-byte x-only pubkey}`
+     */
+    get output(): Script | undefined;
+    /**
+     * Redeem script information (for script-path spending).
+     */
+    get redeem(): ScriptRedeem | undefined;
+    /**
+     * Leaf version (defaults to LEAF_VERSION_TAPSCRIPT = 0xc0).
+     */
+    get redeemVersion(): number;
+    /**
+     * Witness stack.
+     * Key-path: `[signature]`
+     * Script-path: `[script inputs..., script, control block]`
+     */
+    get witness(): Uint8Array[] | undefined;
+    /**
+     * Creates a P2TR payment from an internal pubkey (key-path only).
+     *
+     * @param internalPubkey - x-only internal pubkey (32 bytes)
+     * @param scriptTree - Optional script tree
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2TR payment instance
+     *
+     * @example
+     * ```typescript
+     * // Key-path only
+     * const p2tr = P2TR.fromInternalPubkey(internalPubkey);
+     *
+     * // With script tree
+     * const withScripts = P2TR.fromInternalPubkey(internalPubkey, scriptTree);
+     * ```
+     */
+    static fromInternalPubkey(internalPubkey: XOnlyPublicKey, scriptTree?: Taptree, network?: Network): P2TR;
+    /**
+     * Creates a P2TR payment from a bech32m address.
+     *
+     * @param address - Bech32m encoded address (bc1p...)
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2TR payment instance
+     */
+    static fromAddress(address: string, network?: Network): P2TR;
+    /**
+     * Creates a P2TR payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2TR payment instance
+     */
+    static fromOutput(output: Uint8Array, network?: Network): P2TR;
+    /**
+     * Creates a P2TR payment from a signature (for key-path spending).
+     *
+     * @param signature - Schnorr signature
+     * @param internalPubkey - x-only internal pubkey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new P2TR payment instance
+     */
+    static fromSignature(signature: SchnorrSignature, internalPubkey?: XOnlyPublicKey, network?: Network): P2TR;
+    /**
+     * Converts to a plain P2TRPayment object for backwards compatibility.
+     *
+     * @returns A P2TRPayment object
+     */
+    toPayment(): P2TRPayment;
+}
+/**
+ * Creates a Pay-to-Taproot (P2TR) payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the P2TR class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The P2TR payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2tr } from '@btc-vision/bitcoin';
+ *
+ * // Key-path only
+ * const payment = p2tr({ internalPubkey });
+ *
+ * // With script tree
+ * const withScripts = p2tr({ internalPubkey, scriptTree });
+ * ```
+ */
 export declare function p2tr(a: Omit<P2TRPayment, 'name'>, opts?: PaymentOpts): P2TRPayment;
+//# sourceMappingURL=p2tr.d.ts.map