@vbyte/btc-dev 1.0.0

package/dist/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@vbyte/btc-dev",
+  "version": "1.0.0",
+  "description": "Batteries-included toolset for plebian bitcoin development",
+  "type": "module",
+  "keywords": [
+    "bitcoin",
+    "blockchain",
+    "psbt",
+    "transaction",
+    "segwit",
+    "taproot"
+  ],
+  "author": "Christopher Scott",
+  "license": "CC-BY-1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cmdruid/btc-dev.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "LICENSE",
+    "dist",
+    "src"
+  ],
+  "main": "./main.cjs",
+  "module": "./index.js",
+  "unpkg": "./script.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./index.js",
+      "require": "./main.cjs",
+      "default": "./index.js"
+    },
+    "./address": {
+      "types": "./lib/address/index.d.ts",
+      "import": "./lib/address/index.js"
+    },
+    "./class": {
+      "types": "./class/index.d.ts",
+      "import": "./class/index.js"
+    },
+    "./meta": {
+      "types": "./lib/meta.d.ts",
+      "import": "./lib/meta.js"
+    },
+    "./psbt": {
+      "types": "./lib/psbt/index.d.ts",
+      "import": "./lib/psbt/index.js"
+    },
+    "./script": {
+      "types": "./lib/script/index.d.ts",
+      "import": "./lib/script/index.js"
+    },
+    "./sighash": {
+      "types": "./lib/sighash/index.d.ts",
+      "import": "./lib/sighash/index.js"
+    },
+    "./taproot": {
+      "types": "./lib/taproot/index.d.ts",
+      "import": "./lib/taproot/index.js"
+    },
+    "./tx": {
+      "types": "./lib/tx/index.d.ts",
+      "import": "./lib/tx/index.js"
+    }
+  },
+  "scripts": {
+    "build": "./scripts/build.sh",
+    "package": "npm test | faucet && npm run build",
+    "release": "./scripts/release.sh",
+    "scratch": "npm run script test/scratch.ts",
+    "script": "tsx --tsconfig ./test/tsconfig.json",
+    "test": "npm run script test/src/tape.ts"
+  },
+  "dependencies": {
+    "@noble/curves": "^1.9.2",
+    "@noble/hashes": "^1.8.0",
+    "@scure/btc-signer": "^1.8.1",
+    "@vbyte/buff": "^1.0.2",
+    "@vbyte/micro-lib": "^1.0.11",
+    "zod": "^3.25.69"
+  },
+  "devDependencies": {
+    "@cmdcode/core-cmd": "^1.6.5",
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/node": "^24.0.10",
+    "@types/tape": "^5.8.1",
+    "faucet": "^0.0.4",
+    "rollup": "^4.44.1",
+    "tape": "^5.9.0",
+    "tslib": "^2.8.1",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
+  }
+}

package/dist/schema/index.d.ts

@@ -0,0 +1,2 @@
+export * as taproot from './taproot.js';
+export * as tx from './tx.js';

package/dist/schema/index.js

@@ -0,0 +1,2 @@
+export * as taproot from './taproot.js';
+export * as tx from './tx.js';

package/dist/schema/taproot.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const taptree: z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodEffects<z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>, "many">, z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodEffects<z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>]>;
+export declare const config: z.ZodObject<{
+    pubkey: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodEffects<z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>;
+    leaves: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodEffects<z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>, "many">, z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodEffects<z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>]>, "many">>;
+    target: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodEffects<z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>]>>;
+    version: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pubkey: string | Uint8Array<ArrayBuffer>;
+    leaves?: (string | Uint8Array<ArrayBuffer> | (string | Uint8Array<ArrayBuffer>)[])[] | undefined;
+    target?: string | Uint8Array<ArrayBuffer> | undefined;
+    version?: number | undefined;
+}, {
+    pubkey: string | Uint8Array<ArrayBuffer>;
+    leaves?: (string | Uint8Array<ArrayBuffer> | (string | Uint8Array<ArrayBuffer>)[])[] | undefined;
+    target?: string | Uint8Array<ArrayBuffer> | undefined;
+    version?: number | undefined;
+}>;

package/dist/schema/taproot.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { byte32, uint } from '@vbyte/micro-lib/schema';
+export const taptree = z.union([z.array(byte32), byte32]);
+export const config = z.object({
+    pubkey: byte32,
+    leaves: taptree.array().optional(),
+    target: byte32.optional(),
+    version: uint.optional(),
+});

package/dist/schema/tx.d.ts

@@ -0,0 +1,278 @@
+import { z } from 'zod';
+export declare const sats: z.ZodBigInt;
+export declare const tx_output: z.ZodObject<{
+    value: z.ZodBigInt;
+    script_pk: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    value: bigint;
+    script_pk: string;
+}, {
+    value: bigint;
+    script_pk: string;
+}>;
+export declare const tx_input: z.ZodObject<{
+    coinbase: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    txid: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    vout: z.ZodNumber;
+    prevout: z.ZodNullable<z.ZodObject<{
+        value: z.ZodBigInt;
+        script_pk: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        value: bigint;
+        script_pk: string;
+    }, {
+        value: bigint;
+        script_pk: string;
+    }>>;
+    script_sig: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    sequence: z.ZodNumber;
+    witness: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+}, "strip", z.ZodTypeAny, {
+    coinbase: string | null;
+    txid: string;
+    vout: number;
+    prevout: {
+        value: bigint;
+        script_pk: string;
+    } | null;
+    script_sig: string | null;
+    sequence: number;
+    witness: string[];
+}, {
+    coinbase: string | null;
+    txid: string;
+    vout: number;
+    prevout: {
+        value: bigint;
+        script_pk: string;
+    } | null;
+    script_sig: string | null;
+    sequence: number;
+    witness: string[];
+}>;
+export declare const tx_data: z.ZodObject<{
+    version: z.ZodNumber;
+    vin: z.ZodArray<z.ZodObject<{
+        coinbase: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        txid: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        vout: z.ZodNumber;
+        prevout: z.ZodNullable<z.ZodObject<{
+            value: z.ZodBigInt;
+            script_pk: z.ZodEffects<z.ZodString, string, string>;
+        }, "strip", z.ZodTypeAny, {
+            value: bigint;
+            script_pk: string;
+        }, {
+            value: bigint;
+            script_pk: string;
+        }>>;
+        script_sig: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        sequence: z.ZodNumber;
+        witness: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        coinbase: string | null;
+        txid: string;
+        vout: number;
+        prevout: {
+            value: bigint;
+            script_pk: string;
+        } | null;
+        script_sig: string | null;
+        sequence: number;
+        witness: string[];
+    }, {
+        coinbase: string | null;
+        txid: string;
+        vout: number;
+        prevout: {
+            value: bigint;
+            script_pk: string;
+        } | null;
+        script_sig: string | null;
+        sequence: number;
+        witness: string[];
+    }>, "many">;
+    vout: z.ZodArray<z.ZodObject<{
+        value: z.ZodBigInt;
+        script_pk: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        value: bigint;
+        script_pk: string;
+    }, {
+        value: bigint;
+        script_pk: string;
+    }>, "many">;
+    locktime: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    vout: {
+        value: bigint;
+        script_pk: string;
+    }[];
+    vin: {
+        coinbase: string | null;
+        txid: string;
+        vout: number;
+        prevout: {
+            value: bigint;
+            script_pk: string;
+        } | null;
+        script_sig: string | null;
+        sequence: number;
+        witness: string[];
+    }[];
+    locktime: number;
+}, {
+    version: number;
+    vout: {
+        value: bigint;
+        script_pk: string;
+    }[];
+    vin: {
+        coinbase: string | null;
+        txid: string;
+        vout: number;
+        prevout: {
+            value: bigint;
+            script_pk: string;
+        } | null;
+        script_sig: string | null;
+        sequence: number;
+        witness: string[];
+    }[];
+    locktime: number;
+}>;
+export declare const vin_template: z.ZodObject<{
+    txid: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    vout: z.ZodNumber;
+} & {
+    coinbase: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+    prevout: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        value: z.ZodBigInt;
+        script_pk: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        value: bigint;
+        script_pk: string;
+    }, {
+        value: bigint;
+        script_pk: string;
+    }>>>;
+    script_sig: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+    sequence: z.ZodOptional<z.ZodNumber>;
+    witness: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    txid: string;
+    vout: number;
+    coinbase?: string | null | undefined;
+    prevout?: {
+        value: bigint;
+        script_pk: string;
+    } | null | undefined;
+    script_sig?: string | null | undefined;
+    sequence?: number | undefined;
+    witness?: string[] | undefined;
+}, {
+    txid: string;
+    vout: number;
+    coinbase?: string | null | undefined;
+    prevout?: {
+        value: bigint;
+        script_pk: string;
+    } | null | undefined;
+    script_sig?: string | null | undefined;
+    sequence?: number | undefined;
+    witness?: string[] | undefined;
+}>;
+export declare const tx_template: z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    vin: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        txid: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        vout: z.ZodNumber;
+    } & {
+        coinbase: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+        prevout: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            value: z.ZodBigInt;
+            script_pk: z.ZodEffects<z.ZodString, string, string>;
+        }, "strip", z.ZodTypeAny, {
+            value: bigint;
+            script_pk: string;
+        }, {
+            value: bigint;
+            script_pk: string;
+        }>>>;
+        script_sig: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
+        sequence: z.ZodOptional<z.ZodNumber>;
+        witness: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        txid: string;
+        vout: number;
+        coinbase?: string | null | undefined;
+        prevout?: {
+            value: bigint;
+            script_pk: string;
+        } | null | undefined;
+        script_sig?: string | null | undefined;
+        sequence?: number | undefined;
+        witness?: string[] | undefined;
+    }, {
+        txid: string;
+        vout: number;
+        coinbase?: string | null | undefined;
+        prevout?: {
+            value: bigint;
+            script_pk: string;
+        } | null | undefined;
+        script_sig?: string | null | undefined;
+        sequence?: number | undefined;
+        witness?: string[] | undefined;
+    }>, "many">>;
+    vout: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        value: z.ZodBigInt;
+        script_pk: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        value: bigint;
+        script_pk: string;
+    }, {
+        value: bigint;
+        script_pk: string;
+    }>, "many">>;
+    locktime: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    vout: {
+        value: bigint;
+        script_pk: string;
+    }[];
+    vin: {
+        txid: string;
+        vout: number;
+        coinbase?: string | null | undefined;
+        prevout?: {
+            value: bigint;
+            script_pk: string;
+        } | null | undefined;
+        script_sig?: string | null | undefined;
+        sequence?: number | undefined;
+        witness?: string[] | undefined;
+    }[];
+    version?: number | undefined;
+    locktime?: number | undefined;
+}, {
+    version?: number | undefined;
+    vout?: {
+        value: bigint;
+        script_pk: string;
+    }[] | undefined;
+    vin?: {
+        txid: string;
+        vout: number;
+        coinbase?: string | null | undefined;
+        prevout?: {
+            value: bigint;
+            script_pk: string;
+        } | null | undefined;
+        script_sig?: string | null | undefined;
+        sequence?: number | undefined;
+        witness?: string[] | undefined;
+    }[] | undefined;
+    locktime?: number | undefined;
+}>;

package/dist/schema/tx.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { big, hex, hex32, uint } from '@vbyte/micro-lib/schema';
+export const sats = big.max(2100000000000000n);
+export const tx_output = z.object({
+    value: sats,
+    script_pk: hex,
+});
+export const tx_input = z.object({
+    coinbase: hex.nullable(),
+    txid: hex32,
+    vout: uint,
+    prevout: tx_output.nullable(),
+    script_sig: hex.nullable(),
+    sequence: uint,
+    witness: z.array(hex)
+});
+export const tx_data = z.object({
+    version: uint,
+    vin: z.array(tx_input),
+    vout: z.array(tx_output),
+    locktime: uint,
+});
+export const vin_template = tx_input.extend({
+    coinbase: hex.nullable().optional(),
+    prevout: tx_output.nullable().optional(),
+    script_sig: hex.nullable().optional(),
+    sequence: uint.optional(),
+    witness: z.array(hex).optional(),
+});
+export const tx_template = z.object({
+    version: uint.optional(),
+    vin: z.array(vin_template).default([]),
+    vout: z.array(tx_output).default([]),
+    locktime: uint.optional(),
+});