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

package/browser/psbt/psbtutils.d.ts

@@ -1,21 +1,61 @@
-import { PartialSig, PsbtInput } from 'bip174/src/lib/interfaces.js';
-export declare const isP2MS: (script: Buffer) => boolean;
-export declare const isP2PK: (script: Buffer) => boolean;
-export declare const isP2PKH: (script: Buffer) => boolean;
-export declare const isP2WPKH: (script: Buffer) => boolean;
-export declare const isP2WSHScript: (script: Buffer) => boolean;
-export declare const isP2SHScript: (script: Buffer) => boolean;
-export declare const isP2TR: (script: Buffer) => boolean;
-export declare const isP2OP: (script: Buffer) => boolean;
-export declare const isP2A: (script: Buffer) => boolean;
-export declare function witnessStackToScriptWitness(witness: Buffer[]): Buffer;
-export declare function pubkeyPositionInScript(pubkey: Buffer, script: Buffer): number;
-export declare function pubkeyInScript(pubkey: Buffer, script: Buffer): boolean;
+import { PartialSig, PsbtInput } from 'bip174';
+export declare const isP2MS: (script: Uint8Array) => boolean;
+export declare const isP2PK: (script: Uint8Array) => boolean;
+export declare const isP2PKH: (script: Uint8Array) => boolean;
+export declare const isP2WPKH: (script: Uint8Array) => boolean;
+export declare const isP2WSHScript: (script: Uint8Array) => boolean;
+export declare const isP2SHScript: (script: Uint8Array) => boolean;
+export declare const isP2TR: (script: Uint8Array) => boolean;
+export declare const isP2OP: (script: Uint8Array) => boolean;
+export declare const isP2A: (script: Uint8Array) => boolean;
+/**
+ * Converts a witness stack to a script witness.
+ * @param witness The witness stack to convert.
+ * @returns The script witness as a Uint8Array.
+ */
+export declare function witnessStackToScriptWitness(witness: Uint8Array[]): Uint8Array;
+/**
+ * Finds the position of a public key in a script.
+ * @param pubkey The public key to search for.
+ * @param script The script to search in.
+ * @returns The index of the public key in the script, or -1 if not found.
+ * @throws {Error} If there is an unknown script error.
+ */
+export declare function pubkeyPositionInScript(pubkey: Uint8Array, script: Uint8Array): number;
+/**
+ * Checks if a public key is present in a script.
+ * @param pubkey The public key to check.
+ * @param script The script to search in.
+ * @returns A boolean indicating whether the public key is present in the script.
+ */
+export declare function pubkeyInScript(pubkey: Uint8Array, script: Uint8Array): boolean;
+/**
+ * Checks if an input contains a signature for a specific action.
+ * @param input - The input to check.
+ * @param action - The action to check for.
+ * @returns A boolean indicating whether the input contains a signature for the specified action.
+ */
 export declare function checkInputForSig(input: PsbtInput, action: string): boolean;
-type SignatureDecodeFunc = (buffer: Buffer) => {
-    signature: Buffer;
+type SignatureDecodeFunc = (buffer: Uint8Array) => {
+    signature: Uint8Array;
     hashType: number;
 };
-export declare function signatureBlocksAction(signature: Buffer, signatureDecodeFn: SignatureDecodeFunc, action: string): boolean;
+/**
+ * Determines if a given action is allowed for a signature block.
+ * @param signature - The signature block.
+ * @param signatureDecodeFn - The function used to decode the signature.
+ * @param action - The action to be checked.
+ * @returns True if the action is allowed, false otherwise.
+ */
+export declare function signatureBlocksAction(signature: Uint8Array, signatureDecodeFn: SignatureDecodeFunc, action: string): boolean;
+/**
+ * Retrieves the partial signatures (Psigs) from the input's final scripts.
+ * Psigs are extracted from both the final scriptSig and final scriptWitness of the input.
+ * Only canonical script signatures are considered.
+ *
+ * @param input - The PsbtInput object representing the input.
+ * @returns An array of PartialSig objects containing the extracted Psigs.
+ */
 export declare function getPsigsFromInputFinalScripts(input: PsbtInput): PartialSig[];
 export {};
+//# sourceMappingURL=psbtutils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"psbtutils.d.ts","sourceRoot":"","sources":["../../src/psbt/psbtutils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AA6BpD,eAAO,MAAM,MAAM,WAX2C,UAAU,KAAK,OAWjC,CAAC;AAC7C,eAAO,MAAM,MAAM,WAZ2C,UAAU,KAAK,OAYjC,CAAC;AAC7C,eAAO,MAAM,OAAO,WAb0C,UAAU,KAAK,OAa/B,CAAC;AAC/C,eAAO,MAAM,QAAQ,WAdyC,UAAU,KAAK,OAc7B,CAAC;AACjD,eAAO,MAAM,aAAa,WAfoC,UAAU,KAAK,OAezB,CAAC;AACrD,eAAO,MAAM,YAAY,WAhBqC,UAAU,KAAK,OAgB3B,CAAC;AACnD,eAAO,MAAM,MAAM,WAjB2C,UAAU,KAAK,OAiBjC,CAAC;AAC7C,eAAO,MAAM,MAAM,WAlB2C,UAAU,KAAK,OAkBjC,CAAC;AAC7C,eAAO,MAAM,KAAK,GAAI,QAAQ,UAAU,KAAG,OAQ1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CA2B7E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CA0CrF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK;IAC/C,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,UAAU,EACrB,iBAAiB,EAAE,mBAAmB,EACtC,MAAM,EAAE,MAAM,GACf,OAAO,CAgBT;AAwBD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,EAAE,CAa5E"}

package/browser/psbt/types.d.ts

@@ -0,0 +1,245 @@
+import { Psbt as PsbtBase, PsbtGlobal, PsbtInput, PsbtOutput } from 'bip174';
+import { Network } from '../networks.js';
+import { Transaction, TaprootHashCache } from '../transaction.js';
+import { Bytes32, PublicKey, Satoshi, Script, Signature, SchnorrSignature } from '../types.js';
+/**
+ * Transaction input interface for PSBT.
+ */
+export interface TransactionInput {
+    readonly hash: string | Bytes32;
+    readonly index: number;
+    readonly sequence?: number | undefined;
+}
+/**
+ * PSBT transaction input with Uint8Array hash.
+ */
+export interface PsbtTxInput extends TransactionInput {
+    readonly hash: Bytes32;
+}
+/**
+ * Transaction output interface for PSBT.
+ */
+export interface TransactionOutput {
+    readonly script: Script;
+    readonly value: Satoshi;
+}
+/**
+ * PSBT transaction output with optional address.
+ */
+export interface PsbtTxOutput extends TransactionOutput {
+    readonly address: string | undefined;
+}
+/**
+ * Signature validation function type.
+ * msghash is 32 byte hash of preimage, signature is 64 byte compact signature (r,s 32 bytes each)
+ */
+export type ValidateSigFunction = (pubkey: PublicKey, msghash: Bytes32, signature: Uint8Array) => boolean;
+/**
+ * Extended PsbtBase interface with typed inputs and globalMap.
+ */
+export interface PsbtBaseExtended extends Omit<PsbtBase, 'inputs'> {
+    readonly inputs: PsbtInput[];
+    readonly globalMap: PsbtGlobal;
+}
+/**
+ * Optional PSBT options.
+ */
+export interface PsbtOptsOptional {
+    readonly network?: Network | undefined;
+    readonly maximumFeeRate?: number | undefined;
+    readonly version?: 1 | 2 | 3 | undefined;
+}
+/**
+ * Required PSBT options.
+ */
+export interface PsbtOpts {
+    readonly network: Network;
+    maximumFeeRate: number;
+}
+/**
+ * Extended PSBT input with additional fields.
+ */
+export interface PsbtInputExtended extends PsbtInput, TransactionInput {
+    readonly isPayToAnchor?: boolean | undefined;
+}
+/**
+ * Extended PSBT output - either address-based or script-based.
+ */
+export type PsbtOutputExtended = PsbtOutputExtendedAddress | PsbtOutputExtendedScript;
+/**
+ * PSBT output with address.
+ */
+export interface PsbtOutputExtendedAddress extends PsbtOutput {
+    readonly address: string;
+    readonly value: Satoshi;
+}
+/**
+ * PSBT output with script.
+ */
+export interface PsbtOutputExtendedScript extends PsbtOutput {
+    readonly script: Script;
+    readonly value: Satoshi;
+}
+/**
+ * Base interface for HD signers.
+ */
+interface HDSignerBase {
+    /**
+     * DER format compressed publicKey Uint8Array
+     */
+    readonly publicKey: PublicKey;
+    /**
+     * The first 4 bytes of the sha256-ripemd160 of the publicKey
+     */
+    readonly fingerprint: Uint8Array;
+}
+/**
+ * HD signer interface for synchronous signing.
+ */
+export interface HDSigner extends HDSignerBase {
+    /**
+     * The path string must match /^m(\/\d+'?)+$/
+     * ex. m/44'/0'/0'/1/23 levels with ' must be hard derivations
+     */
+    derivePath(path: string): HDSigner;
+    /**
+     * Input hash (the "message digest") for the signature algorithm
+     * Return a 64 byte signature (32 byte r and 32 byte s in that order)
+     */
+    sign(hash: Bytes32): Uint8Array;
+}
+/**
+ * HD signer interface for asynchronous signing.
+ */
+export interface HDSignerAsync extends HDSignerBase {
+    derivePath(path: string): HDSignerAsync;
+    sign(hash: Bytes32): Promise<Uint8Array>;
+}
+/**
+ * Alternative signer interface with lowR support.
+ */
+export interface SignerAlternative {
+    readonly publicKey: PublicKey;
+    readonly lowR: boolean;
+    sign(hash: Bytes32, lowR?: boolean): Signature;
+    verify(hash: Bytes32, signature: Signature): boolean;
+    signSchnorr(hash: Bytes32): SchnorrSignature;
+    verifySchnorr(hash: Bytes32, signature: SchnorrSignature): boolean;
+}
+/**
+ * Basic signer interface for synchronous signing.
+ */
+export interface Signer {
+    readonly publicKey: PublicKey;
+    readonly network?: Network | undefined;
+    sign(hash: Bytes32, lowR?: boolean): Signature;
+    signSchnorr?(hash: Bytes32): SchnorrSignature;
+    getPublicKey?(): PublicKey;
+}
+/**
+ * Basic signer interface for asynchronous signing.
+ */
+export interface SignerAsync {
+    readonly publicKey: PublicKey;
+    readonly network?: Network | undefined;
+    sign(hash: Bytes32, lowR?: boolean): Promise<Signature>;
+    signSchnorr?(hash: Bytes32): Promise<SchnorrSignature>;
+    getPublicKey?(): PublicKey;
+}
+/**
+ * Minimal key pair interface for checking Taproot hashes.
+ * Only requires publicKey and optional signSchnorr presence check.
+ * Used by checkTaprootHashesForSig to accept broader key pair types (e.g., worker key pairs).
+ */
+export interface TaprootHashCheckSigner {
+    readonly publicKey: Uint8Array;
+    signSchnorr?(hash: Uint8Array): Uint8Array | Promise<Uint8Array>;
+}
+/**
+ * Internal PSBT cache for computed values.
+ */
+export interface PsbtCache {
+    nonWitnessUtxoTxCache: Transaction[];
+    nonWitnessUtxoBufCache: Uint8Array[];
+    txInCache: TxInCacheMap;
+    tx: Transaction;
+    feeRate?: number | undefined;
+    fee?: number | undefined;
+    extractedTx?: Transaction | undefined;
+    unsafeSignNonSegwit: boolean;
+    /** Cached flag: true if any input has signatures (avoids O(n) check) */
+    hasSignatures: boolean;
+    /** Cached prevOuts for Taproot signing (computed once) */
+    prevOuts?: readonly PrevOut[] | undefined;
+    /** Cached signing scripts */
+    signingScripts?: readonly Script[] | undefined;
+    /** Cached values */
+    values?: readonly Satoshi[] | undefined;
+    /** Cached intermediate hashes for Taproot sighash (computed once per PSBT) */
+    taprootHashCache?: TaprootHashCache | undefined;
+}
+/**
+ * Keys for cached numeric values in the transaction cache.
+ */
+export type TxCacheNumberKey = 'feeRate' | 'fee';
+/**
+ * Script types for classification.
+ */
+export type ScriptType = 'witnesspubkeyhash' | 'pubkeyhash' | 'multisig' | 'pubkey' | 'nonstandard';
+/**
+ * All possible script types including witness types.
+ * Note: P2WPKH can't be wrapped in P2WSH (already a witness program)
+ */
+export type AllScriptType = 'witnesspubkeyhash' | 'pubkeyhash' | 'multisig' | 'pubkey' | 'nonstandard' | 'p2sh-witnesspubkeyhash' | 'p2sh-pubkeyhash' | 'p2sh-multisig' | 'p2sh-pubkey' | 'p2sh-nonstandard' | 'p2wsh-pubkeyhash' | 'p2wsh-multisig' | 'p2wsh-pubkey' | 'p2wsh-nonstandard' | 'p2sh-p2wsh-pubkeyhash' | 'p2sh-p2wsh-multisig' | 'p2sh-p2wsh-pubkey' | 'p2sh-p2wsh-nonstandard';
+/**
+ * Return type for getScriptFromInput function.
+ */
+export interface GetScriptReturn {
+    script: Script | null;
+    isSegwit: boolean;
+    isP2SH: boolean;
+    isP2WSH: boolean;
+}
+/**
+ * Index map for transaction input cache.
+ */
+export interface TxInCacheMap {
+    readonly [index: string]: number;
+}
+/**
+ * Previous output data for signing.
+ */
+export interface PrevOut {
+    readonly script: Script;
+    readonly value: Satoshi;
+}
+/**
+ * Result from getTaprootHashesForSig containing hash and optional leaf hash.
+ */
+export interface TaprootHashResult {
+    readonly hash: Bytes32;
+    readonly leafHash?: Bytes32 | undefined;
+}
+/**
+ * Extended Taproot hash result with pubkey for validation.
+ */
+export interface TaprootSigningHash {
+    readonly pubkey: PublicKey;
+    readonly hash: Bytes32;
+    readonly leafHash?: Bytes32 | undefined;
+}
+/**
+ * Function type for final scripts computation.
+ */
+export type FinalScriptsFunc = (inputIndex: number, input: PsbtInput, script: Script, isSegwit: boolean, isP2SH: boolean, isP2WSH: boolean, canRunChecks: boolean) => {
+    finalScriptSig: Script | undefined;
+    finalScriptWitness: Uint8Array | undefined;
+};
+/**
+ * Function type for final Taproot scripts computation.
+ */
+export type FinalTaprootScriptsFunc = (inputIndex: number, input: PsbtInput, tapLeafHashToFinalize?: Bytes32) => {
+    finalScriptWitness: Uint8Array | undefined;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/psbt/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EACR,OAAO,EACP,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,gBAAgB,EACnB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAC9B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,UAAU,KACpB,OAAO,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS,EAAE,gBAAgB;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,wBAAwB,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,UAAU;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,UAAU,YAAY;IAClB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC1C;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IAEnC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAExC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;IAErD,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAE7C,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEvC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/C,WAAW,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAE9C,YAAY,CAAC,IAAI,SAAS,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEvC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAExD,WAAW,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEvD,YAAY,CAAC,IAAI,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,WAAW,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,qBAAqB,EAAE,WAAW,EAAE,CAAC;IACrC,sBAAsB,EAAE,UAAU,EAAE,CAAC;IACrC,SAAS,EAAE,YAAY,CAAC;IACxB,EAAE,EAAE,WAAW,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC1C,6BAA6B;IAC7B,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/C,oBAAoB;IACpB,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IACxC,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,KAAK,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEpG;;;GAGG;AACH,MAAM,MAAM,aAAa,GACnB,mBAAmB,GACnB,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,aAAa,GACb,wBAAwB,GACxB,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,wBAAwB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC3B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,KACpB;IACD,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAClC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,qBAAqB,CAAC,EAAE,OAAO,KAC9B;IACD,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9C,CAAC"}

package/browser/psbt/utils.d.ts

@@ -0,0 +1,64 @@
+import { ScriptType } from './types.js';
+/**
+ * Converts a witness script buffer to an array of witness stack items.
+ * @param buffer - The witness script buffer
+ * @returns Array of witness stack items
+ */
+export declare function scriptWitnessToWitnessStack(buffer: Uint8Array): Uint8Array[];
+/**
+ * Converts a sighash type to a human-readable string.
+ * @param sighashType - The sighash type value
+ * @returns Human-readable sighash type string
+ */
+export declare function sighashTypeToString(sighashType: number): string;
+/**
+ * Compresses an uncompressed public key to compressed form.
+ * @param pubkey - The public key (33 or 65 bytes)
+ * @returns Compressed public key (33 bytes)
+ */
+export declare function compressPubkey(pubkey: Uint8Array): Uint8Array;
+/**
+ * Checks if a buffer looks like a public key.
+ * @param buf - The buffer to check
+ * @returns True if the buffer is a valid compressed public key format
+ */
+export declare function isPubkeyLike(buf: Uint8Array): boolean;
+/**
+ * Checks if a buffer looks like a signature.
+ * @param buf - The buffer to check
+ * @returns True if the buffer is a valid canonical signature format
+ */
+export declare function isSigLike(buf: Uint8Array): boolean;
+/**
+ * Classifies a script into a known script type.
+ * @param script - The script to classify
+ * @returns The script type
+ */
+export declare function classifyScript(script: Uint8Array): ScriptType;
+/**
+ * Creates an array of numbers from 0 to n-1.
+ * @param n - The length of the array
+ * @returns Array of numbers [0, 1, 2, ..., n-1]
+ */
+export declare function range(n: number): number[];
+/**
+ * Validates that a script is not P2WPKH or P2SH (invalid for P2WSH).
+ * @param script - The script to check
+ * @throws {Error} If the script is P2WPKH or P2SH
+ */
+export declare function checkInvalidP2WSH(script: Uint8Array): void;
+/**
+ * Extracts the meaningful script from a potentially wrapped script.
+ * Handles P2SH, P2WSH, and P2SH-P2WSH wrapping.
+ * @param script - The script to analyze
+ * @param index - The input/output index (for error messages)
+ * @param ioType - Whether this is an input or output
+ * @param redeemScript - Optional redeem script for P2SH
+ * @param witnessScript - Optional witness script for P2WSH
+ * @returns The meaningful script and its type
+ */
+export declare function getMeaningfulScript(script: Uint8Array, index: number, ioType: 'input' | 'output', redeemScript?: Uint8Array, witnessScript?: Uint8Array): {
+    meaningfulScript: Uint8Array;
+    type: 'p2sh' | 'p2wsh' | 'p2sh-p2wsh' | 'raw';
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/psbt/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CA0B5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAe/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAQ7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAI1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GAAG,QAAQ,EAC1B,YAAY,CAAC,EAAE,UAAU,EACzB,aAAa,CAAC,EAAE,UAAU,GAC3B;IACC,gBAAgB,EAAE,UAAU,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,KAAK,CAAC;CACjD,CAkCA"}

package/browser/psbt/validation.d.ts

@@ -0,0 +1,84 @@
+import { PsbtInput } from 'bip174';
+import { Payment, PaymentOpts } from '../payments/index.js';
+import { Transaction } from '../transaction.js';
+import { PsbtCache } from './types.js';
+import { PublicKey, Script } from '../types.js';
+/**
+ * Validates that a number is a valid 32-bit unsigned integer.
+ * @param num - The number to validate
+ * @throws {Error} If the number is not a valid 32-bit integer
+ */
+export declare function check32Bit(num: number): void;
+/**
+ * Checks if the cache is in a valid state for export.
+ * @param cache - The PSBT cache to check
+ * @throws {Error} If the cache is not BIP174 compliant
+ */
+export declare function checkCache(cache: PsbtCache): void;
+/**
+ * Checks if a PSBT input has been finalized.
+ * @param input - The PSBT input to check
+ * @returns True if the input has finalScriptSig or finalScriptWitness
+ */
+export declare function isFinalized(input: PsbtInput): boolean;
+/**
+ * Validates that a transaction has empty scriptSigs and witnesses.
+ * @param tx - The transaction to check
+ * @throws {Error} If any input has non-empty scripts
+ */
+export declare function checkTxEmpty(tx: Transaction): void;
+/**
+ * Checks and caches a transaction input to detect duplicates.
+ * @param cache - The PSBT cache
+ * @param input - The input to check
+ * @throws {Error} If a duplicate input is detected
+ */
+export declare function checkTxInputCache(cache: PsbtCache, input: {
+    hash: Uint8Array;
+    index: number;
+}): void;
+/**
+ * Checks all transaction inputs for duplicates.
+ * @param tx - The transaction to check
+ * @param cache - The PSBT cache
+ * @throws {Error} If duplicate inputs are detected
+ */
+export declare function checkTxForDupeIns(tx: Transaction, cache: PsbtCache): void;
+/**
+ * Checks if any inputs have partial signatures that would prevent modification.
+ * @param inputs - The PSBT inputs to check
+ * @param action - The action being attempted (for error message)
+ * @param hasSignaturesCache - Optional cached flag (true = definitely has sigs, false = check needed)
+ * @throws {Error} If signatures exist and prevent modification
+ */
+export declare function checkInputsForPartialSig(inputs: PsbtInput[], action: string, hasSignaturesCache?: boolean): void;
+/**
+ * Validates that partial signature sighash types match the input's sighash type.
+ * @param input - The PSBT input to check
+ * @throws {Error} If sighash types don't match
+ */
+export declare function checkPartialSigSighashes(input: PsbtInput): void;
+/**
+ * Validates that a pubkey exists in a script.
+ * @param pubkey - The pubkey to find
+ * @param script - The script to search
+ * @param action - The action being attempted (for error message)
+ * @throws {Error} If the pubkey is not found in the script
+ */
+export declare function checkScriptForPubkey(pubkey: PublicKey, script: Script, action: string): void;
+/**
+ * Creates a script checker function for validating redeem/witness scripts.
+ * @param payment - The payment function to use (p2sh or p2wsh)
+ * @param paymentScriptName - Name for error messages
+ * @returns A function that validates scripts match
+ */
+export declare function scriptCheckerFactory(payment: (a: Omit<Payment, 'name'>, opts?: PaymentOpts) => Payment, paymentScriptName: string): (idx: number, scriptPubKey: Script, redeemScript: Script, ioType: 'input' | 'output') => void;
+/**
+ * Validates that a redeem script matches the scriptPubKey.
+ */
+export declare const checkRedeemScript: (idx: number, scriptPubKey: Script, redeemScript: Script, ioType: "input" | "output") => void;
+/**
+ * Validates that a witness script matches the scriptPubKey.
+ */
+export declare const checkWitnessScript: (idx: number, scriptPubKey: Script, redeemScript: Script, ioType: "input" | "output") => void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/psbt/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EAAe,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAI9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAErD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAWlD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,kBAAkB,CAAC,EAAE,OAAO,GAC7B,IAAI,CAaN;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAS/D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM5F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,EAClE,iBAAiB,EAAE,MAAM,GAC1B,CACC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,GAAG,QAAQ,KACzB,IAAI,CAiBR;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,QA1BrB,MAAM,gBACG,MAAM,gBACN,MAAM,UACZ,OAAO,GAAG,QAAQ,KACzB,IAsBgF,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QA/BtB,MAAM,gBACG,MAAM,gBACN,MAAM,UACZ,OAAO,GAAG,QAAQ,KACzB,IA2BmF,CAAC"}