crypto-aio 0.0.2 → 0.1.0

package/dist/adapters/utxo/builder.js

@@ -0,0 +1,380 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIOUS_TX_READS = void 0;
+exports.utxoBuilder = utxoBuilder;
+exports.utxoBroadcaster = utxoBroadcaster;
+exports.utxoReplacement = utxoReplacement;
+const error_1 = require("../../core/errors/error");
+const asset_1 = require("../../core/model/asset");
+const address_1 = require("./address");
+const codec_1 = require("./codec");
+const coinselect_1 = require("./coinselect");
+const context_1 = require("./context");
+const errors_1 = require("./errors");
+const proofs_1 = require("./proofs");
+const rawtx_1 = require("./rawtx");
+const fees_1 = require("./fees");
+const spend_1 = require("./spend");
+const speedOf = (fee) => typeof fee === 'string' ? fee : 'custom';
+const paidOf = (fee) => fee.charges.reduce((sum, charge) => sum + charge.amount, 0n);
+function draft(from, speed, fee, details, bound) {
+    return {
+        kind: 'utxo',
+        speed,
+        charges: [{ asset: 'native', amount: fee, label: 'network' }],
+        bound,
+        payer: from,
+        details: { ...details },
+    };
+}
+/** `UtxoFeeDetails` of a stored fee, checked (it is our own plain data). */
+function detailsOf(fee) {
+    const d = fee.details;
+    if (fee.kind !== 'utxo' ||
+        typeof d.satPerKvB !== 'bigint' ||
+        !Number.isSafeInteger(d.vsize) ||
+        d.vsize < 1 ||
+        typeof d.change !== 'bigint' ||
+        !Number.isSafeInteger(d.changeIndex)) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'the fee is not a UTXO fee estimate');
+    }
+    return d;
+}
+const scopeOf = (ctx, network) => ({
+    ctx,
+    network,
+    sequence: ctx.config.rbf ? codec_1.SEQUENCE_RBF : codec_1.SEQUENCE_FINAL_LOCKTIME,
+});
+const changeOf = (scope, build, sender) => (0, spend_1.changeAddressOf)(scope.ctx, build.wallet, sender, build.keys);
+/**
+ * The message is a fixed text, so no amount reaches a log line; the amounts go only in
+ * the details, as decimal strings, as in every family.
+ */
+const insufficient = (what, required, available) => new error_1.ChainError('INSUFFICIENT_FUNDS', `insufficient funds for ${what}`, {
+    details: { required: required.toString(), available: available.toString() },
+});
+/** At most this many previous transactions are read at once for one build. */
+exports.PREVIOUS_TX_READS = 4;
+/**
+ * A refusal of a previous transaction put on the provider: the inputs' outpoints and values
+ * are the indexer's, and their previous transactions are bound to their txids, so authentic
+ * bytes that disagree with the indexer's output decide nothing (retryable), never a user
+ * error.
+ */
+function onProvider(work) {
+    try {
+        return work();
+    }
+    catch (error) {
+        if (!(0, codec_1.isPreviousTxRefusal)(error))
+            throw error;
+        throw new error_1.ProviderError('PROVIDER_INCONSISTENT', "the indexer's unspent output disagrees with its previous transaction", { retryable: true, cause: error });
+    }
+}
+/** The previous transaction of each txid, read at most `PREVIOUS_TX_READS` at a time. */
+async function previousTxs(scope, txids, signal) {
+    const found = new Map();
+    await (0, context_1.forEachBounded)(txids, exports.PREVIOUS_TX_READS, async (txid) => {
+        const prev = await scope.ctx.esplora.previousTx(txid, (0, context_1.withSignal)(context_1.READ, signal));
+        if (prev === null) {
+            throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the previous transaction of an input is not available');
+        }
+        found.set(txid, prev);
+    });
+    return found;
+}
+/**
+ * Every input's value and script, authenticated against its previous transaction
+ * (all wallet types, whatever `nonWitnessUtxo` says), so the node never judges bytes built
+ * on an indexer's wrong value, and an outpoint its transaction does not have (a phantom
+ * that nothing would ever spend, so never proven dead) is never built on. Either would
+ * stall the Operation for good with its inputs held, since signed bytes cannot be
+ * abandoned. A new input's previous transaction must also be in a block the proof quorum
+ * attests, unless it is the wallet's own sent transaction and `minInputConfirmations` is
+ * 0: a made-up parent would freeze the transfer the same way. p2pkh inputs carry it, and
+ * segwit v0 ones while `nonWitnessUtxo` is on; taproot never does: BIP341 commits to
+ * every amount, and `signed-psbt.ts` refuses one on a taproot input.
+ */
+async function authenticated(scope, wallet, inputs, fresh, signal) {
+    const { esplora, config } = scope.ctx;
+    // First, each new input's parent must be in a block the proof quorum attests,
+    // at its own height; only then are its bytes read. Self-authenticating bytes prove what a
+    // transaction is, never that a chain holds it.
+    const parents = inputs
+        .filter((input) => !fresh.kept.has(input.outpoint))
+        .map((input) => input.txid)
+        .filter((txid) => !(fresh.ownUnconfirmed && esplora.isOwn(txid)));
+    await (0, proofs_1.assertConfirmed)(scope.ctx, parents, config.minInputConfirmations, signal);
+    const embed = wallet.type === 'p2pkh' ||
+        (wallet.type !== 'p2tr' && scope.ctx.config.nonWitnessUtxo);
+    const txs = await previousTxs(scope, [...new Set(inputs.map((i) => i.txid))], signal);
+    return inputs.map((input) => {
+        const prevTx = txs.get(input.txid);
+        onProvider(() => (0, codec_1.assertPrevious)(prevTx, input, wallet.script));
+        return embed ? { ...input, prevTx } : { ...input };
+    });
+}
+/** `buildTx`, with its refusal of a previous transaction put on the provider. */
+function builtFor(scope, wallet, inputs, outputs) {
+    return onProvider(() => (0, codec_1.buildTx)(scope.network, wallet, inputs, outputs, scope.sequence));
+}
+/** The unsigned transaction for a selection: PSBT, one request per input, exact fee, ordering. */
+async function unsignedFor(scope, build, sender, selection, outputs, changeScript, rate, speed, summary, fresh) {
+    const { wallet, key } = (0, spend_1.walletOf)(scope.ctx, sender, build.keys);
+    (0, fees_1.assertSaneFee)(selection.fee, selection.vsize, scope.ctx.config);
+    const all = selection.change > 0n
+        ? [...outputs, { script: changeScript, value: selection.change }]
+        : [...outputs];
+    const inputs = await authenticated(scope, wallet, selection.inputs, fresh, build.signal);
+    const built = builtFor(scope, wallet, inputs, all);
+    const signingRequests = built.digests.map((digest, index) => ({
+        id: `in:${index}`,
+        scheme: wallet.type === 'p2tr' ? 'secp256k1-schnorr' : 'secp256k1-ecdsa',
+        payload: digest,
+        payloadKind: 'digest',
+        publicKey: wallet.type === 'p2tr' ? wallet.outputKey : wallet.publicKey,
+        ...(key.keyRef ? { keyRef: key.keyRef } : {}),
+        ...(wallet.tweak ? { params: { tweak: wallet.tweak } } : {}),
+    }));
+    return {
+        payload: { encoding: 'base64', data: built.psbt },
+        ...(built.txid !== undefined
+            ? { expectedRef: { id: built.txid, idKind: 'txid', canonical: true } }
+            : {}),
+        signingRequests,
+        ordering: { kind: 'inputs', inputs: selection.inputs.map((i) => i.outpoint).sort() },
+        fee: draft(sender.from.canonical, speed, selection.fee, {
+            satPerKvB: rate,
+            vsize: selection.vsize,
+            inputs: selection.inputs.length,
+            outputs: all.length,
+            change: selection.change,
+            changeIndex: selection.change > 0n ? outputs.length : -1,
+        }, 'exact'),
+        summary,
+    };
+}
+/** The replaced Attempt: its inputs (values from its PSBT), payments (no change) and fee. */
+function previousOf(scope, previous, sender) {
+    const details = detailsOf(previous.fee);
+    const view = (0, codec_1.viewPsbt)(previous.payload.data, scope.network);
+    const inputs = view.inputs.map((i) => ({
+        outpoint: i.outpoint,
+        txid: i.txid,
+        vout: i.vout,
+        value: i.value,
+    }));
+    const outputs = view.outputs.filter((_, index) => index !== details.changeIndex);
+    // A real signature may be a byte shorter than the worst case the estimate counts: a
+    // full vbyte per legacy input, a quarter per witness input.
+    const slack = sender.type === 'p2pkh' ? inputs.length : Math.ceil(inputs.length / 4);
+    const minVsize = Math.max(1, details.vsize - slack);
+    return { vsize: details.vsize, minVsize, inputs, outputs, paid: paidOf(previous.fee) };
+}
+function utxoBuilder(ctx, network) {
+    const scope = scopeOf(ctx, network);
+    const { config } = ctx;
+    const native = (0, asset_1.assetId)(ctx.chain.id, ctx.network.id, 'native');
+    const plan = async (intent, rate, build) => {
+        (0, spend_1.assertNative)(intent.asset);
+        // Defence in depth behind the network's capability check: nothing here writes a memo,
+        // and the core would otherwise accept one this builder drops.
+        if (intent.memo !== undefined) {
+            throw new error_1.UnsupportedCapabilityError('UNSUPPORTED_CAPABILITY', 'Bitcoin transfers carry no memo (OP_RETURN is not supported)');
+        }
+        const sender = (0, spend_1.senderOf)(ctx, intent.from);
+        const outputs = (0, spend_1.plannedOutputs)(ctx, intent.outputs);
+        const changeScript = changeOf(scope, build, sender).script;
+        const candidates = await (0, spend_1.spendable)(ctx, sender.from.canonical, build.excludeInputs, config.minInputConfirmations, build.signal);
+        const selection = (0, coinselect_1.selectCoins)({
+            candidates,
+            outputs,
+            changeScript,
+            inputType: sender.type,
+            rate,
+            dustRelayFee: config.dustRelayFee,
+            strategy: config.coinSelection,
+        });
+        return { sender, outputs, changeScript, selection };
+    };
+    return {
+        async estimateFee(intent, build) {
+            const rate = await (0, spend_1.rateOf)(ctx, intent.fee, build.signal);
+            const { sender, selection } = await plan(intent, rate, build);
+            const change = selection.ok ? selection.change : 0n;
+            return draft(sender.from.canonical, speedOf(intent.fee), selection.fee, {
+                satPerKvB: rate,
+                vsize: selection.vsize,
+                inputs: selection.ok ? selection.inputs.length : 0,
+                outputs: intent.outputs.length + (change > 0n ? 1 : 0),
+                change,
+                changeIndex: change > 0n ? intent.outputs.length : -1,
+            }, 'expected');
+        },
+        async checkFunds(intent, fee, build) {
+            (0, spend_1.assertNative)(intent.asset);
+            const candidates = await (0, spend_1.spendable)(ctx, (0, spend_1.senderOf)(ctx, intent.from).from.canonical, build.excludeInputs, config.minInputConfirmations, build.signal);
+            const available = candidates.reduce((sum, c) => sum + c.value, 0n);
+            const required = intent.outputs.reduce((sum, o) => sum + o.amount, 0n) + paidOf(fee);
+            return available >= required
+                ? { ok: true }
+                : { ok: false, asset: 'native', required, available };
+        },
+        async build(intent, fee, build) {
+            const rate = detailsOf(fee).satPerKvB;
+            const { sender, outputs, changeScript, selection } = await plan(intent, rate, build);
+            if (!selection.ok) {
+                throw insufficient('this transfer', selection.required, selection.available);
+            }
+            return unsignedFor(scope, build, sender, selection, outputs, changeScript, rate, fee.speed, {
+                asset: native,
+                outputs: intent.outputs.map((o) => ({ to: o.to, amount: o.amount.toString() })),
+            }, { kept: new Set(), ownUnconfirmed: config.minInputConfirmations === 0 });
+        },
+        async assemble(unsigned, signatures) {
+            const { hex, txid } = (0, codec_1.assembleTx)(unsigned.payload.data, network, unsigned.signingRequests, signatures);
+            if (unsigned.expectedRef && unsigned.expectedRef.id !== txid) {
+                throw new error_1.SigningError('SIGNING_FAILED', 'the signed transaction id differs from the prepared one');
+            }
+            return {
+                raw: { encoding: 'hex', data: hex },
+                ref: { id: txid, idKind: 'txid', canonical: true },
+            };
+        },
+        signaturesFrom(unsigned, signed) {
+            if (signed.encoding !== 'base64') {
+                throw new error_1.ValidationError('INVALID_INTENT', 'a signed PSBT is expected, as base64');
+            }
+            return (0, codec_1.signaturesFromPsbt)(unsigned.payload.data, signed.data, network, unsigned.signingRequests);
+        },
+    };
+}
+/**
+ * Twice Bitcoin Core's `MAX_BLOCK_SERIALIZED_SIZE`: no transaction's hex is longer, so
+ * the untrusted text is capped before any decoding. A flat character class, never a
+ * repeated group: V8's regexp stack overflows on a repeated group of a few million
+ * matches, which a valid transaction can have.
+ */
+const MAX_TX_HEX = 8_000_000;
+const HEX = /^[0-9a-fA-F]+$/;
+/**
+ * An Attempt's bytes a node took (accepted, or already holds) are this wallet's
+ * own sent transaction: its client keeps them. A bare broadcast (no ref) is not an Attempt.
+ */
+function rememberOwn(ctx, signed, hex) {
+    if (signed.ref.id === '')
+        return;
+    const tx = (0, codec_1.previousTxOf)(hex);
+    if (tx?.txid === signed.ref.id)
+        ctx.esplora.rememberOwn(tx);
+}
+function utxoBroadcaster(ctx) {
+    return {
+        async broadcast(signed, options = {}) {
+            const { encoding, data } = signed.raw;
+            if (encoding !== 'hex' ||
+                data.length > MAX_TX_HEX ||
+                data.length % 2 !== 0 ||
+                !HEX.test(data)) {
+                throw new error_1.ValidationError('INVALID_INTENT', 'a raw Bitcoin transaction is hex');
+            }
+            const hex = data.toLowerCase();
+            try {
+                const txid = await ctx.esplora.broadcast(hex, {
+                    purpose: 'broadcast',
+                    retry: 'ambiguous-on-failure',
+                    ...(options.fanout !== undefined ? { fanout: options.fanout } : {}),
+                    ...(options.signal ? { signal: options.signal } : {}),
+                });
+                // A bare broadcast (no ref) is checked against the bytes' own txid.
+                const expected = signed.ref.id !== ''
+                    ? signed.ref.id
+                    : (0, rawtx_1.readTxHex)(hex, { maxStripped: rawtx_1.MAX_TX_BYTES })?.txid;
+                if (txid !== expected) {
+                    // The node accepted something under another id: the outcome is unknown.
+                    throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the node answered another txid', {
+                        ambiguous: true,
+                    });
+                }
+                rememberOwn(ctx, signed, hex);
+                return { kind: 'accepted' };
+            }
+            catch (error) {
+                // A definitive 400 is bitcoind's answer; anything else is rethrown. A rejection
+                // stands only when its reason holds for these bytes, checked here.
+                if ((0, error_1.isCryptoAioError)(error, 'RPC_ERROR') &&
+                    !error.ambiguous &&
+                    error.details?.status === 400) {
+                    const result = (0, errors_1.classifyOwnBroadcast)((0, errors_1.parseNodeError)(String(error.details.body ?? '')), hex);
+                    if (result.kind === 'already-known')
+                        rememberOwn(ctx, signed, hex);
+                    return result;
+                }
+                throw error;
+            }
+        },
+    };
+}
+const tooLow = () => new error_1.ChainError('FEE_TOO_LOW', 'a replacement must pay the replaced fee plus the incremental relay fee, at a higher rate');
+function utxoReplacement(ctx, network) {
+    const scope = scopeOf(ctx, network);
+    const { config } = ctx;
+    return {
+        replace: true,
+        cancel: true,
+        async buildReplacement(previous, fee, build) {
+            const sender = (0, spend_1.senderOf)(ctx, build.from);
+            const prev = previousOf(scope, previous, sender);
+            const rate = await (0, spend_1.rateOf)(ctx, fee, build.signal);
+            const changeScript = changeOf(scope, build, sender).script;
+            // BIP125 rule 2: an input it adds must be confirmed; it never takes a held one.
+            const candidates = await (0, spend_1.spendable)(ctx, sender.from.canonical, [...(build.excludeInputs ?? []), ...prev.inputs.map((i) => i.outpoint)], Math.max(1, config.minInputConfirmations), build.signal);
+            const selection = (0, coinselect_1.selectCoins)({
+                candidates,
+                required: prev.inputs,
+                outputs: prev.outputs,
+                changeScript,
+                inputType: sender.type,
+                rate,
+                dustRelayFee: config.dustRelayFee,
+                strategy: 'accumulative',
+            });
+            if (!selection.ok) {
+                throw insufficient('the replacement', selection.required, selection.available);
+            }
+            const floor = (0, fees_1.replacementFloor)({ fee: prev.paid, vsize: prev.vsize, minVsize: prev.minVsize }, selection.vsize, config.incrementalRelayFee);
+            if (selection.fee < floor)
+                throw tooLow();
+            return unsignedFor(scope, build, sender, selection, prev.outputs, changeScript, rate, speedOf(fee), previous.summary, { kept: new Set(prev.inputs.map((i) => i.outpoint)), ownUnconfirmed: false });
+        },
+        async buildCancel(previous, build, fee) {
+            const sender = (0, spend_1.senderOf)(ctx, build.from);
+            const prev = previousOf(scope, previous, sender);
+            // A cancel pays everything back to the sending address itself, never to a
+            // configured change address (under `allowExternalChangeAddress` an external one). A
+            // misconfigured change address is still refused here, as on every path.
+            changeOf(scope, build, sender);
+            const own = sender.from;
+            const total = prev.inputs.reduce((sum, i) => sum + i.value, 0n);
+            const vsize = (0, coinselect_1.vsizeOf)((0, coinselect_1.txWeight)(sender.type, prev.inputs.length, [own.script.length]));
+            const floor = (0, fees_1.replacementFloor)({ fee: prev.paid, vsize: prev.vsize, minVsize: prev.minVsize }, vsize, config.incrementalRelayFee);
+            let paid = floor;
+            let rate = (floor * 1000n + BigInt(vsize) - 1n) / BigInt(vsize);
+            if (fee !== undefined) {
+                rate = await (0, spend_1.rateOf)(ctx, fee, build.signal);
+                paid = (0, fees_1.feeAt)(rate, vsize);
+                if (paid < floor)
+                    throw tooLow();
+            }
+            const dust = (0, address_1.dustThreshold)(own.script, config.dustRelayFee);
+            if (total - paid < dust)
+                throw insufficient('a cancel', paid + dust, total);
+            const value = total - paid;
+            return unsignedFor(scope, build, sender, { ok: true, inputs: prev.inputs, change: 0n, fee: paid, vsize }, [{ script: own.script, value }], own.script, rate, fee === undefined ? 'custom' : speedOf(fee), {
+                asset: previous.summary.asset,
+                outputs: [{ to: own.canonical, amount: value.toString() }],
+            }, { kept: new Set(prev.inputs.map((i) => i.outpoint)), ownUnconfirmed: false });
+        },
+    };
+}
+//# sourceMappingURL=builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/adapters/utxo/builder.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The UTXO builder, broadcaster and RBF replacement policy.\n *\n * - `build` spends only outputs not held by another live Operation (`ctx.excludeInputs`),\n *   pays change to the wallet's change address, and records the spent outpoints as the\n *   `inputs` ordering. The fee is `exact` once built; the absurd-fee guard runs first.\n * - Every input a build, a replacement or a cancel spends is authenticated against its\n *   previous transaction first: the indexer's value and script count only when the\n *   bytes that hash to the outpoint's txid say the same. A lied value could burn the\n *   difference as fee, or make our own signed bytes invalid for good and stall the\n *   Operation with its inputs held.\n * - Replacements and cancels keep EVERY input of the Attempt they replace (and may add\n *   confirmed ones), so each new Attempt conflicts with every earlier one (exclusion is\n *   not transitive). Neither ever raises a fee on its own: a fee below the\n *   replacement floor is `FEE_TOO_LOW`.\n * - A cancel pays everything back to the sending address itself.\n * - Broadcast answers are classified by `errors.ts`; an ambiguous transport failure is\n *   rethrown unclassified. A node's rejection is a claim: it stands only when its reason\n *   holds for the bytes that were sent, checked here; else `refused`. A terminal\n *   `rejected` frees the inputs, so a lying endpoint that relayed our valid bytes would\n *   let the caller's retry spend other coins, and both transactions could confirm.\n */\nimport type {\n  BroadcastResult,\n  Broadcaster,\n  BuildContext,\n  ReplacementPolicy,\n  TxBuilder,\n} from '../../core/driver/types';\nimport {\n  ChainError,\n  ProviderError,\n  SigningError,\n  UnsupportedCapabilityError,\n  ValidationError,\n  isCryptoAioError,\n} from '../../core/errors/error';\nimport { assetId } from '../../core/model/asset';\nimport type { FeeEstimateDraft, FeeOverride, FeeSpeed } from '../../core/model/fee';\nimport type { DriverIntent, IntentSummary } from '../../core/model/intent';\nimport type { RawTx, SignedTx, UnsignedTx } from '../../core/model/transaction';\nimport type { SignatureBundle, SigningRequest } from '../../core/signing/types';\nimport { dustThreshold, type DecodedAddress, type WalletAddress } from './address';\nimport {\n  assembleTx,\n  assertPrevious,\n  buildTx,\n  isPreviousTxRefusal,\n  previousTxOf,\n  signaturesFromPsbt,\n  viewPsbt,\n  SEQUENCE_FINAL_LOCKTIME,\n  SEQUENCE_RBF,\n  type BuiltTx,\n  type PlannedInput,\n  type PreviousTx,\n} from './codec';\nimport {\n  selectCoins,\n  txWeight,\n  vsizeOf,\n  type PlannedOutput,\n  type Selection,\n  type Spendable,\n} from './coinselect';\nimport { READ, forEachBounded, withSignal, type UtxoContext } from './context';\nimport { classifyOwnBroadcast, parseNodeError } from './errors';\nimport { assertConfirmed } from './proofs';\nimport { MAX_TX_BYTES, readTxHex } from './rawtx';\nimport { assertSaneFee, feeAt, replacementFloor } from './fees';\nimport type { Network } from './sdk';\nimport {\n  assertNative,\n  changeAddressOf,\n  plannedOutputs,\n  rateOf,\n  senderOf,\n  spendable,\n  walletOf,\n  type Sender,\n} from './spend';\nimport type { UtxoFeeDetails } from './types';\n\nconst speedOf = (fee: FeeSpeed | FeeOverride): FeeSpeed | 'custom' =>\n  typeof fee === 'string' ? fee : 'custom';\n\nconst paidOf = (fee: FeeEstimateDraft): bigint =>\n  fee.charges.reduce((sum, charge) => sum + charge.amount, 0n);\n\nfunction draft(\n  from: string,\n  speed: FeeSpeed | 'custom',\n  fee: bigint,\n  details: UtxoFeeDetails,\n  bound: 'exact' | 'expected',\n): FeeEstimateDraft {\n  return {\n    kind: 'utxo',\n    speed,\n    charges: [{ asset: 'native', amount: fee, label: 'network' }],\n    bound,\n    payer: from,\n    details: { ...details },\n  };\n}\n\n/** `UtxoFeeDetails` of a stored fee, checked (it is our own plain data). */\nfunction detailsOf(fee: FeeEstimateDraft): UtxoFeeDetails {\n  const d = fee.details as Partial<UtxoFeeDetails>;\n  if (\n    fee.kind !== 'utxo' ||\n    typeof d.satPerKvB !== 'bigint' ||\n    !Number.isSafeInteger(d.vsize) ||\n    (d.vsize as number) < 1 ||\n    typeof d.change !== 'bigint' ||\n    !Number.isSafeInteger(d.changeIndex)\n  ) {\n    throw new ValidationError('INVALID_INTENT', 'the fee is not a UTXO fee estimate');\n  }\n  return d as UtxoFeeDetails;\n}\n\n/** Everything that builds a transaction; shared by the builder and the replacement policy. */\ninterface Scope {\n  readonly ctx: UtxoContext;\n  readonly network: Network;\n  readonly sequence: number;\n}\n\nconst scopeOf = (ctx: UtxoContext, network: Network): Scope => ({\n  ctx,\n  network,\n  sequence: ctx.config.rbf ? SEQUENCE_RBF : SEQUENCE_FINAL_LOCKTIME,\n});\n\nconst changeOf = (scope: Scope, build: BuildContext, sender: Sender): DecodedAddress =>\n  changeAddressOf(scope.ctx, build.wallet, sender, build.keys);\n\n/**\n * The message is a fixed text, so no amount reaches a log line; the amounts go only in\n * the details, as decimal strings, as in every family.\n */\nconst insufficient = (\n  what: 'this transfer' | 'the replacement' | 'a cancel',\n  required: bigint,\n  available: bigint,\n): ChainError =>\n  new ChainError('INSUFFICIENT_FUNDS', `insufficient funds for ${what}`, {\n    details: { required: required.toString(), available: available.toString() },\n  });\n\n/** At most this many previous transactions are read at once for one build. */\nexport const PREVIOUS_TX_READS = 4;\n\n/**\n * A refusal of a previous transaction put on the provider: the inputs' outpoints and values\n * are the indexer's, and their previous transactions are bound to their txids, so authentic\n * bytes that disagree with the indexer's output decide nothing (retryable), never a user\n * error.\n */\nfunction onProvider<T>(work: () => T): T {\n  try {\n    return work();\n  } catch (error) {\n    if (!isPreviousTxRefusal(error)) throw error;\n    throw new ProviderError(\n      'PROVIDER_INCONSISTENT',\n      \"the indexer's unspent output disagrees with its previous transaction\",\n      { retryable: true, cause: error },\n    );\n  }\n}\n\n/** The previous transaction of each txid, read at most `PREVIOUS_TX_READS` at a time. */\nasync function previousTxs(\n  scope: Scope,\n  txids: readonly string[],\n  signal?: AbortSignal,\n): Promise<ReadonlyMap<string, PreviousTx>> {\n  const found = new Map<string, PreviousTx>();\n  await forEachBounded(txids, PREVIOUS_TX_READS, async (txid) => {\n    const prev = await scope.ctx.esplora.previousTx(txid, withSignal(READ, signal));\n    if (prev === null) {\n      throw new ProviderError(\n        'PROVIDER_UNAVAILABLE',\n        'the previous transaction of an input is not available',\n      );\n    }\n    found.set(txid, prev);\n  });\n  return found;\n}\n\n/** Which inputs of a build are new, and how their parents must be confirmed. */\ninterface NewInputs {\n  /** The outpoints a replacement or cancel keeps: attested when their Attempt was built. */\n  readonly kept: ReadonlySet<string>;\n  /**\n   * `minInputConfirmations: 0` on a transfer: an output of the wallet's own sent transaction\n   * (its bytes known to this client) may be spent before a block holds it.\n   */\n  readonly ownUnconfirmed: boolean;\n}\n\n/**\n * Every input's value and script, authenticated against its previous transaction\n * (all wallet types, whatever `nonWitnessUtxo` says), so the node never judges bytes built\n * on an indexer's wrong value, and an outpoint its transaction does not have (a phantom\n * that nothing would ever spend, so never proven dead) is never built on. Either would\n * stall the Operation for good with its inputs held, since signed bytes cannot be\n * abandoned. A new input's previous transaction must also be in a block the proof quorum\n * attests, unless it is the wallet's own sent transaction and `minInputConfirmations` is\n * 0: a made-up parent would freeze the transfer the same way. p2pkh inputs carry it, and\n * segwit v0 ones while `nonWitnessUtxo` is on; taproot never does: BIP341 commits to\n * every amount, and `signed-psbt.ts` refuses one on a taproot input.\n */\nasync function authenticated(\n  scope: Scope,\n  wallet: WalletAddress,\n  inputs: readonly Spendable[],\n  fresh: NewInputs,\n  signal?: AbortSignal,\n): Promise<PlannedInput[]> {\n  const { esplora, config } = scope.ctx;\n  // First, each new input's parent must be in a block the proof quorum attests,\n  // at its own height; only then are its bytes read. Self-authenticating bytes prove what a\n  // transaction is, never that a chain holds it.\n  const parents = inputs\n    .filter((input) => !fresh.kept.has(input.outpoint))\n    .map((input) => input.txid)\n    .filter((txid) => !(fresh.ownUnconfirmed && esplora.isOwn(txid)));\n  await assertConfirmed(scope.ctx, parents, config.minInputConfirmations, signal);\n  const embed =\n    wallet.type === 'p2pkh' ||\n    (wallet.type !== 'p2tr' && scope.ctx.config.nonWitnessUtxo);\n  const txs = await previousTxs(scope, [...new Set(inputs.map((i) => i.txid))], signal);\n  return inputs.map((input) => {\n    const prevTx = txs.get(input.txid) as PreviousTx;\n    onProvider(() => assertPrevious(prevTx, input, wallet.script));\n    return embed ? { ...input, prevTx } : { ...input };\n  });\n}\n\n/** `buildTx`, with its refusal of a previous transaction put on the provider. */\nfunction builtFor(\n  scope: Scope,\n  wallet: WalletAddress,\n  inputs: readonly PlannedInput[],\n  outputs: readonly PlannedOutput[],\n): BuiltTx {\n  return onProvider(() =>\n    buildTx(scope.network, wallet, inputs, outputs, scope.sequence),\n  );\n}\n\n/** The unsigned transaction for a selection: PSBT, one request per input, exact fee, ordering. */\nasync function unsignedFor(\n  scope: Scope,\n  build: BuildContext,\n  sender: Sender,\n  selection: Selection,\n  outputs: readonly PlannedOutput[],\n  changeScript: Uint8Array,\n  rate: bigint,\n  speed: FeeSpeed | 'custom',\n  summary: IntentSummary,\n  fresh: NewInputs,\n): Promise<UnsignedTx> {\n  const { wallet, key } = walletOf(scope.ctx, sender, build.keys);\n  assertSaneFee(selection.fee, selection.vsize, scope.ctx.config);\n  const all: PlannedOutput[] =\n    selection.change > 0n\n      ? [...outputs, { script: changeScript, value: selection.change }]\n      : [...outputs];\n  const inputs = await authenticated(\n    scope,\n    wallet,\n    selection.inputs,\n    fresh,\n    build.signal,\n  );\n  const built = builtFor(scope, wallet, inputs, all);\n  const signingRequests: SigningRequest[] = built.digests.map((digest, index) => ({\n    id: `in:${index}`,\n    scheme: wallet.type === 'p2tr' ? 'secp256k1-schnorr' : 'secp256k1-ecdsa',\n    payload: digest,\n    payloadKind: 'digest',\n    publicKey:\n      wallet.type === 'p2tr' ? (wallet.outputKey as Uint8Array) : wallet.publicKey,\n    ...(key.keyRef ? { keyRef: key.keyRef } : {}),\n    ...(wallet.tweak ? { params: { tweak: wallet.tweak } } : {}),\n  }));\n  return {\n    payload: { encoding: 'base64', data: built.psbt },\n    ...(built.txid !== undefined\n      ? { expectedRef: { id: built.txid, idKind: 'txid', canonical: true } }\n      : {}),\n    signingRequests,\n    ordering: { kind: 'inputs', inputs: selection.inputs.map((i) => i.outpoint).sort() },\n    fee: draft(\n      sender.from.canonical,\n      speed,\n      selection.fee,\n      {\n        satPerKvB: rate,\n        vsize: selection.vsize,\n        inputs: selection.inputs.length,\n        outputs: all.length,\n        change: selection.change,\n        changeIndex: selection.change > 0n ? outputs.length : -1,\n      },\n      'exact',\n    ),\n    summary,\n  };\n}\n\n/** The replaced Attempt: its inputs (values from its PSBT), payments (no change) and fee. */\nfunction previousOf(scope: Scope, previous: UnsignedTx, sender: Sender) {\n  const details = detailsOf(previous.fee);\n  const view = viewPsbt(previous.payload.data, scope.network);\n  const inputs: Spendable[] = view.inputs.map((i) => ({\n    outpoint: i.outpoint,\n    txid: i.txid,\n    vout: i.vout,\n    value: i.value,\n  }));\n  const outputs = view.outputs.filter((_, index) => index !== details.changeIndex);\n  // A real signature may be a byte shorter than the worst case the estimate counts: a\n  // full vbyte per legacy input, a quarter per witness input.\n  const slack = sender.type === 'p2pkh' ? inputs.length : Math.ceil(inputs.length / 4);\n  const minVsize = Math.max(1, details.vsize - slack);\n  return { vsize: details.vsize, minVsize, inputs, outputs, paid: paidOf(previous.fee) };\n}\n\nexport interface UtxoBuilder extends TxBuilder {\n  signaturesFrom(unsigned: UnsignedTx, signed: RawTx): readonly SignatureBundle[];\n}\n\nexport function utxoBuilder(ctx: UtxoContext, network: Network): UtxoBuilder {\n  const scope = scopeOf(ctx, network);\n  const { config } = ctx;\n  const native = assetId(ctx.chain.id, ctx.network.id, 'native');\n\n  const plan = async (intent: DriverIntent, rate: bigint, build: BuildContext) => {\n    assertNative(intent.asset);\n    // Defence in depth behind the network's capability check: nothing here writes a memo,\n    // and the core would otherwise accept one this builder drops.\n    if (intent.memo !== undefined) {\n      throw new UnsupportedCapabilityError(\n        'UNSUPPORTED_CAPABILITY',\n        'Bitcoin transfers carry no memo (OP_RETURN is not supported)',\n      );\n    }\n    const sender = senderOf(ctx, intent.from);\n    const outputs = plannedOutputs(ctx, intent.outputs);\n    const changeScript = changeOf(scope, build, sender).script;\n    const candidates = await spendable(\n      ctx,\n      sender.from.canonical,\n      build.excludeInputs,\n      config.minInputConfirmations,\n      build.signal,\n    );\n    const selection = selectCoins({\n      candidates,\n      outputs,\n      changeScript,\n      inputType: sender.type,\n      rate,\n      dustRelayFee: config.dustRelayFee,\n      strategy: config.coinSelection,\n    });\n    return { sender, outputs, changeScript, selection };\n  };\n\n  return {\n    async estimateFee(intent, build) {\n      const rate = await rateOf(ctx, intent.fee, build.signal);\n      const { sender, selection } = await plan(intent, rate, build);\n      const change = selection.ok ? selection.change : 0n;\n      return draft(\n        sender.from.canonical,\n        speedOf(intent.fee),\n        selection.fee,\n        {\n          satPerKvB: rate,\n          vsize: selection.vsize,\n          inputs: selection.ok ? selection.inputs.length : 0,\n          outputs: intent.outputs.length + (change > 0n ? 1 : 0),\n          change,\n          changeIndex: change > 0n ? intent.outputs.length : -1,\n        },\n        'expected',\n      );\n    },\n\n    async checkFunds(intent, fee, build) {\n      assertNative(intent.asset);\n      const candidates = await spendable(\n        ctx,\n        senderOf(ctx, intent.from).from.canonical,\n        build.excludeInputs,\n        config.minInputConfirmations,\n        build.signal,\n      );\n      const available = candidates.reduce((sum, c) => sum + c.value, 0n);\n      const required =\n        intent.outputs.reduce((sum, o) => sum + o.amount, 0n) + paidOf(fee);\n      return available >= required\n        ? { ok: true }\n        : { ok: false, asset: 'native', required, available };\n    },\n\n    async build(intent, fee, build) {\n      const rate = detailsOf(fee).satPerKvB;\n      const { sender, outputs, changeScript, selection } = await plan(\n        intent,\n        rate,\n        build,\n      );\n      if (!selection.ok) {\n        throw insufficient('this transfer', selection.required, selection.available);\n      }\n      return unsignedFor(\n        scope,\n        build,\n        sender,\n        selection,\n        outputs,\n        changeScript,\n        rate,\n        fee.speed,\n        {\n          asset: native,\n          outputs: intent.outputs.map((o) => ({ to: o.to, amount: o.amount.toString() })),\n        },\n        { kept: new Set(), ownUnconfirmed: config.minInputConfirmations === 0 },\n      );\n    },\n\n    async assemble(unsigned, signatures) {\n      const { hex, txid } = assembleTx(\n        unsigned.payload.data,\n        network,\n        unsigned.signingRequests,\n        signatures,\n      );\n      if (unsigned.expectedRef && unsigned.expectedRef.id !== txid) {\n        throw new SigningError(\n          'SIGNING_FAILED',\n          'the signed transaction id differs from the prepared one',\n        );\n      }\n      return {\n        raw: { encoding: 'hex', data: hex },\n        ref: { id: txid, idKind: 'txid', canonical: true },\n      };\n    },\n\n    signaturesFrom(unsigned, signed) {\n      if (signed.encoding !== 'base64') {\n        throw new ValidationError(\n          'INVALID_INTENT',\n          'a signed PSBT is expected, as base64',\n        );\n      }\n      return signaturesFromPsbt(\n        unsigned.payload.data,\n        signed.data,\n        network,\n        unsigned.signingRequests,\n      );\n    },\n  };\n}\n\n/**\n * Twice Bitcoin Core's `MAX_BLOCK_SERIALIZED_SIZE`: no transaction's hex is longer, so\n * the untrusted text is capped before any decoding. A flat character class, never a\n * repeated group: V8's regexp stack overflows on a repeated group of a few million\n * matches, which a valid transaction can have.\n */\nconst MAX_TX_HEX = 8_000_000;\nconst HEX = /^[0-9a-fA-F]+$/;\n\n/**\n * An Attempt's bytes a node took (accepted, or already holds) are this wallet's\n * own sent transaction: its client keeps them. A bare broadcast (no ref) is not an Attempt.\n */\nfunction rememberOwn(ctx: UtxoContext, signed: SignedTx, hex: string): void {\n  if (signed.ref.id === '') return;\n  const tx = previousTxOf(hex);\n  if (tx?.txid === signed.ref.id) ctx.esplora.rememberOwn(tx);\n}\n\nexport function utxoBroadcaster(ctx: UtxoContext): Broadcaster {\n  return {\n    async broadcast(signed: SignedTx, options = {}): Promise<BroadcastResult> {\n      const { encoding, data } = signed.raw;\n      if (\n        encoding !== 'hex' ||\n        data.length > MAX_TX_HEX ||\n        data.length % 2 !== 0 ||\n        !HEX.test(data)\n      ) {\n        throw new ValidationError('INVALID_INTENT', 'a raw Bitcoin transaction is hex');\n      }\n      const hex = data.toLowerCase();\n      try {\n        const txid = await ctx.esplora.broadcast(hex, {\n          purpose: 'broadcast',\n          retry: 'ambiguous-on-failure',\n          ...(options.fanout !== undefined ? { fanout: options.fanout } : {}),\n          ...(options.signal ? { signal: options.signal } : {}),\n        });\n        // A bare broadcast (no ref) is checked against the bytes' own txid.\n        const expected =\n          signed.ref.id !== ''\n            ? signed.ref.id\n            : readTxHex(hex, { maxStripped: MAX_TX_BYTES })?.txid;\n        if (txid !== expected) {\n          // The node accepted something under another id: the outcome is unknown.\n          throw new ProviderError(\n            'PROVIDER_UNAVAILABLE',\n            'the node answered another txid',\n            {\n              ambiguous: true,\n            },\n          );\n        }\n        rememberOwn(ctx, signed, hex);\n        return { kind: 'accepted' };\n      } catch (error) {\n        // A definitive 400 is bitcoind's answer; anything else is rethrown. A rejection\n        // stands only when its reason holds for these bytes, checked here.\n        if (\n          isCryptoAioError(error, 'RPC_ERROR') &&\n          !error.ambiguous &&\n          error.details?.status === 400\n        ) {\n          const result = classifyOwnBroadcast(\n            parseNodeError(String(error.details.body ?? '')),\n            hex,\n          );\n          if (result.kind === 'already-known') rememberOwn(ctx, signed, hex);\n          return result;\n        }\n        throw error;\n      }\n    },\n  };\n}\n\nconst tooLow = (): ChainError =>\n  new ChainError(\n    'FEE_TOO_LOW',\n    'a replacement must pay the replaced fee plus the incremental relay fee, at a higher rate',\n  );\n\nexport function utxoReplacement(ctx: UtxoContext, network: Network): ReplacementPolicy {\n  const scope = scopeOf(ctx, network);\n  const { config } = ctx;\n  return {\n    replace: true,\n    cancel: true,\n\n    async buildReplacement(previous, fee, build) {\n      const sender = senderOf(ctx, build.from);\n      const prev = previousOf(scope, previous, sender);\n      const rate = await rateOf(ctx, fee, build.signal);\n      const changeScript = changeOf(scope, build, sender).script;\n      // BIP125 rule 2: an input it adds must be confirmed; it never takes a held one.\n      const candidates = await spendable(\n        ctx,\n        sender.from.canonical,\n        [...(build.excludeInputs ?? []), ...prev.inputs.map((i) => i.outpoint)],\n        Math.max(1, config.minInputConfirmations),\n        build.signal,\n      );\n      const selection = selectCoins({\n        candidates,\n        required: prev.inputs,\n        outputs: prev.outputs,\n        changeScript,\n        inputType: sender.type,\n        rate,\n        dustRelayFee: config.dustRelayFee,\n        strategy: 'accumulative',\n      });\n      if (!selection.ok) {\n        throw insufficient('the replacement', selection.required, selection.available);\n      }\n      const floor = replacementFloor(\n        { fee: prev.paid, vsize: prev.vsize, minVsize: prev.minVsize },\n        selection.vsize,\n        config.incrementalRelayFee,\n      );\n      if (selection.fee < floor) throw tooLow();\n      return unsignedFor(\n        scope,\n        build,\n        sender,\n        selection,\n        prev.outputs,\n        changeScript,\n        rate,\n        speedOf(fee),\n        previous.summary,\n        { kept: new Set(prev.inputs.map((i) => i.outpoint)), ownUnconfirmed: false },\n      );\n    },\n\n    async buildCancel(previous, build, fee) {\n      const sender = senderOf(ctx, build.from);\n      const prev = previousOf(scope, previous, sender);\n      // A cancel pays everything back to the sending address itself, never to a\n      // configured change address (under `allowExternalChangeAddress` an external one). A\n      // misconfigured change address is still refused here, as on every path.\n      changeOf(scope, build, sender);\n      const own = sender.from;\n      const total = prev.inputs.reduce((sum, i) => sum + i.value, 0n);\n      const vsize = vsizeOf(\n        txWeight(sender.type, prev.inputs.length, [own.script.length]),\n      );\n      const floor = replacementFloor(\n        { fee: prev.paid, vsize: prev.vsize, minVsize: prev.minVsize },\n        vsize,\n        config.incrementalRelayFee,\n      );\n      let paid = floor;\n      let rate = (floor * 1_000n + BigInt(vsize) - 1n) / BigInt(vsize);\n      if (fee !== undefined) {\n        rate = await rateOf(ctx, fee, build.signal);\n        paid = feeAt(rate, vsize);\n        if (paid < floor) throw tooLow();\n      }\n      const dust = dustThreshold(own.script, config.dustRelayFee);\n      if (total - paid < dust) throw insufficient('a cancel', paid + dust, total);\n      const value = total - paid;\n      return unsignedFor(\n        scope,\n        build,\n        sender,\n        { ok: true, inputs: prev.inputs, change: 0n, fee: paid, vsize },\n        [{ script: own.script, value }],\n        own.script,\n        rate,\n        fee === undefined ? 'custom' : speedOf(fee),\n        {\n          asset: previous.summary.asset,\n          outputs: [{ to: own.canonical, amount: value.toString() }],\n        },\n        { kept: new Set(prev.inputs.map((i) => i.outpoint)), ownUnconfirmed: false },\n      );\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,17 @@
+/**
+ * The built-in Bitcoin chain and networks. Genesis hashes and address prefixes are
+ * verified against Bitcoin Core's `src/kernel/chainparams.cpp`, and relay-policy numbers
+ * against its `src/policy/policy.h` and `policy.cpp`; the rest is library policy:
+ * - `finality: 6 confirmations` on every network, `defaultConfirmations: 1`
+ *   (`waitForConfirmation` waits for inclusion by default; credit deposits on `final`).
+ * - `reorgWindow: 24` (four times the finality depth).
+ * - `maxLagBlocks`: 2 on mainnet and signet, 6 on the testnets (their 20-minute
+ *   minimum-difficulty rule produces bursts of blocks), the transport default on regtest.
+ * - `minRelayFee` and `incrementalRelayFee` 1,000 sat/kvB (1 sat/vB): the defaults of
+ *   Bitcoin Core before v30, so older nodes relay what this library builds.
+ * - `feeFallback`: the rate used when a test network's estimator has no data (never on
+ *   mainnet, where a missing estimate fails the read instead).
+ */
+import type { ChainInfo } from '../../core/model/chain';
+/** Deep-frozen, so no caller can change a network another handle uses. */
+export declare const BITCOIN_CHAIN: ChainInfo;

package/dist/adapters/utxo/chains.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BITCOIN_CHAIN = void 0;
+const freeze_1 = require("../../core/util/freeze");
+const NETWORKS = [
+    {
+        id: 'mainnet',
+        genesis: '000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f',
+        testnet: false,
+        bech32: 'bc',
+        pubKeyHash: 0x00,
+        scriptHash: 0x05,
+        explorer: 'https://blockstream.info',
+        maxLagBlocks: 2,
+    },
+    {
+        id: 'testnet',
+        genesis: '000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943',
+        testnet: true,
+        bech32: 'tb',
+        pubKeyHash: 0x6f,
+        scriptHash: 0xc4,
+        explorer: 'https://blockstream.info/testnet',
+        maxLagBlocks: 6,
+        feeFallback: 1000n,
+    },
+    {
+        id: 'testnet4',
+        genesis: '00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043',
+        testnet: true,
+        bech32: 'tb',
+        pubKeyHash: 0x6f,
+        scriptHash: 0xc4,
+        maxLagBlocks: 6,
+        feeFallback: 1000n,
+    },
+    {
+        id: 'signet',
+        genesis: '00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6',
+        testnet: true,
+        bech32: 'tb',
+        pubKeyHash: 0x6f,
+        scriptHash: 0xc4,
+        explorer: 'https://blockstream.info/signet',
+        maxLagBlocks: 2,
+        feeFallback: 1000n,
+    },
+    {
+        id: 'regtest',
+        genesis: '0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206',
+        testnet: true,
+        bech32: 'bcrt',
+        pubKeyHash: 0x6f,
+        scriptHash: 0xc4,
+        feeFallback: 1000n,
+    },
+];
+function network(spec) {
+    return {
+        id: spec.id,
+        identity: spec.genesis,
+        testnet: spec.testnet,
+        feeModel: 'utxo',
+        finality: { kind: 'confirmations', confirmations: 6 },
+        defaultConfirmations: 1,
+        reorgWindow: 24,
+        ...(spec.maxLagBlocks !== undefined ? { maxLagBlocks: spec.maxLagBlocks } : {}),
+        ...(spec.explorer !== undefined
+            ? {
+                explorer: {
+                    tx: `${spec.explorer}/tx/{id}`,
+                    address: `${spec.explorer}/address/{address}`,
+                },
+            }
+            : {}),
+        params: {
+            bech32: spec.bech32,
+            pubKeyHash: spec.pubKeyHash,
+            scriptHash: spec.scriptHash,
+            dustRelayFee: 3000n,
+            minRelayFee: 1000n,
+            incrementalRelayFee: 1000n,
+            ...(spec.feeFallback !== undefined ? { feeFallback: spec.feeFallback } : {}),
+        },
+    };
+}
+/** Deep-frozen, so no caller can change a network another handle uses. */
+exports.BITCOIN_CHAIN = (0, freeze_1.deepFreeze)({
+    id: 'bitcoin',
+    family: 'utxo',
+    model: 'utxo',
+    ordering: 'inputs',
+    // keys[0] (the ECDSA key) defines the address; p2tr wallets also sign with Schnorr.
+    schemes: ['secp256k1-ecdsa', 'secp256k1-schnorr'],
+    nativeAsset: { symbol: 'BTC', decimals: 8, name: 'Bitcoin' },
+    defaultNetwork: 'mainnet',
+    networks: Object.fromEntries(NETWORKS.map((spec) => [spec.id, network(spec)])),
+});
+//# sourceMappingURL=chains.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/adapters/utxo/chains.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The built-in Bitcoin chain and networks. Genesis hashes and address prefixes are\n * verified against Bitcoin Core's `src/kernel/chainparams.cpp`, and relay-policy numbers\n * against its `src/policy/policy.h` and `policy.cpp`; the rest is library policy:\n * - `finality: 6 confirmations` on every network, `defaultConfirmations: 1`\n *   (`waitForConfirmation` waits for inclusion by default; credit deposits on `final`).\n * - `reorgWindow: 24` (four times the finality depth).\n * - `maxLagBlocks`: 2 on mainnet and signet, 6 on the testnets (their 20-minute\n *   minimum-difficulty rule produces bursts of blocks), the transport default on regtest.\n * - `minRelayFee` and `incrementalRelayFee` 1,000 sat/kvB (1 sat/vB): the defaults of\n *   Bitcoin Core before v30, so older nodes relay what this library builds.\n * - `feeFallback`: the rate used when a test network's estimator has no data (never on\n *   mainnet, where a missing estimate fails the read instead).\n */\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport { deepFreeze } from '../../core/util/freeze';\n\ninterface NetworkSpec {\n  readonly id: string;\n  readonly genesis: string;\n  readonly testnet: boolean;\n  readonly bech32: string;\n  readonly pubKeyHash: number;\n  readonly scriptHash: number;\n  readonly explorer?: string;\n  readonly maxLagBlocks?: number;\n  readonly feeFallback?: bigint;\n}\n\nconst NETWORKS: readonly NetworkSpec[] = [\n  {\n    id: 'mainnet',\n    genesis: '000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f',\n    testnet: false,\n    bech32: 'bc',\n    pubKeyHash: 0x00,\n    scriptHash: 0x05,\n    explorer: 'https://blockstream.info',\n    maxLagBlocks: 2,\n  },\n  {\n    id: 'testnet',\n    genesis: '000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943',\n    testnet: true,\n    bech32: 'tb',\n    pubKeyHash: 0x6f,\n    scriptHash: 0xc4,\n    explorer: 'https://blockstream.info/testnet',\n    maxLagBlocks: 6,\n    feeFallback: 1_000n,\n  },\n  {\n    id: 'testnet4',\n    genesis: '00000000da84f2bafbbc53dee25a72ae507ff4914b867c565be350b0da8bf043',\n    testnet: true,\n    bech32: 'tb',\n    pubKeyHash: 0x6f,\n    scriptHash: 0xc4,\n    maxLagBlocks: 6,\n    feeFallback: 1_000n,\n  },\n  {\n    id: 'signet',\n    genesis: '00000008819873e925422c1ff0f99f7cc9bbb232af63a077a480a3633bee1ef6',\n    testnet: true,\n    bech32: 'tb',\n    pubKeyHash: 0x6f,\n    scriptHash: 0xc4,\n    explorer: 'https://blockstream.info/signet',\n    maxLagBlocks: 2,\n    feeFallback: 1_000n,\n  },\n  {\n    id: 'regtest',\n    genesis: '0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206',\n    testnet: true,\n    bech32: 'bcrt',\n    pubKeyHash: 0x6f,\n    scriptHash: 0xc4,\n    feeFallback: 1_000n,\n  },\n];\n\nfunction network(spec: NetworkSpec): NetworkInfo {\n  return {\n    id: spec.id,\n    identity: spec.genesis,\n    testnet: spec.testnet,\n    feeModel: 'utxo',\n    finality: { kind: 'confirmations', confirmations: 6 },\n    defaultConfirmations: 1,\n    reorgWindow: 24,\n    ...(spec.maxLagBlocks !== undefined ? { maxLagBlocks: spec.maxLagBlocks } : {}),\n    ...(spec.explorer !== undefined\n      ? {\n          explorer: {\n            tx: `${spec.explorer}/tx/{id}`,\n            address: `${spec.explorer}/address/{address}`,\n          },\n        }\n      : {}),\n    params: {\n      bech32: spec.bech32,\n      pubKeyHash: spec.pubKeyHash,\n      scriptHash: spec.scriptHash,\n      dustRelayFee: 3_000n,\n      minRelayFee: 1_000n,\n      incrementalRelayFee: 1_000n,\n      ...(spec.feeFallback !== undefined ? { feeFallback: spec.feeFallback } : {}),\n    },\n  };\n}\n\n/** Deep-frozen, so no caller can change a network another handle uses. */\nexport const BITCOIN_CHAIN: ChainInfo = deepFreeze({\n  id: 'bitcoin',\n  family: 'utxo',\n  model: 'utxo',\n  ordering: 'inputs',\n  // keys[0] (the ECDSA key) defines the address; p2tr wallets also sign with Schnorr.\n  schemes: ['secp256k1-ecdsa', 'secp256k1-schnorr'],\n  nativeAsset: { symbol: 'BTC', decimals: 8, name: 'Bitcoin' },\n  defaultNetwork: 'mainnet',\n  networks: Object.fromEntries(NETWORKS.map((spec) => [spec.id, network(spec)])),\n});\n"]}