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

package/src/io/MemoryPool.ts

@@ -77,6 +77,38 @@ export class MemoryPool {
         this.#maxSize = size;
     }
 
+    /**
+     * Total capacity of the pool in bytes.
+     */
+    public get capacity(): number {
+        return this.#maxSize;
+    }
+
+    /**
+     * Current allocation offset (bytes used).
+     *
+     * Uses Atomics for thread-safe reading.
+     */
+    public get used(): number {
+        return Atomics.load(this.#control, 0);
+    }
+
+    /**
+     * Remaining available bytes.
+     */
+    public get available(): number {
+        return this.#maxSize - this.used;
+    }
+
+    /**
+     * The underlying SharedArrayBuffer.
+     *
+     * Can be transferred to Workers for shared memory access.
+     */
+    public get sharedBuffer(): SharedArrayBuffer {
+        return this.#buffer;
+    }
+
     /**
      * Creates a MemoryPool from an existing SharedArrayBuffer.
      *
@@ -111,38 +143,6 @@ export class MemoryPool {
         return pool;
     }
 
-    /**
-     * Total capacity of the pool in bytes.
-     */
-    public get capacity(): number {
-        return this.#maxSize;
-    }
-
-    /**
-     * Current allocation offset (bytes used).
-     *
-     * Uses Atomics for thread-safe reading.
-     */
-    public get used(): number {
-        return Atomics.load(this.#control, 0);
-    }
-
-    /**
-     * Remaining available bytes.
-     */
-    public get available(): number {
-        return this.#maxSize - this.used;
-    }
-
-    /**
-     * The underlying SharedArrayBuffer.
-     *
-     * Can be transferred to Workers for shared memory access.
-     */
-    public get sharedBuffer(): SharedArrayBuffer {
-        return this.#buffer;
-    }
-
     /**
      * Allocates memory from the pool.
      *

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;

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;
@@ -186,8 +202,6 @@ export class Embed {
         return bscript.compile(([OPS.OP_RETURN] as Stack).concat(this.#inputData)) as Script;
     }
 
-    // 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;
@@ -364,6 +390,8 @@ export class P2MS {
         return bscript.compile(([OPS.OP_0] as Stack).concat(this.#inputSignatures)) as Script;
     }
 
+    // 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;
@@ -284,6 +301,8 @@ export class P2PK {
         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;
@@ -425,6 +444,8 @@ export class P2PKH {
         return bscript.compile([this.#inputSignature, pubKey]) as Script;
     }
 
+    // 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,8 +333,9 @@ 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,
+                    output: (lastChunk === OPS.OP_FALSE
+                        ? new Uint8Array(0)
+                        : (lastChunk as Uint8Array)) as Script,
                     input: bscript.compile(chunks.slice(0, -1)) as Script,
                     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;
@@ -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),
+        ) as Script;
     }
 
     #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,
-        };
-    }
 }
 
 /**