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

package/build/crypto.js

@@ -1,20 +1,55 @@
+/**
+ * Cryptographic hashing functions for Bitcoin.
+ * Includes ripemd160, sha1, sha256, hash160, hash256, and taggedHash.
+ *
+ * @packageDocumentation
+ */
 import { ripemd160 as _ripemd160, sha1 as _sha1 } from '@noble/hashes/legacy.js';
 import { sha256 as _sha256 } from '@noble/hashes/sha2.js';
-export function ripemd160(buffer) {
-    return Buffer.from(_ripemd160(Uint8Array.from(buffer)));
+import { concat } from './io/index.js';
+/**
+ * Computes RIPEMD-160 hash of the input.
+ * @param data - Input data
+ * @returns 20-byte hash (Bytes20)
+ */
+export function ripemd160(data) {
+    return _ripemd160(data);
 }
-export function sha1(buffer) {
-    return Buffer.from(_sha1(Uint8Array.from(buffer)));
+/**
+ * Computes SHA-1 hash of the input.
+ * @param data - Input data
+ * @returns 20-byte hash (Bytes20)
+ */
+export function sha1(data) {
+    return _sha1(data);
 }
-export function sha256(buffer) {
-    return Buffer.from(_sha256(Uint8Array.from(buffer)));
+/**
+ * Computes SHA-256 hash of the input.
+ * @param data - Input data
+ * @returns 32-byte hash (Bytes32)
+ */
+export function sha256(data) {
+    return _sha256(data);
 }
-export function hash160(buffer) {
-    return Buffer.from(_ripemd160(_sha256(Uint8Array.from(buffer))));
+/**
+ * Computes HASH160 (RIPEMD160(SHA256(data))) of the input.
+ * @param data - Input data
+ * @returns 20-byte hash (Bytes20)
+ */
+export function hash160(data) {
+    return _ripemd160(_sha256(data));
 }
-export function hash256(buffer) {
-    return Buffer.from(_sha256(_sha256(Uint8Array.from(buffer))));
+/**
+ * Computes double SHA-256 hash of the input.
+ * @param data - Input data
+ * @returns 32-byte hash (Bytes32)
+ */
+export function hash256(data) {
+    return _sha256(_sha256(data));
 }
+/**
+ * BIP340/Taproot tag names for tagged hashing.
+ */
 export const TAGS = [
     'BIP0340/challenge',
     'BIP0340/aux',
@@ -26,61 +61,71 @@ export const TAGS = [
     'KeyAgg list',
     'KeyAgg coefficient',
 ];
+/**
+ * Precomputed tagged hash prefixes: SHA256(tag) || SHA256(tag)
+ */
 export const TAGGED_HASH_PREFIXES = {
-    'BIP0340/challenge': Buffer.from([
+    'BIP0340/challenge': new Uint8Array([
         123, 181, 45, 122, 159, 239, 88, 50, 62, 177, 191, 122, 64, 125, 179, 130, 210, 243, 242,
         216, 27, 177, 34, 79, 73, 254, 81, 143, 109, 72, 211, 124, 123, 181, 45, 122, 159, 239, 88,
         50, 62, 177, 191, 122, 64, 125, 179, 130, 210, 243, 242, 216, 27, 177, 34, 79, 73, 254, 81,
         143, 109, 72, 211, 124,
     ]),
-    'BIP0340/aux': Buffer.from([
+    'BIP0340/aux': new Uint8Array([
         241, 239, 78, 94, 192, 99, 202, 218, 109, 148, 202, 250, 157, 152, 126, 160, 105, 38, 88,
         57, 236, 193, 31, 151, 45, 119, 165, 46, 216, 193, 204, 144, 241, 239, 78, 94, 192, 99, 202,
         218, 109, 148, 202, 250, 157, 152, 126, 160, 105, 38, 88, 57, 236, 193, 31, 151, 45, 119,
         165, 46, 216, 193, 204, 144,
     ]),
-    'BIP0340/nonce': Buffer.from([
+    'BIP0340/nonce': new Uint8Array([
         7, 73, 119, 52, 167, 155, 203, 53, 91, 155, 140, 125, 3, 79, 18, 28, 244, 52, 215, 62, 247,
         45, 218, 25, 135, 0, 97, 251, 82, 191, 235, 47, 7, 73, 119, 52, 167, 155, 203, 53, 91, 155,
         140, 125, 3, 79, 18, 28, 244, 52, 215, 62, 247, 45, 218, 25, 135, 0, 97, 251, 82, 191, 235,
         47,
     ]),
-    TapLeaf: Buffer.from([
+    TapLeaf: new Uint8Array([
         174, 234, 143, 220, 66, 8, 152, 49, 5, 115, 75, 88, 8, 29, 30, 38, 56, 211, 95, 28, 181, 64,
         8, 212, 211, 87, 202, 3, 190, 120, 233, 238, 174, 234, 143, 220, 66, 8, 152, 49, 5, 115, 75,
         88, 8, 29, 30, 38, 56, 211, 95, 28, 181, 64, 8, 212, 211, 87, 202, 3, 190, 120, 233, 238,
     ]),
-    TapBranch: Buffer.from([
+    TapBranch: new Uint8Array([
         25, 65, 161, 242, 229, 110, 185, 95, 162, 169, 241, 148, 190, 92, 1, 247, 33, 111, 51, 237,
         130, 176, 145, 70, 52, 144, 208, 91, 245, 22, 160, 21, 25, 65, 161, 242, 229, 110, 185, 95,
         162, 169, 241, 148, 190, 92, 1, 247, 33, 111, 51, 237, 130, 176, 145, 70, 52, 144, 208, 91,
         245, 22, 160, 21,
     ]),
-    TapSighash: Buffer.from([
+    TapSighash: new Uint8Array([
         244, 10, 72, 223, 75, 42, 112, 200, 180, 146, 75, 242, 101, 70, 97, 237, 61, 149, 253, 102,
         163, 19, 235, 135, 35, 117, 151, 198, 40, 228, 160, 49, 244, 10, 72, 223, 75, 42, 112, 200,
         180, 146, 75, 242, 101, 70, 97, 237, 61, 149, 253, 102, 163, 19, 235, 135, 35, 117, 151,
         198, 40, 228, 160, 49,
     ]),
-    TapTweak: Buffer.from([
+    TapTweak: new Uint8Array([
         232, 15, 225, 99, 156, 156, 160, 80, 227, 175, 27, 57, 193, 67, 198, 62, 66, 156, 188, 235,
         21, 217, 64, 251, 181, 197, 161, 244, 175, 87, 197, 233, 232, 15, 225, 99, 156, 156, 160,
         80, 227, 175, 27, 57, 193, 67, 198, 62, 66, 156, 188, 235, 21, 217, 64, 251, 181, 197, 161,
         244, 175, 87, 197, 233,
     ]),
-    'KeyAgg list': Buffer.from([
+    'KeyAgg list': new Uint8Array([
         72, 28, 151, 28, 60, 11, 70, 215, 240, 178, 117, 174, 89, 141, 78, 44, 126, 215, 49, 156,
         89, 74, 92, 110, 199, 158, 160, 212, 153, 2, 148, 240, 72, 28, 151, 28, 60, 11, 70, 215,
         240, 178, 117, 174, 89, 141, 78, 44, 126, 215, 49, 156, 89, 74, 92, 110, 199, 158, 160, 212,
         153, 2, 148, 240,
     ]),
-    'KeyAgg coefficient': Buffer.from([
+    'KeyAgg coefficient': new Uint8Array([
         191, 201, 4, 3, 77, 28, 136, 232, 200, 14, 34, 229, 61, 36, 86, 109, 100, 130, 78, 214, 66,
         114, 129, 192, 145, 0, 249, 77, 205, 82, 201, 129, 191, 201, 4, 3, 77, 28, 136, 232, 200,
         14, 34, 229, 61, 36, 86, 109, 100, 130, 78, 214, 66, 114, 129, 192, 145, 0, 249, 77, 205,
         82, 201, 129,
     ]),
 };
+/**
+ * Computes a BIP340-style tagged hash.
+ * @param prefix - The tag name
+ * @param data - Input data
+ * @returns 32-byte hash (Bytes32)
+ */
 export function taggedHash(prefix, data) {
-    return sha256(Buffer.concat([TAGGED_HASH_PREFIXES[prefix], data]));
+    return sha256(concat([TAGGED_HASH_PREFIXES[prefix], data]));
 }
+//# sourceMappingURL=crypto.js.map

package/build/crypto.js.map

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

package/build/ecc/context.d.ts

@@ -0,0 +1,135 @@
+/**
+ * ECC library context management with dependency injection.
+ * Provides initialization, access, and lifecycle management for the ECC library.
+ *
+ * @packageDocumentation
+ */
+import type { EccLib } from './types.js';
+/**
+ * Context class for managing the ECC library instance.
+ * Uses dependency injection pattern instead of global singleton.
+ *
+ * @example
+ * ```typescript
+ * import { EccContext } from '@btc-vision/bitcoin';
+ * import * as secp256k1 from 'tiny-secp256k1';
+ *
+ * // Initialize once at app startup
+ * EccContext.init(secp256k1);
+ *
+ * // Get instance anywhere in your code
+ * const ecc = EccContext.get();
+ *
+ * // Clear when done (optional, for testing)
+ * EccContext.clear();
+ * ```
+ */
+export declare class EccContext {
+    #private;
+    private constructor();
+    /**
+     * The underlying ECC library instance.
+     */
+    get lib(): EccLib;
+    /**
+     * Initializes the ECC context with the provided library.
+     * The library is verified before being set as active.
+     *
+     * @param lib - The ECC library instance to initialize
+     * @returns The initialized EccContext instance
+     * @throws Error if the ECC library fails verification
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     * import * as secp256k1 from 'tiny-secp256k1';
+     *
+     * const context = EccContext.init(secp256k1);
+     * ```
+     */
+    static init(lib: EccLib): EccContext;
+    /**
+     * Gets the initialized ECC context.
+     *
+     * @returns The EccContext instance
+     * @throws Error if the context has not been initialized
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     *
+     * const context = EccContext.get();
+     * const isValid = context.lib.isXOnlyPoint(someKey);
+     * ```
+     */
+    static get(): EccContext;
+    /**
+     * Clears the ECC context.
+     * Useful for testing or when reinitializing with a different library.
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     *
+     * EccContext.clear();
+     * // Context is now uninitialized
+     * ```
+     */
+    static clear(): void;
+    /**
+     * Checks if the ECC context has been initialized.
+     *
+     * @returns True if initialized
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     *
+     * if (!EccContext.isInitialized()) {
+     *     EccContext.init(secp256k1);
+     * }
+     * ```
+     */
+    static isInitialized(): boolean;
+}
+/**
+ * Initializes the ECC library with the provided instance.
+ * This is a convenience function that wraps EccContext.init().
+ * Pass `undefined` to clear the library.
+ *
+ * @param eccLib - The ECC library instance to initialize, or undefined to clear
+ * @throws Error if the ECC library fails verification
+ *
+ * @example
+ * ```typescript
+ * import { initEccLib } from '@btc-vision/bitcoin';
+ * import * as secp256k1 from 'tiny-secp256k1';
+ *
+ * // Initialize the ECC library
+ * initEccLib(secp256k1);
+ *
+ * // Clear the library
+ * initEccLib(undefined);
+ * ```
+ */
+export declare function initEccLib(eccLib: EccLib | undefined): void;
+/**
+ * Retrieves the initialized ECC library instance.
+ * This is a convenience function that wraps EccContext.get().lib.
+ *
+ * @returns The ECC library instance
+ * @throws Error if the ECC library has not been initialized
+ *
+ * @example
+ * ```typescript
+ * import { getEccLib, initEccLib } from '@btc-vision/bitcoin';
+ * import * as secp256k1 from 'tiny-secp256k1';
+ *
+ * initEccLib(secp256k1);
+ *
+ * const ecc = getEccLib();
+ * const isValid = ecc.isXOnlyPoint(somePublicKey);
+ * ```
+ */
+export declare function getEccLib(): EccLib;
+//# sourceMappingURL=context.d.ts.map

package/build/ecc/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/ecc/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAU;;IAInB,OAAO;IAIP;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAMpC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,GAAG,IAAI,UAAU;IASxB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO;CAGlC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM3D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/build/ecc/context.js

@@ -0,0 +1,232 @@
+import { equals, fromHex } from '../io/index.js';
+/**
+ * Context class for managing the ECC library instance.
+ * Uses dependency injection pattern instead of global singleton.
+ *
+ * @example
+ * ```typescript
+ * import { EccContext } from '@btc-vision/bitcoin';
+ * import * as secp256k1 from 'tiny-secp256k1';
+ *
+ * // Initialize once at app startup
+ * EccContext.init(secp256k1);
+ *
+ * // Get instance anywhere in your code
+ * const ecc = EccContext.get();
+ *
+ * // Clear when done (optional, for testing)
+ * EccContext.clear();
+ * ```
+ */
+export class EccContext {
+    static #instance;
+    #lib;
+    constructor(lib) {
+        this.#lib = lib;
+    }
+    /**
+     * The underlying ECC library instance.
+     */
+    get lib() {
+        return this.#lib;
+    }
+    /**
+     * Initializes the ECC context with the provided library.
+     * The library is verified before being set as active.
+     *
+     * @param lib - The ECC library instance to initialize
+     * @returns The initialized EccContext instance
+     * @throws Error if the ECC library fails verification
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     * import * as secp256k1 from 'tiny-secp256k1';
+     *
+     * const context = EccContext.init(secp256k1);
+     * ```
+     */
+    static init(lib) {
+        verifyEcc(lib);
+        EccContext.#instance = new EccContext(lib);
+        return EccContext.#instance;
+    }
+    /**
+     * Gets the initialized ECC context.
+     *
+     * @returns The EccContext instance
+     * @throws Error if the context has not been initialized
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     *
+     * const context = EccContext.get();
+     * const isValid = context.lib.isXOnlyPoint(someKey);
+     * ```
+     */
+    static get() {
+        if (!EccContext.#instance) {
+            throw new Error('ECC library not initialized. Call EccContext.init() or initEccLib() first.');
+        }
+        return EccContext.#instance;
+    }
+    /**
+     * Clears the ECC context.
+     * Useful for testing or when reinitializing with a different library.
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     *
+     * EccContext.clear();
+     * // Context is now uninitialized
+     * ```
+     */
+    static clear() {
+        EccContext.#instance = undefined;
+    }
+    /**
+     * Checks if the ECC context has been initialized.
+     *
+     * @returns True if initialized
+     *
+     * @example
+     * ```typescript
+     * import { EccContext } from '@btc-vision/bitcoin';
+     *
+     * if (!EccContext.isInitialized()) {
+     *     EccContext.init(secp256k1);
+     * }
+     * ```
+     */
+    static isInitialized() {
+        return EccContext.#instance !== undefined;
+    }
+}
+/**
+ * Initializes the ECC library with the provided instance.
+ * This is a convenience function that wraps EccContext.init().
+ * Pass `undefined` to clear the library.
+ *
+ * @param eccLib - The ECC library instance to initialize, or undefined to clear
+ * @throws Error if the ECC library fails verification
+ *
+ * @example
+ * ```typescript
+ * import { initEccLib } from '@btc-vision/bitcoin';
+ * import * as secp256k1 from 'tiny-secp256k1';
+ *
+ * // Initialize the ECC library
+ * initEccLib(secp256k1);
+ *
+ * // Clear the library
+ * initEccLib(undefined);
+ * ```
+ */
+export function initEccLib(eccLib) {
+    if (eccLib === undefined) {
+        EccContext.clear();
+        return;
+    }
+    EccContext.init(eccLib);
+}
+/**
+ * Retrieves the initialized ECC library instance.
+ * This is a convenience function that wraps EccContext.get().lib.
+ *
+ * @returns The ECC library instance
+ * @throws Error if the ECC library has not been initialized
+ *
+ * @example
+ * ```typescript
+ * import { getEccLib, initEccLib } from '@btc-vision/bitcoin';
+ * import * as secp256k1 from 'tiny-secp256k1';
+ *
+ * initEccLib(secp256k1);
+ *
+ * const ecc = getEccLib();
+ * const isValid = ecc.isXOnlyPoint(somePublicKey);
+ * ```
+ */
+export function getEccLib() {
+    return EccContext.get().lib;
+}
+const TWEAK_ADD_VECTORS = [
+    {
+        pubkey: '79be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798',
+        tweak: 'fffffffffffffffffffffffffffffffebaaedce6af48a03bbfd25e8cd0364140',
+        parity: -1,
+        result: null,
+    },
+    {
+        pubkey: '1617d38ed8d8657da4d4761e8057bc396ea9e4b9d29776d4be096016dbd2509b',
+        tweak: 'a8397a935f0dfceba6ba9618f6451ef4d80637abf4e6af2669fbc9de6a8fd2ac',
+        parity: 1,
+        result: 'e478f99dab91052ab39a33ea35fd5e6e4933f4d28023cd597c9a1f6760346adf',
+    },
+    {
+        pubkey: '2c0b7cf95324a07d05398b240174dc0c2be444d96b159aa6c7f7b1e668680991',
+        tweak: '823c3cd2142744b075a87eade7e1b8678ba308d566226a0056ca2b7a76f86b47',
+        parity: 0,
+        result: '9534f8dc8c6deda2dc007655981c78b49c5d96c778fbf363462a11ec9dfd948c',
+    },
+];
+/**
+ * Verifies that the ECC library implementation is correct.
+ * Tests `isXOnlyPoint` and `xOnlyPointAddTweak` with known test vectors.
+ *
+ * @param ecc - The ECC library to verify
+ * @throws Error if any verification test fails
+ */
+function verifyEcc(ecc) {
+    if (typeof ecc.isXOnlyPoint !== 'function') {
+        throw new Error('ECC library missing isXOnlyPoint function');
+    }
+    // Test isXOnlyPoint with valid points
+    const validPoints = [
+        '79be667ef9dcbbac55a06295ce870b07029bfcdb2dce28d959f2815b16f81798',
+        'fffffffffffffffffffffffffffffffffffffffffffffffffffffffeeffffc2e',
+        'f9308a019258c31049344f85f89d5229b531c845836f99b08601f113bce036f9',
+        '0000000000000000000000000000000000000000000000000000000000000001',
+    ];
+    for (const hex of validPoints) {
+        if (!ecc.isXOnlyPoint(fromHex(hex))) {
+            throw new Error(`ECC library isXOnlyPoint failed for valid point: ${hex}`);
+        }
+    }
+    // Test isXOnlyPoint with invalid points
+    const invalidPoints = [
+        '0000000000000000000000000000000000000000000000000000000000000000',
+        'fffffffffffffffffffffffffffffffffffffffffffffffffffffffefffffc2f',
+    ];
+    for (const hex of invalidPoints) {
+        if (ecc.isXOnlyPoint(fromHex(hex))) {
+            throw new Error(`ECC library isXOnlyPoint should reject invalid point: ${hex}`);
+        }
+    }
+    // Test xOnlyPointAddTweak
+    if (typeof ecc.xOnlyPointAddTweak !== 'function') {
+        throw new Error('ECC library missing xOnlyPointAddTweak function');
+    }
+    for (const vector of TWEAK_ADD_VECTORS) {
+        const result = ecc.xOnlyPointAddTweak(fromHex(vector.pubkey), fromHex(vector.tweak));
+        if (vector.result === null) {
+            if (result !== null) {
+                throw new Error(`ECC library xOnlyPointAddTweak should return null for: ${vector.pubkey}`);
+            }
+        }
+        else {
+            if (result === null) {
+                throw new Error(`ECC library xOnlyPointAddTweak returned null unexpectedly for: ${vector.pubkey}`);
+            }
+            if (result.parity !== vector.parity) {
+                throw new Error(`ECC library xOnlyPointAddTweak parity mismatch for: ${vector.pubkey}`);
+            }
+            if (!equals(result.xOnlyPubkey, fromHex(vector.result))) {
+                throw new Error(`ECC library xOnlyPointAddTweak result mismatch for: ${vector.pubkey}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=context.js.map

package/build/ecc/context.js.map

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

package/build/ecc/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ECC (Elliptic Curve Cryptography) module.
+ *
+ * Provides dependency injection for the secp256k1 elliptic curve library
+ * required for Taproot (BIP340/BIP341) operations.
+ *
+ * @packageDocumentation
+ */
+export type { EccLib, XOnlyPointAddTweakResult, Parity } from './types.js';
+export { EccContext, initEccLib, getEccLib } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/build/ecc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ecc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/build/ecc/index.js

@@ -0,0 +1,11 @@
+/**
+ * ECC (Elliptic Curve Cryptography) module.
+ *
+ * Provides dependency injection for the secp256k1 elliptic curve library
+ * required for Taproot (BIP340/BIP341) operations.
+ *
+ * @packageDocumentation
+ */
+// Context management
+export { EccContext, initEccLib, getEccLib } from './context.js';
+//# sourceMappingURL=index.js.map

package/build/ecc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ecc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}