crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/utxo/fees.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPEED_TARGETS = void 0;
+exports.satPerKvB = satPerKvB;
+exports.rateForSpeed = rateForSpeed;
+exports.rateFromOverride = rateFromOverride;
+exports.feeAt = feeAt;
+exports.assertSaneFee = assertSaneFee;
+exports.replacementFloor = replacementFloor;
+/**
+ * UTXO fee policy (pure): fee rates from Esplora estimates or an override, the fee of a
+ * size, the absurd-fee guard, and the replacement rules every Bitcoin Core release since
+ * v28 enforces (doc/policy/mempool-replacements.md): the replacement pays at least the
+ * replaced fee plus the incremental relay fee for its own size (rules 3 and 4), and a
+ * strictly higher fee rate (the pre-v31 rule 6, which a single-transaction conflict still
+ * needs for the v31 feerate diagram). Rates are sat/kvB bigints; nothing here floats except
+ * the parsing of Esplora's sat/vB numbers.
+ */
+const error_1 = require("../../core/errors/error");
+/** Confirmation targets (blocks) per speed: library policy, not a network fact. */
+exports.SPEED_TARGETS = Object.freeze({
+    fast: 2,
+    normal: 6,
+    slow: 144,
+});
+/** Esplora's sat/vB float as sat/kvB, rounded up after removing float noise. */
+function satPerKvB(satPerVByte) {
+    const micro = Math.round(satPerVByte * 1_000_000);
+    return BigInt(Math.ceil(micro / 1_000));
+}
+const outOfRange = () => new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the fee estimate is out of range');
+/**
+ * The largest sat/vB an estimate may carry before it is converted (the `/fee-estimates`
+ * parser's bound too); above about 1.8e302, `satPerKvB`'s `x × 1e6` overflows to
+ * Infinity.
+ */
+const MAX_ESTIMATE = 1e7;
+/**
+ * The rate for a speed: the estimate at its target, else at the nearest faster target the
+ * endpoint has; never below the minimum relay fee. With no usable estimate, a test
+ * network's `feeFallback`, else a retryable `PROVIDER_UNAVAILABLE` (nothing is guessed).
+ * The relay floor clamps the fallback too: it is registry data, never checked against
+ * `minRelayFee`.
+ */
+function rateForSpeed(estimates, speed, policy) {
+    const target = exports.SPEED_TARGETS[speed];
+    let best;
+    for (const available of estimates.keys()) {
+        if (available <= target && (best === undefined || available > best))
+            best = available;
+    }
+    let rate;
+    if (best !== undefined) {
+        const estimate = estimates.get(best);
+        // One endpoint's estimate never sets an absurd rate (an explicit override may), and a
+        // malformed one (negative, not finite or beyond any real rate) decides nothing either;
+        // the negated range test also refuses NaN.
+        if (!(estimate >= 0 && estimate <= MAX_ESTIMATE))
+            throw outOfRange();
+        rate = satPerKvB(estimate);
+        if (rate > policy.maxEstimatedFeeRate)
+            throw outOfRange();
+    }
+    else if (policy.feeFallback !== undefined)
+        rate = policy.feeFallback;
+    else {
+        throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the endpoint has no fee estimate for this confirmation target');
+    }
+    return rate < policy.minRelayFee ? policy.minRelayFee : rate;
+}
+const DECIMAL = /^(0|[1-9][0-9]{0,6})(\.[0-9]{1,3})?$/;
+/** `{ satPerVByte }` as sat/kvB. `INVALID_INTENT` when malformed, `FEE_TOO_LOW` below relay. */
+function rateFromOverride(override, policy) {
+    const keys = Object.keys(override);
+    const value = override.satPerVByte;
+    if (keys.length !== 1 || keys[0] !== 'satPerVByte') {
+        throw new error_1.ValidationError('INVALID_INTENT', 'a UTXO fee override is { satPerVByte: bigint | decimal string }');
+    }
+    let rate;
+    if (typeof value === 'bigint') {
+        if (value < 0n)
+            throw new error_1.ValidationError('INVALID_INTENT', 'satPerVByte must be >= 0');
+        rate = value * 1000n;
+    }
+    else if (typeof value === 'string' && DECIMAL.test(value)) {
+        const [whole, fraction = ''] = value.split('.');
+        rate = BigInt(whole) * 1000n + BigInt(fraction.padEnd(3, '0'));
+    }
+    else {
+        throw new error_1.ValidationError('INVALID_INTENT', 'satPerVByte must be a bigint or a decimal string with at most 3 fractional digits');
+    }
+    if (rate < policy.minRelayFee) {
+        throw new error_1.ChainError('FEE_TOO_LOW', 'the fee rate is below the minimum relay fee');
+    }
+    return rate;
+}
+/** Bitcoin Core's `CFeeRate::GetFee`: `rate × vsize / 1000`, rounded up. */
+function feeAt(rate, vsize) {
+    return (rate * BigInt(vsize) + 999n) / 1000n;
+}
+/**
+ * The absurd-fee guard (a burn of funds by a fee bug or a fat-fingered override): refuses
+ * a fee above `maxFee` or a rate above `maxFeeRate` before anything is signed.
+ */
+function assertSaneFee(fee, vsize, policy) {
+    if (fee > policy.maxFee || fee * 1000n > policy.maxFeeRate * BigInt(vsize)) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'the fee exceeds the configured maximum (options.maxFee / options.maxFeeRate)');
+    }
+}
+/**
+ * The least fee a replacement of `vsize` may pay over `previous` (rules 3, 4 and 6). It does
+ * not count descendants of the replaced transaction (a recipient's CPFP): a node then refuses
+ * with `FEE_TOO_LOW`, and a higher explicit fee resolves it.
+ */
+function replacementFloor(previous, vsize, incrementalRelayFee) {
+    const byBandwidth = previous.fee + feeAt(incrementalRelayFee, vsize);
+    // The replaced rate at its smallest possible size (the worst-case size understates it),
+    // rounded up to sat/kvB, plus one: strictly higher both exactly (v30) and truncated to
+    // sat/kvB (v28, v29).
+    const smallest = BigInt(previous.minVsize ?? previous.vsize);
+    const oldRate = (previous.fee * 1000n + smallest - 1n) / smallest;
+    const byRate = ((oldRate + 1n) * BigInt(vsize) + 999n) / 1000n;
+    return byBandwidth > byRate ? byBandwidth : byRate;
+}
+//# sourceMappingURL=fees.js.map

package/dist/adapters/utxo/fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../../src/adapters/utxo/fees.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UTXO fee policy (pure): fee rates from Esplora estimates or an override, the fee of a\n * size, the absurd-fee guard, and the replacement rules every Bitcoin Core release since\n * v28 enforces (doc/policy/mempool-replacements.md): the replacement pays at least the\n * replaced fee plus the incremental relay fee for its own size (rules 3 and 4), and a\n * strictly higher fee rate (the pre-v31 rule 6, which a single-transaction conflict still\n * needs for the v31 feerate diagram). Rates are sat/kvB bigints; nothing here floats except\n * the parsing of Esplora's sat/vB numbers.\n */\nimport { ChainError, ProviderError, ValidationError } from '../../core/errors/error';\nimport type { FeeOverride, FeeSpeed } from '../../core/model/fee';\nimport type { UtxoNetworkConfig } from './network';\n\n/** Confirmation targets (blocks) per speed: library policy, not a network fact. */\nexport const SPEED_TARGETS: Readonly<Record<FeeSpeed, number>> = Object.freeze({\n  fast: 2,\n  normal: 6,\n  slow: 144,\n});\n\ntype FeePolicy = Pick<\n  UtxoNetworkConfig,\n  'minRelayFee' | 'feeFallback' | 'maxFeeRate' | 'maxFee' | 'maxEstimatedFeeRate'\n>;\n\n/** Esplora's sat/vB float as sat/kvB, rounded up after removing float noise. */\nexport function satPerKvB(satPerVByte: number): bigint {\n  const micro = Math.round(satPerVByte * 1_000_000);\n  return BigInt(Math.ceil(micro / 1_000));\n}\n\nconst outOfRange = (): ProviderError =>\n  new ProviderError('PROVIDER_UNAVAILABLE', 'the fee estimate is out of range');\n\n/**\n * The largest sat/vB an estimate may carry before it is converted (the `/fee-estimates`\n * parser's bound too); above about 1.8e302, `satPerKvB`'s `x × 1e6` overflows to\n * Infinity.\n */\nconst MAX_ESTIMATE = 1e7;\n\n/**\n * The rate for a speed: the estimate at its target, else at the nearest faster target the\n * endpoint has; never below the minimum relay fee. With no usable estimate, a test\n * network's `feeFallback`, else a retryable `PROVIDER_UNAVAILABLE` (nothing is guessed).\n * The relay floor clamps the fallback too: it is registry data, never checked against\n * `minRelayFee`.\n */\nexport function rateForSpeed(\n  estimates: ReadonlyMap<number, number>,\n  speed: FeeSpeed,\n  policy: FeePolicy,\n): bigint {\n  const target = SPEED_TARGETS[speed];\n  let best: number | undefined;\n  for (const available of estimates.keys()) {\n    if (available <= target && (best === undefined || available > best)) best = available;\n  }\n  let rate: bigint;\n  if (best !== undefined) {\n    const estimate = estimates.get(best) as number;\n    // One endpoint's estimate never sets an absurd rate (an explicit override may), and a\n    // malformed one (negative, not finite or beyond any real rate) decides nothing either;\n    // the negated range test also refuses NaN.\n    if (!(estimate >= 0 && estimate <= MAX_ESTIMATE)) throw outOfRange();\n    rate = satPerKvB(estimate);\n    if (rate > policy.maxEstimatedFeeRate) throw outOfRange();\n  } else if (policy.feeFallback !== undefined) rate = policy.feeFallback;\n  else {\n    throw new ProviderError(\n      'PROVIDER_UNAVAILABLE',\n      'the endpoint has no fee estimate for this confirmation target',\n    );\n  }\n  return rate < policy.minRelayFee ? policy.minRelayFee : rate;\n}\n\nconst DECIMAL = /^(0|[1-9][0-9]{0,6})(\\.[0-9]{1,3})?$/;\n\n/** `{ satPerVByte }` as sat/kvB. `INVALID_INTENT` when malformed, `FEE_TOO_LOW` below relay. */\nexport function rateFromOverride(override: FeeOverride, policy: FeePolicy): bigint {\n  const keys = Object.keys(override);\n  const value = override.satPerVByte;\n  if (keys.length !== 1 || keys[0] !== 'satPerVByte') {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'a UTXO fee override is { satPerVByte: bigint | decimal string }',\n    );\n  }\n  let rate: bigint;\n  if (typeof value === 'bigint') {\n    if (value < 0n)\n      throw new ValidationError('INVALID_INTENT', 'satPerVByte must be >= 0');\n    rate = value * 1_000n;\n  } else if (typeof value === 'string' && DECIMAL.test(value)) {\n    const [whole, fraction = ''] = value.split('.') as [string, string?];\n    rate = BigInt(whole) * 1_000n + BigInt(fraction.padEnd(3, '0'));\n  } else {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'satPerVByte must be a bigint or a decimal string with at most 3 fractional digits',\n    );\n  }\n  if (rate < policy.minRelayFee) {\n    throw new ChainError('FEE_TOO_LOW', 'the fee rate is below the minimum relay fee');\n  }\n  return rate;\n}\n\n/** Bitcoin Core's `CFeeRate::GetFee`: `rate × vsize / 1000`, rounded up. */\nexport function feeAt(rate: bigint, vsize: number): bigint {\n  return (rate * BigInt(vsize) + 999n) / 1_000n;\n}\n\n/**\n * The absurd-fee guard (a burn of funds by a fee bug or a fat-fingered override): refuses\n * a fee above `maxFee` or a rate above `maxFeeRate` before anything is signed.\n */\nexport function assertSaneFee(fee: bigint, vsize: number, policy: FeePolicy): void {\n  if (fee > policy.maxFee || fee * 1_000n > policy.maxFeeRate * BigInt(vsize)) {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'the fee exceeds the configured maximum (options.maxFee / options.maxFeeRate)',\n    );\n  }\n}\n\nexport interface PaidFee {\n  readonly fee: bigint;\n  /** Estimated with worst-case signatures (an upper bound of the real size). */\n  readonly vsize: number;\n  /**\n   * A lower bound of the real size: a signature can be shorter than the worst case the\n   * estimate assumes. Default `vsize`.\n   */\n  readonly minVsize?: number;\n}\n\n/**\n * The least fee a replacement of `vsize` may pay over `previous` (rules 3, 4 and 6). It does\n * not count descendants of the replaced transaction (a recipient's CPFP): a node then refuses\n * with `FEE_TOO_LOW`, and a higher explicit fee resolves it.\n */\nexport function replacementFloor(\n  previous: PaidFee,\n  vsize: number,\n  incrementalRelayFee: bigint,\n): bigint {\n  const byBandwidth = previous.fee + feeAt(incrementalRelayFee, vsize);\n  // The replaced rate at its smallest possible size (the worst-case size understates it),\n  // rounded up to sat/kvB, plus one: strictly higher both exactly (v30) and truncated to\n  // sat/kvB (v28, v29).\n  const smallest = BigInt(previous.minVsize ?? previous.vsize);\n  const oldRate = (previous.fee * 1_000n + smallest - 1n) / smallest;\n  const byRate = ((oldRate + 1n) * BigInt(vsize) + 999n) / 1_000n;\n  return byBandwidth > byRate ? byBandwidth : byRate;\n}\n"]}

package/dist/adapters/utxo/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `crypto-aio/utxo`: the SDK-free UTXO types, the family's peer dependency and
+ * capabilities, and the `crypto-aio/native` client type: importing this entry types
+ * `native(bc, 'bitcoinjs-lib')` as a {@link UtxoNativeClient}.
+ *
+ * @module crypto-aio/utxo
+ */
+import type { UtxoNativeClient } from './driver';
+declare module '../../index' {
+    interface NativeClientMap {
+        'bitcoinjs-lib': UtxoNativeClient;
+    }
+}
+export type { UtxoNativeClient } from './driver';
+export { UTXO_PEER_DEPENDENCIES } from './plugin';
+export { UTXO_CAPABILITIES } from './network';
+export type { UtxoAddressType, UtxoExt, UtxoFeeDetails, UtxoFeeOverride, UtxoOutputType, UtxoSelectionPreview, UtxoSelectionRequest, UtxoUnspent, UtxoWalletOptions, } from './types';

package/dist/adapters/utxo/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UTXO_CAPABILITIES = exports.UTXO_PEER_DEPENDENCIES = void 0;
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "UTXO_PEER_DEPENDENCIES", { enumerable: true, get: function () { return plugin_1.UTXO_PEER_DEPENDENCIES; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "UTXO_CAPABILITIES", { enumerable: true, get: function () { return network_1.UTXO_CAPABILITIES; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/utxo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/utxo/index.ts"],"names":[],"mappings":";;;AAkBA,mCAAkD;AAAzC,gHAAA,sBAAsB,OAAA;AAC/B,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA","sourcesContent":["/**\n * `crypto-aio/utxo`: the SDK-free UTXO types, the family's peer dependency and\n * capabilities, and the `crypto-aio/native` client type: importing this entry types\n * `native(bc, 'bitcoinjs-lib')` as a {@link UtxoNativeClient}.\n *\n * @module crypto-aio/utxo\n */\nimport type { UtxoNativeClient } from './driver';\n\n// Through the package entry, as users augment 'crypto-aio'. SDK types appear only in this\n// subpath's `NativeClientMap` augmentation, never in the main entry's types.\ndeclare module '../../index' {\n  interface NativeClientMap {\n    'bitcoinjs-lib': UtxoNativeClient;\n  }\n}\n\nexport type { UtxoNativeClient } from './driver';\nexport { UTXO_PEER_DEPENDENCIES } from './plugin';\nexport { UTXO_CAPABILITIES } from './network';\nexport type {\n  UtxoAddressType,\n  UtxoExt,\n  UtxoFeeDetails,\n  UtxoFeeOverride,\n  UtxoOutputType,\n  UtxoSelectionPreview,\n  UtxoSelectionRequest,\n  UtxoUnspent,\n  UtxoWalletOptions,\n} from './types';\n"]}

package/dist/adapters/utxo/network.d.ts

@@ -0,0 +1,50 @@
+import { type Capability } from '../../core/model/capability';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+import type { AddressParams } from './types';
+/** Every capability of a UTXO network (the indexer is required). */
+export declare const UTXO_CAPABILITIES: readonly Capability[];
+export type CoinSelectionStrategy = 'accumulative' | 'all';
+export interface UtxoNetworkConfig {
+    /** The genesis block hash: the endpoint identity. */
+    readonly genesisHash: string;
+    readonly address: AddressParams;
+    /** Finality depth N: a block with N confirmations is final. */
+    readonly confirmations: number;
+    /** Relay policy, in sat/kvB. */
+    readonly dustRelayFee: bigint;
+    readonly minRelayFee: bigint;
+    readonly incrementalRelayFee: bigint;
+    /** The rate used when a test network's estimator has no data; `undefined` on mainnet. */
+    readonly feeFallback?: bigint;
+    /** Absurd-fee guard: the highest fee rate (sat/kvB) and absolute fee (sat) ever built. */
+    readonly maxFeeRate: bigint;
+    readonly maxFee: bigint;
+    /**
+     * The highest rate (sat/kvB) taken from an endpoint's estimate; above it the estimate
+     * decides nothing. One endpoint's estimate sets a speed's rate, so it has a cap of its
+     * own, lower than `maxFeeRate`, which alone bounds an explicit override.
+     */
+    readonly maxEstimatedFeeRate: bigint;
+    /**
+     * Carry each segwit v0 input's previous transaction in the PSBT, for hardware wallets
+     * that demand it. A p2tr input never carries one.
+     */
+    readonly nonWitnessUtxo: boolean;
+    /** Confirmations an output needs before coin selection spends it (0 allows unconfirmed). */
+    readonly minInputConfirmations: number;
+    readonly coinSelection: CoinSelectionStrategy;
+    /** Signal BIP125 replaceability (`nSequence` 0xfffffffd) on every input. */
+    readonly rbf: boolean;
+    readonly capabilities: ReadonlySet<Capability>;
+}
+/** Library defaults for the handle `options`: library policy, not network facts. */
+export declare const OPTION_DEFAULTS: Readonly<{
+    maxFeeRate: 1000000n;
+    maxFee: 10000000n;
+    maxEstimatedFeeRate: 200000n;
+    nonWitnessUtxo: true;
+    minInputConfirmations: 1;
+    coinSelection: CoinSelectionStrategy;
+    rbf: true;
+}>;
+export declare function utxoNetworkConfig(chain: ChainInfo, network: NetworkInfo, options?: Readonly<Record<string, unknown>>): UtxoNetworkConfig;

package/dist/adapters/utxo/network.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPTION_DEFAULTS = exports.UTXO_CAPABILITIES = void 0;
+exports.utxoNetworkConfig = utxoNetworkConfig;
+/**
+ * What the UTXO driver needs from a network's registry entry and from the handle's
+ * `options`, validated once when a driver is created, so bad data fails with
+ * `CONFIG_INVALID` instead of misbehaving (every number is checked, and the finality
+ * depth is a safe integer of at least 1).
+ */
+const error_1 = require("../../core/errors/error");
+const capability_1 = require("../../core/model/capability");
+const names_1 = require("../../core/util/names");
+/** Every capability of a UTXO network (the indexer is required). */
+exports.UTXO_CAPABILITIES = Object.freeze([
+    'batch-transfer',
+    'replace-fee',
+    'cancel',
+    'block-scan',
+    'address-history',
+    'hd-public-derivation',
+]);
+/** Library defaults for the handle `options`: library policy, not network facts. */
+exports.OPTION_DEFAULTS = Object.freeze({
+    maxFeeRate: 1000000n, // 1,000 sat/vB
+    maxFee: 10000000n, // 0.1 BTC, Bitcoin Core's -maxtxfee default
+    maxEstimatedFeeRate: 200000n, // 200 sat/vB
+    nonWitnessUtxo: true,
+    minInputConfirmations: 1,
+    coinSelection: 'accumulative',
+    rbf: true,
+});
+const OPTION_KEYS = new Set([
+    'maxFeeRate',
+    'maxFee',
+    'maxEstimatedFeeRate',
+    'nonWitnessUtxo',
+    'minInputConfirmations',
+    'coinSelection',
+    'rbf',
+]);
+/**
+ * A network's capability overrides, checked against what the
+ * UTXO driver serves. The handle advertises the manifest's capabilities plus `add`, minus
+ * `remove`, and the core accepts what it advertises: `add: ['memo']` would make it take a
+ * memo the builder cannot write (no OP_RETURN). So each name, added or removed, must be one
+ * the driver serves, and a removal of anything else fails as the typo it likely is. The error
+ * names a library capability, never a caller's unknown text, and lists the accepted names.
+ */
+function checkCapabilities(network, fail) {
+    const add = network.capabilities?.add ?? [];
+    const remove = network.capabilities?.remove ?? [];
+    if (!Array.isArray(add) || !Array.isArray(remove)) {
+        fail('capabilities.add and capabilities.remove must be lists');
+    }
+    const serves = `the UTXO driver serves ${exports.UTXO_CAPABILITIES.join(', ')}`;
+    for (const [side, names] of [
+        ['add', add],
+        ['remove', remove],
+    ]) {
+        for (const name of names) {
+            if (exports.UTXO_CAPABILITIES.includes(name))
+                continue;
+            const known = capability_1.KNOWN_CAPABILITIES.includes(name);
+            fail(`capabilities.${side}: ${known ? `'${String(name)}' is not one` : 'an unknown name'}; ${serves}`);
+        }
+    }
+}
+function utxoNetworkConfig(chain, network, options = {}) {
+    const fail = (reason) => {
+        throw new error_1.ConfigError('CONFIG_INVALID', `UTXO network ${chain.id}:${network.id}: ${reason}`);
+    };
+    const identity = network.identity;
+    if (identity === undefined || !/^[0-9a-f]{64}$/.test(identity)) {
+        fail('its identity must be the genesis block hash (64 lowercase hex digits)');
+    }
+    if (network.feeModel !== 'utxo')
+        fail(`fee model '${network.feeModel}' is not 'utxo'`);
+    const finality = network.finality;
+    if (finality.kind !== 'confirmations') {
+        fail(`finality '${finality.kind}' is not a UTXO policy (use 'confirmations')`);
+    }
+    const confirmations = finality.confirmations;
+    if (!Number.isSafeInteger(confirmations) || confirmations < 1) {
+        fail('finality.confirmations must be a safe integer >= 1');
+    }
+    const params = network.params ?? {};
+    const bech32 = params.bech32;
+    // 30 letters at most: a 32-byte witness program (p2tr, p2wsh) then fits in 90 characters.
+    if (typeof bech32 !== 'string' || !/^[a-z]{1,30}$/.test(bech32)) {
+        fail('params.bech32 must be a lowercase human-readable part of 1 to 30 letters');
+    }
+    const byte = (key) => {
+        const value = params[key];
+        if (!Number.isInteger(value) || value < 0 || value > 255) {
+            fail(`params.${key} must be a byte (0-255)`);
+        }
+        return value;
+    };
+    const pubKeyHash = byte('pubKeyHash');
+    const scriptHash = byte('scriptHash');
+    if (pubKeyHash === scriptHash)
+        fail('params.pubKeyHash and scriptHash must differ');
+    const rate = (source, key, where) => {
+        const value = source[key];
+        if (typeof value !== 'bigint' || value < 0n)
+            fail(`${where}.${key} must be a bigint >= 0`);
+        return value;
+    };
+    const dustRelayFee = rate(params, 'dustRelayFee', 'params');
+    const minRelayFee = rate(params, 'minRelayFee', 'params');
+    const incrementalRelayFee = rate(params, 'incrementalRelayFee', 'params');
+    const feeFallback = params.feeFallback === undefined ? undefined : rate(params, 'feeFallback', 'params');
+    for (const key of Object.keys(options)) {
+        // The accepted names, never the caller's key (it may be a pasted secret).
+        if (!OPTION_KEYS.has(key))
+            fail((0, names_1.unknownName)('option', OPTION_KEYS));
+    }
+    const merged = { ...exports.OPTION_DEFAULTS, ...options };
+    const maxFeeRate = rate(merged, 'maxFeeRate', 'options');
+    const maxFee = rate(merged, 'maxFee', 'options');
+    if (maxFeeRate < minRelayFee)
+        fail('options.maxFeeRate is below the minimum relay fee');
+    if (maxFee < 1n)
+        fail('options.maxFee must be at least 1 satoshi');
+    const maxEstimatedFeeRate = rate(merged, 'maxEstimatedFeeRate', 'options');
+    if (maxEstimatedFeeRate < minRelayFee) {
+        fail('options.maxEstimatedFeeRate is below the minimum relay fee');
+    }
+    if (typeof merged.nonWitnessUtxo !== 'boolean')
+        fail('options.nonWitnessUtxo must be a boolean');
+    const minInputConfirmations = merged.minInputConfirmations;
+    if (!Number.isSafeInteger(minInputConfirmations) || minInputConfirmations < 0) {
+        fail('options.minInputConfirmations must be a safe integer >= 0');
+    }
+    if (merged.coinSelection !== 'accumulative' && merged.coinSelection !== 'all') {
+        fail(`options.coinSelection must be 'accumulative' or 'all'`);
+    }
+    if (typeof merged.rbf !== 'boolean')
+        fail('options.rbf must be a boolean');
+    checkCapabilities(network, fail);
+    const capabilities = new Set(exports.UTXO_CAPABILITIES);
+    for (const c of network.capabilities?.add ?? [])
+        capabilities.add(c);
+    for (const c of network.capabilities?.remove ?? [])
+        capabilities.delete(c);
+    return {
+        genesisHash: identity,
+        address: { bech32: bech32, pubKeyHash, scriptHash },
+        confirmations: confirmations,
+        dustRelayFee,
+        minRelayFee,
+        incrementalRelayFee,
+        ...(feeFallback !== undefined ? { feeFallback } : {}),
+        maxFeeRate,
+        maxFee,
+        maxEstimatedFeeRate,
+        nonWitnessUtxo: merged.nonWitnessUtxo,
+        minInputConfirmations,
+        coinSelection: merged.coinSelection,
+        rbf: merged.rbf,
+        capabilities,
+    };
+}
+//# sourceMappingURL=network.js.map

package/dist/adapters/utxo/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/adapters/utxo/network.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What the UTXO driver needs from a network's registry entry and from the handle's\n * `options`, validated once when a driver is created, so bad data fails with\n * `CONFIG_INVALID` instead of misbehaving (every number is checked, and the finality\n * depth is a safe integer of at least 1).\n */\nimport { ConfigError } from '../../core/errors/error';\nimport { KNOWN_CAPABILITIES, type Capability } from '../../core/model/capability';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport { unknownName } from '../../core/util/names';\nimport type { AddressParams } from './types';\n\n/** Every capability of a UTXO network (the indexer is required). */\nexport const UTXO_CAPABILITIES: readonly Capability[] = Object.freeze([\n  'batch-transfer',\n  'replace-fee',\n  'cancel',\n  'block-scan',\n  'address-history',\n  'hd-public-derivation',\n]);\n\nexport type CoinSelectionStrategy = 'accumulative' | 'all';\n\nexport interface UtxoNetworkConfig {\n  /** The genesis block hash: the endpoint identity. */\n  readonly genesisHash: string;\n  readonly address: AddressParams;\n  /** Finality depth N: a block with N confirmations is final. */\n  readonly confirmations: number;\n  /** Relay policy, in sat/kvB. */\n  readonly dustRelayFee: bigint;\n  readonly minRelayFee: bigint;\n  readonly incrementalRelayFee: bigint;\n  /** The rate used when a test network's estimator has no data; `undefined` on mainnet. */\n  readonly feeFallback?: bigint;\n  /** Absurd-fee guard: the highest fee rate (sat/kvB) and absolute fee (sat) ever built. */\n  readonly maxFeeRate: bigint;\n  readonly maxFee: bigint;\n  /**\n   * The highest rate (sat/kvB) taken from an endpoint's estimate; above it the estimate\n   * decides nothing. One endpoint's estimate sets a speed's rate, so it has a cap of its\n   * own, lower than `maxFeeRate`, which alone bounds an explicit override.\n   */\n  readonly maxEstimatedFeeRate: bigint;\n  /**\n   * Carry each segwit v0 input's previous transaction in the PSBT, for hardware wallets\n   * that demand it. A p2tr input never carries one.\n   */\n  readonly nonWitnessUtxo: boolean;\n  /** Confirmations an output needs before coin selection spends it (0 allows unconfirmed). */\n  readonly minInputConfirmations: number;\n  readonly coinSelection: CoinSelectionStrategy;\n  /** Signal BIP125 replaceability (`nSequence` 0xfffffffd) on every input. */\n  readonly rbf: boolean;\n  readonly capabilities: ReadonlySet<Capability>;\n}\n\n/** Library defaults for the handle `options`: library policy, not network facts. */\nexport const OPTION_DEFAULTS = Object.freeze({\n  maxFeeRate: 1_000_000n, // 1,000 sat/vB\n  maxFee: 10_000_000n, // 0.1 BTC, Bitcoin Core's -maxtxfee default\n  maxEstimatedFeeRate: 200_000n, // 200 sat/vB\n  nonWitnessUtxo: true,\n  minInputConfirmations: 1,\n  coinSelection: 'accumulative' as CoinSelectionStrategy,\n  rbf: true,\n});\n\nconst OPTION_KEYS = new Set([\n  'maxFeeRate',\n  'maxFee',\n  'maxEstimatedFeeRate',\n  'nonWitnessUtxo',\n  'minInputConfirmations',\n  'coinSelection',\n  'rbf',\n]);\n\n/**\n * A network's capability overrides, checked against what the\n * UTXO driver serves. The handle advertises the manifest's capabilities plus `add`, minus\n * `remove`, and the core accepts what it advertises: `add: ['memo']` would make it take a\n * memo the builder cannot write (no OP_RETURN). So each name, added or removed, must be one\n * the driver serves, and a removal of anything else fails as the typo it likely is. The error\n * names a library capability, never a caller's unknown text, and lists the accepted names.\n */\nfunction checkCapabilities(network: NetworkInfo, fail: (reason: string) => never): void {\n  const add: unknown = network.capabilities?.add ?? [];\n  const remove: unknown = network.capabilities?.remove ?? [];\n  if (!Array.isArray(add) || !Array.isArray(remove)) {\n    fail('capabilities.add and capabilities.remove must be lists');\n  }\n  const serves = `the UTXO driver serves ${UTXO_CAPABILITIES.join(', ')}`;\n  for (const [side, names] of [\n    ['add', add],\n    ['remove', remove],\n  ] as const) {\n    for (const name of names as readonly unknown[]) {\n      if (UTXO_CAPABILITIES.includes(name as Capability)) continue;\n      const known = (KNOWN_CAPABILITIES as readonly unknown[]).includes(name);\n      fail(\n        `capabilities.${side}: ${known ? `'${String(name)}' is not one` : 'an unknown name'}; ${serves}`,\n      );\n    }\n  }\n}\n\nexport function utxoNetworkConfig(\n  chain: ChainInfo,\n  network: NetworkInfo,\n  options: Readonly<Record<string, unknown>> = {},\n): UtxoNetworkConfig {\n  const fail = (reason: string): never => {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `UTXO network ${chain.id}:${network.id}: ${reason}`,\n    );\n  };\n  const identity = network.identity;\n  if (identity === undefined || !/^[0-9a-f]{64}$/.test(identity)) {\n    fail('its identity must be the genesis block hash (64 lowercase hex digits)');\n  }\n  if (network.feeModel !== 'utxo') fail(`fee model '${network.feeModel}' is not 'utxo'`);\n  const finality = network.finality;\n  if (finality.kind !== 'confirmations') {\n    fail(`finality '${finality.kind}' is not a UTXO policy (use 'confirmations')`);\n  }\n  const confirmations = (finality as { confirmations: unknown }).confirmations;\n  if (!Number.isSafeInteger(confirmations) || (confirmations as number) < 1) {\n    fail('finality.confirmations must be a safe integer >= 1');\n  }\n  const params = network.params ?? {};\n  const bech32 = params.bech32;\n  // 30 letters at most: a 32-byte witness program (p2tr, p2wsh) then fits in 90 characters.\n  if (typeof bech32 !== 'string' || !/^[a-z]{1,30}$/.test(bech32)) {\n    fail('params.bech32 must be a lowercase human-readable part of 1 to 30 letters');\n  }\n  const byte = (key: string): number => {\n    const value = params[key];\n    if (!Number.isInteger(value) || (value as number) < 0 || (value as number) > 255) {\n      fail(`params.${key} must be a byte (0-255)`);\n    }\n    return value as number;\n  };\n  const pubKeyHash = byte('pubKeyHash');\n  const scriptHash = byte('scriptHash');\n  if (pubKeyHash === scriptHash) fail('params.pubKeyHash and scriptHash must differ');\n  const rate = (\n    source: Readonly<Record<string, unknown>>,\n    key: string,\n    where: string,\n  ) => {\n    const value = source[key];\n    if (typeof value !== 'bigint' || value < 0n)\n      fail(`${where}.${key} must be a bigint >= 0`);\n    return value as bigint;\n  };\n  const dustRelayFee = rate(params, 'dustRelayFee', 'params');\n  const minRelayFee = rate(params, 'minRelayFee', 'params');\n  const incrementalRelayFee = rate(params, 'incrementalRelayFee', 'params');\n  const feeFallback =\n    params.feeFallback === undefined ? undefined : rate(params, 'feeFallback', 'params');\n\n  for (const key of Object.keys(options)) {\n    // The accepted names, never the caller's key (it may be a pasted secret).\n    if (!OPTION_KEYS.has(key)) fail(unknownName('option', OPTION_KEYS));\n  }\n  const merged = { ...OPTION_DEFAULTS, ...options };\n  const maxFeeRate = rate(merged, 'maxFeeRate', 'options');\n  const maxFee = rate(merged, 'maxFee', 'options');\n  if (maxFeeRate < minRelayFee) fail('options.maxFeeRate is below the minimum relay fee');\n  if (maxFee < 1n) fail('options.maxFee must be at least 1 satoshi');\n  const maxEstimatedFeeRate = rate(merged, 'maxEstimatedFeeRate', 'options');\n  if (maxEstimatedFeeRate < minRelayFee) {\n    fail('options.maxEstimatedFeeRate is below the minimum relay fee');\n  }\n  if (typeof merged.nonWitnessUtxo !== 'boolean')\n    fail('options.nonWitnessUtxo must be a boolean');\n  const minInputConfirmations = merged.minInputConfirmations;\n  if (!Number.isSafeInteger(minInputConfirmations) || minInputConfirmations < 0) {\n    fail('options.minInputConfirmations must be a safe integer >= 0');\n  }\n  if (merged.coinSelection !== 'accumulative' && merged.coinSelection !== 'all') {\n    fail(`options.coinSelection must be 'accumulative' or 'all'`);\n  }\n  if (typeof merged.rbf !== 'boolean') fail('options.rbf must be a boolean');\n\n  checkCapabilities(network, fail);\n  const capabilities = new Set<Capability>(UTXO_CAPABILITIES);\n  for (const c of network.capabilities?.add ?? []) capabilities.add(c);\n  for (const c of network.capabilities?.remove ?? []) capabilities.delete(c);\n  return {\n    genesisHash: identity as string,\n    address: { bech32: bech32 as string, pubKeyHash, scriptHash },\n    confirmations: confirmations as number,\n    dustRelayFee,\n    minRelayFee,\n    incrementalRelayFee,\n    ...(feeFallback !== undefined ? { feeFallback } : {}),\n    maxFeeRate,\n    maxFee,\n    maxEstimatedFeeRate,\n    nonWitnessUtxo: merged.nonWitnessUtxo,\n    minInputConfirmations,\n    coinSelection: merged.coinSelection,\n    rbf: merged.rbf,\n    capabilities,\n  };\n}\n"]}

package/dist/adapters/utxo/plugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The UTXO family plugin (SDK-free): the Bitcoin chain, the Esplora presets and the
+ * bitcoinjs-lib manifest. Only `load()` pulls in the driver module and, with it, the SDK.
+ */
+import type { AdapterManifest, PeerDependency } from '../../core/driver/types';
+import type { Plugin } from '../../core/registry/plugin';
+/** Keyed by library name, as in every family; each manifest lists only its own. */
+export declare const UTXO_PEER_DEPENDENCIES: Readonly<Record<'bitcoinjs-lib', PeerDependency>>;
+/**
+ * The `bitcoinjs-lib` manifest. Built once, at module level, like the presets, so every
+ * `utxoPlugin()` carries the same `load` function and registering it again is the same
+ * plugin, a no-op: the registry compares functions by identity, and a different plugin
+ * under a registered name is `CONFIG_INVALID`.
+ */
+export declare const utxoManifest: AdapterManifest;
+/** The built-in UTXO family: chain `bitcoin` with mainnet, testnet, testnet4, signet and regtest. */
+export declare function utxoPlugin(): Plugin;

package/dist/adapters/utxo/plugin.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.utxoManifest = exports.UTXO_PEER_DEPENDENCIES = void 0;
+exports.utxoPlugin = utxoPlugin;
+const chains_1 = require("./chains");
+const network_1 = require("./network");
+const presets_1 = require("./presets");
+/** Keyed by library name, as in every family; each manifest lists only its own. */
+exports.UTXO_PEER_DEPENDENCIES = Object.freeze({
+    'bitcoinjs-lib': Object.freeze({ name: 'bitcoinjs-lib', range: '^7.0.2' }),
+});
+/**
+ * The `bitcoinjs-lib` manifest. Built once, at module level, like the presets, so every
+ * `utxoPlugin()` carries the same `load` function and registering it again is the same
+ * plugin, a no-op: the registry compares functions by identity, and a different plugin
+ * under a registered name is `CONFIG_INVALID`.
+ */
+exports.utxoManifest = Object.freeze({
+    family: 'utxo',
+    library: 'bitcoinjs-lib',
+    chains: Object.freeze(['bitcoin']),
+    capabilities: network_1.UTXO_CAPABILITIES,
+    // Esplora is the only data source; the core refuses a handle without one.
+    requiresIndexer: true,
+    peerDependencies: Object.freeze([exports.UTXO_PEER_DEPENDENCIES['bitcoinjs-lib']]),
+    load: async () => {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const mod = require('./driver');
+        return mod.utxoDriverFactory;
+    },
+});
+/** The built-in UTXO family: chain `bitcoin` with mainnet, testnet, testnet4, signet and regtest. */
+function utxoPlugin() {
+    return {
+        name: 'utxo',
+        chains: [chains_1.BITCOIN_CHAIN],
+        adapters: [exports.utxoManifest],
+        presets: presets_1.UTXO_PRESETS,
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/adapters/utxo/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/adapters/utxo/plugin.ts"],"names":[],"mappings":";;;AA0CA,gCAOC;AAvCD,qCAAyC;AACzC,uCAA8C;AAC9C,uCAAyC;AAEzC,mFAAmF;AACtE,QAAA,sBAAsB,GACjC,MAAM,CAAC,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;CAC3E,CAAC,CAAC;AAEL;;;;;GAKG;AACU,QAAA,YAAY,GAAoB,MAAM,CAAC,MAAM,CAAC;IACzD,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;IAClC,YAAY,EAAE,2BAAiB;IAC/B,0EAA0E;IAC1E,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,8BAAsB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1E,IAAI,EAAE,KAAK,IAA4B,EAAE;QACvC,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAA8B,CAAC;QAC7D,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC;AAEH,qGAAqG;AACrG,SAAgB,UAAU;IACxB,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,CAAC,sBAAa,CAAC;QACvB,QAAQ,EAAE,CAAC,oBAAY,CAAC;QACxB,OAAO,EAAE,sBAAY;KACtB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The UTXO family plugin (SDK-free): the Bitcoin chain, the Esplora presets and the\n * bitcoinjs-lib manifest. Only `load()` pulls in the driver module and, with it, the SDK.\n */\nimport type {\n  AdapterManifest,\n  DriverFactory,\n  PeerDependency,\n} from '../../core/driver/types';\nimport type { Plugin } from '../../core/registry/plugin';\nimport { BITCOIN_CHAIN } from './chains';\nimport { UTXO_CAPABILITIES } from './network';\nimport { UTXO_PRESETS } from './presets';\n\n/** Keyed by library name, as in every family; each manifest lists only its own. */\nexport const UTXO_PEER_DEPENDENCIES: Readonly<Record<'bitcoinjs-lib', PeerDependency>> =\n  Object.freeze({\n    'bitcoinjs-lib': Object.freeze({ name: 'bitcoinjs-lib', range: '^7.0.2' }),\n  });\n\n/**\n * The `bitcoinjs-lib` manifest. Built once, at module level, like the presets, so every\n * `utxoPlugin()` carries the same `load` function and registering it again is the same\n * plugin, a no-op: the registry compares functions by identity, and a different plugin\n * under a registered name is `CONFIG_INVALID`.\n */\nexport const utxoManifest: AdapterManifest = Object.freeze({\n  family: 'utxo',\n  library: 'bitcoinjs-lib',\n  chains: Object.freeze(['bitcoin']),\n  capabilities: UTXO_CAPABILITIES,\n  // Esplora is the only data source; the core refuses a handle without one.\n  requiresIndexer: true,\n  peerDependencies: Object.freeze([UTXO_PEER_DEPENDENCIES['bitcoinjs-lib']]),\n  load: async (): Promise<DriverFactory> => {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const mod = require('./driver') as typeof import('./driver');\n    return mod.utxoDriverFactory;\n  },\n});\n\n/** The built-in UTXO family: chain `bitcoin` with mainnet, testnet, testnet4, signet and regtest. */\nexport function utxoPlugin(): Plugin {\n  return {\n    name: 'utxo',\n    chains: [BITCOIN_CHAIN],\n    adapters: [utxoManifest],\n    presets: UTXO_PRESETS,\n  };\n}\n"]}

package/dist/adapters/utxo/presets.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Esplora provider presets. Each is registered twice, as an `rpc` provider
+ * (blocks, transactions, broadcasts, proofs, fee estimates) and as an `indexer` (address
+ * UTXOs, balances, history), because the core requires an `rpc` provider and the UTXO
+ * manifest `requiresIndexer`. Only base URLs verified against the operators' own sources
+ * are listed (Blockstream's `esplora/API.md` and live answers; mempool.space's frontend
+ * source); a preset refuses every other network with `CONFIG_INVALID`.
+ * Both services are free and rate limited, so they are marked `production: false`: for
+ * production, run your own Esplora and configure it as `{ endpoints: [...] }`.
+ */
+import type { ProviderPreset } from '../../core/registry/providers';
+export declare const UTXO_PRESETS: readonly ProviderPreset[];

package/dist/adapters/utxo/presets.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UTXO_PRESETS = void 0;
+/** blockstream.info: mainnet, testnet (v3) and signet. */
+const BLOCKSTREAM = Object.freeze({
+    mainnet: 'https://blockstream.info/api',
+    testnet: 'https://blockstream.info/testnet/api',
+    signet: 'https://blockstream.info/signet/api',
+});
+/** mempool.space: mainnet, testnet (v3), testnet4 and signet. */
+const MEMPOOL = Object.freeze({
+    mainnet: 'https://mempool.space/api',
+    testnet: 'https://mempool.space/testnet/api',
+    testnet4: 'https://mempool.space/testnet4/api',
+    signet: 'https://mempool.space/signet/api',
+});
+/** Own keys only: `table['toString']` would find `Object.prototype`'s. */
+function has(table, network) {
+    return Object.hasOwn(table, network);
+}
+function url(table, network) {
+    // Unreachable through the catalog, which asks `supports` first.
+    if (!has(table, network))
+        throw new Error(`no entry for bitcoin:${network}`);
+    return table[network];
+}
+function presets(name, endpoints, supports) {
+    return ['rpc', 'indexer'].map((kind) => Object.freeze({
+        name,
+        kind,
+        production: false,
+        supports: (chain, network) => chain === 'bitcoin' && supports(network),
+        endpoints: (input) => endpoints(input.network),
+    }));
+}
+exports.UTXO_PRESETS = Object.freeze([
+    ...presets('blockstream', (network) => [{ name: 'blockstream', url: url(BLOCKSTREAM, network) }], (network) => has(BLOCKSTREAM, network)),
+    ...presets('mempool', (network) => [{ name: 'mempool', url: url(MEMPOOL, network) }], (network) => has(MEMPOOL, network)),
+    // The fallback when a handle names no provider: both services, mempool.space first.
+    ...presets('public', (network) => [
+        { name: 'mempool', url: url(MEMPOOL, network), priority: 0 },
+        ...(has(BLOCKSTREAM, network)
+            ? [{ name: 'blockstream', url: url(BLOCKSTREAM, network), priority: 1 }]
+            : []),
+    ], (network) => has(MEMPOOL, network)),
+]);
+//# sourceMappingURL=presets.js.map

package/dist/adapters/utxo/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/adapters/utxo/presets.ts"],"names":[],"mappings":";;;AAeA,0DAA0D;AAC1D,MAAM,WAAW,GAAU,MAAM,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,8BAA8B;IACvC,OAAO,EAAE,sCAAsC;IAC/C,MAAM,EAAE,qCAAqC;CAC9C,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,OAAO,GAAU,MAAM,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,2BAA2B;IACpC,OAAO,EAAE,mCAAmC;IAC5C,QAAQ,EAAE,oCAAoC;IAC9C,MAAM,EAAE,kCAAkC;CAC3C,CAAC,CAAC;AAEH,0EAA0E;AAC1E,SAAS,GAAG,CAAC,KAAY,EAAE,OAAe;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,GAAG,CAAC,KAAY,EAAE,OAAe;IACxC,gEAAgE;IAChE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,OAAO,CAAW,CAAC;AAClC,CAAC;AAED,SAAS,OAAO,CACd,IAAY,EACZ,SAAyD,EACzD,QAAsC;IAEtC,OAAQ,CAAC,KAAK,EAAE,SAAS,CAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAChD,MAAM,CAAC,MAAM,CAAiB;QAC5B,IAAI;QACJ,IAAI;QACJ,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CAC3C,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC;QAC1C,SAAS,EAAE,CAAC,KAAkB,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;KAC5D,CAAC,CACH,CAAC;AACJ,CAAC;AAEY,QAAA,YAAY,GAA8B,MAAM,CAAC,MAAM,CAAC;IACnE,GAAG,OAAO,CACR,aAAa,EACb,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,EACtE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CACvC;IACD,GAAG,OAAO,CACR,SAAS,EACT,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,EAC9D,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CACnC;IACD,oFAAoF;IACpF,GAAG,OAAO,CACR,QAAQ,EACR,CAAC,OAAO,EAAE,EAAE,CAAC;QACX,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC5D,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC;YAC3B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACxE,CAAC,CAAC,EAAE,CAAC;KACR,EACD,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CACnC;CACF,CAAC,CAAC","sourcesContent":["/**\n * Esplora provider presets. Each is registered twice, as an `rpc` provider\n * (blocks, transactions, broadcasts, proofs, fee estimates) and as an `indexer` (address\n * UTXOs, balances, history), because the core requires an `rpc` provider and the UTXO\n * manifest `requiresIndexer`. Only base URLs verified against the operators' own sources\n * are listed (Blockstream's `esplora/API.md` and live answers; mempool.space's frontend\n * source); a preset refuses every other network with `CONFIG_INVALID`.\n * Both services are free and rate limited, so they are marked `production: false`: for\n * production, run your own Esplora and configure it as `{ endpoints: [...] }`.\n */\nimport type { PresetInput, ProviderPreset } from '../../core/registry/providers';\nimport type { EndpointConfig } from '../../core/transport/types';\n\ntype Table = Readonly<Record<string, string>>;\n\n/** blockstream.info: mainnet, testnet (v3) and signet. */\nconst BLOCKSTREAM: Table = Object.freeze({\n  mainnet: 'https://blockstream.info/api',\n  testnet: 'https://blockstream.info/testnet/api',\n  signet: 'https://blockstream.info/signet/api',\n});\n\n/** mempool.space: mainnet, testnet (v3), testnet4 and signet. */\nconst MEMPOOL: Table = Object.freeze({\n  mainnet: 'https://mempool.space/api',\n  testnet: 'https://mempool.space/testnet/api',\n  testnet4: 'https://mempool.space/testnet4/api',\n  signet: 'https://mempool.space/signet/api',\n});\n\n/** Own keys only: `table['toString']` would find `Object.prototype`'s. */\nfunction has(table: Table, network: string): boolean {\n  return Object.hasOwn(table, network);\n}\n\nfunction url(table: Table, network: string): string {\n  // Unreachable through the catalog, which asks `supports` first.\n  if (!has(table, network)) throw new Error(`no entry for bitcoin:${network}`);\n  return table[network] as string;\n}\n\nfunction presets(\n  name: string,\n  endpoints: (network: string) => readonly EndpointConfig[],\n  supports: (network: string) => boolean,\n): ProviderPreset[] {\n  return (['rpc', 'indexer'] as const).map((kind) =>\n    Object.freeze<ProviderPreset>({\n      name,\n      kind,\n      production: false,\n      supports: (chain: string, network: string) =>\n        chain === 'bitcoin' && supports(network),\n      endpoints: (input: PresetInput) => endpoints(input.network),\n    }),\n  );\n}\n\nexport const UTXO_PRESETS: readonly ProviderPreset[] = Object.freeze([\n  ...presets(\n    'blockstream',\n    (network) => [{ name: 'blockstream', url: url(BLOCKSTREAM, network) }],\n    (network) => has(BLOCKSTREAM, network),\n  ),\n  ...presets(\n    'mempool',\n    (network) => [{ name: 'mempool', url: url(MEMPOOL, network) }],\n    (network) => has(MEMPOOL, network),\n  ),\n  // The fallback when a handle names no provider: both services, mempool.space first.\n  ...presets(\n    'public',\n    (network) => [\n      { name: 'mempool', url: url(MEMPOOL, network), priority: 0 },\n      ...(has(BLOCKSTREAM, network)\n        ? [{ name: 'blockstream', url: url(BLOCKSTREAM, network), priority: 1 }]\n        : []),\n    ],\n    (network) => has(MEMPOOL, network),\n  ),\n]);\n"]}

package/dist/adapters/utxo/preview.d.ts

@@ -0,0 +1,3 @@
+import type { UtxoContext } from './context';
+import type { UtxoSelectionPreview, UtxoSelectionRequest } from './types';
+export declare function coinSelectionPreview(ctx: UtxoContext, request: UtxoSelectionRequest): Promise<UtxoSelectionPreview>;