crypto-aio 0.0.2 → 0.1.0

package/dist/adapters/avalanche/context.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contradiction = exports.undecided = exports.LocationCache = exports.SCAN_DEPTH = exports.withSignal = exports.PROOF = exports.MONITOR = exports.READ = void 0;
+exports.proofRead = proofRead;
+exports.locate = locate;
+/**
+ * What every Avalanche port is built from, the transport tags of the `ChainDriver` contract
+ * table, and the locator: which accepted block holds a transaction.
+ *
+ * AvalancheGo can say a transaction is accepted, never in which block. The locator asks the
+ * Data API, then checks the answer against the node's block; a transaction the indexer does
+ * not know yet (it trails the chain by seconds) is looked for in the newest `SCAN_DEPTH`
+ * blocks. Accepted blocks never change (Snowman finality), so a location is kept once found.
+ * A location found on one endpoint is only a candidate for proofs: every proof re-reads its
+ * block under the proof quorum, and a candidate the quorum contradicts is forgotten.
+ */
+const error_1 = require("../../core/errors/error");
+exports.READ = { purpose: 'read', retry: 'safe' };
+exports.MONITOR = { purpose: 'monitor', retry: 'safe' };
+exports.PROOF = {
+    purpose: 'proof',
+    retry: 'safe',
+    quorum: 'proof',
+};
+const withSignal = (tags, signal) => (signal ? { ...tags, signal } : tags);
+exports.withSignal = withSignal;
+/** How many blocks below the head the locator reads when the indexer does not know a tx. */
+exports.SCAN_DEPTH = 16;
+/** Locations kept per driver (oldest dropped first). */
+const LOCATIONS = 10_000;
+class LocationCache {
+    #entries = new Map();
+    get(txId) {
+        return this.#entries.get(txId);
+    }
+    set(txId, location) {
+        this.#entries.set(txId, location);
+        if (this.#entries.size > LOCATIONS) {
+            this.#entries.delete(this.#entries.keys().next().value);
+        }
+    }
+    forget(txId) {
+        this.#entries.delete(txId);
+    }
+}
+exports.LocationCache = LocationCache;
+const undecided = (reason) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', reason);
+exports.undecided = undecided;
+/** Two reads that cannot both hold decide nothing (retryable). */
+const contradiction = (reason) => new error_1.ProviderError('PROVIDER_INCONSISTENT', reason, { retryable: true });
+exports.contradiction = contradiction;
+/**
+ * On a proof path only a definitive negative proof may answer "no".
+ * Every other non-retryable provider error (a JSON-RPC error that is not a "not found" the
+ * caller already mapped, a proxy's 4xx, a 401/403) becomes a retryable
+ * `PROVIDER_UNAVAILABLE` here, so it never decides anything. Retryable errors pass as they
+ * are. The cost is liveness only.
+ */
+async function proofRead(read) {
+    try {
+        return await read();
+    }
+    catch (error) {
+        if ((0, error_1.isCryptoAioError)(error) && error.category === 'provider' && !error.retryable) {
+            throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the proof read failed on this endpoint; nothing is decided', { cause: error });
+        }
+        throw error;
+    }
+}
+/** A location is a candidate, read on one endpoint: never a quorum read. */
+const singleRead = (tags) => ({
+    purpose: tags.purpose === 'proof' ? 'monitor' : (tags.purpose ?? 'read'),
+    retry: 'safe',
+    ...(tags.signal ? { signal: tags.signal } : {}),
+});
+/**
+ * The accepted block holding `txId`, a transaction the node has accepted: from the cache,
+ * else the indexer (checked against the node's block at its height), else the newest
+ * `SCAN_DEPTH` blocks. `undefined` when none of them names it yet, `'no-block'` for an
+ * X-Chain transaction from before the chain had blocks. Reads are single
+ * (`monitor` or `read`) reads: a location is a candidate; proofs re-read it under quorum.
+ */
+async function locate(ctx, txId, tags) {
+    const cached = ctx.located.get(txId);
+    if (cached)
+        return cached;
+    const read = singleRead(tags);
+    const indexed = await ctx.dataApi.locate(txId, read);
+    // An X-Chain transaction accepted before the linearization (April 2023) has no block.
+    if (indexed === 'no-block')
+        return 'no-block';
+    if (indexed !== null) {
+        const block = await ctx.node.blockAt(indexed.height, read);
+        if (block === null)
+            return undefined; // the node has not reached it yet
+        if (block.id !== indexed.hash || !block.txIds.includes(txId)) {
+            throw (0, exports.contradiction)("the indexer's block for the transaction is not the node's");
+        }
+        ctx.located.set(txId, indexed);
+        return indexed;
+    }
+    const head = await ctx.node.height(read);
+    const lowest = head - BigInt(exports.SCAN_DEPTH) + 1n;
+    for (let height = head; height >= 0n && height >= lowest; height--) {
+        const block = await ctx.node.blockAt(height, read);
+        if (block?.txIds.includes(txId)) {
+            const found = { height: block.height, hash: block.id };
+            ctx.located.set(txId, found);
+            return found;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=context.js.map

package/dist/adapters/avalanche/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What every Avalanche port is built from, the transport tags of the `ChainDriver` contract\n * table, and the locator: which accepted block holds a transaction.\n *\n * AvalancheGo can say a transaction is accepted, never in which block. The locator asks the\n * Data API, then checks the answer against the node's block; a transaction the indexer does\n * not know yet (it trails the chain by seconds) is looked for in the newest `SCAN_DEPTH`\n * blocks. Accepted blocks never change (Snowman finality), so a location is kept once found.\n * A location found on one endpoint is only a candidate for proofs: every proof re-reads its\n * block under the proof quorum, and a candidate the quorum contradicts is forgotten.\n */\nimport { ProviderError, isCryptoAioError } from '../../core/errors/error';\nimport type { Logger } from '../../core/events/logger';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport type { Clock } from '../../core/util/clock';\nimport type { AvalancheNode, DataApi, Location } from './api';\nimport type { AvalancheNetworkConfig } from './network';\nimport type { AvalancheCallTags } from './types';\n\nexport const READ: AvalancheCallTags = { purpose: 'read', retry: 'safe' };\nexport const MONITOR: AvalancheCallTags = { purpose: 'monitor', retry: 'safe' };\nexport const PROOF: AvalancheCallTags = {\n  purpose: 'proof',\n  retry: 'safe',\n  quorum: 'proof',\n};\n\nexport const withSignal = (\n  tags: AvalancheCallTags,\n  signal?: AbortSignal,\n): AvalancheCallTags => (signal ? { ...tags, signal } : tags);\n\n/** How many blocks below the head the locator reads when the indexer does not know a tx. */\nexport const SCAN_DEPTH = 16;\n/** Locations kept per driver (oldest dropped first). */\nconst LOCATIONS = 10_000;\n\nexport class LocationCache {\n  readonly #entries = new Map<string, Location>();\n\n  get(txId: string): Location | undefined {\n    return this.#entries.get(txId);\n  }\n\n  set(txId: string, location: Location): void {\n    this.#entries.set(txId, location);\n    if (this.#entries.size > LOCATIONS) {\n      this.#entries.delete(this.#entries.keys().next().value as string);\n    }\n  }\n\n  forget(txId: string): void {\n    this.#entries.delete(txId);\n  }\n}\n\nexport interface AvalancheContext {\n  readonly node: AvalancheNode;\n  readonly dataApi: DataApi;\n  readonly chain: ChainInfo;\n  readonly network: NetworkInfo;\n  readonly config: AvalancheNetworkConfig;\n  readonly clock: Clock;\n  readonly log: Logger;\n  readonly located: LocationCache;\n}\n\nexport const undecided = (reason: string): ProviderError =>\n  new ProviderError('PROVIDER_UNAVAILABLE', reason);\n\n/** Two reads that cannot both hold decide nothing (retryable). */\nexport const contradiction = (reason: string): ProviderError =>\n  new ProviderError('PROVIDER_INCONSISTENT', reason, { retryable: true });\n\n/**\n * On a proof path only a definitive negative proof may answer \"no\".\n * Every other non-retryable provider error (a JSON-RPC error that is not a \"not found\" the\n * caller already mapped, a proxy's 4xx, a 401/403) becomes a retryable\n * `PROVIDER_UNAVAILABLE` here, so it never decides anything. Retryable errors pass as they\n * are. The cost is liveness only.\n */\nexport async function proofRead<T>(read: () => Promise<T>): Promise<T> {\n  try {\n    return await read();\n  } catch (error) {\n    if (isCryptoAioError(error) && error.category === 'provider' && !error.retryable) {\n      throw new ProviderError(\n        'PROVIDER_UNAVAILABLE',\n        'the proof read failed on this endpoint; nothing is decided',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n}\n\n/** A location is a candidate, read on one endpoint: never a quorum read. */\nconst singleRead = (tags: AvalancheCallTags): AvalancheCallTags => ({\n  purpose: tags.purpose === 'proof' ? 'monitor' : (tags.purpose ?? 'read'),\n  retry: 'safe',\n  ...(tags.signal ? { signal: tags.signal } : {}),\n});\n\n/**\n * The accepted block holding `txId`, a transaction the node has accepted: from the cache,\n * else the indexer (checked against the node's block at its height), else the newest\n * `SCAN_DEPTH` blocks. `undefined` when none of them names it yet, `'no-block'` for an\n * X-Chain transaction from before the chain had blocks. Reads are single\n * (`monitor` or `read`) reads: a location is a candidate; proofs re-read it under quorum.\n */\nexport async function locate(\n  ctx: AvalancheContext,\n  txId: string,\n  tags: AvalancheCallTags,\n): Promise<Location | 'no-block' | undefined> {\n  const cached = ctx.located.get(txId);\n  if (cached) return cached;\n  const read = singleRead(tags);\n  const indexed = await ctx.dataApi.locate(txId, read);\n  // An X-Chain transaction accepted before the linearization (April 2023) has no block.\n  if (indexed === 'no-block') return 'no-block';\n  if (indexed !== null) {\n    const block = await ctx.node.blockAt(indexed.height, read);\n    if (block === null) return undefined; // the node has not reached it yet\n    if (block.id !== indexed.hash || !block.txIds.includes(txId)) {\n      throw contradiction(\"the indexer's block for the transaction is not the node's\");\n    }\n    ctx.located.set(txId, indexed);\n    return indexed;\n  }\n  const head = await ctx.node.height(read);\n  const lowest = head - BigInt(SCAN_DEPTH) + 1n;\n  for (let height = head; height >= 0n && height >= lowest; height--) {\n    const block = await ctx.node.blockAt(height, read);\n    if (block?.txIds.includes(txId)) {\n      const found = { height: block.height, hash: block.id };\n      ctx.located.set(txId, found);\n      return found;\n    }\n  }\n  return undefined;\n}\n"]}

package/dist/adapters/avalanche/decode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * An Avalanche transaction as the core reads it, from its signed bytes.
+ * - Transfers: each plain AVAX output of the transaction's own outputs (its base outputs,
+ *   on this chain) to one address, unlocked, threshold 1: `out:<index>`, the output's index
+ *   in its UTXO id. The senders are the addresses the signatures recover to.
+ * - `decoding: 'complete'` only for a BaseTx or ImportTx whose every output is such a
+ *   transfer. An export (value leaves for another chain), a staking or subnet transaction,
+ *   a reward, another asset, a locked or multi-owner output, or a type this SDK cannot read
+ *   is `partial`; bytes that do not parse are `none`.
+ * - `details.signers`: the addresses that signed it, whatever it did.
+ * - The fee is the AVAX the transaction burns. A memo that is UTF-8 text becomes the
+ *   transfers' memo; the raw memo is in `details.memo` (hex).
+ */
+import type { DriverTransaction, DriverTxObservation } from '../../core/driver/types';
+import type { AvalancheNetworkConfig } from './network';
+export declare function decodeTransaction(bytes: Uint8Array, config: AvalancheNetworkConfig, observation: DriverTxObservation): DriverTransaction;

package/dist/adapters/avalanche/decode.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeTransaction = decodeTransaction;
+const bytes_1 = require("../../core/util/bytes");
+const address_1 = require("./address");
+const cb58_1 = require("./cb58");
+const codec_1 = require("./codec");
+const sdk_1 = require("./sdk");
+const COMPLETE_TYPES = new Set([
+    'avm.BaseTx',
+    'pvm.BaseTx',
+    'avm.ImportTx',
+    'pvm.ImportTx',
+]);
+const utf8 = new TextDecoder('utf-8', { fatal: true });
+function memoText(memo) {
+    if (memo.length === 0)
+        return undefined;
+    try {
+        return utf8.decode(memo);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The AVAX `tx` burns, or `undefined` when the SDK cannot say. */
+function burnedAvax(tx, config) {
+    try {
+        const burned = sdk_1.avalanche.utils
+            .getBurnedAmountByTx(tx, (0, codec_1.sdkContext)(config))
+            .get(config.avaxAssetId);
+        return burned !== undefined && burned >= 0n ? burned : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function decodeTransaction(bytes, config, observation) {
+    const raw = { encoding: 'hex', data: (0, bytes_1.toHex)(bytes) };
+    let parsed;
+    try {
+        parsed = (0, codec_1.parseSignedTx)(bytes, config);
+    }
+    catch {
+        // A transaction type this SDK version cannot read: known only by its id.
+        return {
+            id: (0, cb58_1.idOf)(bytes),
+            observation,
+            transfers: [],
+            decoding: 'none',
+            raw,
+            details: { type: 'unknown' },
+        };
+    }
+    const { tx } = parsed;
+    const base = tx.baseTx;
+    const from = (0, codec_1.signersOf)(parsed).map((address) => (0, address_1.formatAddress)(address, config));
+    const memoBytes = base?.memo.bytes ?? new Uint8Array();
+    const memo = memoText(memoBytes);
+    const transfers = [];
+    let complete = COMPLETE_TYPES.has(tx._type) && base !== undefined;
+    base?.outputs.forEach((output, index) => {
+        const owners = output.output._type === sdk_1.TYPES.transferOutput
+            ? output.output.outputOwners
+            : undefined;
+        if (output.assetId.toString() !== config.avaxAssetId ||
+            owners === undefined ||
+            owners.locktime.value() !== 0n ||
+            owners.threshold.value() !== 1 ||
+            owners.addrs.length !== 1) {
+            complete = false;
+            return;
+        }
+        transfers.push({
+            locator: `out:${index}`,
+            from,
+            to: (0, address_1.formatAddress)(owners.addrs[0]?.toBytes(), config),
+            asset: 'native',
+            amount: output.amount(),
+            source: 'native',
+            ...(memo !== undefined ? { memo } : {}),
+        });
+    });
+    const fee = burnedAvax(tx, config);
+    return {
+        id: parsed.id,
+        observation,
+        ...(fee !== undefined && fee > 0n
+            ? { fee: [{ asset: 'native', amount: fee }] }
+            : {}),
+        transfers,
+        decoding: complete ? 'complete' : 'partial',
+        raw,
+        details: {
+            type: tx._type,
+            signers: from,
+            ...(memoBytes.length > 0 ? { memo: (0, bytes_1.toHex)(memoBytes) } : {}),
+        },
+    };
+}
+//# sourceMappingURL=decode.js.map

package/dist/adapters/avalanche/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/decode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * An Avalanche transaction as the core reads it, from its signed bytes.\n * - Transfers: each plain AVAX output of the transaction's own outputs (its base outputs,\n *   on this chain) to one address, unlocked, threshold 1: `out:<index>`, the output's index\n *   in its UTXO id. The senders are the addresses the signatures recover to.\n * - `decoding: 'complete'` only for a BaseTx or ImportTx whose every output is such a\n *   transfer. An export (value leaves for another chain), a staking or subnet transaction,\n *   a reward, another asset, a locked or multi-owner output, or a type this SDK cannot read\n *   is `partial`; bytes that do not parse are `none`.\n * - `details.signers`: the addresses that signed it, whatever it did.\n * - The fee is the AVAX the transaction burns. A memo that is UTF-8 text becomes the\n *   transfers' memo; the raw memo is in `details.memo` (hex).\n */\nimport type {\n  DriverTransaction,\n  DriverTransfer,\n  DriverTxObservation,\n} from '../../core/driver/types';\nimport { toHex } from '../../core/util/bytes';\nimport { formatAddress } from './address';\nimport { idOf } from './cb58';\nimport { parseSignedTx, sdkContext, signersOf } from './codec';\nimport type { AvalancheNetworkConfig } from './network';\nimport { TYPES, avalanche, type SdkTransferOutput } from './sdk';\n\nconst COMPLETE_TYPES = new Set([\n  'avm.BaseTx',\n  'pvm.BaseTx',\n  'avm.ImportTx',\n  'pvm.ImportTx',\n]);\n\nconst utf8 = new TextDecoder('utf-8', { fatal: true });\n\nfunction memoText(memo: Uint8Array): string | undefined {\n  if (memo.length === 0) return undefined;\n  try {\n    return utf8.decode(memo);\n  } catch {\n    return undefined;\n  }\n}\n\n/** The AVAX `tx` burns, or `undefined` when the SDK cannot say. */\nfunction burnedAvax(\n  tx: Parameters<typeof avalanche.utils.getBurnedAmountByTx>[0],\n  config: AvalancheNetworkConfig,\n): bigint | undefined {\n  try {\n    const burned = avalanche.utils\n      .getBurnedAmountByTx(tx, sdkContext(config))\n      .get(config.avaxAssetId);\n    return burned !== undefined && burned >= 0n ? burned : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function decodeTransaction(\n  bytes: Uint8Array,\n  config: AvalancheNetworkConfig,\n  observation: DriverTxObservation,\n): DriverTransaction {\n  const raw = { encoding: 'hex' as const, data: toHex(bytes) };\n  let parsed: ReturnType<typeof parseSignedTx>;\n  try {\n    parsed = parseSignedTx(bytes, config);\n  } catch {\n    // A transaction type this SDK version cannot read: known only by its id.\n    return {\n      id: idOf(bytes),\n      observation,\n      transfers: [],\n      decoding: 'none',\n      raw,\n      details: { type: 'unknown' },\n    };\n  }\n  const { tx } = parsed;\n  const base = tx.baseTx;\n  const from = signersOf(parsed).map((address) => formatAddress(address, config));\n  const memoBytes = base?.memo.bytes ?? new Uint8Array();\n  const memo = memoText(memoBytes);\n  const transfers: DriverTransfer[] = [];\n  let complete = COMPLETE_TYPES.has(tx._type) && base !== undefined;\n  base?.outputs.forEach((output, index) => {\n    const owners =\n      output.output._type === TYPES.transferOutput\n        ? (output.output as SdkTransferOutput).outputOwners\n        : undefined;\n    if (\n      output.assetId.toString() !== config.avaxAssetId ||\n      owners === undefined ||\n      owners.locktime.value() !== 0n ||\n      owners.threshold.value() !== 1 ||\n      owners.addrs.length !== 1\n    ) {\n      complete = false;\n      return;\n    }\n    transfers.push({\n      locator: `out:${index}`,\n      from,\n      to: formatAddress(owners.addrs[0]?.toBytes() as Uint8Array, config),\n      asset: 'native',\n      amount: output.amount(),\n      source: 'native',\n      ...(memo !== undefined ? { memo } : {}),\n    });\n  });\n  const fee = burnedAvax(tx, config);\n  return {\n    id: parsed.id,\n    observation,\n    ...(fee !== undefined && fee > 0n\n      ? { fee: [{ asset: 'native' as const, amount: fee }] }\n      : {}),\n    transfers,\n    decoding: complete ? 'complete' : 'partial',\n    raw,\n    details: {\n      type: tx._type,\n      signers: from,\n      ...(memoBytes.length > 0 ? { memo: toHex(memoBytes) } : {}),\n    },\n  };\n}\n"]}

package/dist/adapters/avalanche/driver.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The Avalanche driver factory: validated network config, endpoint probes on both
+ * transports, and the ports. Loaded only by the manifest's `load()`, with
+ * `@avalabs/avalanchejs`.
+ */
+import type { DriverFactory } from '../../core/driver/types';
+import { type AvalancheSdk, type SdkContext } from './sdk';
+export interface AvalancheNativeClient {
+    /**
+     * The `@avalabs/avalanchejs` module. Its type names the members this library uses; cast
+     * it to reach the rest of the SDK.
+     */
+    readonly avalanche: AvalancheSdk;
+    /**
+     * avalanchejs's `Context` for this network and chain (network id, HRP, AVAX asset id,
+     * this chain's id). Its fee fields are zero: read the fees from the chain.
+     */
+    readonly context: SdkContext;
+    /** A JSON-RPC call (e.g. `avm.getTxFee`) to the handle's node endpoints, through the transport. */
+    rpc<T = unknown>(method: string, params?: unknown): Promise<T>;
+}
+export declare const avalancheDriverFactory: DriverFactory;

package/dist/adapters/avalanche/driver.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.avalancheDriverFactory = void 0;
+const error_1 = require("../../core/errors/error");
+const api_1 = require("./api");
+const builder_1 = require("./builder");
+const codec_1 = require("./codec");
+const context_1 = require("./context");
+const network_1 = require("./network");
+const proofs_1 = require("./proofs");
+const reader_1 = require("./reader");
+const sdk_1 = require("./sdk");
+function nodeProbes(config) {
+    const prefix = config.vm === 'avm' ? 'avm' : 'platform';
+    return {
+        identity: async (call) => (0, api_1.parseBlock)(await call.rpc(`${prefix}.getBlockByHeight`, { height: '0', encoding: 'json' })).id,
+        expectedIdentity: config.genesisBlockId,
+        height: async (call) => (0, api_1.parseHeight)((await call.rpc(`${prefix}.getHeight`, {}))
+            ?.height),
+    };
+}
+function indexerProbes(config) {
+    return {
+        identity: async (call) => api_1.DataApi.blockZero(await call.http({ method: 'GET', path: '/blocks/0', route: '/blocks/:id' })),
+        expectedIdentity: config.genesisBlockId,
+        height: async (call) => api_1.DataApi.latestHeight(await call.http({
+            method: 'GET',
+            path: '/blocks',
+            query: { pageSize: '1' },
+            route: '/blocks',
+        })),
+    };
+}
+exports.avalancheDriverFactory = {
+    async create(ctx) {
+        const config = (0, network_1.avalancheNetworkConfig)(ctx.chain, ctx.network, ctx.options);
+        if (!ctx.indexer) {
+            throw new error_1.ConfigError('CONFIG_INVALID', 'the Avalanche driver requires an indexer provider (the Avalanche Data API)');
+        }
+        // Probes on both transports, once, before any traffic: without them an endpoint's
+        // identity is never checked, and an endpoint of another network is never disabled.
+        ctx.transport.setProbes(nodeProbes(config));
+        ctx.indexer.setProbes(indexerProbes(config));
+        const avax = {
+            node: new api_1.AvalancheNode(ctx.transport, config.vm),
+            dataApi: new api_1.DataApi(ctx.indexer),
+            chain: ctx.chain,
+            network: ctx.network,
+            config,
+            clock: ctx.clock,
+            log: ctx.log,
+            located: new context_1.LocationCache(),
+        };
+        return {
+            ordering: 'inputs',
+            capabilities: config.capabilities,
+            address: (0, reader_1.addressCodec)(avax),
+            reader: (0, reader_1.chainReader)(avax),
+            builder: (0, builder_1.avalancheBuilder)(avax),
+            broadcaster: (0, builder_1.avalancheBroadcaster)(avax),
+            proofs: (0, proofs_1.proofSource)(avax),
+            blocks: (0, proofs_1.blockSource)(avax),
+            history: (0, reader_1.addressHistory)(avax),
+            ext: {
+                avalanche: {
+                    listUnspent: (address) => (0, reader_1.listUnspent)(avax, address),
+                },
+            },
+            limits: () => ({ maxOutputs: builder_1.MAX_OUTPUTS }),
+            createNativeClient: () => {
+                const client = {
+                    avalanche: sdk_1.avalanche,
+                    context: (0, codec_1.sdkContext)(config),
+                    rpc: (method, params) => ctx.transport.rpc(method, params ?? {}, context_1.READ),
+                };
+                return { client };
+            },
+        };
+    },
+};
+//# sourceMappingURL=driver.js.map

package/dist/adapters/avalanche/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/driver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Avalanche driver factory: validated network config, endpoint probes on both\n * transports, and the ports. Loaded only by the manifest's `load()`, with\n * `@avalabs/avalanchejs`.\n */\nimport type { ChainDriver, DriverContext, DriverFactory } from '../../core/driver/types';\nimport { ConfigError } from '../../core/errors/error';\nimport type { EndpointCall, HealthProbes } from '../../core/transport/types';\nimport { AvalancheNode, DataApi, parseBlock, parseHeight } from './api';\nimport { avalancheBroadcaster, avalancheBuilder, MAX_OUTPUTS } from './builder';\nimport { sdkContext } from './codec';\nimport { LocationCache, READ, type AvalancheContext } from './context';\nimport { avalancheNetworkConfig, type AvalancheNetworkConfig } from './network';\nimport { blockSource, proofSource } from './proofs';\nimport { addressCodec, addressHistory, chainReader, listUnspent } from './reader';\nimport { avalanche, type AvalancheSdk, type SdkContext } from './sdk';\nimport type { AvalancheExt } from './types';\n\nexport interface AvalancheNativeClient {\n  /**\n   * The `@avalabs/avalanchejs` module. Its type names the members this library uses; cast\n   * it to reach the rest of the SDK.\n   */\n  readonly avalanche: AvalancheSdk;\n  /**\n   * avalanchejs's `Context` for this network and chain (network id, HRP, AVAX asset id,\n   * this chain's id). Its fee fields are zero: read the fees from the chain.\n   */\n  readonly context: SdkContext;\n  /** A JSON-RPC call (e.g. `avm.getTxFee`) to the handle's node endpoints, through the transport. */\n  rpc<T = unknown>(method: string, params?: unknown): Promise<T>;\n}\n\nfunction nodeProbes(config: AvalancheNetworkConfig): HealthProbes {\n  const prefix = config.vm === 'avm' ? 'avm' : 'platform';\n  return {\n    identity: async (call: EndpointCall) =>\n      parseBlock(\n        await call.rpc(`${prefix}.getBlockByHeight`, { height: '0', encoding: 'json' }),\n      ).id,\n    expectedIdentity: config.genesisBlockId,\n    height: async (call: EndpointCall) =>\n      parseHeight(\n        ((await call.rpc(`${prefix}.getHeight`, {})) as { height?: unknown } | null)\n          ?.height,\n      ),\n  };\n}\n\nfunction indexerProbes(config: AvalancheNetworkConfig): HealthProbes {\n  return {\n    identity: async (call: EndpointCall) =>\n      DataApi.blockZero(\n        await call.http({ method: 'GET', path: '/blocks/0', route: '/blocks/:id' }),\n      ),\n    expectedIdentity: config.genesisBlockId,\n    height: async (call: EndpointCall) =>\n      DataApi.latestHeight(\n        await call.http({\n          method: 'GET',\n          path: '/blocks',\n          query: { pageSize: '1' },\n          route: '/blocks',\n        }),\n      ),\n  };\n}\n\nexport const avalancheDriverFactory: DriverFactory = {\n  async create(ctx: DriverContext): Promise<ChainDriver> {\n    const config = avalancheNetworkConfig(ctx.chain, ctx.network, ctx.options);\n    if (!ctx.indexer) {\n      throw new ConfigError(\n        'CONFIG_INVALID',\n        'the Avalanche driver requires an indexer provider (the Avalanche Data API)',\n      );\n    }\n    // Probes on both transports, once, before any traffic: without them an endpoint's\n    // identity is never checked, and an endpoint of another network is never disabled.\n    ctx.transport.setProbes(nodeProbes(config));\n    ctx.indexer.setProbes(indexerProbes(config));\n    const avax: AvalancheContext = {\n      node: new AvalancheNode(ctx.transport, config.vm),\n      dataApi: new DataApi(ctx.indexer),\n      chain: ctx.chain,\n      network: ctx.network,\n      config,\n      clock: ctx.clock,\n      log: ctx.log,\n      located: new LocationCache(),\n    };\n    return {\n      ordering: 'inputs',\n      capabilities: config.capabilities,\n      address: addressCodec(avax),\n      reader: chainReader(avax),\n      builder: avalancheBuilder(avax),\n      broadcaster: avalancheBroadcaster(avax),\n      proofs: proofSource(avax),\n      blocks: blockSource(avax),\n      history: addressHistory(avax),\n      ext: {\n        avalanche: {\n          listUnspent: (address: string) => listUnspent(avax, address),\n        },\n      } satisfies AvalancheExt,\n      limits: () => ({ maxOutputs: MAX_OUTPUTS }),\n      createNativeClient: () => {\n        const client: AvalancheNativeClient = {\n          avalanche,\n          context: sdkContext(config),\n          rpc: <T>(method: string, params?: unknown) =>\n            ctx.transport.rpc<T>(method, params ?? {}, READ),\n        };\n        return { client };\n      },\n    };\n  },\n};\n"]}

package/dist/adapters/avalanche/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Broadcast classification (pure). AvalancheGo answers a refused `issueTx` with a JSON-RPC
+ * error (-32000) whose message is its Go error chain, e.g. `couldn't issue tx: failed
+ * verification: failed to read consumed UTXO …: not found` (P-Chain) or `failed to get
+ * utxo …: not found` (X-Chain); the texts below are AvalancheGo's (`vms/txs/mempool`,
+ * `vms/components/avax`, `vms/platformvm/utxo`, `vms/secp256k1fx`). A node answers a
+ * duplicate with the id, as a success; the text is still recognized here.
+ *
+ * A node's rejection is a claim: a lone endpoint can claim one and relay the bytes
+ * anyway, and a terminal `rejected` would free the inputs for a retry that pays twice.
+ * Every transaction this driver builds is checked before it is signed and its signature
+ * verified by the core, so no answer here is `rejected`: each is a `refused`
+ * (state-dependent, never terminal) with a code, and the core first looks up the
+ * Attempt's own id. Reasons are fixed texts: the node's carry ids and amounts, which a
+ * stored reason must never hold.
+ */
+import type { BroadcastResult } from '../../core/driver/types';
+export declare function classifyIssueError(message: string): BroadcastResult;

package/dist/adapters/avalanche/errors.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyIssueError = classifyIssueError;
+/** Only a message's head is read, so an oversized node text costs a bounded scan. */
+const MAX_MESSAGE = 1_024;
+const RULES = [
+    [/\bduplicate tx\b/, { kind: 'already-known' }],
+    [
+        /\binsufficient (?:unlocked )?funds\b/,
+        {
+            kind: 'refused',
+            code: 'FEE_TOO_LOW',
+            reason: 'the transaction burns less than the chain charges now',
+        },
+    ],
+    [
+        /\bfailed to (?:get|read consumed) utxo\b/i,
+        {
+            kind: 'refused',
+            code: 'TX_REFUSED',
+            reason: 'an input is already spent, or not known to the node yet',
+        },
+    ],
+    [
+        /\btx conflicts with other tx\b/,
+        {
+            kind: 'refused',
+            code: 'TX_REFUSED',
+            reason: 'it conflicts with a transaction in the mempool',
+        },
+    ],
+    [
+        /\bmempool is full\b/,
+        { kind: 'refused', code: 'TX_REFUSED', reason: 'the node mempool is full' },
+    ],
+    [
+        /\btx too large\b/,
+        {
+            kind: 'refused',
+            code: 'TX_REFUSED',
+            reason: 'the transaction is larger than the mempool takes',
+        },
+    ],
+    [
+        /\boutput is time locked\b/,
+        { kind: 'refused', code: 'TX_REFUSED', reason: 'an input is still time locked' },
+    ],
+];
+const DEFAULT = {
+    kind: 'refused',
+    code: 'TX_REFUSED',
+    reason: 'the node refused the transaction',
+};
+function classifyIssueError(message) {
+    const head = message.slice(0, MAX_MESSAGE);
+    for (const [pattern, result] of RULES)
+        if (pattern.test(head))
+            return result;
+    return DEFAULT;
+}
+//# sourceMappingURL=errors.js.map

package/dist/adapters/avalanche/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/errors.ts"],"names":[],"mappings":";;AAuEA,gDAIC;AAzDD,qFAAqF;AACrF,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B,MAAM,KAAK,GAAoD;IAC7D,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAC/C;QACE,sCAAsC;QACtC;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,uDAAuD;SAChE;KACF;IACD;QACE,2CAA2C;QAC3C;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,yDAAyD;SAClE;KACF;IACD;QACE,gCAAgC;QAChC;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,gDAAgD;SACzD;KACF;IACD;QACE,qBAAqB;QACrB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,0BAA0B,EAAE;KAC5E;IACD;QACE,kBAAkB;QAClB;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,kDAAkD;SAC3D;KACF;IACD;QACE,2BAA2B;QAC3B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,+BAA+B,EAAE;KACjF;CACF,CAAC;AAEF,MAAM,OAAO,GAAoB;IAC/B,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,kCAAkC;CAC3C,CAAC;AAEF,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK;QAAE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * Broadcast classification (pure). AvalancheGo answers a refused `issueTx` with a JSON-RPC\n * error (-32000) whose message is its Go error chain, e.g. `couldn't issue tx: failed\n * verification: failed to read consumed UTXO …: not found` (P-Chain) or `failed to get\n * utxo …: not found` (X-Chain); the texts below are AvalancheGo's (`vms/txs/mempool`,\n * `vms/components/avax`, `vms/platformvm/utxo`, `vms/secp256k1fx`). A node answers a\n * duplicate with the id, as a success; the text is still recognized here.\n *\n * A node's rejection is a claim: a lone endpoint can claim one and relay the bytes\n * anyway, and a terminal `rejected` would free the inputs for a retry that pays twice.\n * Every transaction this driver builds is checked before it is signed and its signature\n * verified by the core, so no answer here is `rejected`: each is a `refused`\n * (state-dependent, never terminal) with a code, and the core first looks up the\n * Attempt's own id. Reasons are fixed texts: the node's carry ids and amounts, which a\n * stored reason must never hold.\n */\nimport type { BroadcastResult } from '../../core/driver/types';\n\n/** Only a message's head is read, so an oversized node text costs a bounded scan. */\nconst MAX_MESSAGE = 1_024;\n\nconst RULES: readonly (readonly [RegExp, BroadcastResult])[] = [\n  [/\\bduplicate tx\\b/, { kind: 'already-known' }],\n  [\n    /\\binsufficient (?:unlocked )?funds\\b/,\n    {\n      kind: 'refused',\n      code: 'FEE_TOO_LOW',\n      reason: 'the transaction burns less than the chain charges now',\n    },\n  ],\n  [\n    /\\bfailed to (?:get|read consumed) utxo\\b/i,\n    {\n      kind: 'refused',\n      code: 'TX_REFUSED',\n      reason: 'an input is already spent, or not known to the node yet',\n    },\n  ],\n  [\n    /\\btx conflicts with other tx\\b/,\n    {\n      kind: 'refused',\n      code: 'TX_REFUSED',\n      reason: 'it conflicts with a transaction in the mempool',\n    },\n  ],\n  [\n    /\\bmempool is full\\b/,\n    { kind: 'refused', code: 'TX_REFUSED', reason: 'the node mempool is full' },\n  ],\n  [\n    /\\btx too large\\b/,\n    {\n      kind: 'refused',\n      code: 'TX_REFUSED',\n      reason: 'the transaction is larger than the mempool takes',\n    },\n  ],\n  [\n    /\\boutput is time locked\\b/,\n    { kind: 'refused', code: 'TX_REFUSED', reason: 'an input is still time locked' },\n  ],\n];\n\nconst DEFAULT: BroadcastResult = {\n  kind: 'refused',\n  code: 'TX_REFUSED',\n  reason: 'the node refused the transaction',\n};\n\nexport function classifyIssueError(message: string): BroadcastResult {\n  const head = message.slice(0, MAX_MESSAGE);\n  for (const [pattern, result] of RULES) if (pattern.test(head)) return result;\n  return DEFAULT;\n}\n"]}

package/dist/adapters/avalanche/fees.d.ts

@@ -0,0 +1,23 @@
+import { type FeeOverride, type FeeSpeed } from '../../core/model/fee';
+import type { FeeWeights } from './api';
+import { type FeePlan } from './codec';
+import { type AvalancheContext } from './context';
+/** Each speed's margin over the endpoint's gas price, in basis points. */
+export declare const SPEED_MARGIN_BPS: Readonly<Record<FeeSpeed, bigint>>;
+export interface FeeConfigCache {
+    value?: {
+        readonly weights: FeeWeights;
+        readonly minPrice: bigint;
+    };
+    until?: number;
+}
+/** The fee plan of `fee` on this chain, from the endpoints' current fee data. */
+export declare function feePlanOf(ctx: AvalancheContext, fee: FeeSpeed | FeeOverride, cache: FeeConfigCache, signal?: AbortSignal): Promise<FeePlan>;
+/**
+ * The fee plan a stored estimate fixed (`details`), checked: it is our own plain data,
+ * read back from the caller's store, which keeps only plain values (`bigint` included).
+ */
+export declare function storedPlan(details: Readonly<Record<string, unknown>>, model: 'static' | 'dynamic'): {
+    readonly txFee?: bigint;
+    readonly gasPrice?: bigint;
+};

package/dist/adapters/avalanche/fees.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPEED_MARGIN_BPS = void 0;
+exports.feePlanOf = feePlanOf;
+exports.storedPlan = storedPlan;
+/**
+ * Fee plans. The X-Chain burns a fixed fee per transaction (`txFee`, 0.001 AVAX
+ * on mainnet and Fuji), read under the proof quorum so one endpoint cannot raise it, and
+ * every speed pays it. Since Etna the P-Chain prices gas: a transaction's fee is its gas
+ * (complexity weighed by the network's weights) times the gas price. The price an endpoint
+ * reports moves with load (it can double in about 30 s at full load), so a speed pays it
+ * times a margin, library policy: slow 1.1×, normal 1.5×, fast 2× (rounded up). Above
+ * `options.maxGasPrice` an endpoint's price decides nothing (retryable), and no fee is ever
+ * above `options.maxFee`. The weights only change with network upgrades: they are read under
+ * the proof quorum and kept for ten minutes.
+ */
+const error_1 = require("../../core/errors/error");
+const fee_1 = require("../../core/model/fee");
+const codec_1 = require("./codec");
+const context_1 = require("./context");
+/** Each speed's margin over the endpoint's gas price, in basis points. */
+exports.SPEED_MARGIN_BPS = Object.freeze({
+    slow: 11000n,
+    normal: 15000n,
+    fast: 20000n,
+});
+const WEIGHTS_TTL_MS = 600_000;
+const override = (message) => new error_1.ValidationError('INVALID_INTENT', message);
+/** A gas price from `{ gasPrice }`: a bigint or a decimal integer string, nAVAX per gas. */
+function gasPriceOf(fee) {
+    const keys = Object.keys(fee);
+    if (keys.length !== 1 || keys[0] !== 'gasPrice') {
+        throw override('a P-Chain fee is a speed or { gasPrice } (nAVAX per unit of gas)');
+    }
+    const value = fee.gasPrice;
+    if (typeof value === 'bigint')
+        return value;
+    if (typeof value === 'string' && /^[1-9][0-9]{0,18}$/.test(value))
+        return BigInt(value);
+    throw override('gasPrice must be a positive integer (bigint or decimal string)');
+}
+async function feeConfigOf(ctx, cache, signal) {
+    const now = ctx.clock.now();
+    if (cache.value && cache.until !== undefined && now < cache.until)
+        return cache.value;
+    const value = await ctx.node.feeConfig({
+        ...(0, context_1.withSignal)(context_1.READ, signal),
+        quorum: 'proof',
+    });
+    cache.value = value;
+    cache.until = now + WEIGHTS_TTL_MS;
+    return value;
+}
+/** The fee plan of `fee` on this chain, from the endpoints' current fee data. */
+async function feePlanOf(ctx, fee, cache, signal) {
+    const { config, node } = ctx;
+    if (config.vm === 'avm') {
+        if (!(0, fee_1.isFeeSpeed)(fee)) {
+            throw override("the X-Chain fee is fixed; use 'slow', 'normal' or 'fast'");
+        }
+        const txFee = await node.txFee({ ...(0, context_1.withSignal)(context_1.READ, signal), quorum: 'proof' });
+        (0, codec_1.assertSaneFee)(txFee, config);
+        return { model: 'static', txFee };
+    }
+    if (!(0, fee_1.isFeeSpeed)(fee) && (fee === null || typeof fee !== 'object')) {
+        throw override('fee must be a speed or { gasPrice }');
+    }
+    const [state, { weights, minPrice }] = await Promise.all([
+        node.feeState((0, context_1.withSignal)(context_1.READ, signal)),
+        feeConfigOf(ctx, cache, signal),
+    ]);
+    if (state.price < 1n || state.price > config.maxGasPrice) {
+        throw (0, context_1.undecided)("the endpoint's P-Chain gas price is outside 1..options.maxGasPrice");
+    }
+    let price;
+    if ((0, fee_1.isFeeSpeed)(fee)) {
+        const margin = exports.SPEED_MARGIN_BPS[fee];
+        price = (state.price * margin + 9999n) / 10000n;
+    }
+    else {
+        price = gasPriceOf(fee);
+        if (price < minPrice || price < 1n) {
+            throw override("gasPrice is below the P-Chain's minimum gas price");
+        }
+    }
+    if (price > config.maxGasPrice) {
+        throw override('the gas price exceeds the configured maximum (options.maxGasPrice)');
+    }
+    return { model: 'dynamic', price, state, weights };
+}
+/**
+ * The fee plan a stored estimate fixed (`details`), checked: it is our own plain data,
+ * read back from the caller's store, which keeps only plain values (`bigint` included).
+ */
+function storedPlan(details, model) {
+    if (details.model !== model) {
+        throw override('the fee is not an estimate of this chain');
+    }
+    const value = model === 'static' ? details.txFee : details.gasPrice;
+    if (typeof value !== 'bigint' || value < (model === 'static' ? 0n : 1n)) {
+        throw override('the fee is not an estimate of this chain');
+    }
+    return model === 'static' ? { txFee: value } : { gasPrice: value };
+}
+//# sourceMappingURL=fees.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/fees.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Fee plans. The X-Chain burns a fixed fee per transaction (`txFee`, 0.001 AVAX\n * on mainnet and Fuji), read under the proof quorum so one endpoint cannot raise it, and\n * every speed pays it. Since Etna the P-Chain prices gas: a transaction's fee is its gas\n * (complexity weighed by the network's weights) times the gas price. The price an endpoint\n * reports moves with load (it can double in about 30 s at full load), so a speed pays it\n * times a margin, library policy: slow 1.1×, normal 1.5×, fast 2× (rounded up). Above\n * `options.maxGasPrice` an endpoint's price decides nothing (retryable), and no fee is ever\n * above `options.maxFee`. The weights only change with network upgrades: they are read under\n * the proof quorum and kept for ten minutes.\n */\nimport { ValidationError } from '../../core/errors/error';\nimport { isFeeSpeed, type FeeOverride, type FeeSpeed } from '../../core/model/fee';\nimport type { FeeWeights } from './api';\nimport { assertSaneFee, type FeePlan } from './codec';\nimport { READ, undecided, withSignal, type AvalancheContext } from './context';\n\n/** Each speed's margin over the endpoint's gas price, in basis points. */\nexport const SPEED_MARGIN_BPS: Readonly<Record<FeeSpeed, bigint>> = Object.freeze({\n  slow: 11_000n,\n  normal: 15_000n,\n  fast: 20_000n,\n});\n\nconst WEIGHTS_TTL_MS = 600_000;\n\nexport interface FeeConfigCache {\n  value?: { readonly weights: FeeWeights; readonly minPrice: bigint };\n  until?: number;\n}\n\nconst override = (message: string): ValidationError =>\n  new ValidationError('INVALID_INTENT', message);\n\n/** A gas price from `{ gasPrice }`: a bigint or a decimal integer string, nAVAX per gas. */\nfunction gasPriceOf(fee: FeeOverride): bigint {\n  const keys = Object.keys(fee);\n  if (keys.length !== 1 || keys[0] !== 'gasPrice') {\n    throw override('a P-Chain fee is a speed or { gasPrice } (nAVAX per unit of gas)');\n  }\n  const value = fee.gasPrice;\n  if (typeof value === 'bigint') return value;\n  if (typeof value === 'string' && /^[1-9][0-9]{0,18}$/.test(value)) return BigInt(value);\n  throw override('gasPrice must be a positive integer (bigint or decimal string)');\n}\n\nasync function feeConfigOf(\n  ctx: AvalancheContext,\n  cache: FeeConfigCache,\n  signal?: AbortSignal,\n): Promise<{ readonly weights: FeeWeights; readonly minPrice: bigint }> {\n  const now = ctx.clock.now();\n  if (cache.value && cache.until !== undefined && now < cache.until) return cache.value;\n  const value = await ctx.node.feeConfig({\n    ...withSignal(READ, signal),\n    quorum: 'proof',\n  });\n  cache.value = value;\n  cache.until = now + WEIGHTS_TTL_MS;\n  return value;\n}\n\n/** The fee plan of `fee` on this chain, from the endpoints' current fee data. */\nexport async function feePlanOf(\n  ctx: AvalancheContext,\n  fee: FeeSpeed | FeeOverride,\n  cache: FeeConfigCache,\n  signal?: AbortSignal,\n): Promise<FeePlan> {\n  const { config, node } = ctx;\n  if (config.vm === 'avm') {\n    if (!isFeeSpeed(fee)) {\n      throw override(\"the X-Chain fee is fixed; use 'slow', 'normal' or 'fast'\");\n    }\n    const txFee = await node.txFee({ ...withSignal(READ, signal), quorum: 'proof' });\n    assertSaneFee(txFee, config);\n    return { model: 'static', txFee };\n  }\n  if (!isFeeSpeed(fee) && (fee === null || typeof fee !== 'object')) {\n    throw override('fee must be a speed or { gasPrice }');\n  }\n  const [state, { weights, minPrice }] = await Promise.all([\n    node.feeState(withSignal(READ, signal)),\n    feeConfigOf(ctx, cache, signal),\n  ]);\n  if (state.price < 1n || state.price > config.maxGasPrice) {\n    throw undecided(\"the endpoint's P-Chain gas price is outside 1..options.maxGasPrice\");\n  }\n  let price: bigint;\n  if (isFeeSpeed(fee)) {\n    const margin = SPEED_MARGIN_BPS[fee];\n    price = (state.price * margin + 9_999n) / 10_000n;\n  } else {\n    price = gasPriceOf(fee);\n    if (price < minPrice || price < 1n) {\n      throw override(\"gasPrice is below the P-Chain's minimum gas price\");\n    }\n  }\n  if (price > config.maxGasPrice) {\n    throw override('the gas price exceeds the configured maximum (options.maxGasPrice)');\n  }\n  return { model: 'dynamic', price, state, weights };\n}\n\n/**\n * The fee plan a stored estimate fixed (`details`), checked: it is our own plain data,\n * read back from the caller's store, which keeps only plain values (`bigint` included).\n */\nexport function storedPlan(\n  details: Readonly<Record<string, unknown>>,\n  model: 'static' | 'dynamic',\n): { readonly txFee?: bigint; readonly gasPrice?: bigint } {\n  if (details.model !== model) {\n    throw override('the fee is not an estimate of this chain');\n  }\n  const value = model === 'static' ? details.txFee : details.gasPrice;\n  if (typeof value !== 'bigint' || value < (model === 'static' ? 0n : 1n)) {\n    throw override('the fee is not an estimate of this chain');\n  }\n  return model === 'static' ? { txFee: value } : { gasPrice: value };\n}\n"]}