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

package/build/merkle.js

@@ -1,3 +1,11 @@
+/**
+ * Calculates the Merkle root of an array of Uint8Arrays using a specified digest function.
+ *
+ * @param values - The array of Uint8Arrays.
+ * @param digestFn - The digest function used to calculate the hash of the concatenated arrays.
+ * @returns The Merkle root as a Uint8Array.
+ * @throws {TypeError} If the values parameter is not an array or the digestFn parameter is not a function.
+ */
 export function fastMerkleRoot(values, digestFn) {
     if (!Array.isArray(values))
         throw TypeError('Expected values Array');
@@ -10,10 +18,13 @@ export function fastMerkleRoot(values, digestFn) {
         for (let i = 0; i < length; i += 2, ++j) {
             const left = results[i];
             const right = i + 1 === length ? left : results[i + 1];
-            const data = Buffer.concat([left, right]);
+            const data = new Uint8Array(left.length + right.length);
+            data.set(left);
+            data.set(right, left.length);
             results[j] = digestFn(data);
         }
         length = j;
     }
     return results[0];
 }
+//# sourceMappingURL=merkle.js.map

package/build/merkle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merkle.js","sourceRoot":"","sources":["../src/merkle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC1B,MAAoB,EACpB,QAAuC;IAEvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,SAAS,CAAC,uBAAuB,CAAC,CAAC;IACrE,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,MAAM,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAEhF,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhC,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,CAAC;QAEV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YACzB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACxD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAE7B,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACvB,CAAC"}

package/build/networks.d.ts

@@ -1,24 +1,85 @@
+/**
+ * Represents a Bitcoin network configuration，including messagePrefix, bech32, bip32, pubKeyHash, scriptHash, wif.
+ * Support bitcoin、bitcoin testnet and bitcoin regtest.
+ * @packageDocumentation
+ */
 export interface Bip32 {
-    public: number;
-    private: number;
+    readonly public: number;
+    readonly private: number;
 }
 export interface Network {
-    wif: number;
-    bip32: Bip32;
-    messagePrefix: string;
-    bech32: string;
-    bech32Opnet?: string;
-    pubKeyHash: number;
-    scriptHash: number;
+    readonly wif: number;
+    readonly bip32: Bip32;
+    readonly messagePrefix: string;
+    readonly bech32: string;
+    readonly bech32Opnet?: string;
+    readonly pubKeyHash: number;
+    readonly scriptHash: number;
 }
+/**
+ * Represents the Bitcoin network configuration.
+ */
 export declare const bitcoin: Network;
+/**
+ * Represents the regtest network configuration.
+ */
 export declare const regtest: Network;
+/**
+ * Represents the testnet network configuration.
+ */
 export declare const testnet: Network;
+/**
+ * Represents the Dogecoin mainnet configuration.
+ *
+ * Prefixes from:
+ * - P2PKH: 0x1e (30 decimal) - addresses start with 'D'
+ * - P2SH: 0x16 (22 decimal) - addresses often start with '9' or 'A'
+ * - WIF: 0x9e (158 decimal)
+ * - BIP32:
+ *   - public: 0x02facafd
+ *   - private: 0x02fac398
+ * Message prefix:
+ *   - Dogecoin uses "\x19Dogecoin Signed Message:\n"
+ */
 export declare const dogecoin: Network;
+/**
+ * Represents the Dogecoin testnet configuration.
+ *
+ * Prefixes from Dogecoin testnet chainparams:
+ * - P2PKH: 0x71 (113 decimal)
+ * - P2SH: 0xc4 (196 decimal)
+ * - WIF: 0xf1 (241 decimal)
+ * - BIP32:
+ *   - public: 0x0432a9a8
+ *   - private: 0x0432a243
+ * Message prefix:
+ *   - Same as mainnet: "\x19Dogecoin Signed Message:\n"
+ */
 export declare const dogecoinTestnet: Network;
+/**
+ * Litecoin mainnet configuration.
+ */
 export declare const litecoin: Network;
+/**
+ * Litecoin testnet configuration.
+ */
 export declare const litecoinTestnet: Network;
+/**
+ * Bitcoin Cash mainnet configuration (legacy).
+ * Note: Bitcoin Cash uses Cashaddr starting with 'q' or 'p',
+ * but we retain the legacy prefixes for compatibility.
+ */
 export declare const bitcoinCash: Network;
+/**
+ * Bitcoin Cash testnet configuration (legacy).
+ */
 export declare const bitcoinCashTestnet: Network;
+/**
+ * Dash mainnet configuration.
+ */
 export declare const dash: Network;
+/**
+ * Dash testnet configuration.
+ */
 export declare const dashTestnet: Network;
+//# sourceMappingURL=networks.d.ts.map

package/build/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,WAAW,KAAK;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAmCrB,CAAC;AACF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAWrB,CAAC;AACF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAWrB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,EAAE,OAWtB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,OAW7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,OAWtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAW7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,OAazB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAWhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,OAalB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,OAWzB,CAAC"}

package/build/networks.js

@@ -1,15 +1,47 @@
+// https://en.bitcoin.it/wiki/List_of_address_prefixes
+// Dogecoin BIP32 is a proposed standard: https://bitcointalk.org/index.php?topic=409731
+/**
+ * Represents the Bitcoin network configuration.
+ */
 export const bitcoin = {
+    /**
+     * The message prefix used for signing Bitcoin messages.
+     */
     messagePrefix: '\x18Bitcoin Signed Message:\n',
+    /**
+     * The Bech32 prefix used for Bitcoin addresses.
+     */
     bech32: 'bc',
     bech32Opnet: 'op',
+    /**
+     * The BIP32 key prefixes for Bitcoin.
+     */
     bip32: {
+        /**
+         * The public key prefix for BIP32 extended public keys.
+         */
         public: 0x0488b21e,
+        /**
+         * The private key prefix for BIP32 extended private keys.
+         */
         private: 0x0488ade4,
     },
+    /**
+     * The prefix for Bitcoin public key hashes.
+     */
     pubKeyHash: 0x00,
+    /**
+     * The prefix for Bitcoin script hashes.
+     */
     scriptHash: 0x05,
+    /**
+     * The prefix for Bitcoin Wallet Import Format (WIF) private keys.
+     */
     wif: 0x80,
 };
+/**
+ * Represents the regtest network configuration.
+ */
 export const regtest = {
     messagePrefix: '\x18Bitcoin Signed Message:\n',
     bech32: 'bcrt',
@@ -22,6 +54,9 @@ export const regtest = {
     scriptHash: 0xc4,
     wif: 0xef,
 };
+/**
+ * Represents the testnet network configuration.
+ */
 export const testnet = {
     messagePrefix: '\x18Bitcoin Signed Message:\n',
     bech32: 'tb',
@@ -34,9 +69,22 @@ export const testnet = {
     scriptHash: 0xc4,
     wif: 0xef,
 };
+/**
+ * Represents the Dogecoin mainnet configuration.
+ *
+ * Prefixes from:
+ * - P2PKH: 0x1e (30 decimal) - addresses start with 'D'
+ * - P2SH: 0x16 (22 decimal) - addresses often start with '9' or 'A'
+ * - WIF: 0x9e (158 decimal)
+ * - BIP32:
+ *   - public: 0x02facafd
+ *   - private: 0x02fac398
+ * Message prefix:
+ *   - Dogecoin uses "\x19Dogecoin Signed Message:\n"
+ */
 export const dogecoin = {
     messagePrefix: '\x19Dogecoin Signed Message:\n',
-    bech32: '',
+    bech32: '', // Dogecoin does not currently use Bech32
     bech32Opnet: '',
     bip32: {
         public: 0x02facafd,
@@ -46,9 +94,22 @@ export const dogecoin = {
     scriptHash: 0x16,
     wif: 0x9e,
 };
+/**
+ * Represents the Dogecoin testnet configuration.
+ *
+ * Prefixes from Dogecoin testnet chainparams:
+ * - P2PKH: 0x71 (113 decimal)
+ * - P2SH: 0xc4 (196 decimal)
+ * - WIF: 0xf1 (241 decimal)
+ * - BIP32:
+ *   - public: 0x0432a9a8
+ *   - private: 0x0432a243
+ * Message prefix:
+ *   - Same as mainnet: "\x19Dogecoin Signed Message:\n"
+ */
 export const dogecoinTestnet = {
     messagePrefix: '\x19Dogecoin Signed Message:\n',
-    bech32: '',
+    bech32: '', // Dogecoin testnet does not currently use Bech32
     bech32Opnet: '',
     bip32: {
         public: 0x0432a9a8,
@@ -58,6 +119,9 @@ export const dogecoinTestnet = {
     scriptHash: 0xc4,
     wif: 0xf1,
 };
+/**
+ * Litecoin mainnet configuration.
+ */
 export const litecoin = {
     messagePrefix: '\x19Litecoin Signed Message:\n',
     bech32: 'ltc',
@@ -70,6 +134,9 @@ export const litecoin = {
     scriptHash: 0x32,
     wif: 0xb0,
 };
+/**
+ * Litecoin testnet configuration.
+ */
 export const litecoinTestnet = {
     messagePrefix: '\x19Litecoin Signed Message:\n',
     bech32: 'tltc',
@@ -82,8 +149,15 @@ export const litecoinTestnet = {
     scriptHash: 0x3a,
     wif: 0xef,
 };
+/**
+ * Bitcoin Cash mainnet configuration (legacy).
+ * Note: Bitcoin Cash uses Cashaddr starting with 'q' or 'p',
+ * but we retain the legacy prefixes for compatibility.
+ */
 export const bitcoinCash = {
     messagePrefix: '\x18Bitcoin Signed Message:\n',
+    // Cashaddr prefix differs from bech32 for general usage, but we can set it similarly.
+    // Actual cashaddr prefix is "bitcoincash", but this field is for bech32 which BCH doesn't fully use for segwit (it doesn't have segwit).
     bech32: 'bitcoincash',
     bech32Opnet: 'opbch',
     bip32: {
@@ -94,6 +168,9 @@ export const bitcoinCash = {
     scriptHash: 0x05,
     wif: 0x80,
 };
+/**
+ * Bitcoin Cash testnet configuration (legacy).
+ */
 export const bitcoinCashTestnet = {
     messagePrefix: '\x18Bitcoin Signed Message:\n',
     bech32: 'bchtest',
@@ -106,9 +183,14 @@ export const bitcoinCashTestnet = {
     scriptHash: 0xc4,
     wif: 0xef,
 };
+/**
+ * Dash mainnet configuration.
+ */
 export const dash = {
+    // Historically Dash used DarkCoin message prefix, and most implementations use this:
+    // As of Dash Core 0.17, this has not changed in code.
     messagePrefix: '\x19DarkCoin Signed Message:\n',
-    bech32: '',
+    bech32: '', // Dash does not use Bech32
     bech32Opnet: '',
     bip32: {
         public: 0x02fe52cc,
@@ -118,9 +200,12 @@ export const dash = {
     scriptHash: 0x10,
     wif: 0xcc,
 };
+/**
+ * Dash testnet configuration.
+ */
 export const dashTestnet = {
     messagePrefix: '\x19DarkCoin Signed Message:\n',
-    bech32: '',
+    bech32: '', // Dash testnet does not use Bech32
     bech32Opnet: '',
     bip32: {
         public: 0x3a8061a0,
@@ -130,3 +215,4 @@ export const dashTestnet = {
     scriptHash: 0x13,
     wif: 0xef,
 };
+//# sourceMappingURL=networks.js.map

package/build/networks.js.map

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

package/build/opcodes.d.ts

@@ -123,3 +123,4 @@ export declare const opcodes: Opcodes;
 export declare const REVERSE_OPS: {
     [key: number]: string;
 };
+//# sourceMappingURL=opcodes.d.ts.map

package/build/opcodes.d.ts.map

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

package/build/opcodes.js

@@ -124,3 +124,4 @@ for (const op of Object.keys(opcodes)) {
     const code = opcodes[op];
     REVERSE_OPS[code] = op;
 }
+//# sourceMappingURL=opcodes.js.map

package/build/opcodes.js.map

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

package/build/payments/bip341.d.ts

@@ -1,23 +1,50 @@
-import { Tapleaf, Taptree } from '../types.js';
+import type { Tapleaf, Taptree } from '../types.js';
+import type { Bytes32, XOnlyPublicKey } from '../types.js';
 export declare const LEAF_VERSION_TAPSCRIPT = 192;
 export declare const MAX_TAPTREE_DEPTH = 128;
 interface HashLeaf {
-    hash: Buffer;
+    hash: Bytes32;
 }
 interface HashBranch {
-    hash: Buffer;
+    hash: Bytes32;
     left: HashTree;
     right: HashTree;
 }
 interface TweakedPublicKey {
     parity: number;
-    x: Buffer;
+    x: XOnlyPublicKey;
 }
+/**
+ * Binary tree representing leaf, branch, and root node hashes of a Taptree.
+ * Each node contains a hash, and potentially left and right branch hashes.
+ * This tree is used for 2 purposes: Providing the root hash for tweaking,
+ * and calculating merkle inclusion proofs when constructing a control block.
+ */
 export type HashTree = HashLeaf | HashBranch;
-export declare function rootHashFromPath(controlBlock: Buffer, leafHash: Buffer): Buffer;
+/**
+ * Calculates the root hash from a given control block and leaf hash.
+ * @param controlBlock - The control block.
+ * @param leafHash - The leaf hash.
+ * @returns The root hash.
+ * @throws {TypeError} If the control block length is less than 33.
+ */
+export declare function rootHashFromPath(controlBlock: Uint8Array, leafHash: Uint8Array): Bytes32;
+/**
+ * Build a hash tree of merkle nodes from the scripts binary tree.
+ * @param scriptTree - the tree of scripts to pairwise hash.
+ */
 export declare function toHashTree(scriptTree: Taptree): HashTree;
-export declare function findScriptPath(node: HashTree, hash: Buffer): Buffer[] | undefined;
-export declare function tapleafHash(leaf: Tapleaf): Buffer;
-export declare function tapTweakHash(pubKey: Buffer, h: Buffer | undefined): Buffer;
-export declare function tweakKey(pubKey: Buffer, h: Buffer | undefined): TweakedPublicKey | null;
+/**
+ * Given a HashTree, finds the path from a particular hash to the root.
+ * @param node - the root of the tree
+ * @param hash - the hash to search for
+ * @returns - array of sibling hashes, from leaf (inclusive) to root
+ * (exclusive) needed to prove inclusion of the specified hash. undefined if no
+ * path is found
+ */
+export declare function findScriptPath(node: HashTree, hash: Bytes32): Bytes32[] | undefined;
+export declare function tapleafHash(leaf: Tapleaf): Bytes32;
+export declare function tapTweakHash(pubKey: XOnlyPublicKey, h: Bytes32 | undefined): Bytes32;
+export declare function tweakKey(pubKey: XOnlyPublicKey, h: Bytes32 | undefined): TweakedPublicKey | null;
 export {};
+//# sourceMappingURL=bip341.d.ts.map

package/build/payments/bip341.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bip341.d.ts","sourceRoot":"","sources":["../../src/payments/bip341.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,sBAAsB,MAAO,CAAC;AAC3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,UAAU,QAAQ;IACd,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,UAAU;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;CACnB;AAED,UAAU,gBAAgB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,cAAc,CAAC;CACrB;AAID;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAkBxF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,OAAO,GAAG,QAAQ,CAYxD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,CAYnF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMlD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAEpF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAchG"}

package/build/payments/bip341.js

@@ -1,11 +1,18 @@
-import { Buffer as NBuffer } from 'buffer';
 import * as bcrypto from '../crypto.js';
-import { getEccLib } from '../ecc_lib.js';
-import { varuint } from '../bufferutils.js';
+import { getEccLib } from '../ecc/context.js';
+import { concat, compare, equals, alloc } from '../io/index.js';
+import { varuint } from '../io/index.js';
 import { isTapleaf } from '../types.js';
 export const LEAF_VERSION_TAPSCRIPT = 0xc0;
 export const MAX_TAPTREE_DEPTH = 128;
 const isHashBranch = (ht) => 'left' in ht && 'right' in ht;
+/**
+ * Calculates the root hash from a given control block and leaf hash.
+ * @param controlBlock - The control block.
+ * @param leafHash - The leaf hash.
+ * @returns The root hash.
+ * @throws {TypeError} If the control block length is less than 33.
+ */
 export function rootHashFromPath(controlBlock, leafHash) {
     if (controlBlock.length < 33)
         throw new TypeError(`The control-block length is too small. Got ${controlBlock.length}, expected min 33.`);
@@ -13,7 +20,7 @@ export function rootHashFromPath(controlBlock, leafHash) {
     let kj = leafHash;
     for (let j = 0; j < m; j++) {
         const ej = controlBlock.subarray(33 + 32 * j, 65 + 32 * j);
-        if (kj.compare(ej) < 0) {
+        if (compare(kj, ej) < 0) {
             kj = tapBranchHash(kj, ej);
         }
         else {
@@ -22,18 +29,30 @@ export function rootHashFromPath(controlBlock, leafHash) {
     }
     return kj;
 }
+/**
+ * Build a hash tree of merkle nodes from the scripts binary tree.
+ * @param scriptTree - the tree of scripts to pairwise hash.
+ */
 export function toHashTree(scriptTree) {
     if (isTapleaf(scriptTree))
         return { hash: tapleafHash(scriptTree) };
     const hashes = [toHashTree(scriptTree[0]), toHashTree(scriptTree[1])];
-    hashes.sort((a, b) => a.hash.compare(b.hash));
+    hashes.sort((a, b) => compare(a.hash, b.hash));
     const [left, right] = hashes;
     return {
         hash: tapBranchHash(left.hash, right.hash),
-        left,
-        right,
+        left: left,
+        right: right,
     };
 }
+/**
+ * Given a HashTree, finds the path from a particular hash to the root.
+ * @param node - the root of the tree
+ * @param hash - the hash to search for
+ * @returns - array of sibling hashes, from leaf (inclusive) to root
+ * (exclusive) needed to prove inclusion of the specified hash. undefined if no
+ * path is found
+ */
 export function findScriptPath(node, hash) {
     if (isHashBranch(node)) {
         const leftPath = findScriptPath(node.left, hash);
@@ -43,20 +62,20 @@ export function findScriptPath(node, hash) {
         if (rightPath !== undefined)
             return [...rightPath, node.left.hash];
     }
-    else if (node.hash.equals(hash)) {
+    else if (equals(node.hash, hash)) {
         return [];
     }
     return undefined;
 }
 export function tapleafHash(leaf) {
     const version = leaf.version || LEAF_VERSION_TAPSCRIPT;
-    return bcrypto.taggedHash('TapLeaf', NBuffer.concat([NBuffer.from([version]), serializeScript(leaf.output)]));
+    return bcrypto.taggedHash('TapLeaf', concat([new Uint8Array([version]), serializeScript(leaf.output)]));
 }
 export function tapTweakHash(pubKey, h) {
-    return bcrypto.taggedHash('TapTweak', NBuffer.concat(h ? [pubKey, h] : [pubKey]));
+    return bcrypto.taggedHash('TapTweak', h ? concat([pubKey, h]) : pubKey);
 }
 export function tweakKey(pubKey, h) {
-    if (!NBuffer.isBuffer(pubKey))
+    if (!(pubKey instanceof Uint8Array))
         return null;
     if (pubKey.length !== 32)
         return null;
@@ -68,15 +87,16 @@ export function tweakKey(pubKey, h) {
         return null;
     return {
         parity: res.parity,
-        x: NBuffer.from(res.xOnlyPubkey),
+        x: new Uint8Array(res.xOnlyPubkey),
     };
 }
 function tapBranchHash(a, b) {
-    return bcrypto.taggedHash('TapBranch', NBuffer.concat([a, b]));
+    return bcrypto.taggedHash('TapBranch', concat([a, b]));
 }
 function serializeScript(s) {
     const varintLen = varuint.encodingLength(s.length);
-    const buffer = NBuffer.allocUnsafe(varintLen);
+    const buffer = alloc(varintLen);
     varuint.encode(s.length, buffer);
-    return NBuffer.concat([buffer, s]);
+    return concat([buffer, s]);
 }
+//# sourceMappingURL=bip341.js.map

package/build/payments/bip341.js.map

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

package/build/payments/embed.d.ts

@@ -1,2 +1,121 @@
-import { EmbedPayment, PaymentOpts } from './types.js';
+/**
+ * OP_RETURN Embed payment class.
+ *
+ * Embed payments use OP_RETURN to store arbitrary data in the blockchain.
+ * These outputs are provably unspendable.
+ *
+ * @packageDocumentation
+ */
+import { type Network } from '../networks.js';
+import type { Script } from '../types.js';
+import { PaymentType, type EmbedPayment, type PaymentOpts } from './types.js';
+/**
+ * OP_RETURN Embed payment class.
+ *
+ * Creates outputs of the form: `OP_RETURN {data1} {data2} ...`
+ * These outputs are provably unspendable and used for data storage.
+ *
+ * @example
+ * ```typescript
+ * import { Embed } from '@btc-vision/bitcoin';
+ *
+ * // Create from data
+ * const payment = Embed.fromData([Buffer.from('Hello, Bitcoin!')]);
+ * console.log(payment.output); // scriptPubKey with OP_RETURN
+ *
+ * // Decode an existing output
+ * const decoded = Embed.fromOutput(scriptPubKey);
+ * console.log(decoded.data); // array of data chunks
+ * ```
+ */
+export declare class Embed {
+    #private;
+    static readonly NAME: "embed";
+    /**
+     * Creates a new Embed payment instance.
+     *
+     * @param params - Payment parameters
+     * @param params.data - Array of data chunks to embed
+     * @param params.output - The scriptPubKey
+     * @param params.network - Network parameters (defaults to mainnet)
+     * @param opts - Payment options
+     * @param opts.validate - Whether to validate inputs (default: true)
+     *
+     * @throws {TypeError} If validation is enabled and data is invalid
+     */
+    constructor(params: {
+        data?: Uint8Array[] | undefined;
+        output?: Uint8Array | undefined;
+        network?: Network | undefined;
+    }, opts?: PaymentOpts);
+    /**
+     * Payment type discriminant.
+     */
+    get name(): typeof PaymentType.Embed;
+    /**
+     * Network parameters.
+     */
+    get network(): Network;
+    /**
+     * The embedded data chunks.
+     */
+    get data(): Uint8Array[];
+    /**
+     * The scriptPubKey: `OP_RETURN {data...}`
+     */
+    get output(): Script | undefined;
+    /**
+     * Creates an Embed payment from data chunks.
+     *
+     * @param data - Array of data chunks to embed
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new Embed payment instance
+     *
+     * @example
+     * ```typescript
+     * const payment = Embed.fromData([
+     *   new TextEncoder().encode('Hello'),
+     *   new TextEncoder().encode('Bitcoin')
+     * ]);
+     * ```
+     */
+    static fromData(data: Uint8Array[], network?: Network): Embed;
+    /**
+     * Creates an Embed payment from a scriptPubKey.
+     *
+     * @param output - The scriptPubKey
+     * @param network - Network parameters (defaults to mainnet)
+     * @returns A new Embed payment instance
+     */
+    static fromOutput(output: Uint8Array, network?: Network): Embed;
+    /**
+     * Converts to a plain EmbedPayment object for backwards compatibility.
+     *
+     * @returns An EmbedPayment object
+     */
+    toPayment(): EmbedPayment;
+}
+/**
+ * Creates an OP_RETURN Embed payment object.
+ *
+ * This is the legacy factory function for backwards compatibility.
+ * For new code, prefer using the Embed class directly.
+ *
+ * @param a - The payment object containing the necessary data
+ * @param opts - Optional payment options
+ * @returns The Embed payment object
+ * @throws {TypeError} If the required data is not provided or if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { p2data } from '@btc-vision/bitcoin';
+ *
+ * // Create from data
+ * const payment = p2data({ data: [Buffer.from('Hello')] });
+ *
+ * // Decode from output
+ * const decoded = p2data({ output: scriptPubKey });
+ * ```
+ */
 export declare function p2data(a: Omit<EmbedPayment, 'name'>, opts?: PaymentOpts): EmbedPayment;
+//# sourceMappingURL=embed.d.ts.map

package/build/payments/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/payments/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,KAAK;;IAEd,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAqB;IAkBzC;;;;;;;;;;;OAWG;gBAEC,MAAM,EAAE;QACJ,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;QAChC,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAChC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACjC,EACD,IAAI,CAAC,EAAE,WAAW;IAoBtB;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,WAAW,CAAC,KAAK,CAEnC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,UAAU,EAAE,CAMvB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAM/B;IAID;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAI7D;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK;IAmD/D;;;;OAIG;IACH,SAAS,IAAI,YAAY;CAQ5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,CAgBtF"}