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

package/build/psbt/utils.js

@@ -0,0 +1,171 @@
+/**
+ * PSBT utility functions
+ * @packageDocumentation
+ */
+import { varuint } from '../io/index.js';
+import * as bscript from '../script.js';
+import { Transaction } from '../transaction.js';
+import { isP2MS, isP2PK, isP2PKH, isP2SHScript, isP2WPKH, isP2WSHScript } from './psbtutils.js';
+import { checkRedeemScript, checkWitnessScript } from './validation.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 function scriptWitnessToWitnessStack(buffer) {
+    let offset = 0;
+    function readSlice(n) {
+        offset += n;
+        return buffer.subarray(offset - n, offset);
+    }
+    function readVarInt() {
+        const vi = varuint.decode(buffer, offset);
+        offset += vi.bytes;
+        return vi.numberValue || 0;
+    }
+    function readVarSlice() {
+        return readSlice(readVarInt());
+    }
+    function readVector() {
+        const count = readVarInt();
+        const vector = [];
+        for (let i = 0; i < count; i++)
+            vector.push(readVarSlice());
+        return vector;
+    }
+    return readVector();
+}
+/**
+ * Converts a sighash type to a human-readable string.
+ * @param sighashType - The sighash type value
+ * @returns Human-readable sighash type string
+ */
+export function sighashTypeToString(sighashType) {
+    let text = sighashType & Transaction.SIGHASH_ANYONECANPAY ? 'SIGHASH_ANYONECANPAY | ' : '';
+    const sigMod = sighashType & 0x1f;
+    switch (sigMod) {
+        case Transaction.SIGHASH_ALL:
+            text += 'SIGHASH_ALL';
+            break;
+        case Transaction.SIGHASH_SINGLE:
+            text += 'SIGHASH_SINGLE';
+            break;
+        case Transaction.SIGHASH_NONE:
+            text += 'SIGHASH_NONE';
+            break;
+    }
+    return text;
+}
+/**
+ * Compresses an uncompressed public key to compressed form.
+ * @param pubkey - The public key (33 or 65 bytes)
+ * @returns Compressed public key (33 bytes)
+ */
+export function compressPubkey(pubkey) {
+    if (pubkey.length === 65) {
+        const parity = pubkey[64] & 1;
+        const newKey = new Uint8Array(pubkey.subarray(0, 33));
+        newKey[0] = 2 | parity;
+        return newKey;
+    }
+    return new Uint8Array(pubkey);
+}
+/**
+ * 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 function isPubkeyLike(buf) {
+    return buf.length === 33 && bscript.isCanonicalPubKey(buf);
+}
+/**
+ * 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 function isSigLike(buf) {
+    return bscript.isCanonicalScriptSignature(buf);
+}
+/**
+ * Classifies a script into a known script type.
+ * @param script - The script to classify
+ * @returns The script type
+ */
+export function classifyScript(script) {
+    if (isP2WPKH(script))
+        return 'witnesspubkeyhash';
+    if (isP2PKH(script))
+        return 'pubkeyhash';
+    if (isP2MS(script))
+        return 'multisig';
+    if (isP2PK(script))
+        return 'pubkey';
+    return 'nonstandard';
+}
+/**
+ * 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 function range(n) {
+    return [...Array(n).keys()];
+}
+/**
+ * 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 function checkInvalidP2WSH(script) {
+    if (isP2WPKH(script) || isP2SHScript(script)) {
+        throw new Error('P2WPKH or P2SH can not be contained within P2WSH');
+    }
+}
+/**
+ * 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 function getMeaningfulScript(script, index, ioType, redeemScript, witnessScript) {
+    const isP2SH = isP2SHScript(script);
+    const isP2SHP2WSH = isP2SH && redeemScript && isP2WSHScript(redeemScript);
+    const isP2WSH = isP2WSHScript(script);
+    if (isP2SH && redeemScript === undefined)
+        throw new Error('scriptPubkey is P2SH but redeemScript missing');
+    let meaningfulScript;
+    if (isP2SHP2WSH) {
+        if (!witnessScript)
+            throw new Error('scriptPubkey or redeemScript is P2WSH but witnessScript missing');
+        if (!redeemScript)
+            throw new Error('P2SH-P2WSH requires redeemScript');
+        meaningfulScript = witnessScript;
+        checkRedeemScript(index, script, redeemScript, ioType);
+        checkWitnessScript(index, redeemScript, witnessScript, ioType);
+        checkInvalidP2WSH(meaningfulScript);
+    }
+    else if (isP2WSH) {
+        if (!witnessScript)
+            throw new Error('scriptPubkey or redeemScript is P2WSH but witnessScript missing');
+        meaningfulScript = witnessScript;
+        checkWitnessScript(index, script, witnessScript, ioType);
+        checkInvalidP2WSH(meaningfulScript);
+    }
+    else if (isP2SH) {
+        if (!redeemScript)
+            throw new Error('P2SH requires redeemScript');
+        meaningfulScript = redeemScript;
+        checkRedeemScript(index, script, redeemScript, ioType);
+    }
+    else {
+        meaningfulScript = script;
+    }
+    return {
+        meaningfulScript,
+        type: isP2SHP2WSH ? 'p2sh-p2wsh' : isP2SH ? 'p2sh' : isP2WSH ? 'p2wsh' : 'raw',
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/psbt/utils.js.map

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

package/build/psbt/validation.d.ts

@@ -0,0 +1,88 @@
+/**
+ * PSBT validation utilities
+ * @packageDocumentation
+ */
+import type { PsbtInput } from 'bip174';
+import type { Payment, PaymentOpts } from '../payments/index.js';
+import type { Transaction } from '../transaction.js';
+import type { PsbtCache } from './types.js';
+import type { 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/build/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"}

package/build/psbt/validation.js

@@ -0,0 +1,149 @@
+/**
+ * PSBT validation utilities
+ * @packageDocumentation
+ */
+import { reverse, equals, toHex } from '../io/index.js';
+import * as payments from '../payments/index.js';
+import { checkTaprootInputForSigs, isTaprootInput } from './bip371.js';
+import { checkInputForSig, pubkeyInScript } from './psbtutils.js';
+import * as bscript from '../script.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 function check32Bit(num) {
+    if (typeof num !== 'number' || num !== Math.floor(num) || num > 0xffffffff || num < 0) {
+        throw new Error('Invalid 32 bit integer');
+    }
+}
+/**
+ * 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 function checkCache(cache) {
+    if (cache.unsafeSignNonSegwit) {
+        throw new Error('Not BIP174 compliant, can not export');
+    }
+}
+/**
+ * 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 function isFinalized(input) {
+    return !!input.finalScriptSig || !!input.finalScriptWitness;
+}
+/**
+ * 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 function checkTxEmpty(tx) {
+    const isEmpty = tx.ins.every((input) => input.script &&
+        input.script.length === 0 &&
+        input.witness &&
+        input.witness.length === 0);
+    if (!isEmpty) {
+        throw new Error('Format Error: Transaction ScriptSigs are not empty');
+    }
+}
+/**
+ * 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 function checkTxInputCache(cache, input) {
+    const reversed = reverse(new Uint8Array(input.hash));
+    const key = `${toHex(reversed)}:${input.index}`;
+    if (cache.txInCache[key])
+        throw new Error('Duplicate input detected.');
+    cache.txInCache[key] = 1;
+}
+/**
+ * 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 function checkTxForDupeIns(tx, cache) {
+    tx.ins.forEach((input) => {
+        checkTxInputCache(cache, input);
+    });
+}
+/**
+ * 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 function checkInputsForPartialSig(inputs, action, hasSignaturesCache) {
+    // Fast path: if cache says no signatures, skip entirely (O(1))
+    if (hasSignaturesCache === false) {
+        return;
+    }
+    // Only do full validation if signatures might exist
+    inputs.forEach((input) => {
+        const throws = isTaprootInput(input)
+            ? checkTaprootInputForSigs(input, action)
+            : checkInputForSig(input, action);
+        if (throws)
+            throw new Error('Can not modify transaction, signatures exist.');
+    });
+}
+/**
+ * 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 function checkPartialSigSighashes(input) {
+    if (!input.sighashType || !input.partialSig)
+        return;
+    const { partialSig, sighashType } = input;
+    partialSig.forEach((pSig) => {
+        const { hashType } = bscript.signature.decode(pSig.signature);
+        if (sighashType !== hashType) {
+            throw new Error('Signature sighash does not match input sighash type');
+        }
+    });
+}
+/**
+ * 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 function checkScriptForPubkey(pubkey, script, action) {
+    if (!pubkeyInScript(pubkey, script)) {
+        throw new Error(`Can not ${action} for this input with the key ${toHex(pubkey)}`);
+    }
+}
+/**
+ * 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 function scriptCheckerFactory(payment, paymentScriptName) {
+    return (inputIndex, scriptPubKey, redeemScript, ioType) => {
+        const redeemScriptOutput = payment({
+            redeem: { output: redeemScript },
+        }).output;
+        if (!equals(scriptPubKey, redeemScriptOutput)) {
+            throw new Error(`${paymentScriptName} for ${ioType} #${inputIndex} doesn't match the scriptPubKey in the prevout`);
+        }
+    };
+}
+/**
+ * Validates that a redeem script matches the scriptPubKey.
+ */
+export const checkRedeemScript = scriptCheckerFactory(payments.p2sh, 'Redeem script');
+/**
+ * Validates that a witness script matches the scriptPubKey.
+ */
+export const checkWitnessScript = scriptCheckerFactory(payments.p2wsh, 'Witness script');
+//# sourceMappingURL=validation.js.map

package/build/psbt/validation.js.map

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