@btc-vision/bitcoin 6.3.0 → 6.3.2

package/build/networks.js

@@ -0,0 +1,121 @@
+export const bitcoin = {
+    messagePrefix: '\x18Bitcoin Signed Message:\n',
+    bech32: 'bc',
+    bip32: {
+        public: 0x0488b21e,
+        private: 0x0488ade4,
+    },
+    pubKeyHash: 0x00,
+    scriptHash: 0x05,
+    wif: 0x80,
+};
+export const regtest = {
+    messagePrefix: '\x18Bitcoin Signed Message:\n',
+    bech32: 'bcrt',
+    bip32: {
+        public: 0x043587cf,
+        private: 0x04358394,
+    },
+    pubKeyHash: 0x6f,
+    scriptHash: 0xc4,
+    wif: 0xef,
+};
+export const testnet = {
+    messagePrefix: '\x18Bitcoin Signed Message:\n',
+    bech32: 'tb',
+    bip32: {
+        public: 0x043587cf,
+        private: 0x04358394,
+    },
+    pubKeyHash: 0x6f,
+    scriptHash: 0xc4,
+    wif: 0xef,
+};
+export const dogecoin = {
+    messagePrefix: '\x19Dogecoin Signed Message:\n',
+    bech32: '',
+    bip32: {
+        public: 0x02facafd,
+        private: 0x02fac398,
+    },
+    pubKeyHash: 0x1e,
+    scriptHash: 0x16,
+    wif: 0x9e,
+};
+export const dogecoinTestnet = {
+    messagePrefix: '\x19Dogecoin Signed Message:\n',
+    bech32: '',
+    bip32: {
+        public: 0x0432a9a8,
+        private: 0x0432a243,
+    },
+    pubKeyHash: 0x71,
+    scriptHash: 0xc4,
+    wif: 0xf1,
+};
+export const litecoin = {
+    messagePrefix: '\x19Litecoin Signed Message:\n',
+    bech32: 'ltc',
+    bip32: {
+        public: 0x019da462,
+        private: 0x019d9cfe,
+    },
+    pubKeyHash: 0x30,
+    scriptHash: 0x32,
+    wif: 0xb0,
+};
+export const litecoinTestnet = {
+    messagePrefix: '\x19Litecoin Signed Message:\n',
+    bech32: 'tltc',
+    bip32: {
+        public: 0x0436ef7d,
+        private: 0x0436f6e1,
+    },
+    pubKeyHash: 0x6f,
+    scriptHash: 0x3a,
+    wif: 0xef,
+};
+export const bitcoinCash = {
+    messagePrefix: '\x18Bitcoin Signed Message:\n',
+    bech32: 'bitcoincash',
+    bip32: {
+        public: 0x0488b21e,
+        private: 0x0488ade4,
+    },
+    pubKeyHash: 0x00,
+    scriptHash: 0x05,
+    wif: 0x80,
+};
+export const bitcoinCashTestnet = {
+    messagePrefix: '\x18Bitcoin Signed Message:\n',
+    bech32: 'bchtest',
+    bip32: {
+        public: 0x043587cf,
+        private: 0x04358394,
+    },
+    pubKeyHash: 0x6f,
+    scriptHash: 0xc4,
+    wif: 0xef,
+};
+export const dash = {
+    messagePrefix: '\x19DarkCoin Signed Message:\n',
+    bech32: '',
+    bip32: {
+        public: 0x02fe52cc,
+        private: 0x02fe52f8,
+    },
+    pubKeyHash: 0x4c,
+    scriptHash: 0x10,
+    wif: 0xcc,
+};
+export const dashTestnet = {
+    messagePrefix: '\x19DarkCoin Signed Message:\n',
+    bech32: '',
+    bip32: {
+        public: 0x3a8061a0,
+        private: 0x3a805837,
+    },
+    pubKeyHash: 0x8c,
+    scriptHash: 0x13,
+    wif: 0xef,
+};

package/build/ops.d.ts

@@ -0,0 +1,126 @@
+export interface Opcodes {
+    OP_FALSE: number;
+    OP_0: number;
+    OP_PUSHDATA1: number;
+    OP_PUSHDATA2: number;
+    OP_PUSHDATA4: number;
+    OP_1NEGATE: number;
+    OP_RESERVED: number;
+    OP_TRUE: number;
+    OP_1: number;
+    OP_2: number;
+    OP_3: number;
+    OP_4: number;
+    OP_5: number;
+    OP_6: number;
+    OP_7: number;
+    OP_8: number;
+    OP_9: number;
+    OP_10: number;
+    OP_11: number;
+    OP_12: number;
+    OP_13: number;
+    OP_14: number;
+    OP_15: number;
+    OP_16: number;
+    OP_NOP: number;
+    OP_VER: number;
+    OP_IF: number;
+    OP_NOTIF: number;
+    OP_VERIF: number;
+    OP_VERNOTIF: number;
+    OP_ELSE: number;
+    OP_ENDIF: number;
+    OP_VERIFY: number;
+    OP_RETURN: number;
+    OP_TOALTSTACK: number;
+    OP_FROMALTSTACK: number;
+    OP_2DROP: number;
+    OP_2DUP: number;
+    OP_3DUP: number;
+    OP_2OVER: number;
+    OP_2ROT: number;
+    OP_2SWAP: number;
+    OP_IFDUP: number;
+    OP_DEPTH: number;
+    OP_DROP: number;
+    OP_DUP: number;
+    OP_NIP: number;
+    OP_OVER: number;
+    OP_PICK: number;
+    OP_ROLL: number;
+    OP_ROT: number;
+    OP_SWAP: number;
+    OP_TUCK: number;
+    OP_CAT: number;
+    OP_SUBSTR: number;
+    OP_LEFT: number;
+    OP_RIGHT: number;
+    OP_SIZE: number;
+    OP_INVERT: number;
+    OP_AND: number;
+    OP_OR: number;
+    OP_XOR: number;
+    OP_EQUAL: number;
+    OP_EQUALVERIFY: number;
+    OP_RESERVED1: number;
+    OP_RESERVED2: number;
+    OP_1ADD: number;
+    OP_1SUB: number;
+    OP_2MUL: number;
+    OP_2DIV: number;
+    OP_NEGATE: number;
+    OP_ABS: number;
+    OP_NOT: number;
+    OP_0NOTEQUAL: number;
+    OP_ADD: number;
+    OP_SUB: number;
+    OP_MUL: number;
+    OP_DIV: number;
+    OP_MOD: number;
+    OP_LSHIFT: number;
+    OP_RSHIFT: number;
+    OP_BOOLAND: number;
+    OP_BOOLOR: number;
+    OP_NUMEQUAL: number;
+    OP_NUMEQUALVERIFY: number;
+    OP_NUMNOTEQUAL: number;
+    OP_LESSTHAN: number;
+    OP_GREATERTHAN: number;
+    OP_LESSTHANOREQUAL: number;
+    OP_GREATERTHANOREQUAL: number;
+    OP_MIN: number;
+    OP_MAX: number;
+    OP_WITHIN: number;
+    OP_RIPEMD160: number;
+    OP_SHA1: number;
+    OP_SHA256: number;
+    OP_HASH160: number;
+    OP_HASH256: number;
+    OP_CODESEPARATOR: number;
+    OP_CHECKSIG: number;
+    OP_CHECKSIGVERIFY: number;
+    OP_CHECKMULTISIG: number;
+    OP_CHECKMULTISIGVERIFY: number;
+    OP_CHECKLOCKTIMEVERIFY: number;
+    OP_CHECKSEQUENCEVERIFY: number;
+    OP_CHECKSIGADD: number;
+    OP_NOP1: number;
+    OP_NOP2: number;
+    OP_NOP3: number;
+    OP_NOP4: number;
+    OP_NOP5: number;
+    OP_NOP6: number;
+    OP_NOP7: number;
+    OP_NOP8: number;
+    OP_NOP9: number;
+    OP_NOP10: number;
+    OP_PUBKEYHASH: number;
+    OP_PUBKEY: number;
+    OP_INVALIDOPCODE: number;
+}
+declare const OPS: Opcodes;
+declare const REVERSE_OPS: {
+    [key: number]: string;
+};
+export { OPS, REVERSE_OPS };

package/{src → build}/ops.js

@@ -1,131 +1,127 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.REVERSE_OPS = exports.OPS = void 0;
-const OPS = {
-    OP_FALSE: 0,
-    OP_0: 0,
-    OP_PUSHDATA1: 76,
-    OP_PUSHDATA2: 77,
-    OP_PUSHDATA4: 78,
-    OP_1NEGATE: 79,
-    OP_RESERVED: 80,
-    OP_TRUE: 81,
-    OP_1: 81,
-    OP_2: 82,
-    OP_3: 83,
-    OP_4: 84,
-    OP_5: 85,
-    OP_6: 86,
-    OP_7: 87,
-    OP_8: 88,
-    OP_9: 89,
-    OP_10: 90,
-    OP_11: 91,
-    OP_12: 92,
-    OP_13: 93,
-    OP_14: 94,
-    OP_15: 95,
-    OP_16: 96,
-    OP_NOP: 97,
-    OP_VER: 98,
-    OP_IF: 99,
-    OP_NOTIF: 100,
-    OP_VERIF: 101,
-    OP_VERNOTIF: 102,
-    OP_ELSE: 103,
-    OP_ENDIF: 104,
-    OP_VERIFY: 105,
-    OP_RETURN: 106,
-    OP_TOALTSTACK: 107,
-    OP_FROMALTSTACK: 108,
-    OP_2DROP: 109,
-    OP_2DUP: 110,
-    OP_3DUP: 111,
-    OP_2OVER: 112,
-    OP_2ROT: 113,
-    OP_2SWAP: 114,
-    OP_IFDUP: 115,
-    OP_DEPTH: 116,
-    OP_DROP: 117,
-    OP_DUP: 118,
-    OP_NIP: 119,
-    OP_OVER: 120,
-    OP_PICK: 121,
-    OP_ROLL: 122,
-    OP_ROT: 123,
-    OP_SWAP: 124,
-    OP_TUCK: 125,
-    OP_CAT: 126,
-    OP_SUBSTR: 127,
-    OP_LEFT: 128,
-    OP_RIGHT: 129,
-    OP_SIZE: 130,
-    OP_INVERT: 131,
-    OP_AND: 132,
-    OP_OR: 133,
-    OP_XOR: 134,
-    OP_EQUAL: 135,
-    OP_EQUALVERIFY: 136,
-    OP_RESERVED1: 137,
-    OP_RESERVED2: 138,
-    OP_1ADD: 139,
-    OP_1SUB: 140,
-    OP_2MUL: 141,
-    OP_2DIV: 142,
-    OP_NEGATE: 143,
-    OP_ABS: 144,
-    OP_NOT: 145,
-    OP_0NOTEQUAL: 146,
-    OP_ADD: 147,
-    OP_SUB: 148,
-    OP_MUL: 149,
-    OP_DIV: 150,
-    OP_MOD: 151,
-    OP_LSHIFT: 152,
-    OP_RSHIFT: 153,
-    OP_BOOLAND: 154,
-    OP_BOOLOR: 155,
-    OP_NUMEQUAL: 156,
-    OP_NUMEQUALVERIFY: 157,
-    OP_NUMNOTEQUAL: 158,
-    OP_LESSTHAN: 159,
-    OP_GREATERTHAN: 160,
-    OP_LESSTHANOREQUAL: 161,
-    OP_GREATERTHANOREQUAL: 162,
-    OP_MIN: 163,
-    OP_MAX: 164,
-    OP_WITHIN: 165,
-    OP_RIPEMD160: 166,
-    OP_SHA1: 167,
-    OP_SHA256: 168,
-    OP_HASH160: 169,
-    OP_HASH256: 170,
-    OP_CODESEPARATOR: 171,
-    OP_CHECKSIG: 172,
-    OP_CHECKSIGVERIFY: 173,
-    OP_CHECKMULTISIG: 174,
-    OP_CHECKMULTISIGVERIFY: 175,
-    OP_NOP1: 176,
-    OP_NOP2: 177,
-    OP_CHECKLOCKTIMEVERIFY: 177,
-    OP_NOP3: 178,
-    OP_CHECKSEQUENCEVERIFY: 178,
-    OP_NOP4: 179,
-    OP_NOP5: 180,
-    OP_NOP6: 181,
-    OP_NOP7: 182,
-    OP_NOP8: 183,
-    OP_NOP9: 184,
-    OP_NOP10: 185,
-    OP_CHECKSIGADD: 186,
-    OP_PUBKEYHASH: 253,
-    OP_PUBKEY: 254,
-    OP_INVALIDOPCODE: 255,
-};
-exports.OPS = OPS;
-const REVERSE_OPS = {};
-exports.REVERSE_OPS = REVERSE_OPS;
-for (const op of Object.keys(OPS)) {
-    const code = OPS[op];
-    REVERSE_OPS[code] = op;
-}
+const OPS = {
+    OP_FALSE: 0,
+    OP_0: 0,
+    OP_PUSHDATA1: 76,
+    OP_PUSHDATA2: 77,
+    OP_PUSHDATA4: 78,
+    OP_1NEGATE: 79,
+    OP_RESERVED: 80,
+    OP_TRUE: 81,
+    OP_1: 81,
+    OP_2: 82,
+    OP_3: 83,
+    OP_4: 84,
+    OP_5: 85,
+    OP_6: 86,
+    OP_7: 87,
+    OP_8: 88,
+    OP_9: 89,
+    OP_10: 90,
+    OP_11: 91,
+    OP_12: 92,
+    OP_13: 93,
+    OP_14: 94,
+    OP_15: 95,
+    OP_16: 96,
+    OP_NOP: 97,
+    OP_VER: 98,
+    OP_IF: 99,
+    OP_NOTIF: 100,
+    OP_VERIF: 101,
+    OP_VERNOTIF: 102,
+    OP_ELSE: 103,
+    OP_ENDIF: 104,
+    OP_VERIFY: 105,
+    OP_RETURN: 106,
+    OP_TOALTSTACK: 107,
+    OP_FROMALTSTACK: 108,
+    OP_2DROP: 109,
+    OP_2DUP: 110,
+    OP_3DUP: 111,
+    OP_2OVER: 112,
+    OP_2ROT: 113,
+    OP_2SWAP: 114,
+    OP_IFDUP: 115,
+    OP_DEPTH: 116,
+    OP_DROP: 117,
+    OP_DUP: 118,
+    OP_NIP: 119,
+    OP_OVER: 120,
+    OP_PICK: 121,
+    OP_ROLL: 122,
+    OP_ROT: 123,
+    OP_SWAP: 124,
+    OP_TUCK: 125,
+    OP_CAT: 126,
+    OP_SUBSTR: 127,
+    OP_LEFT: 128,
+    OP_RIGHT: 129,
+    OP_SIZE: 130,
+    OP_INVERT: 131,
+    OP_AND: 132,
+    OP_OR: 133,
+    OP_XOR: 134,
+    OP_EQUAL: 135,
+    OP_EQUALVERIFY: 136,
+    OP_RESERVED1: 137,
+    OP_RESERVED2: 138,
+    OP_1ADD: 139,
+    OP_1SUB: 140,
+    OP_2MUL: 141,
+    OP_2DIV: 142,
+    OP_NEGATE: 143,
+    OP_ABS: 144,
+    OP_NOT: 145,
+    OP_0NOTEQUAL: 146,
+    OP_ADD: 147,
+    OP_SUB: 148,
+    OP_MUL: 149,
+    OP_DIV: 150,
+    OP_MOD: 151,
+    OP_LSHIFT: 152,
+    OP_RSHIFT: 153,
+    OP_BOOLAND: 154,
+    OP_BOOLOR: 155,
+    OP_NUMEQUAL: 156,
+    OP_NUMEQUALVERIFY: 157,
+    OP_NUMNOTEQUAL: 158,
+    OP_LESSTHAN: 159,
+    OP_GREATERTHAN: 160,
+    OP_LESSTHANOREQUAL: 161,
+    OP_GREATERTHANOREQUAL: 162,
+    OP_MIN: 163,
+    OP_MAX: 164,
+    OP_WITHIN: 165,
+    OP_RIPEMD160: 166,
+    OP_SHA1: 167,
+    OP_SHA256: 168,
+    OP_HASH160: 169,
+    OP_HASH256: 170,
+    OP_CODESEPARATOR: 171,
+    OP_CHECKSIG: 172,
+    OP_CHECKSIGVERIFY: 173,
+    OP_CHECKMULTISIG: 174,
+    OP_CHECKMULTISIGVERIFY: 175,
+    OP_NOP1: 176,
+    OP_NOP2: 177,
+    OP_CHECKLOCKTIMEVERIFY: 177,
+    OP_NOP3: 178,
+    OP_CHECKSEQUENCEVERIFY: 178,
+    OP_NOP4: 179,
+    OP_NOP5: 180,
+    OP_NOP6: 181,
+    OP_NOP7: 182,
+    OP_NOP8: 183,
+    OP_NOP9: 184,
+    OP_NOP10: 185,
+    OP_CHECKSIGADD: 186,
+    OP_PUBKEYHASH: 253,
+    OP_PUBKEY: 254,
+    OP_INVALIDOPCODE: 255,
+};
+const REVERSE_OPS = {};
+for (const op of Object.keys(OPS)) {
+    const code = OPS[op];
+    REVERSE_OPS[code] = op;
+}
+export { OPS, REVERSE_OPS };

package/build/payments/bip341.d.ts

@@ -0,0 +1,23 @@
+import { Tapleaf, Taptree } from '../types.js';
+export declare const LEAF_VERSION_TAPSCRIPT = 192;
+export declare const MAX_TAPTREE_DEPTH = 128;
+interface HashLeaf {
+    hash: Buffer;
+}
+interface HashBranch {
+    hash: Buffer;
+    left: HashTree;
+    right: HashTree;
+}
+interface TweakedPublicKey {
+    parity: number;
+    x: Buffer;
+}
+export type HashTree = HashLeaf | HashBranch;
+export declare function rootHashFromPath(controlBlock: Buffer, leafHash: Buffer): Buffer;
+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;
+export {};

package/build/payments/bip341.js

@@ -0,0 +1,82 @@
+import { Buffer as NBuffer } from 'buffer';
+import * as bcrypto from '../crypto.js';
+import { getEccLib } from '../ecc_lib.js';
+import { varuint } from '../bufferutils.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;
+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.`);
+    const m = (controlBlock.length - 33) / 32;
+    let kj = leafHash;
+    for (let j = 0; j < m; j++) {
+        const ej = controlBlock.slice(33 + 32 * j, 65 + 32 * j);
+        if (kj.compare(ej) < 0) {
+            kj = tapBranchHash(kj, ej);
+        }
+        else {
+            kj = tapBranchHash(ej, kj);
+        }
+    }
+    return kj;
+}
+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));
+    const [left, right] = hashes;
+    return {
+        hash: tapBranchHash(left.hash, right.hash),
+        left,
+        right,
+    };
+}
+export function findScriptPath(node, hash) {
+    if (isHashBranch(node)) {
+        const leftPath = findScriptPath(node.left, hash);
+        if (leftPath !== undefined)
+            return [...leftPath, node.right.hash];
+        const rightPath = findScriptPath(node.right, hash);
+        if (rightPath !== undefined)
+            return [...rightPath, node.left.hash];
+    }
+    else if (node.hash.equals(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)]));
+}
+export function tapTweakHash(pubKey, h) {
+    return bcrypto.taggedHash('TapTweak', NBuffer.concat(h ? [pubKey, h] : [pubKey]));
+}
+export function tweakKey(pubKey, h) {
+    if (!NBuffer.isBuffer(pubKey))
+        return null;
+    if (pubKey.length !== 32)
+        return null;
+    if (h && h.length !== 32)
+        return null;
+    const tweakHash = tapTweakHash(pubKey, h);
+    const res = getEccLib().xOnlyPointAddTweak(pubKey, tweakHash);
+    if (!res || res.xOnlyPubkey === null)
+        return null;
+    return {
+        parity: res.parity,
+        x: NBuffer.from(res.xOnlyPubkey),
+    };
+}
+function tapBranchHash(a, b) {
+    return bcrypto.taggedHash('TapBranch', NBuffer.concat([a, b]));
+}
+function serializeScript(s) {
+    const varintLen = varuint.encodingLength(s.length);
+    const buffer = NBuffer.allocUnsafe(varintLen);
+    varuint.encode(s.length, buffer);
+    return NBuffer.concat([buffer, s]);
+}

package/build/payments/embed.d.ts

@@ -0,0 +1,2 @@
+import { Payment, PaymentOpts } from './index.js';
+export declare function p2data(a: Payment, opts?: PaymentOpts): Payment;

package/build/payments/embed.js

@@ -0,0 +1,39 @@
+import { bitcoin as BITCOIN_NETWORK } from '../networks.js';
+import * as bscript from '../script.js';
+import { stacksEqual, typeforce as typef } from '../types.js';
+import * as lazy from './lazy.js';
+const OPS = bscript.OPS;
+export function p2data(a, opts) {
+    if (!a.data && !a.output)
+        throw new TypeError('Not enough data');
+    opts = Object.assign({ validate: true }, opts || {});
+    typef({
+        network: typef.maybe(typef.Object),
+        output: typef.maybe(typef.Buffer),
+        data: typef.maybe(typef.arrayOf(typef.Buffer)),
+    }, a);
+    const network = a.network || BITCOIN_NETWORK;
+    const o = { name: 'embed', network };
+    lazy.prop(o, 'output', () => {
+        if (!a.data)
+            return;
+        return bscript.compile([OPS.OP_RETURN].concat(a.data));
+    });
+    lazy.prop(o, 'data', () => {
+        if (!a.output)
+            return;
+        return bscript.decompile(a.output).slice(1);
+    });
+    if (opts.validate) {
+        if (a.output) {
+            const chunks = bscript.decompile(a.output);
+            if (chunks[0] !== OPS.OP_RETURN)
+                throw new TypeError('Output is invalid');
+            if (!chunks.slice(1).every(typef.Buffer))
+                throw new TypeError('Output is invalid');
+            if (a.data && !stacksEqual(a.data, o.data))
+                throw new TypeError('Data mismatch');
+        }
+    }
+    return Object.assign(o, a);
+}