@btc-vision/bitcoin 7.0.0-alpha.9 → 7.0.0-beta.0

package/benchmark-compare/harness.ts

@@ -0,0 +1,220 @@
+/**
+ * Shared benchmark infrastructure for comparison benchmarks.
+ *
+ * Provides consistent measurement (warmup + iterations), statistics,
+ * and ASCII table formatting.
+ */
+
+export interface BenchResult {
+    name: string;
+    mean: number;
+    median: number;
+    min: number;
+    max: number;
+    p95: number;
+    stddev: number;
+    samples: number;
+}
+
+export interface MeasureOpts {
+    warmup?: number;
+    iterations?: number;
+}
+
+const DEFAULT_WARMUP = 5;
+const DEFAULT_ITERATIONS = 50;
+
+/**
+ * Force GC if --expose-gc is available.
+ */
+function tryGC(): void {
+    if (typeof globalThis.gc === 'function') {
+        globalThis.gc();
+    }
+}
+
+/**
+ * Run a function with warmup + measurement iterations, return stats.
+ */
+export async function measure(
+    name: string,
+    fn: () => void | Promise<void>,
+    opts: MeasureOpts = {},
+): Promise<BenchResult> {
+    const warmup = opts.warmup ?? DEFAULT_WARMUP;
+    const iterations = opts.iterations ?? DEFAULT_ITERATIONS;
+
+    // Warmup
+    for (let i = 0; i < warmup; i++) {
+        await fn();
+    }
+
+    tryGC();
+
+    // Measure
+    const times: number[] = [];
+    for (let i = 0; i < iterations; i++) {
+        const t0 = performance.now();
+        await fn();
+        times.push(performance.now() - t0);
+    }
+
+    times.sort((a, b) => a - b);
+
+    const sum = times.reduce((a, b) => a + b, 0);
+    const mean = sum / times.length;
+    const median = times[Math.floor(times.length / 2)]!;
+    const min = times[0]!;
+    const max = times[times.length - 1]!;
+    const p95 = times[Math.floor(times.length * 0.95)]!;
+    const variance = times.reduce((acc, t) => acc + (t - mean) ** 2, 0) / times.length;
+    const stddev = Math.sqrt(variance);
+
+    return { name, mean, median, min, max, p95, stddev, samples: times.length };
+}
+
+/**
+ * Measure a synchronous function.
+ */
+export async function measureSync(
+    name: string,
+    fn: () => void,
+    opts: MeasureOpts = {},
+): Promise<BenchResult> {
+    return measure(name, fn, opts);
+}
+
+/**
+ * Format milliseconds nicely.
+ */
+export function fmt(ms: number): string {
+    if (ms < 0.001) return `${(ms * 1_000_000).toFixed(0)}ns`;
+    if (ms < 1) return `${(ms * 1000).toFixed(0)}us`;
+    if (ms < 1000) return `${ms.toFixed(2)}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+
+export interface ComparisonRow {
+    scenario: string;
+    detail: string;
+    fork: BenchResult | null;
+    forkNoble: BenchResult | null;
+    official: BenchResult | null;
+}
+
+/**
+ * Print an aligned ASCII comparison table.
+ */
+export function printComparison(title: string, rows: ComparisonRow[]): void {
+    console.log();
+    console.log('='.repeat(110));
+    console.log(`  ${title}`);
+    console.log('='.repeat(110));
+
+    const header = [
+        pad('Scenario', 28),
+        pad('Detail', 12),
+        pad('Fork (Noble)', 14),
+        pad('Fork (tiny)', 14),
+        pad('Official', 14),
+        pad('Improvement', 14),
+    ].join(' | ');
+
+    console.log(header);
+    console.log('-'.repeat(110));
+
+    for (const row of rows) {
+        const forkNobleMs = row.forkNoble ? fmt(row.forkNoble.median) : '-';
+        const forkMs = row.fork ? fmt(row.fork.median) : '-';
+        const officialMs = row.official ? fmt(row.official.median) : '-';
+
+        // Calculate improvement: official vs best fork (smallest median wins)
+        let improvement = '-';
+        const candidates = [row.forkNoble, row.fork].filter(Boolean) as BenchResult[];
+        const bestFork = candidates.length > 0
+            ? candidates.reduce((a, b) => a.median < b.median ? a : b)
+            : null;
+        if (bestFork && row.official) {
+            const ratio = row.official.median / bestFork.median;
+            if (ratio > 1.01) {
+                improvement = `${ratio.toFixed(2)}x faster`;
+            } else if (ratio < 0.99) {
+                improvement = `${(1 / ratio).toFixed(2)}x slower`;
+            } else {
+                improvement = 'equal';
+            }
+        }
+
+        const line = [
+            pad(row.scenario, 28),
+            pad(row.detail, 12),
+            pad(forkNobleMs, 14),
+            pad(forkMs, 14),
+            pad(officialMs, 14),
+            pad(improvement, 14),
+        ].join(' | ');
+
+        console.log(line);
+    }
+
+    console.log('='.repeat(110));
+    console.log();
+}
+
+function pad(s: string, n: number): string {
+    return s.length >= n ? s.slice(0, n) : s + ' '.repeat(n - s.length);
+}
+
+/**
+ * Print a simple results table for fork-only scenarios (e.g., parallel signing).
+ */
+export function printForkOnly(title: string, rows: { scenario: string; detail: string; result: BenchResult }[]): void {
+    console.log();
+    console.log('='.repeat(80));
+    console.log(`  ${title}`);
+    console.log('='.repeat(80));
+
+    const header = [
+        pad('Scenario', 36),
+        pad('Detail', 12),
+        pad('Median', 14),
+        pad('p95', 14),
+    ].join(' | ');
+
+    console.log(header);
+    console.log('-'.repeat(80));
+
+    for (const row of rows) {
+        const line = [
+            pad(row.scenario, 36),
+            pad(row.detail, 12),
+            pad(fmt(row.result.median), 14),
+            pad(fmt(row.result.p95), 14),
+        ].join(' | ');
+        console.log(line);
+    }
+
+    console.log('='.repeat(80));
+    console.log();
+}
+
+/**
+ * Summary JSON record for machine-readable output.
+ */
+export interface BenchSummary {
+    timestamp: string;
+    node: string;
+    platform: string;
+    arch: string;
+    scenarios: Record<string, BenchResult>;
+}
+
+export function buildSummary(results: Record<string, BenchResult>): BenchSummary {
+    return {
+        timestamp: new Date().toISOString(),
+        node: process.version,
+        platform: process.platform,
+        arch: process.arch,
+        scenarios: results,
+    };
+}

package/benchmark-compare/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "benchmark-compare",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Benchmark suite comparing @btc-vision/bitcoin vs bitcoinjs-lib",
+  "type": "module",
+  "scripts": {
+    "bench": "npx tsx compare.bench.ts",
+    "bench:gc": "node --expose-gc --import tsx compare.bench.ts"
+  },
+  "devDependencies": {
+    "bitcoinjs-lib": "^7.0.1",
+    "ecpair": "^3.0.0",
+    "tiny-secp256k1": "^2.2.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/browser/address.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,OAAO,EACH,KAAK,OAAO,EAMf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,CAAC;AAEzC,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAW,CAAC;AACjD,eAAO,MAAM,sBAAsB,EAAE,MAAU,CAAC;AAChD,eAAO,MAAM,yBAAyB,EAAE,MAAW,CAAC;AACpD,eAAO,MAAM,kBAAkB,EAAE,MAAW,CAAC;AAC7C,eAAO,MAAM,oBAAoB,EAAE,MAAW,CAAC;AAC/C,eAAO,MAAM,yBAAyB,EAAE,MAAU,CAAC;AACnD,eAAO,MAAM,0BAA0B,EAAE,MAAa,CAAC;AAOvD,eAAO,MAAM,sBAAsB,GAAI,QAAQ,UAAU,KAAG,OAkB3D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAoCjF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAWlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CASpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACpB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACrB,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CA+C9E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,OAAO,GAAG,qBAAqB,GACnD,UAAU,CAwEZ"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,OAAO,EACH,KAAK,OAAO,EAMf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,CAAC;AAEzC,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAW,CAAC;AACjD,eAAO,MAAM,sBAAsB,EAAE,MAAU,CAAC;AAChD,eAAO,MAAM,yBAAyB,EAAE,MAAW,CAAC;AACpD,eAAO,MAAM,kBAAkB,EAAE,MAAW,CAAC;AAC7C,eAAO,MAAM,oBAAoB,EAAE,MAAW,CAAC;AAC/C,eAAO,MAAM,yBAAyB,EAAE,MAAU,CAAC;AACnD,eAAO,MAAM,0BAA0B,EAAE,MAAa,CAAC;AAOvD,eAAO,MAAM,sBAAsB,GAAI,QAAQ,UAAU,KAAG,OAoB3D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAsCjF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAkBnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAWlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CASpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACpB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACrB,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CA+C9E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,OAAO,GAAG,qBAAqB,GACnD,UAAU,CAwEZ"}

package/browser/block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../src/block.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAO1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,KAAK;;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAK;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAa;IAC/B,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAa;IACjC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAK;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAa;IACpC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAK;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAK;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAa;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK;IAoC5C;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAIlC;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY7C;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO;IAqBtF;;;OAGG;IACH,gBAAgB,IAAI,OAAO,GAAG,IAAI;IAkBlC;;;OAGG;IACH,gBAAgB,IAAI,OAAO;IAO3B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAMhB;;;;;OAKG;IACH,UAAU,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,YAAY,GAAE,OAAc,GAAG,MAAM;IAUvE;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACH,KAAK,IAAI,MAAM;IAIf;;;OAGG;IACH,UAAU,IAAI,IAAI;IAOlB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU;IA4B3C;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM;IAIpC;;;OAGG;IACH,YAAY,IAAI,OAAO;IAQvB;;;OAGG;IACH,gBAAgB,IAAI,OAAO;CAuB9B"}
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../src/block.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAO1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,KAAK;;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAK;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAa;IAC/B,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAa;IACjC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAK;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAa;IACpC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAK;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAK;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAa;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK;IAoC5C;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAIlC;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY7C;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO;IAwBtF;;;OAGG;IACH,gBAAgB,IAAI,OAAO,GAAG,IAAI;IAoBlC;;;OAGG;IACH,gBAAgB,IAAI,OAAO;IAO3B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAMhB;;;;;OAKG;IACH,UAAU,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,YAAY,GAAE,OAAc,GAAG,MAAM;IAUvE;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACH,KAAK,IAAI,MAAM;IAIf;;;OAGG;IACH,UAAU,IAAI,IAAI;IAOlB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU;IA4B3C;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM;IAIpC;;;OAGG;IACH,YAAY,IAAI,OAAO;IAQvB;;;OAGG;IACH,gBAAgB,IAAI,OAAO;CAuB9B"}