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

package/src/io/index.ts

@@ -34,8 +34,5 @@ export {
     toUtf8,
 } from './utils.js';
 
-// Memory pools
-export { MemoryPool, SimpleMemoryPool } from './MemoryPool.js';
-
 // Re-export varuint for Bitcoin CompactSize encoding
 export { varuint };

package/src/opcodes.ts

@@ -273,8 +273,25 @@ export const opcodes: Opcodes = {
     OP_INVALIDOPCODE: 255,
 };
 
-export const REVERSE_OPS: { [key: number]: string } = {};
-for (const op of Object.keys(opcodes)) {
-    const code = opcodes[op as keyof Opcodes];
-    REVERSE_OPS[code] = op;
+let _reverseOps: { [key: number]: string } | undefined;
+
+/**
+ * Returns the reverse mapping from opcode number to opcode name.
+ * Lazily computed on first call.
+ */
+export function getReverseOps(): { [key: number]: string } {
+    if (!_reverseOps) {
+        _reverseOps = {};
+        for (const op of Object.keys(opcodes)) {
+            const code = opcodes[op as keyof Opcodes];
+            _reverseOps[code] = op;
+        }
+    }
+    return _reverseOps;
 }
+
+/**
+ * @deprecated Use {@link getReverseOps}() for lazy initialization.
+ * This eagerly-initialized alias exists for backward compatibility.
+ */
+export const REVERSE_OPS: { [key: number]: string } = getReverseOps();

package/src/payments/bip341.ts

@@ -1,10 +1,8 @@
 import * as bcrypto from '../crypto.js';
 import { getEccLib } from '../ecc/context.js';
-import { concat, compare, equals, alloc } from '../io/index.js';
-import { varuint } from '../io/index.js';
+import { alloc, compare, concat, equals, varuint } from '../io/index.js';
+import type { Bytes32, Tapleaf, Taptree, XOnlyPublicKey } from '../types.js';
 import { isTapleaf } from '../types.js';
-import type { Tapleaf, Taptree } from '../types.js';
-import type { Bytes32, XOnlyPublicKey } from '../types.js';
 
 export const LEAF_VERSION_TAPSCRIPT = 0xc0;
 export const MAX_TAPTREE_DEPTH = 128;
@@ -106,11 +104,11 @@ export function tapleafHash(leaf: Tapleaf): Bytes32 {
     return bcrypto.taggedHash(
         'TapLeaf',
         concat([new Uint8Array([version]), serializeScript(leaf.output)]),
-    ) as Bytes32;
+    );
 }
 
 export function tapTweakHash(pubKey: XOnlyPublicKey, h: Bytes32 | undefined): Bytes32 {
-    return bcrypto.taggedHash('TapTweak', h ? concat([pubKey, h]) : pubKey) as Bytes32;
+    return bcrypto.taggedHash('TapTweak', h ? concat([pubKey, h]) : pubKey);
 }
 
 export function tweakKey(pubKey: XOnlyPublicKey, h: Bytes32 | undefined): TweakedPublicKey | null {
@@ -130,7 +128,7 @@ export function tweakKey(pubKey: XOnlyPublicKey, h: Bytes32 | undefined): Tweake
 }
 
 function tapBranchHash(a: Uint8Array, b: Uint8Array): Bytes32 {
-    return bcrypto.taggedHash('TapBranch', concat([a, b])) as Bytes32;
+    return bcrypto.taggedHash('TapBranch', concat([a, b]));
 }
 
 function serializeScript(s: Uint8Array): Uint8Array {

package/src/payments/embed.ts

@@ -9,9 +9,9 @@
 
 import { bitcoin as BITCOIN_NETWORK, type Network } from '../networks.js';
 import * as bscript from '../script.js';
-import { stacksEqual, type Stack } from '../types.js';
 import type { Script } from '../types.js';
-import { PaymentType, type EmbedPayment, type PaymentOpts } from './types.js';
+import { type Stack, stacksEqual } from '../types.js';
+import { type EmbedPayment, type PaymentOpts, PaymentType } from './types.js';
 
 const OPS = bscript.opcodes;
 
@@ -162,6 +162,20 @@ export class Embed {
 
     // Private computation methods
 
+    /**
+     * Converts to a plain EmbedPayment object for backwards compatibility.
+     *
+     * @returns An EmbedPayment object
+     */
+    toPayment(): EmbedPayment {
+        return {
+            name: this.name,
+            network: this.network,
+            data: this.data,
+            output: this.output,
+        };
+    }
+
     #computeData(): Uint8Array[] | undefined {
         if (this.#inputData) {
             return this.#inputData;
@@ -176,6 +190,8 @@ export class Embed {
         return undefined;
     }
 
+    // Validation
+
     #computeOutput(): Uint8Array | undefined {
         if (this.#inputOutput) {
             return this.#inputOutput;
@@ -183,11 +199,9 @@ export class Embed {
         if (!this.#inputData) {
             return undefined;
         }
-        return bscript.compile(([OPS.OP_RETURN] as Stack).concat(this.#inputData)) as Script;
+        return bscript.compile(([OPS.OP_RETURN] as Stack).concat(this.#inputData));
     }
 
-    // Validation
-
     #validate(): void {
         if (this.#inputOutput) {
             const chunks = bscript.decompile(this.#inputOutput);
@@ -206,20 +220,6 @@ export class Embed {
             }
         }
     }
-
-    /**
-     * Converts to a plain EmbedPayment object for backwards compatibility.
-     *
-     * @returns An EmbedPayment object
-     */
-    toPayment(): EmbedPayment {
-        return {
-            name: this.name,
-            network: this.network,
-            data: this.data,
-            output: this.output,
-        };
-    }
 }
 
 /**

package/src/payments/p2ms.ts

@@ -9,8 +9,15 @@
 
 import { bitcoin as BITCOIN_NETWORK, type Network } from '../networks.js';
 import * as bscript from '../script.js';
-import { isPoint, stacksEqual, type PublicKey, type Script, type Signature, type Stack } from '../types.js';
-import { PaymentType, type P2MSPayment, type PaymentOpts } from './types.js';
+import {
+    isPoint,
+    type PublicKey,
+    type Script,
+    type Signature,
+    type Stack,
+    stacksEqual,
+} from '../types.js';
+import { type P2MSPayment, type PaymentOpts, PaymentType } from './types.js';
 
 const OPS = bscript.opcodes;
 const OP_INT_BASE = OPS.OP_RESERVED; // OP_1 - 1
@@ -274,6 +281,27 @@ export class P2MS {
 
     // Private helper methods
 
+    /**
+     * Converts to a plain P2MSPayment object for backwards compatibility.
+     *
+     * @returns A P2MSPayment object
+     */
+    toPayment(): P2MSPayment {
+        return {
+            name: this.name,
+            network: this.network,
+            m: this.m,
+            n: this.n,
+            pubkeys: this.pubkeys,
+            signatures: this.signatures,
+            output: this.output,
+            input: this.input,
+            witness: this.witness,
+        };
+    }
+
+    // Private computation methods
+
     #decode(output: Uint8Array | Stack): void {
         if (this.#decoded) return;
         this.#decoded = true;
@@ -286,8 +314,6 @@ export class P2MS {
         this.#pubkeysComputed = true;
     }
 
-    // Private computation methods
-
     #computeM(): number | undefined {
         if (this.#inputM !== undefined) {
             return this.#inputM;
@@ -351,7 +377,7 @@ export class P2MS {
         }
         return bscript.compile(
             ([] as Stack).concat(OP_INT_BASE + m, pubkeys, OP_INT_BASE + n, OPS.OP_CHECKMULTISIG),
-        ) as Script;
+        );
     }
 
     #computeInput(): Script | undefined {
@@ -361,9 +387,11 @@ export class P2MS {
         if (!this.#inputSignatures) {
             return undefined;
         }
-        return bscript.compile(([OPS.OP_0] as Stack).concat(this.#inputSignatures)) as Script;
+        return bscript.compile(([OPS.OP_0] as Stack).concat(this.#inputSignatures));
     }
 
+    // Validation
+
     #computeWitness(): Uint8Array[] | undefined {
         if (this.input) {
             return [];
@@ -371,8 +399,6 @@ export class P2MS {
         return undefined;
     }
 
-    // Validation
-
     #isAcceptableSignature(x: Uint8Array | number): boolean {
         return (
             bscript.isCanonicalScriptSignature(x as Uint8Array) ||
@@ -465,25 +491,6 @@ export class P2MS {
             }
         }
     }
-
-    /**
-     * Converts to a plain P2MSPayment object for backwards compatibility.
-     *
-     * @returns A P2MSPayment object
-     */
-    toPayment(): P2MSPayment {
-        return {
-            name: this.name,
-            network: this.network,
-            m: this.m,
-            n: this.n,
-            pubkeys: this.pubkeys,
-            signatures: this.signatures,
-            output: this.output,
-            input: this.input,
-            witness: this.witness,
-        };
-    }
 }
 
 /**

package/src/payments/p2op.ts

@@ -13,7 +13,7 @@ import { bitcoin as BITCOIN_NETWORK, type Network } from '../networks.js';
 import * as bscript from '../script.js';
 import { alloc, concat, equals } from '../io/index.js';
 import type { Bytes20, Script } from '../types.js';
-import { PaymentType, type P2OPPayment, type PaymentOpts } from './types.js';
+import { type P2OPPayment, type PaymentOpts, PaymentType } from './types.js';
 
 const OPS = bscript.opcodes;
 const P2OP_WITNESS_VERSION = 0x10;
@@ -241,6 +241,23 @@ export class P2OP {
 
     // Private helper methods
 
+    /**
+     * Converts to a plain P2OPPayment object for backwards compatibility.
+     *
+     * @returns A P2OPPayment object
+     */
+    toPayment(): P2OPPayment {
+        return {
+            name: this.name,
+            network: this.network,
+            address: this.address,
+            program: this.program,
+            deploymentVersion: this.deploymentVersion,
+            hash160: this.hash160,
+            output: this.output as Script | undefined,
+        };
+    }
+
     #getDecodedAddress(): { version: number; prefix: string; data: Uint8Array } | undefined {
         if (!this.#decodedAddressComputed) {
             if (this.#inputAddress) {
@@ -258,6 +275,8 @@ export class P2OP {
         return this.#decodedAddress;
     }
 
+    // Private computation methods
+
     #makeProgramFromParts(): Uint8Array | undefined {
         if (
             typeof this.#inputDeploymentVersion !== 'undefined' &&
@@ -274,8 +293,6 @@ export class P2OP {
         return undefined;
     }
 
-    // Private computation methods
-
     #computeAddress(): string | undefined {
         if (this.#inputAddress) {
             return this.#inputAddress;
@@ -346,6 +363,8 @@ export class P2OP {
         return prog.subarray(1) as Bytes20;
     }
 
+    // Validation
+
     #computeOutput(): Uint8Array | undefined {
         if (this.#inputOutput) {
             return this.#inputOutput;
@@ -356,8 +375,6 @@ export class P2OP {
         return bscript.compile([OPS.OP_16, prog]);
     }
 
-    // Validation
-
     #validate(): void {
         let prog: Uint8Array = alloc(0);
 
@@ -416,23 +433,6 @@ export class P2OP {
             throw new TypeError('hash160 mismatch');
         }
     }
-
-    /**
-     * Converts to a plain P2OPPayment object for backwards compatibility.
-     *
-     * @returns A P2OPPayment object
-     */
-    toPayment(): P2OPPayment {
-        return {
-            name: this.name,
-            network: this.network,
-            address: this.address,
-            program: this.program,
-            deploymentVersion: this.deploymentVersion,
-            hash160: this.hash160,
-            output: this.output as Script | undefined,
-        };
-    }
 }
 
 /**

package/src/payments/p2pk.ts

@@ -11,7 +11,7 @@ import { bitcoin as BITCOIN_NETWORK, type Network } from '../networks.js';
 import * as bscript from '../script.js';
 import { isPoint, type PublicKey, type Script, type Signature } from '../types.js';
 import { equals } from '../io/index.js';
-import { PaymentType, type P2PKPayment, type PaymentOpts } from './types.js';
+import { type P2PKPayment, type PaymentOpts, PaymentType } from './types.js';
 
 const OPS = bscript.opcodes;
 
@@ -238,6 +238,23 @@ export class P2PK {
 
     // Private computation methods
 
+    /**
+     * Converts to a plain P2PKPayment object for backwards compatibility.
+     *
+     * @returns A P2PKPayment object
+     */
+    toPayment(): P2PKPayment {
+        return {
+            name: this.name,
+            network: this.network,
+            pubkey: this.pubkey,
+            signature: this.signature,
+            output: this.output,
+            input: this.input,
+            witness: this.witness,
+        };
+    }
+
     #computePubkey(): PublicKey | undefined {
         if (this.#inputPubkey) {
             return this.#inputPubkey as PublicKey;
@@ -268,7 +285,7 @@ export class P2PK {
         }
         const pubkey = this.#inputPubkey;
         if (pubkey) {
-            return bscript.compile([pubkey, OPS.OP_CHECKSIG]) as Script;
+            return bscript.compile([pubkey, OPS.OP_CHECKSIG]);
         }
         return undefined;
     }
@@ -279,11 +296,13 @@ export class P2PK {
         }
         const signature = this.#inputSignature;
         if (signature) {
-            return bscript.compile([signature]) as Script;
+            return bscript.compile([signature]);
         }
         return undefined;
     }
 
+    // Validation
+
     #computeWitness(): Uint8Array[] | undefined {
         if (this.input) {
             return [];
@@ -291,8 +310,6 @@ export class P2PK {
         return undefined;
     }
 
-    // Validation
-
     #validate(): void {
         if (this.#inputOutput) {
             if (this.#inputOutput[this.#inputOutput.length - 1] !== OPS.OP_CHECKSIG) {
@@ -329,23 +346,6 @@ export class P2PK {
             }
         }
     }
-
-    /**
-     * Converts to a plain P2PKPayment object for backwards compatibility.
-     *
-     * @returns A P2PKPayment object
-     */
-    toPayment(): P2PKPayment {
-        return {
-            name: this.name,
-            network: this.network,
-            pubkey: this.pubkey,
-            signature: this.signature,
-            output: this.output,
-            input: this.input,
-            witness: this.witness,
-        };
-    }
 }
 
 /**

package/src/payments/p2pkh.ts

@@ -13,9 +13,9 @@ import * as bcrypto from '../crypto.js';
 import { bitcoin as BITCOIN_NETWORK, type Network } from '../networks.js';
 import { decompressPublicKey } from '../pubkey.js';
 import * as bscript from '../script.js';
-import { isPoint, type Bytes20, type PublicKey, type Script, type Signature } from '../types.js';
+import { type Bytes20, isPoint, type PublicKey, type Script, type Signature } from '../types.js';
 import { alloc, equals } from '../io/index.js';
-import { PaymentType, type P2PKHPayment, type PaymentOpts } from './types.js';
+import { type P2PKHPayment, type PaymentOpts, PaymentType } from './types.js';
 
 const OPS = bscript.opcodes;
 
@@ -303,6 +303,25 @@ export class P2PKH {
 
     // Private helper methods
 
+    /**
+     * Converts to a plain P2PKHPayment object for backwards compatibility.
+     *
+     * @returns A P2PKHPayment object
+     */
+    toPayment(): P2PKHPayment {
+        return {
+            name: this.name,
+            network: this.network,
+            address: this.address,
+            hash: this.hash,
+            pubkey: this.pubkey,
+            signature: this.signature,
+            output: this.output,
+            input: this.input,
+            witness: this.witness,
+        };
+    }
+
     #getDecodedAddress(): { version: number; hash: Uint8Array } | undefined {
         if (!this.#decodedAddressComputed) {
             if (this.#inputAddress) {
@@ -317,6 +336,8 @@ export class P2PKH {
         return this.#decodedAddress;
     }
 
+    // Private computation methods
+
     #getInputChunks(): (Uint8Array | number)[] | undefined {
         if (!this.#inputChunksComputed) {
             if (this.#inputInput) {
@@ -327,8 +348,6 @@ export class P2PKH {
         return this.#inputChunks;
     }
 
-    // Private computation methods
-
     #computeAddress(): string | undefined {
         if (this.#inputAddress) {
             return this.#inputAddress;
@@ -355,7 +374,7 @@ export class P2PKH {
         // Use the pubkey getter to derive pubkey from input if available
         const pk = this.pubkey;
         if (pk) {
-            return bcrypto.hash160(pk) as Bytes20;
+            return bcrypto.hash160(pk);
         }
         return undefined;
     }
@@ -399,7 +418,7 @@ export class P2PKH {
             h,
             OPS.OP_EQUALVERIFY,
             OPS.OP_CHECKSIG,
-        ]) as Script;
+        ]);
     }
 
     #computeInput(): Script | undefined {
@@ -422,9 +441,11 @@ export class P2PKH {
             }
         }
 
-        return bscript.compile([this.#inputSignature, pubKey]) as Script;
+        return bscript.compile([this.#inputSignature, pubKey]);
     }
 
+    // Validation
+
     #computeWitness(): Uint8Array[] | undefined {
         if (this.input) {
             return [];
@@ -432,8 +453,6 @@ export class P2PKH {
         return undefined;
     }
 
-    // Validation
-
     #validate(): void {
         let hash: Uint8Array = new Uint8Array(0);
 
@@ -540,25 +559,6 @@ export class P2PKH {
             }
         }
     }
-
-    /**
-     * Converts to a plain P2PKHPayment object for backwards compatibility.
-     *
-     * @returns A P2PKHPayment object
-     */
-    toPayment(): P2PKHPayment {
-        return {
-            name: this.name,
-            network: this.network,
-            address: this.address,
-            hash: this.hash,
-            pubkey: this.pubkey,
-            signature: this.signature,
-            output: this.output,
-            input: this.input,
-            witness: this.witness,
-        };
-    }
 }
 
 /**

package/src/payments/p2sh.ts

@@ -12,13 +12,13 @@ import * as bs58check from 'bs58check';
 import * as bcrypto from '../crypto.js';
 import { bitcoin as BITCOIN_NETWORK, type Network } from '../networks.js';
 import * as bscript from '../script.js';
-import { stacksEqual, type Bytes20, type Script, type Stack } from '../types.js';
+import { type Bytes20, type Script, type Stack, stacksEqual } from '../types.js';
 import { alloc, equals } from '../io/index.js';
 import {
-    PaymentType,
     type P2SHPayment,
     type Payment,
     type PaymentOpts,
+    PaymentType,
     type ScriptRedeem,
 } from './types.js';
 
@@ -282,6 +282,24 @@ export class P2SH {
 
     // Private helper methods
 
+    /**
+     * Converts to a plain P2SHPayment object for backwards compatibility.
+     *
+     * @returns A P2SHPayment object
+     */
+    toPayment(): P2SHPayment {
+        return {
+            name: this.name,
+            network: this.network,
+            address: this.address,
+            hash: this.hash,
+            output: this.output,
+            input: this.input,
+            redeem: this.redeem,
+            witness: this.witness,
+        };
+    }
+
     #getDecodedAddress(): { version: number; hash: Uint8Array } | undefined {
         if (!this.#decodedAddressComputed) {
             if (this.#inputAddress) {
@@ -306,6 +324,8 @@ export class P2SH {
         return this.#inputChunks;
     }
 
+    // Private computation methods
+
     #getDerivedRedeem(): ScriptRedeem | undefined {
         if (!this.#derivedRedeemComputed) {
             const chunks = this.#getInputChunks();
@@ -313,9 +333,10 @@ export class P2SH {
                 const lastChunk = chunks[chunks.length - 1];
                 this.#derivedRedeem = {
                     network: this.#network,
-                    output:
-                        (lastChunk === OPS.OP_FALSE ? new Uint8Array(0) : (lastChunk as Uint8Array)) as Script,
-                    input: bscript.compile(chunks.slice(0, -1)) as Script,
+                    output: (lastChunk === OPS.OP_FALSE
+                        ? new Uint8Array(0)
+                        : (lastChunk as Uint8Array)) as Script,
+                    input: bscript.compile(chunks.slice(0, -1)),
                     witness: this.#inputWitness || [],
                 };
             }
@@ -324,8 +345,6 @@ export class P2SH {
         return this.#derivedRedeem;
     }
 
-    // Private computation methods
-
     #computeAddress(): string | undefined {
         if (this.#inputAddress) {
             return this.#inputAddress;
@@ -351,7 +370,7 @@ export class P2SH {
         }
         const r = this.redeem;
         if (r && r.output) {
-            return bcrypto.hash160(r.output) as Bytes20;
+            return bcrypto.hash160(r.output);
         }
         return undefined;
     }
@@ -363,7 +382,7 @@ export class P2SH {
         const h = this.hash;
         if (!h) return undefined;
 
-        return bscript.compile([OPS.OP_HASH160, h, OPS.OP_EQUAL]) as Script;
+        return bscript.compile([OPS.OP_HASH160, h, OPS.OP_EQUAL]);
     }
 
     #computeInput(): Script | undefined {
@@ -374,7 +393,9 @@ export class P2SH {
         if (!r || !r.input || !r.output) {
             return undefined;
         }
-        return bscript.compile(([] as Stack).concat(bscript.decompile(r.input) as Stack, r.output)) as Script;
+        return bscript.compile(
+            ([] as Stack).concat(bscript.decompile(r.input) as Stack, r.output),
+        );
     }
 
     #computeRedeem(): ScriptRedeem | undefined {
@@ -387,6 +408,8 @@ export class P2SH {
         return undefined;
     }
 
+    // Validation
+
     #computeWitness(): Uint8Array[] | undefined {
         if (this.#inputWitness) {
             return this.#inputWitness;
@@ -401,8 +424,6 @@ export class P2SH {
         return undefined;
     }
 
-    // Validation
-
     #checkRedeem(redeem: Payment): void {
         // Is the redeem output empty/invalid?
         if (redeem.output) {
@@ -547,24 +568,6 @@ export class P2SH {
             }
         }
     }
-
-    /**
-     * Converts to a plain P2SHPayment object for backwards compatibility.
-     *
-     * @returns A P2SHPayment object
-     */
-    toPayment(): P2SHPayment {
-        return {
-            name: this.name,
-            network: this.network,
-            address: this.address,
-            hash: this.hash,
-            output: this.output,
-            input: this.input,
-            redeem: this.redeem,
-            witness: this.witness,
-        };
-    }
 }
 
 /**