@scure/btc-signer 2.0.0 → 2.2.0

package/payment.d.ts

@@ -2,13 +2,20 @@ import { type Coder } from '@scure/base';
 import * as P from 'micro-packed';
 import { type TransactionInput } from './psbt.ts';
 import { type ScriptType } from './script.ts';
-import { type BTC_NETWORK, type Bytes } from './utils.ts';
+import { type BTC_NETWORK, type Bytes, type TArg, type TRet } from './utils.ts';
+/** Common shape returned by payment helper constructors. */
 export type P2Ret = {
+    /** Payment-script tag such as `pkh`, `wpkh`, or `tr`. */
     type: string;
+    /** Serialized output script for the payment descriptor. */
     script: Bytes;
+    /** Encoded address when the script has a standard address form. */
     address?: string;
+    /** Redeem script for wrapped script-hash descriptors. */
     redeemScript?: Bytes;
+    /** Witness script for SegWit script-hash descriptors. */
     witnessScript?: Bytes;
+    /** Hash committed by the output script when applicable. */
     hash?: Bytes;
 };
 type OutP2AType = {
@@ -19,6 +26,7 @@ type OutPKType = {
     type: 'pk';
     pubkey: Bytes;
 };
+/** Optional parsed script result used by output-script coders. */
 export type OptScript = ScriptType | undefined;
 type OutPKHType = {
     type: 'pkh';
@@ -65,60 +73,208 @@ type FinalizeSignature = [{
 type CustomScriptOut = {
     type: string;
 } & Record<string, any>;
+/** Custom taproot script coder/finalizer hook. */
 export type CustomScript = Coder<OptScript, CustomScriptOut | undefined> & {
     finalizeTaproot?: (script: Bytes, parsed: CustomScriptOut, signatures: FinalizeSignature[]) => Bytes[] | undefined;
 };
-export declare const OutScript: P.CoderType<NonNullable<OutP2AType | OutPKType | OutPKHType | OutSHType | OutWSHType | OutWPKHType | OutMSType | OutTRType | OutTRNSType | OutTRMSType | OutUnknownType | undefined>>;
+/**
+ * Coder for recognized Bitcoin output scripts.
+ * @example
+ * Decode a serialized output script back into the tagged payment descriptor.
+ * ```ts
+ * import { OutScript, p2wpkh } from '@scure/btc-signer/payment.js';
+ * import { pubECDSA, randomPrivateKeyBytes } from '@scure/btc-signer/utils.js';
+ * const pay = p2wpkh(pubECDSA(randomPrivateKeyBytes()));
+ * OutScript.decode(pay.script);
+ * ```
+ */
+export declare const OutScript: TRet<P.CoderType<NonNullable<OutP2AType | OutPKType | OutPKHType | OutSHType | OutWSHType | OutWPKHType | OutMSType | OutTRType | OutTRNSType | OutTRMSType | OutUnknownType | undefined>>>;
+/** Type of the output-script coder. */
 export type OutScriptType = typeof OutScript;
-export declare function checkScript(script?: Bytes, redeemScript?: Bytes, witnessScript?: Bytes): void;
+type OutScriptValue = ReturnType<OutScriptType['decode']> | undefined;
+/**
+ * Validates that nested redeem and witness scripts match their wrappers.
+ * @param script - top-level output script
+ * @param redeemScript - optional redeem script for P2SH wrappers
+ * @param witnessScript - optional witness script for P2WSH wrappers
+ * @throws If the script nesting is invalid or unsupported. {@link Error}
+ * @example
+ * Verify that wrapped scripts and hashes still match after custom edits.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { checkScript, p2pkh, p2sh } from '@scure/btc-signer/payment.js';
+ * const wrapped = p2sh(
+ *   p2pkh(hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798'))
+ * );
+ * checkScript(wrapped.script, wrapped.redeemScript);
+ * ```
+ */
+export declare function checkScript(script?: TArg<Bytes>, redeemScript?: TArg<Bytes>, witnessScript?: TArg<Bytes>): void;
 type Extends<T, U> = T extends U ? T : never;
+/** Pay-to-public-key output descriptor. */
 export type P2PK = {
+    /** Payment-script tag for pay-to-public-key outputs. */
     type: 'pk';
-    script: Bytes;
+    /** Serialized `pubkey CHECKSIG` script. */
+    script: TRet<Bytes>;
 };
-export declare const p2pk: (pubkey: Bytes, _network?: BTC_NETWORK) => Extends<P2PK, P2Ret>;
+/**
+ * Builds a pay-to-public-key script.
+ * @param pubkey - compressed or uncompressed ECDSA public key
+ * @param _network - unused network placeholder for API consistency
+ * @returns P2PK descriptor.
+ * @throws If the public key cannot be encoded as a P2PK output. {@link Error}
+ * @example
+ * Build a bare pay-to-public-key output.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2pk } from '@scure/btc-signer/payment.js';
+ * p2pk(hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798'));
+ * ```
+ */
+export declare const p2pk: (pubkey: TArg<Bytes>, _network?: BTC_NETWORK) => TRet<Extends<P2PK, P2Ret>>;
+/** Pay-to-public-key-hash output descriptor. */
 export type P2PKH = {
+    /** Payment-script tag for pay-to-public-key-hash outputs. */
     type: 'pkh';
-    script: Bytes;
+    /** Serialized P2PKH script. */
+    script: TRet<Bytes>;
+    /** Base58Check address for the descriptor. */
     address: string;
-    hash: Bytes;
+    /** HASH160 committed by the script. */
+    hash: TRet<Bytes>;
 };
-export declare const p2pkh: (publicKey: Bytes, network?: BTC_NETWORK) => Extends<P2PKH, P2Ret>;
+/**
+ * Builds a P2PKH output from a public key.
+ * @param publicKey - compressed or uncompressed ECDSA public key bytes; HASH160 commits to the exact encoding
+ * @param network - address network parameters
+ * @returns P2PKH descriptor.
+ * @throws If the public key cannot be encoded as a P2PKH output. {@link Error}
+ * @example
+ * Build a classic pay-to-public-key-hash output.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2pkh } from '@scure/btc-signer/payment.js';
+ * p2pkh(hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798'));
+ * ```
+ */
+export declare const p2pkh: (publicKey: TArg<Bytes>, network?: BTC_NETWORK) => TRet<Extends<P2PKH, P2Ret>>;
+/** Shared fields for pay-to-script-hash outputs. */
 export type P2SHBase = {
+    /** Payment-script tag for pay-to-script-hash outputs. */
     type: 'sh';
-    redeemScript: Bytes;
-    script: Bytes;
+    /** Child script wrapped by the P2SH output. */
+    redeemScript: TRet<Bytes>;
+    /** Serialized P2SH script. */
+    script: TRet<Bytes>;
+    /** Base58Check address for the descriptor. */
     address: string;
-    hash: Bytes;
+    /** HASH160 committed by the script. */
+    hash: TRet<Bytes>;
 };
+/** P2SH descriptor with an embedded witness script. */
 export type P2SHWithWitness = P2SHBase & {
-    witnessScript: Bytes;
+    witnessScript: TRet<Bytes>;
 };
+/** P2SH descriptor without an embedded witness script. */
 export type P2SHWithoutWitness = Omit<P2SHBase, 'witnessScript'>;
+/** Conditional P2SH return type for wrapped scripts. */
 export type P2SHReturn<T extends P2Ret> = T extends {
     witnessScript: Bytes;
 } ? P2SHWithWitness : P2SHWithoutWitness;
-export declare const p2sh: <T extends P2Ret>(child: T, network?: BTC_NETWORK) => Extends<P2SHReturn<T>, P2Ret>;
+/**
+ * Wraps a child script inside P2SH.
+ * @param child - child payment descriptor to wrap
+ * @param network - address network parameters
+ * @returns P2SH descriptor preserving witness metadata when present.
+ * @throws If the wrapped script combination is invalid or unsupported. {@link Error}
+ * @example
+ * Wrap a child script in P2SH so it gets a base58 address form.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2pk, p2sh, p2wsh } from '@scure/btc-signer/payment.js';
+ * p2sh(p2wsh(p2pk(hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798'))));
+ * ```
+ */
+export declare const p2sh: <T extends P2Ret>(child: TArg<T>, network?: BTC_NETWORK) => TRet<Extends<P2SHReturn<T>, P2Ret>>;
+/** Pay-to-witness-script-hash descriptor. */
 export type P2WSH = {
+    /** Payment-script tag for pay-to-witness-script-hash outputs. */
     type: 'wsh';
-    witnessScript: Bytes;
-    script: Bytes;
+    /** Child script committed by the witness program. */
+    witnessScript: TRet<Bytes>;
+    /** Serialized P2WSH script. */
+    script: TRet<Bytes>;
+    /** Bech32 address for the descriptor. */
     address: string;
-    hash: Bytes;
+    /** SHA256 committed by the witness program. */
+    hash: TRet<Bytes>;
 };
-export declare const p2wsh: (child: P2Ret, network?: BTC_NETWORK) => Extends<P2WSH, P2Ret>;
+/**
+ * Wraps a child script inside native SegWit P2WSH.
+ * @param child - child payment descriptor to wrap
+ * @param network - address network parameters
+ * @returns P2WSH descriptor.
+ * @throws If the wrapped script combination is invalid or unsupported. {@link Error}
+ * @example
+ * Wrap a child script in native SegWit P2WSH.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2pk, p2wsh } from '@scure/btc-signer/payment.js';
+ * p2wsh(p2pk(hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798')));
+ * ```
+ */
+export declare const p2wsh: (child: TArg<P2Ret>, network?: BTC_NETWORK) => TRet<Extends<P2WSH, P2Ret>>;
+/** Pay-to-witness-public-key-hash descriptor. */
 export type P2WPKH = {
+    /** Payment-script tag for pay-to-witness-public-key-hash outputs. */
     type: 'wpkh';
-    script: Bytes;
+    /** Serialized P2WPKH script. */
+    script: TRet<Bytes>;
+    /** Bech32 address for the descriptor. */
     address: string;
-    hash: Bytes;
+    /** HASH160 committed by the witness program. */
+    hash: TRet<Bytes>;
 };
-export declare const p2wpkh: (publicKey: Bytes, network?: BTC_NETWORK) => Extends<P2WPKH, P2Ret>;
+/**
+ * Builds a native SegWit P2WPKH output from a public key.
+ * @param publicKey - compressed ECDSA public key
+ * @param network - address network parameters
+ * @returns P2WPKH descriptor.
+ * @throws If the public key cannot be encoded as a P2WPKH output. {@link Error}
+ * @example
+ * Build a native SegWit pay-to-public-key-hash output.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2wpkh } from '@scure/btc-signer/payment.js';
+ * p2wpkh(hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798'));
+ * ```
+ */
+export declare const p2wpkh: (publicKey: TArg<Bytes>, network?: BTC_NETWORK) => TRet<Extends<P2WPKH, P2Ret>>;
+/** Bare multisig output descriptor. */
 export type P2MS = {
+    /** Payment-script tag for bare multisig outputs. */
     type: 'ms';
-    script: Bytes;
+    /** Serialized bare multisig script. */
+    script: TRet<Bytes>;
 };
-export declare const p2ms: (m: number, pubkeys: Bytes[], allowSamePubkeys?: boolean) => Extends<P2MS, P2Ret>;
+/**
+ * Builds a bare multisig script.
+ * @param m - number of required signatures
+ * @param pubkeys - participating public keys
+ * @param allowSamePubkeys - whether duplicate keys are allowed
+ * @returns P2MS descriptor.
+ * @throws If the multisig parameters are invalid. {@link Error}
+ * @example
+ * Build a bare multisig output script.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2ms } from '@scure/btc-signer/payment.js';
+ * p2ms(1, [hex.decode('0279be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798')], true);
+ * ```
+ */
+export declare const p2ms: (m: number, pubkeys: TArg<Bytes[]>, allowSamePubkeys?: boolean) => TRet<Extends<P2MS, P2Ret>>;
+/** Internal taproot hash tree without merkle paths. */
 export type HashedTree = {
     type: 'leaf';
     version?: number;
@@ -130,33 +286,66 @@ export type HashedTree = {
     right: HashedTree;
     hash: Bytes;
 };
+/** Taproot key-path descriptor. */
 export type P2TR = {
+    /** Payment-script tag for taproot outputs. */
     type: 'tr';
+    /** Serialized v1 witness-program script. */
     script: Bytes;
+    /** Bech32m address for the descriptor. */
     address: string;
+    /** Tweaked x-only output key committed by the address and script. */
     tweakedPubkey: Bytes;
+    /** Internal x-only taproot key before tweaking. */
     tapInternalKey: Bytes;
 };
+/** Taproot descriptor with a script tree attached. */
 export type P2TR_TREE = P2TR & {
     tapMerkleRoot: Bytes;
     tapLeafScript: TransactionInput['tapLeafScript'];
     leaves: TaprootLeaf[];
 };
+/** Node accepted when constructing a taproot script tree. */
 export type TaprootNode = {
     script: Bytes | string;
     leafVersion?: number;
     weight?: number;
 } & Partial<P2TR_TREE>;
+/** Recursive taproot tree input. */
 export type TaprootScriptTree = TaprootNode | TaprootScriptTree[];
+/** Flat list of weighted taproot leaves. */
 export type TaprootScriptList = TaprootNode[];
-export declare function taprootListToTree(taprootList: TaprootScriptList): TaprootScriptTree;
+/**
+ * Converts a flat list of weighted leaves into a binary taproot tree.
+ * @param taprootList - weighted leaves to arrange
+ * @returns Binary taproot script tree.
+ * @throws If the list is empty and cannot describe any tree. {@link Error}
+ * @example
+ * Start from a flat weighted list, then let the helper build the binary tree shape.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2tr_pk, taprootListToTree } from '@scure/btc-signer/payment.js';
+ * taprootListToTree([
+ *   p2tr_pk(hex.decode('f9308a019258c31049344f85f89d5229b531c845836f99b08601f113bce036f9')),
+ *   p2tr_pk(hex.decode('dff1d77f2a671c5f36183726db2341be58feae1da2deced843240f7b502ba659')),
+ * ]);
+ * ```
+ */
+export declare function taprootListToTree(taprootList: TArg<TaprootScriptList>): TRet<TaprootScriptTree>;
+/** Taproot leaf with its merkle path. */
 export type TaprootLeaf = {
+    /** Leaf marker inside the annotated taproot tree. */
     type: 'leaf';
+    /** Tapleaf version committed by the merkle tree. */
     version?: number;
+    /** Serialized leaf script. */
     script: Bytes;
+    /** Tagged tapleaf hash for the script and version. */
     hash: Bytes;
+    /** Merkle path hashes required for script-path spending. */
     path: Bytes[];
 };
+/** Internal taproot tree annotated with merkle paths. */
 export type HashedTreeWithPath = TaprootLeaf | {
     type: 'branch';
     left: HashedTreeWithPath;
@@ -164,37 +353,217 @@ export type HashedTreeWithPath = TaprootLeaf | {
     hash: Bytes;
     path: Bytes[];
 };
+/** Default tapleaf version used by taproot script-path outputs before adding the parity bit. */
 export declare const TAP_LEAF_VERSION = 192;
-export declare const tapLeafHash: (script: Bytes, version?: number) => Bytes;
+/**
+ * Computes the tagged hash of a tapleaf script.
+ * @param script - tapleaf script bytes
+ * @param version - base even tapleaf version byte (for tapscript, `0xc0`)
+ * @returns Tapleaf hash.
+ * @throws If the tapleaf version is not a valid even one-byte version.
+ * {@link Error}
+ * @example
+ * Hash a finalized tapscript leaf before placing it into a Merkle tree.
+ * ```ts
+ * tapLeafHash(new Uint8Array([0x51]));
+ * ```
+ */
+export declare const tapLeafHash: (script: TArg<Bytes>, version?: number) => TRet<Bytes>;
+/** Conditional taproot return type for key-only or tree-backed outputs. */
 export type P2TRRet<T> = T extends TaprootScriptTree ? P2TR_TREE : P2TR;
-export declare function p2tr(internalPubKey: Bytes | string, tree?: undefined, network?: BTC_NETWORK, allowUnknownOutputs?: boolean, customScripts?: CustomScript[]): Extends<P2TR, P2Ret>;
-export declare function p2tr(internalPubKey: Bytes | string, tree: TaprootScriptTree, network?: BTC_NETWORK, allowUnknownOutputs?: boolean, customScripts?: CustomScript[]): Extends<P2TR_TREE, P2Ret>;
+/**
+ * Builds a taproot output from an internal key and optional script tree.
+ * @param internalPubKey - x-only internal public key, hex string, or `undefined` for script-only outputs
+ * @param tree - optional taproot script tree
+ * @param network - address network parameters
+ * @param allowUnknownOutputs - whether unknown leaf scripts are allowed
+ * @param customScripts - optional custom script codecs for taproot leaves
+ * @returns Taproot descriptor with optional script-path metadata.
+ * @throws If the internal key or taproot script tree is invalid. {@link Error}
+ * @example
+ * Combine script leaves into a final taproot output descriptor and address.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2tr, p2tr_pk } from '@scure/btc-signer/payment.js';
+ * p2tr(
+ *   undefined,
+ *   [p2tr_pk(hex.decode('f9308a019258c31049344f85f89d5229b531c845836f99b08601f113bce036f9'))]
+ * );
+ * ```
+ */
+export declare function p2tr(internalPubKey: TArg<Bytes | string>, tree?: undefined, network?: BTC_NETWORK, allowUnknownOutputs?: boolean, customScripts?: TArg<CustomScript[]>): TRet<Extends<P2TR, P2Ret>>;
+export declare function p2tr(internalPubKey: TArg<Bytes | string | undefined>, tree: TArg<TaprootScriptTree>, network?: BTC_NETWORK, allowUnknownOutputs?: boolean, customScripts?: TArg<CustomScript[]>): TRet<Extends<P2TR_TREE, P2Ret>>;
+/**
+ * Returns all size-`m` combinations from a list.
+ * @param m - size of each combination
+ * @param list - input items to combine
+ * @returns Array of combinations.
+ * @throws If the combination size or input list is invalid. {@link Error}
+ * @example
+ * Enumerate all size-two subsets of a short list.
+ * ```ts
+ * combinations(2, [1, 2, 3]);
+ * ```
+ */
 export declare function combinations<T>(m: number, list: T[]): T[][];
 /**
  * M-of-N multi-leaf wallet via p2tr_ns. If m == n, single script is emitted.
  * Takes O(n^2) if m != n. 99-of-100 is ok, 5-of-100 is not.
+ * It materializes C(n, m) leaves, so middle-of-the-range thresholds blow up combinatorially.
  * `2-of-[A,B,C] => [A,B] | [A,C] | [B,C]`
  */
 export type P2TR_NS = {
+    /** Payment-script tag for taproot `CHECKSIGVERIFY` leaf scripts. */
     type: 'tr_ns';
-    script: Bytes;
+    /** Serialized tapscript leaf. */
+    script: TRet<Bytes>;
 };
-export declare const p2tr_ns: (m: number, pubkeys: Bytes[], allowSamePubkeys?: boolean) => Extends<P2TR_NS, P2Ret>[];
+/**
+ * Builds the leaf set for an M-of-N `CHECKSIGVERIFY` taproot policy.
+ * @param m - number of required signatures
+ * @param pubkeys - participating Schnorr public keys
+ * @param allowSamePubkeys - whether duplicate keys are allowed
+ * @returns Array of taproot leaf descriptors.
+ * @throws If the taproot multisig parameters are invalid. {@link Error}
+ * @example
+ * Build the leaf set for an M-of-N taproot `CHECKSIGVERIFY` policy.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2tr_ns } from '@scure/btc-signer/payment.js';
+ * p2tr_ns(1, [hex.decode('f9308a019258c31049344f85f89d5229b531c845836f99b08601f113bce036f9')], true);
+ * ```
+ */
+export declare const p2tr_ns: (m: number, pubkeys: TArg<Bytes[]>, allowSamePubkeys?: boolean) => TRet<Extends<P2TR_NS, P2Ret>[]>;
+/** Single-key taproot leaf descriptor. */
 export type P2TR_PK = P2TR_NS;
-export declare const p2tr_pk: (pubkey: Bytes) => Extends<P2TR_PK, P2Ret>;
+/**
+ * Builds a single-key taproot leaf script.
+ * BIP 341 design guidance: if this is the most likely single-key spend path, prefer
+ * using that key as the `p2tr()` internal key instead of forcing it into a script leaf.
+ * @param pubkey - Schnorr public key
+ * @returns Taproot single-key leaf descriptor.
+ * @throws If the taproot single-key leaf cannot be encoded. {@link Error}
+ * @example
+ * Build a single-key tapscript leaf.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2tr_pk } from '@scure/btc-signer/payment.js';
+ * p2tr_pk(hex.decode('f9308a019258c31049344f85f89d5229b531c845836f99b08601f113bce036f9'));
+ * ```
+ */
+export declare const p2tr_pk: (pubkey: TArg<Bytes>) => TRet<Extends<P2TR_PK, P2Ret>>;
+/** Taproot `CHECKSIGADD` multisig leaf descriptor. */
 export type P2TR_MS = {
+    /** Payment-script tag for taproot `CHECKSIGADD` leaf scripts. */
     type: 'tr_ms';
-    script: Bytes;
+    /** Serialized tapscript leaf. */
+    script: TRet<Bytes>;
 };
-export declare function p2tr_ms(m: number, pubkeys: Bytes[], allowSamePubkeys?: boolean): Extends<P2TR_MS, P2Ret>;
-export declare function getAddress(type: 'pkh' | 'wpkh' | 'tr', privKey: Bytes, network?: BTC_NETWORK): string | undefined;
-export declare const _sortPubkeys: (pubkeys: Bytes[]) => Bytes[];
-export declare function multisig(m: number, pubkeys: Bytes[], sorted?: boolean, witness?: boolean, network?: BTC_NETWORK): P2Ret;
-export declare function sortedMultisig(m: number, pubkeys: Bytes[], witness?: boolean, network?: BTC_NETWORK): P2Ret;
-export declare function WIF(network?: BTC_NETWORK): Coder<Bytes, string>;
+/**
+ * Builds a `CHECKSIGADD` taproot multisig leaf.
+ * @param m - number of required signatures
+ * @param pubkeys - participating Schnorr public keys
+ * @param allowSamePubkeys - whether duplicate keys are allowed
+ * @returns Taproot multisig leaf descriptor.
+ * @throws If the taproot multisig parameters are invalid. {@link Error}
+ * @example
+ * Build a `CHECKSIGADD` taproot multisig leaf.
+ * ```ts
+ * import { hex } from '@scure/base';
+ * import { p2tr_ms } from '@scure/btc-signer/payment.js';
+ * p2tr_ms(1, [hex.decode('f9308a019258c31049344f85f89d5229b531c845836f99b08601f113bce036f9')], true);
+ * ```
+ */
+export declare function p2tr_ms(m: number, pubkeys: TArg<Bytes[]>, allowSamePubkeys?: boolean): TRet<Extends<P2TR_MS, P2Ret>>;
+/**
+ * Derives a simple address from a private key.
+ * @param type - address type to derive
+ * @param privKey - private key bytes
+ * @param network - address network parameters
+ * @returns Encoded Bitcoin address.
+ * @throws If the requested address type is unknown. {@link Error}
+ * @example
+ * Pick the output type first, then derive the matching address from the private key.
+ * ```ts
+ * import { getAddress } from '@scure/btc-signer/payment.js';
+ * import { randomPrivateKeyBytes } from '@scure/btc-signer/utils.js';
+ * getAddress('wpkh', randomPrivateKeyBytes());
+ * ```
+ */
+export declare function getAddress(type: 'pkh' | 'wpkh' | 'tr', privKey: TArg<Bytes>, network?: BTC_NETWORK): string;
+export declare const _sortPubkeys: (pubkeys: TArg<Bytes[]>) => TRet<Bytes[]>;
+/**
+ * Builds a classic M-of-N multisig output, wrapped in P2SH or P2WSH.
+ * @param m - number of required signatures
+ * @param pubkeys - participating public keys
+ * @param sorted - whether to sort the public keys first
+ * @param witness - whether to wrap the result as native SegWit
+ * @param network - address network parameters
+ * @returns Multisig payment descriptor.
+ * @throws If the multisig parameters or wrapped script are invalid. {@link Error}
+ * @example
+ * Wrap a classic 2-of-2 script into an addressable multisig output.
+ * ```ts
+ * import { multisig } from '@scure/btc-signer/payment.js';
+ * import { pubECDSA, randomPrivateKeyBytes } from '@scure/btc-signer/utils.js';
+ * multisig(
+ *   2,
+ *   [pubECDSA(randomPrivateKeyBytes()), pubECDSA(randomPrivateKeyBytes())],
+ *   true,
+ *   true
+ * );
+ * ```
+ */
+export declare function multisig(m: number, pubkeys: TArg<Bytes[]>, sorted?: boolean, witness?: boolean, network?: BTC_NETWORK): TRet<P2Ret>;
+/**
+ * Builds a multisig output after lexicographically sorting the keys.
+ * @param m - number of required signatures
+ * @param pubkeys - participating public keys
+ * @param witness - whether to wrap the result as native SegWit
+ * @param network - address network parameters
+ * @returns Sorted multisig payment descriptor.
+ * @throws If the multisig parameters or wrapped script are invalid. {@link Error}
+ * @example
+ * Sort public keys deterministically before constructing the multisig address.
+ * ```ts
+ * import { sortedMultisig } from '@scure/btc-signer/payment.js';
+ * import { pubECDSA, randomPrivateKeyBytes } from '@scure/btc-signer/utils.js';
+ * sortedMultisig(
+ *   2,
+ *   [pubECDSA(randomPrivateKeyBytes()), pubECDSA(randomPrivateKeyBytes())],
+ *   true
+ * );
+ * ```
+ */
+export declare function sortedMultisig(m: number, pubkeys: TArg<Bytes[]>, witness?: boolean, network?: BTC_NETWORK): TRet<P2Ret>;
+/**
+ * Wallet-import-format coder for private keys.
+ * @param network - address network parameters
+ * @returns WIF coder.
+ * @example
+ * Encode or decode wallet-import-format private keys.
+ * ```ts
+ * const coder = WIF();
+ * coder.encode(new Uint8Array(32).fill(1));
+ * ```
+ */
+export declare function WIF(network?: BTC_NETWORK): TRet<Coder<Bytes, string>>;
+/**
+ * Address encoder/decoder for a specific Bitcoin network.
+ * @param network - address network parameters
+ * @returns Address coder backed by the provided network.
+ * @example
+ * Create a network-specific address coder and encode a payment descriptor.
+ * ```ts
+ * import { Address, p2wpkh } from '@scure/btc-signer/payment.js';
+ * import { pubECDSA, randomPrivateKeyBytes } from '@scure/btc-signer/utils.js';
+ * const coder = Address();
+ * coder.encode(p2wpkh(pubECDSA(randomPrivateKeyBytes())));
+ * ```
+ */
 export declare function Address(network?: BTC_NETWORK): {
-    encode(from: P.UnwrapCoder<OutScriptType>): string;
-    decode(address: string): P.UnwrapCoder<OutScriptType>;
+    encode(from: Exclude<OutScriptValue, undefined>): string;
+    decode(address: string): OutScriptValue;
 };
 export {};
 //# sourceMappingURL=payment.d.ts.map

package/payment.d.ts.map

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