crypto-aio 0.0.3 → 0.2.0

package/dist/adapters/evm/ethers-client.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ethersDriverFactory = exports.EthersClient = exports.TransportJsonRpcProvider = void 0;
+/**
+ * `EthersClient`: the ethers v6 strategy (the EVM default). Driver I/O goes straight to the
+ * core transport under each call's tags, never through ethers' provider: ethers' request
+ * queue drains on a real 0 ms timer that fake-clock tests cannot step deterministically,
+ * and the driver needs none of it (one request per call). ethers does the codec work, and
+ * `TransportJsonRpcProvider` (static network, no batching, no cache, no polling, `_send` →
+ * transport) is the `crypto-aio/native` client.
+ */
+const ethers_1 = require("ethers");
+const client_1 = require("./client");
+const driver_1 = require("./driver");
+const rpc_1 = require("./rpc");
+/**
+ * The ethers provider bridged onto the core transport through `call`: the native client
+ * only.
+ */
+class TransportJsonRpcProvider extends ethers_1.JsonRpcApiProvider {
+    #call;
+    constructor(network, call) {
+        super(network, { staticNetwork: network, batchMaxCount: 1, cacheTimeout: -1 });
+        this.#call = call;
+        this._start();
+    }
+    async _send(payload) {
+        const results = [];
+        for (const item of Array.isArray(payload) ? payload : [payload]) {
+            results.push({ id: item.id, result: await this.#call(item.method, item.params) });
+        }
+        return results;
+    }
+}
+exports.TransportJsonRpcProvider = TransportJsonRpcProvider;
+const coder = ethers_1.AbiCoder.defaultAbiCoder();
+const erc20 = new ethers_1.Interface([
+    'function transfer(address to, uint256 amount)',
+    'function balanceOf(address owner) view returns (uint256)',
+    'function decimals() view returns (uint8)',
+    'function symbol() view returns (string)',
+    'function deprecated() view returns (bool)',
+    'event Transfer(address indexed from, address indexed to, uint256 amount)',
+]);
+const gasPriceOracle = new ethers_1.Interface([
+    'function getL1Fee(bytes data) view returns (uint256)',
+    'function getOperatorFee(uint256 gasUsed) view returns (uint256)',
+]);
+const TRANSFER_TOPIC = erc20.getEvent('Transfer')?.topicHash;
+const ethersAbi = {
+    transferTopic: TRANSFER_TOPIC,
+    encodeTransfer: (to, amount) => erc20.encodeFunctionData('transfer', [to, amount]),
+    encodeBalanceOf: (owner) => erc20.encodeFunctionData('balanceOf', [owner]),
+    encodeDecimals: () => erc20.encodeFunctionData('decimals', []),
+    encodeSymbol: () => erc20.encodeFunctionData('symbol', []),
+    encodeDeprecated: () => erc20.encodeFunctionData('deprecated', []),
+    encodeGetL1Fee: (unsignedTx) => gasPriceOracle.encodeFunctionData('getL1Fee', [unsignedTx]),
+    encodeGetOperatorFee: (gasUsed) => gasPriceOracle.encodeFunctionData('getOperatorFee', [gasUsed]),
+    decodeUint256: (data) => {
+        if (!client_1.ABI_WORD.test(data))
+            throw new Error('not one ABI word');
+        return coder.decode(['uint256'], data)[0];
+    },
+    decodeString: (data) => coder.decode(['string'], data)[0],
+    decodeTransfer: (log) => {
+        const words = (0, client_1.transferLogWords)(log, TRANSFER_TOPIC);
+        if (!words)
+            return null;
+        return {
+            from: (0, ethers_1.getAddress)(coder.decode(['address'], words.from)[0]),
+            to: (0, ethers_1.getAddress)(coder.decode(['address'], words.to)[0]),
+            amount: coder.decode(['uint256'], words.data)[0],
+        };
+    },
+};
+function toEthers(tx, signature) {
+    const common = {
+        chainId: tx.chainId,
+        nonce: Number(tx.nonce),
+        to: tx.to,
+        value: tx.value,
+        data: tx.data,
+        gasLimit: tx.gasLimit,
+    };
+    const built = ethers_1.Transaction.from(tx.type === 'eip1559'
+        ? {
+            ...common,
+            type: 2,
+            maxFeePerGas: tx.maxFeePerGas,
+            maxPriorityFeePerGas: tx.maxPriorityFeePerGas,
+        }
+        : { ...common, type: 0, gasPrice: tx.gasPrice });
+    if (signature)
+        built.signature = ethers_1.Signature.from(signature);
+    return built;
+}
+class EthersClient extends client_1.EvmClientBase {
+    library = 'ethers';
+    abi = ethersAbi;
+    #transport;
+    #network;
+    constructor(transport, chainId) {
+        super(chainId);
+        this.#transport = transport;
+        // A plain network: ethers' known networks carry plugins (ENS, gas stations) we never use.
+        this.#network = new ethers_1.Network('crypto-aio', chainId);
+    }
+    send(method, params, tags) {
+        // No SDK queue, and so no real timer, between a driver call and the transport.
+        return (0, rpc_1.transportCall)(this.#transport, method, [...params], tags);
+    }
+    isAddress(value) {
+        return client_1.ADDRESS.test(value) && (0, ethers_1.isAddress)(value);
+    }
+    checksum(address) {
+        return this.checked(address, ethers_1.getAddress);
+    }
+    addressFromPublicKey(publicKey) {
+        return (0, ethers_1.computeAddress)((0, ethers_1.hexlify)((0, client_1.uncompressedPublicKey)(publicKey)));
+    }
+    encodeUnsigned(tx) {
+        return toEthers(tx).unsignedSerialized;
+    }
+    hashUnsigned(tx) {
+        return toEthers(tx).unsignedHash;
+    }
+    encodeSigned(tx, signature) {
+        const signed = toEthers(tx, signature);
+        return { raw: signed.serialized, hash: signed.hash };
+    }
+    createNative() {
+        const client = new TransportJsonRpcProvider(this.#network, (method, params) => (0, rpc_1.transportCall)(this.#transport, method, params, (0, rpc_1.nativeTags)(method)));
+        return { client, close: () => client.destroy() };
+    }
+}
+exports.EthersClient = EthersClient;
+/** The `ethers` adapter's driver factory; the manifest's `load()` returns it. */
+exports.ethersDriverFactory = (0, driver_1.evmDriverFactory)((transport, chainId) => new EthersClient(transport, chainId));
+//# sourceMappingURL=ethers-client.js.map

package/dist/adapters/evm/ethers-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethers-client.js","sourceRoot":"","sources":["../../../src/adapters/evm/ethers-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `EthersClient`: the ethers v6 strategy (the EVM default). Driver I/O goes straight to the\n * core transport under each call's tags, never through ethers' provider: ethers' request\n * queue drains on a real 0 ms timer that fake-clock tests cannot step deterministically,\n * and the driver needs none of it (one request per call). ethers does the codec work, and\n * `TransportJsonRpcProvider` (static network, no batching, no cache, no polling, `_send` →\n * transport) is the `crypto-aio/native` client.\n */\nimport {\n  AbiCoder,\n  Interface,\n  JsonRpcApiProvider,\n  Network,\n  Signature,\n  Transaction,\n  computeAddress,\n  getAddress,\n  hexlify,\n  isAddress,\n  type JsonRpcPayload,\n  type JsonRpcResult,\n} from 'ethers';\nimport type { DisposableNativeClient } from '../../core/driver/types';\nimport type { Transport } from '../../core/transport/types';\nimport {\n  ABI_WORD,\n  ADDRESS,\n  EvmClientBase,\n  transferLogWords,\n  uncompressedPublicKey,\n} from './client';\nimport { evmDriverFactory } from './driver';\nimport { nativeTags, transportCall } from './rpc';\nimport type { EvmAbi, EvmCallTags, EvmSignature, EvmTxFields } from './types';\n\ntype Call = (method: string, params: unknown) => Promise<unknown>;\n\n/**\n * The ethers provider bridged onto the core transport through `call`: the native client\n * only.\n */\nexport class TransportJsonRpcProvider extends JsonRpcApiProvider {\n  readonly #call: Call;\n\n  constructor(network: Network, call: Call) {\n    super(network, { staticNetwork: network, batchMaxCount: 1, cacheTimeout: -1 });\n    this.#call = call;\n    this._start();\n  }\n\n  override async _send(\n    payload: JsonRpcPayload | JsonRpcPayload[],\n  ): Promise<JsonRpcResult[]> {\n    const results: JsonRpcResult[] = [];\n    for (const item of Array.isArray(payload) ? payload : [payload]) {\n      results.push({ id: item.id, result: await this.#call(item.method, item.params) });\n    }\n    return results;\n  }\n}\n\nconst coder = AbiCoder.defaultAbiCoder();\nconst erc20 = new Interface([\n  'function transfer(address to, uint256 amount)',\n  'function balanceOf(address owner) view returns (uint256)',\n  'function decimals() view returns (uint8)',\n  'function symbol() view returns (string)',\n  'function deprecated() view returns (bool)',\n  'event Transfer(address indexed from, address indexed to, uint256 amount)',\n]);\nconst gasPriceOracle = new Interface([\n  'function getL1Fee(bytes data) view returns (uint256)',\n  'function getOperatorFee(uint256 gasUsed) view returns (uint256)',\n]);\nconst TRANSFER_TOPIC = erc20.getEvent('Transfer')?.topicHash as string;\n\nconst ethersAbi: EvmAbi = {\n  transferTopic: TRANSFER_TOPIC,\n  encodeTransfer: (to, amount) => erc20.encodeFunctionData('transfer', [to, amount]),\n  encodeBalanceOf: (owner) => erc20.encodeFunctionData('balanceOf', [owner]),\n  encodeDecimals: () => erc20.encodeFunctionData('decimals', []),\n  encodeSymbol: () => erc20.encodeFunctionData('symbol', []),\n  encodeDeprecated: () => erc20.encodeFunctionData('deprecated', []),\n  encodeGetL1Fee: (unsignedTx) =>\n    gasPriceOracle.encodeFunctionData('getL1Fee', [unsignedTx]),\n  encodeGetOperatorFee: (gasUsed) =>\n    gasPriceOracle.encodeFunctionData('getOperatorFee', [gasUsed]),\n  decodeUint256: (data) => {\n    if (!ABI_WORD.test(data)) throw new Error('not one ABI word');\n    return coder.decode(['uint256'], data)[0] as bigint;\n  },\n  decodeString: (data) => coder.decode(['string'], data)[0] as string,\n  decodeTransfer: (log) => {\n    const words = transferLogWords(log, TRANSFER_TOPIC);\n    if (!words) return null;\n    return {\n      from: getAddress(coder.decode(['address'], words.from)[0] as string),\n      to: getAddress(coder.decode(['address'], words.to)[0] as string),\n      amount: coder.decode(['uint256'], words.data)[0] as bigint,\n    };\n  },\n};\n\nfunction toEthers(tx: EvmTxFields, signature?: EvmSignature): Transaction {\n  const common = {\n    chainId: tx.chainId,\n    nonce: Number(tx.nonce),\n    to: tx.to,\n    value: tx.value,\n    data: tx.data,\n    gasLimit: tx.gasLimit,\n  };\n  const built = Transaction.from(\n    tx.type === 'eip1559'\n      ? {\n          ...common,\n          type: 2,\n          maxFeePerGas: tx.maxFeePerGas,\n          maxPriorityFeePerGas: tx.maxPriorityFeePerGas,\n        }\n      : { ...common, type: 0, gasPrice: tx.gasPrice },\n  );\n  if (signature) built.signature = Signature.from(signature);\n  return built;\n}\n\nexport class EthersClient extends EvmClientBase {\n  readonly library = 'ethers';\n  readonly abi = ethersAbi;\n  readonly #transport: Transport;\n  readonly #network: Network;\n\n  constructor(transport: Transport, chainId: bigint) {\n    super(chainId);\n    this.#transport = transport;\n    // A plain network: ethers' known networks carry plugins (ENS, gas stations) we never use.\n    this.#network = new Network('crypto-aio', chainId);\n  }\n\n  protected send(\n    method: string,\n    params: readonly unknown[],\n    tags: EvmCallTags,\n  ): Promise<unknown> {\n    // No SDK queue, and so no real timer, between a driver call and the transport.\n    return transportCall(this.#transport, method, [...params], tags);\n  }\n\n  isAddress(value: string): boolean {\n    return ADDRESS.test(value) && isAddress(value);\n  }\n\n  checksum(address: string): string {\n    return this.checked(address, getAddress);\n  }\n\n  addressFromPublicKey(publicKey: Uint8Array): string {\n    return computeAddress(hexlify(uncompressedPublicKey(publicKey)));\n  }\n\n  protected encodeUnsigned(tx: EvmTxFields): string {\n    return toEthers(tx).unsignedSerialized;\n  }\n\n  protected hashUnsigned(tx: EvmTxFields): string {\n    return toEthers(tx).unsignedHash;\n  }\n\n  protected encodeSigned(\n    tx: EvmTxFields,\n    signature: EvmSignature,\n  ): { raw: string; hash: string } {\n    const signed = toEthers(tx, signature);\n    return { raw: signed.serialized, hash: signed.hash as string };\n  }\n\n  createNative(): DisposableNativeClient {\n    const client = new TransportJsonRpcProvider(this.#network, (method, params) =>\n      transportCall(this.#transport, method, params, nativeTags(method)),\n    );\n    return { client, close: () => client.destroy() };\n  }\n}\n\n/** The `ethers` adapter's driver factory; the manifest's `load()` returns it. */\nexport const ethersDriverFactory = evmDriverFactory(\n  (transport, chainId) => new EthersClient(transport, chainId),\n);\n"]}

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

@@ -0,0 +1,103 @@
+import type { FeeEstimateDraft, FeeOverride, FeeSpeed } from '../../core/model/fee';
+import type { EvmFeeHistory } from './types';
+export type EvmFeeModel = 'evm-1559' | 'evm-legacy';
+/** The per-gas prices of one transaction. */
+export type EvmFeeParams = {
+    readonly type: 'eip1559';
+    readonly maxFeePerGas: bigint;
+    readonly maxPriorityFeePerGas: bigint;
+} | {
+    readonly type: 'legacy';
+    readonly gasPrice: bigint;
+};
+/**
+ * `eth_feeHistory` window and priority-fee percentiles for slow, normal and fast: the
+ * method the Polygon Gas Station documents (10th, 25th and 50th over the last 15 blocks).
+ */
+export declare const FEE_HISTORY_BLOCKS = 15;
+export declare const FEE_PERCENTILES: readonly number[];
+/** A plain transfer to an account without code costs exactly this much gas. */
+export declare const TRANSFER_GAS = 21000n;
+/** The lower median; `0n` for no values. */
+export declare function median(values: readonly bigint[]): bigint;
+/**
+ * EIP-1559 prices for `speed`: the tip is the median, over the window, of the speed's
+ * percentile (at least `minTip`); the cap allows the next base fee to double. The history
+ * must answer a request for `FEE_PERCENTILES`: one without the next base fee, without
+ * reward rows, or with a reward row shorter than `FEE_PERCENTILES` is a retryable
+ * `PROVIDER_UNAVAILABLE`, never a tip of `minTip`.
+ */
+export declare function feesFromHistory(history: EvmFeeHistory, speed: FeeSpeed, minTip: bigint): {
+    readonly params: EvmFeeParams;
+    readonly baseFeePerGas: bigint;
+};
+export declare function legacyPrice(gasPrice: bigint, speed: FeeSpeed): EvmFeeParams;
+/** The node's estimate, with headroom unless it is a plain transfer. */
+export declare function gasLimitFrom(estimate: bigint): bigint;
+/**
+ * The default `maxFeePerGas`, the highest price per gas an EVM transaction signs, 1,000
+ * gwei. It bounds a plain transfer at 0.021 and a 65,000-gas token transfer at 0.065 of
+ * the native coin, however an endpoint prices the fee. A network whose base fee rises
+ * above the ceiling stalls its transfers as `FEE_TOO_LOW` until the fee falls or the
+ * option is raised.
+ */
+export declare const DEFAULT_MAX_FEE_PER_GAS = 1000000000000n;
+/** The highest price per gas `params` may pay: the fee cap, or the legacy gas price. */
+export declare function priceCap(params: EvmFeeParams): bigint;
+/**
+ * A node's suggestion within the ceiling: the fee cap or gas price at most `ceiling`,
+ * and the tip at most the fee cap. No endpoint can raise what a transfer signs.
+ */
+export declare function capPrice(params: EvmFeeParams, ceiling: bigint): EvmFeeParams;
+/**
+ * Refuses, before anything is signed, a fee whose price per gas is above `ceiling` (the
+ * handle's `maxFeePerGas`), whatever produced it: an explicit override, a stored fee, or a
+ * cancel's least bump. The details carry the price and the bound as decimal strings.
+ */
+export declare function assertWithinCeiling(params: EvmFeeParams, ceiling: bigint): void;
+/**
+ * The default `maxGasLimit`, the highest gas limit an EVM transaction signs: 16,777,216
+ * (2^24), the per-transaction cap Ethereum enforces since Fusaka (EIP-7825), so no
+ * transaction above it is included there. A transfer this driver builds needs a small
+ * fraction of it (21,000 gas for a plain transfer, tens of thousands for a token's); an
+ * Arbitrum estimate also counts the L1 data fee in L2 gas, so it grows with L1 prices.
+ * Like `DEFAULT_MAX_FEE_PER_GAS`, it stops an absurd gas limit, from an endpoint's
+ * estimate or an override, not an expensive one: set the option to your own policy.
+ */
+export declare const DEFAULT_MAX_GAS_LIMIT = 16777216n;
+/**
+ * Refuses, before anything is signed, a gas limit above `bound` (the handle's
+ * `maxGasLimit`), whatever produced it: the node's estimate with its headroom, an
+ * override's `gasLimit`, a stored fee, or a replacement that keeps its original's. It is
+ * never clamped: a lower limit than the call needs runs out of gas and still pays. The
+ * details carry the gas limit and the bound as decimal strings.
+ */
+export declare function assertWithinGasLimit(gasLimit: bigint, bound: bigint): void;
+/** Validates an `EvmFeeOverride` against the network's fee model. */
+export declare function parseFeeOverride(override: FeeOverride, model: EvmFeeModel): {
+    readonly params: EvmFeeParams;
+    readonly gasLimit?: bigint;
+};
+/** The fee draft for a transaction of `gasLimit` at `params`. */
+export declare function feeDraft(speed: FeeSpeed | 'custom', gasLimit: bigint, params: EvmFeeParams, extra?: {
+    readonly baseFeePerGas?: bigint;
+    readonly l1Fee?: bigint;
+    readonly operatorFee?: bigint;
+}): FeeEstimateDraft;
+/** The gas limit and prices a fee draft's details hold. */
+export declare function feeOf(details: Readonly<Record<string, unknown>>): {
+    readonly gasLimit: bigint;
+    readonly params: EvmFeeParams;
+};
+/**
+ * Orders two fee settings by what a txpool compares on replacement: the fee cap (or gas
+ * price), then the tip. A legacy gas price is compared as a fee cap and tip alike.
+ */
+export declare function comparePrices(a: EvmFeeParams, b: EvmFeeParams): number;
+/**
+ * Whether `next` may replace `previous` under a txpool's `percent` price bump: each price
+ * strictly higher, and at least `percent` higher (geth), so a zero tip must still rise.
+ */
+export declare function meetsBump(previous: EvmFeeParams, next: EvmFeeParams, percent: number): boolean;
+/** The smallest prices that meet the bump over `previous`: each strictly higher (geth). */
+export declare function minimumBump(previous: EvmFeeParams, percent: number): EvmFeeParams;

package/dist/adapters/evm/fees.js

@@ -0,0 +1,277 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_GAS_LIMIT = exports.DEFAULT_MAX_FEE_PER_GAS = exports.TRANSFER_GAS = exports.FEE_PERCENTILES = exports.FEE_HISTORY_BLOCKS = void 0;
+exports.median = median;
+exports.feesFromHistory = feesFromHistory;
+exports.legacyPrice = legacyPrice;
+exports.gasLimitFrom = gasLimitFrom;
+exports.priceCap = priceCap;
+exports.capPrice = capPrice;
+exports.assertWithinCeiling = assertWithinCeiling;
+exports.assertWithinGasLimit = assertWithinGasLimit;
+exports.parseFeeOverride = parseFeeOverride;
+exports.feeDraft = feeDraft;
+exports.feeOf = feeOf;
+exports.comparePrices = comparePrices;
+exports.meetsBump = meetsBump;
+exports.minimumBump = minimumBump;
+/**
+ * The EVM fee policy: `evm-1559` or `evm-legacy` per network, an `upper`
+ * bound with the `expected` cost in the details, overrides, and replacement bumps. Pure
+ * functions over plain data; the driver does the I/O.
+ */
+const error_1 = require("../../core/errors/error");
+/**
+ * `eth_feeHistory` window and priority-fee percentiles for slow, normal and fast: the
+ * method the Polygon Gas Station documents (10th, 25th and 50th over the last 15 blocks).
+ */
+exports.FEE_HISTORY_BLOCKS = 15;
+exports.FEE_PERCENTILES = [10, 25, 50];
+const SPEED_INDEX = { slow: 0, normal: 1, fast: 2 };
+/** Legacy networks: `eth_gasPrice` scaled per speed, in percent. */
+const LEGACY_PERCENT = {
+    slow: 100n,
+    normal: 110n,
+    fast: 125n,
+};
+/** A plain transfer to an account without code costs exactly this much gas. */
+exports.TRANSFER_GAS = 21000n;
+/** Headroom over the node's estimate for anything but a plain transfer, in percent. */
+const GAS_HEADROOM_PERCENT = 120n;
+const ceilDiv = (a, b) => (a + b - 1n) / b;
+const max = (a, b) => (a > b ? a : b);
+const min = (a, b) => (a < b ? a : b);
+/** The lower median; `0n` for no values. */
+function median(values) {
+    if (values.length === 0)
+        return 0n;
+    const sorted = [...values].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    return sorted[Math.floor((sorted.length - 1) / 2)];
+}
+const malformedHistory = () => new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'malformed fee history');
+/**
+ * EIP-1559 prices for `speed`: the tip is the median, over the window, of the speed's
+ * percentile (at least `minTip`); the cap allows the next base fee to double. The history
+ * must answer a request for `FEE_PERCENTILES`: one without the next base fee, without
+ * reward rows, or with a reward row shorter than `FEE_PERCENTILES` is a retryable
+ * `PROVIDER_UNAVAILABLE`, never a tip of `minTip`.
+ */
+function feesFromHistory(history, speed, minTip) {
+    const baseFeePerGas = history.baseFeePerGas[history.baseFeePerGas.length - 1];
+    if (baseFeePerGas === undefined || history.reward.length === 0) {
+        throw malformedHistory();
+    }
+    const index = SPEED_INDEX[speed];
+    const tips = history.reward.map((row) => {
+        const tip = row[index];
+        if (row.length < exports.FEE_PERCENTILES.length || tip === undefined)
+            throw malformedHistory();
+        return tip;
+    });
+    const tip = max(median(tips), minTip);
+    return {
+        params: {
+            type: 'eip1559',
+            maxFeePerGas: 2n * baseFeePerGas + tip,
+            maxPriorityFeePerGas: tip,
+        },
+        baseFeePerGas,
+    };
+}
+function legacyPrice(gasPrice, speed) {
+    return { type: 'legacy', gasPrice: ceilDiv(gasPrice * LEGACY_PERCENT[speed], 100n) };
+}
+/** The node's estimate, with headroom unless it is a plain transfer. */
+function gasLimitFrom(estimate) {
+    return estimate === exports.TRANSFER_GAS
+        ? exports.TRANSFER_GAS
+        : ceilDiv(estimate * GAS_HEADROOM_PERCENT, 100n);
+}
+const invalid = (reason) => new error_1.ValidationError('INVALID_INTENT', reason);
+/**
+ * The default `maxFeePerGas`, the highest price per gas an EVM transaction signs, 1,000
+ * gwei. It bounds a plain transfer at 0.021 and a 65,000-gas token transfer at 0.065 of
+ * the native coin, however an endpoint prices the fee. A network whose base fee rises
+ * above the ceiling stalls its transfers as `FEE_TOO_LOW` until the fee falls or the
+ * option is raised.
+ */
+exports.DEFAULT_MAX_FEE_PER_GAS = 1000000000000n;
+/** The highest price per gas `params` may pay: the fee cap, or the legacy gas price. */
+function priceCap(params) {
+    return params.type === 'eip1559' ? params.maxFeePerGas : params.gasPrice;
+}
+/**
+ * A node's suggestion within the ceiling: the fee cap or gas price at most `ceiling`,
+ * and the tip at most the fee cap. No endpoint can raise what a transfer signs.
+ */
+function capPrice(params, ceiling) {
+    if (params.type === 'legacy')
+        return { type: 'legacy', gasPrice: min(params.gasPrice, ceiling) };
+    const maxFeePerGas = min(params.maxFeePerGas, ceiling);
+    return {
+        type: 'eip1559',
+        maxFeePerGas,
+        maxPriorityFeePerGas: min(params.maxPriorityFeePerGas, maxFeePerGas),
+    };
+}
+/**
+ * Refuses, before anything is signed, a fee whose price per gas is above `ceiling` (the
+ * handle's `maxFeePerGas`), whatever produced it: an explicit override, a stored fee, or a
+ * cancel's least bump. The details carry the price and the bound as decimal strings.
+ */
+function assertWithinCeiling(params, ceiling) {
+    const price = priceCap(params);
+    if (price <= ceiling)
+        return;
+    throw new error_1.ValidationError('INVALID_INTENT', 'the fee is above maxFeePerGas, the EVM handle option that bounds it (wei per gas)', { details: { required: price.toString(), maxFeePerGas: ceiling.toString() } });
+}
+/**
+ * The default `maxGasLimit`, the highest gas limit an EVM transaction signs: 16,777,216
+ * (2^24), the per-transaction cap Ethereum enforces since Fusaka (EIP-7825), so no
+ * transaction above it is included there. A transfer this driver builds needs a small
+ * fraction of it (21,000 gas for a plain transfer, tens of thousands for a token's); an
+ * Arbitrum estimate also counts the L1 data fee in L2 gas, so it grows with L1 prices.
+ * Like `DEFAULT_MAX_FEE_PER_GAS`, it stops an absurd gas limit, from an endpoint's
+ * estimate or an override, not an expensive one: set the option to your own policy.
+ */
+exports.DEFAULT_MAX_GAS_LIMIT = 16777216n;
+/**
+ * Refuses, before anything is signed, a gas limit above `bound` (the handle's
+ * `maxGasLimit`), whatever produced it: the node's estimate with its headroom, an
+ * override's `gasLimit`, a stored fee, or a replacement that keeps its original's. It is
+ * never clamped: a lower limit than the call needs runs out of gas and still pays. The
+ * details carry the gas limit and the bound as decimal strings.
+ */
+function assertWithinGasLimit(gasLimit, bound) {
+    if (gasLimit <= bound)
+        return;
+    throw new error_1.ValidationError('INVALID_INTENT', 'the gas limit is above maxGasLimit, the EVM handle option that bounds it (gas)', { details: { required: gasLimit.toString(), maxGasLimit: bound.toString() } });
+}
+/** Validates an `EvmFeeOverride` against the network's fee model. */
+function parseFeeOverride(override, model) {
+    const allowed = model === 'evm-1559'
+        ? ['maxFeePerGas', 'maxPriorityFeePerGas', 'gasLimit']
+        : ['gasPrice', 'gasLimit'];
+    const shape = model === 'evm-1559'
+        ? '{ maxFeePerGas, maxPriorityFeePerGas, gasLimit? }'
+        : '{ gasPrice, gasLimit? }';
+    const keys = Object.keys(override);
+    if (keys.some((key) => !allowed.includes(key))) {
+        throw invalid(`${model} fee overrides look like ${shape}`);
+    }
+    const amount = (key, min) => {
+        const value = override[key];
+        if (typeof value !== 'bigint' || value < min) {
+            throw invalid(`fee override '${key}' must be a bigint of at least ${min}`);
+        }
+        return value;
+    };
+    const gasLimit = override.gasLimit === undefined ? undefined : amount('gasLimit', exports.TRANSFER_GAS);
+    const limit = gasLimit !== undefined ? { gasLimit } : {};
+    if (model === 'evm-legacy') {
+        return { params: { type: 'legacy', gasPrice: amount('gasPrice', 1n) }, ...limit };
+    }
+    const maxFeePerGas = amount('maxFeePerGas', 1n);
+    const maxPriorityFeePerGas = amount('maxPriorityFeePerGas', 0n);
+    if (maxPriorityFeePerGas > maxFeePerGas) {
+        throw invalid('maxPriorityFeePerGas must not exceed maxFeePerGas');
+    }
+    return { params: { type: 'eip1559', maxFeePerGas, maxPriorityFeePerGas }, ...limit };
+}
+/** The fee draft for a transaction of `gasLimit` at `params`. */
+function feeDraft(speed, gasLimit, params, extra = {}) {
+    const cap = params.type === 'eip1559' ? params.maxFeePerGas : params.gasPrice;
+    const expectedPrice = params.type === 'eip1559' && extra.baseFeePerGas !== undefined
+        ? min(params.maxFeePerGas, extra.baseFeePerGas + params.maxPriorityFeePerGas)
+        : cap;
+    // `satisfies` checks the shape and keeps a literal type the draft's record accepts.
+    const details = {
+        gasLimit,
+        ...(params.type === 'eip1559'
+            ? {
+                maxFeePerGas: params.maxFeePerGas,
+                maxPriorityFeePerGas: params.maxPriorityFeePerGas,
+                ...(extra.baseFeePerGas !== undefined
+                    ? { baseFeePerGas: extra.baseFeePerGas }
+                    : {}),
+            }
+            : { gasPrice: params.gasPrice }),
+        ...(extra.l1Fee !== undefined ? { l1Fee: extra.l1Fee } : {}),
+        ...(extra.operatorFee !== undefined ? { operatorFee: extra.operatorFee } : {}),
+        expected: gasLimit * expectedPrice + (extra.l1Fee ?? 0n) + (extra.operatorFee ?? 0n),
+    };
+    return {
+        kind: params.type === 'eip1559' ? 'evm-1559' : 'evm-legacy',
+        speed,
+        charges: [
+            { asset: 'native', amount: gasLimit * cap, label: 'network' },
+            ...(extra.l1Fee !== undefined
+                ? [{ asset: 'native', amount: extra.l1Fee, label: 'l1-data' }]
+                : []),
+            ...(extra.operatorFee !== undefined
+                ? [{ asset: 'native', amount: extra.operatorFee, label: 'operator' }]
+                : []),
+        ],
+        // The L1 data fee moves with L1 prices until inclusion, and the operator fee with the
+        // chain's operator settings, so either is only expected.
+        bound: extra.l1Fee !== undefined || extra.operatorFee !== undefined ? 'expected' : 'upper',
+        details,
+    };
+}
+/** The gas limit and prices a fee draft's details hold. */
+function feeOf(details) {
+    const { gasLimit, maxFeePerGas, maxPriorityFeePerGas, gasPrice } = details;
+    if (typeof gasLimit !== 'bigint')
+        throw invalid('the fee holds no EVM gas limit');
+    if (typeof maxFeePerGas === 'bigint' && typeof maxPriorityFeePerGas === 'bigint') {
+        return { gasLimit, params: { type: 'eip1559', maxFeePerGas, maxPriorityFeePerGas } };
+    }
+    if (typeof gasPrice === 'bigint')
+        return { gasLimit, params: { type: 'legacy', gasPrice } };
+    throw invalid('the fee holds no EVM gas prices');
+}
+/**
+ * Orders two fee settings by what a txpool compares on replacement: the fee cap (or gas
+ * price), then the tip. A legacy gas price is compared as a fee cap and tip alike.
+ */
+function comparePrices(a, b) {
+    const pair = (p) => p.type === 'eip1559'
+        ? [p.maxFeePerGas, p.maxPriorityFeePerGas]
+        : [p.gasPrice, p.gasPrice];
+    const [capA, tipA] = pair(a);
+    const [capB, tipB] = pair(b);
+    if (capA !== capB)
+        return capA < capB ? -1 : 1;
+    return tipA === tipB ? 0 : tipA < tipB ? -1 : 1;
+}
+/**
+ * Whether `next` may replace `previous` under a txpool's `percent` price bump: each price
+ * strictly higher, and at least `percent` higher (geth), so a zero tip must still rise.
+ */
+function meetsBump(previous, next, percent) {
+    const factor = BigInt(100 + percent);
+    const bumped = (before, after) => after > before && after * 100n >= before * factor;
+    if (previous.type === 'eip1559' && next.type === 'eip1559') {
+        return (bumped(previous.maxFeePerGas, next.maxFeePerGas) &&
+            bumped(previous.maxPriorityFeePerGas, next.maxPriorityFeePerGas));
+    }
+    if (previous.type === 'legacy' && next.type === 'legacy') {
+        return bumped(previous.gasPrice, next.gasPrice);
+    }
+    return false;
+}
+/** The smallest prices that meet the bump over `previous`: each strictly higher (geth). */
+function minimumBump(previous, percent) {
+    const up = (value) => {
+        const bumped = ceilDiv(value * BigInt(100 + percent), 100n);
+        return bumped > value ? bumped : value + 1n;
+    };
+    return previous.type === 'eip1559'
+        ? {
+            type: 'eip1559',
+            maxFeePerGas: up(previous.maxFeePerGas),
+            maxPriorityFeePerGas: up(previous.maxPriorityFeePerGas),
+        }
+        : { type: 'legacy', gasPrice: up(previous.gasPrice) };
+}
+//# sourceMappingURL=fees.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../../src/adapters/evm/fees.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The EVM fee policy: `evm-1559` or `evm-legacy` per network, an `upper`\n * bound with the `expected` cost in the details, overrides, and replacement bumps. Pure\n * functions over plain data; the driver does the I/O.\n */\nimport { ProviderError, ValidationError } from '../../core/errors/error';\nimport type { FeeEstimateDraft, FeeOverride, FeeSpeed } from '../../core/model/fee';\nimport type { EvmFeeDetails, EvmFeeHistory } from './types';\n\nexport type EvmFeeModel = 'evm-1559' | 'evm-legacy';\n\n/** The per-gas prices of one transaction. */\nexport type EvmFeeParams =\n  | {\n      readonly type: 'eip1559';\n      readonly maxFeePerGas: bigint;\n      readonly maxPriorityFeePerGas: bigint;\n    }\n  | { readonly type: 'legacy'; readonly gasPrice: bigint };\n\n/**\n * `eth_feeHistory` window and priority-fee percentiles for slow, normal and fast: the\n * method the Polygon Gas Station documents (10th, 25th and 50th over the last 15 blocks).\n */\nexport const FEE_HISTORY_BLOCKS = 15;\nexport const FEE_PERCENTILES: readonly number[] = [10, 25, 50];\nconst SPEED_INDEX: Readonly<Record<FeeSpeed, number>> = { slow: 0, normal: 1, fast: 2 };\n/** Legacy networks: `eth_gasPrice` scaled per speed, in percent. */\nconst LEGACY_PERCENT: Readonly<Record<FeeSpeed, bigint>> = {\n  slow: 100n,\n  normal: 110n,\n  fast: 125n,\n};\n/** A plain transfer to an account without code costs exactly this much gas. */\nexport const TRANSFER_GAS = 21_000n;\n/** Headroom over the node's estimate for anything but a plain transfer, in percent. */\nconst GAS_HEADROOM_PERCENT = 120n;\n\nconst ceilDiv = (a: bigint, b: bigint): bigint => (a + b - 1n) / b;\nconst max = (a: bigint, b: bigint): bigint => (a > b ? a : b);\nconst min = (a: bigint, b: bigint): bigint => (a < b ? a : b);\n\n/** The lower median; `0n` for no values. */\nexport function median(values: readonly bigint[]): bigint {\n  if (values.length === 0) return 0n;\n  const sorted = [...values].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));\n  return sorted[Math.floor((sorted.length - 1) / 2)] as bigint;\n}\n\nconst malformedHistory = () =>\n  new ProviderError('PROVIDER_UNAVAILABLE', 'malformed fee history');\n\n/**\n * EIP-1559 prices for `speed`: the tip is the median, over the window, of the speed's\n * percentile (at least `minTip`); the cap allows the next base fee to double. The history\n * must answer a request for `FEE_PERCENTILES`: one without the next base fee, without\n * reward rows, or with a reward row shorter than `FEE_PERCENTILES` is a retryable\n * `PROVIDER_UNAVAILABLE`, never a tip of `minTip`.\n */\nexport function feesFromHistory(\n  history: EvmFeeHistory,\n  speed: FeeSpeed,\n  minTip: bigint,\n): { readonly params: EvmFeeParams; readonly baseFeePerGas: bigint } {\n  const baseFeePerGas = history.baseFeePerGas[history.baseFeePerGas.length - 1];\n  if (baseFeePerGas === undefined || history.reward.length === 0) {\n    throw malformedHistory();\n  }\n  const index = SPEED_INDEX[speed];\n  const tips = history.reward.map((row) => {\n    const tip = row[index];\n    if (row.length < FEE_PERCENTILES.length || tip === undefined)\n      throw malformedHistory();\n    return tip;\n  });\n  const tip = max(median(tips), minTip);\n  return {\n    params: {\n      type: 'eip1559',\n      maxFeePerGas: 2n * baseFeePerGas + tip,\n      maxPriorityFeePerGas: tip,\n    },\n    baseFeePerGas,\n  };\n}\n\nexport function legacyPrice(gasPrice: bigint, speed: FeeSpeed): EvmFeeParams {\n  return { type: 'legacy', gasPrice: ceilDiv(gasPrice * LEGACY_PERCENT[speed], 100n) };\n}\n\n/** The node's estimate, with headroom unless it is a plain transfer. */\nexport function gasLimitFrom(estimate: bigint): bigint {\n  return estimate === TRANSFER_GAS\n    ? TRANSFER_GAS\n    : ceilDiv(estimate * GAS_HEADROOM_PERCENT, 100n);\n}\n\nconst invalid = (reason: string) => new ValidationError('INVALID_INTENT', reason);\n\n/**\n * The default `maxFeePerGas`, the highest price per gas an EVM transaction signs, 1,000\n * gwei. It bounds a plain transfer at 0.021 and a 65,000-gas token transfer at 0.065 of\n * the native coin, however an endpoint prices the fee. A network whose base fee rises\n * above the ceiling stalls its transfers as `FEE_TOO_LOW` until the fee falls or the\n * option is raised.\n */\nexport const DEFAULT_MAX_FEE_PER_GAS = 1_000_000_000_000n;\n\n/** The highest price per gas `params` may pay: the fee cap, or the legacy gas price. */\nexport function priceCap(params: EvmFeeParams): bigint {\n  return params.type === 'eip1559' ? params.maxFeePerGas : params.gasPrice;\n}\n\n/**\n * A node's suggestion within the ceiling: the fee cap or gas price at most `ceiling`,\n * and the tip at most the fee cap. No endpoint can raise what a transfer signs.\n */\nexport function capPrice(params: EvmFeeParams, ceiling: bigint): EvmFeeParams {\n  if (params.type === 'legacy')\n    return { type: 'legacy', gasPrice: min(params.gasPrice, ceiling) };\n  const maxFeePerGas = min(params.maxFeePerGas, ceiling);\n  return {\n    type: 'eip1559',\n    maxFeePerGas,\n    maxPriorityFeePerGas: min(params.maxPriorityFeePerGas, maxFeePerGas),\n  };\n}\n\n/**\n * Refuses, before anything is signed, a fee whose price per gas is above `ceiling` (the\n * handle's `maxFeePerGas`), whatever produced it: an explicit override, a stored fee, or a\n * cancel's least bump. The details carry the price and the bound as decimal strings.\n */\nexport function assertWithinCeiling(params: EvmFeeParams, ceiling: bigint): void {\n  const price = priceCap(params);\n  if (price <= ceiling) return;\n  throw new ValidationError(\n    'INVALID_INTENT',\n    'the fee is above maxFeePerGas, the EVM handle option that bounds it (wei per gas)',\n    { details: { required: price.toString(), maxFeePerGas: ceiling.toString() } },\n  );\n}\n\n/**\n * The default `maxGasLimit`, the highest gas limit an EVM transaction signs: 16,777,216\n * (2^24), the per-transaction cap Ethereum enforces since Fusaka (EIP-7825), so no\n * transaction above it is included there. A transfer this driver builds needs a small\n * fraction of it (21,000 gas for a plain transfer, tens of thousands for a token's); an\n * Arbitrum estimate also counts the L1 data fee in L2 gas, so it grows with L1 prices.\n * Like `DEFAULT_MAX_FEE_PER_GAS`, it stops an absurd gas limit, from an endpoint's\n * estimate or an override, not an expensive one: set the option to your own policy.\n */\nexport const DEFAULT_MAX_GAS_LIMIT = 16_777_216n;\n\n/**\n * Refuses, before anything is signed, a gas limit above `bound` (the handle's\n * `maxGasLimit`), whatever produced it: the node's estimate with its headroom, an\n * override's `gasLimit`, a stored fee, or a replacement that keeps its original's. It is\n * never clamped: a lower limit than the call needs runs out of gas and still pays. The\n * details carry the gas limit and the bound as decimal strings.\n */\nexport function assertWithinGasLimit(gasLimit: bigint, bound: bigint): void {\n  if (gasLimit <= bound) return;\n  throw new ValidationError(\n    'INVALID_INTENT',\n    'the gas limit is above maxGasLimit, the EVM handle option that bounds it (gas)',\n    { details: { required: gasLimit.toString(), maxGasLimit: bound.toString() } },\n  );\n}\n\n/** Validates an `EvmFeeOverride` against the network's fee model. */\nexport function parseFeeOverride(\n  override: FeeOverride,\n  model: EvmFeeModel,\n): { readonly params: EvmFeeParams; readonly gasLimit?: bigint } {\n  const allowed =\n    model === 'evm-1559'\n      ? ['maxFeePerGas', 'maxPriorityFeePerGas', 'gasLimit']\n      : ['gasPrice', 'gasLimit'];\n  const shape =\n    model === 'evm-1559'\n      ? '{ maxFeePerGas, maxPriorityFeePerGas, gasLimit? }'\n      : '{ gasPrice, gasLimit? }';\n  const keys = Object.keys(override);\n  if (keys.some((key) => !allowed.includes(key))) {\n    throw invalid(`${model} fee overrides look like ${shape}`);\n  }\n  const amount = (key: string, min: bigint): bigint => {\n    const value = override[key];\n    if (typeof value !== 'bigint' || value < min) {\n      throw invalid(`fee override '${key}' must be a bigint of at least ${min}`);\n    }\n    return value;\n  };\n  const gasLimit =\n    override.gasLimit === undefined ? undefined : amount('gasLimit', TRANSFER_GAS);\n  const limit = gasLimit !== undefined ? { gasLimit } : {};\n  if (model === 'evm-legacy') {\n    return { params: { type: 'legacy', gasPrice: amount('gasPrice', 1n) }, ...limit };\n  }\n  const maxFeePerGas = amount('maxFeePerGas', 1n);\n  const maxPriorityFeePerGas = amount('maxPriorityFeePerGas', 0n);\n  if (maxPriorityFeePerGas > maxFeePerGas) {\n    throw invalid('maxPriorityFeePerGas must not exceed maxFeePerGas');\n  }\n  return { params: { type: 'eip1559', maxFeePerGas, maxPriorityFeePerGas }, ...limit };\n}\n\n/** The fee draft for a transaction of `gasLimit` at `params`. */\nexport function feeDraft(\n  speed: FeeSpeed | 'custom',\n  gasLimit: bigint,\n  params: EvmFeeParams,\n  extra: {\n    readonly baseFeePerGas?: bigint;\n    readonly l1Fee?: bigint;\n    readonly operatorFee?: bigint;\n  } = {},\n): FeeEstimateDraft {\n  const cap = params.type === 'eip1559' ? params.maxFeePerGas : params.gasPrice;\n  const expectedPrice =\n    params.type === 'eip1559' && extra.baseFeePerGas !== undefined\n      ? min(params.maxFeePerGas, extra.baseFeePerGas + params.maxPriorityFeePerGas)\n      : cap;\n  // `satisfies` checks the shape and keeps a literal type the draft's record accepts.\n  const details = {\n    gasLimit,\n    ...(params.type === 'eip1559'\n      ? {\n          maxFeePerGas: params.maxFeePerGas,\n          maxPriorityFeePerGas: params.maxPriorityFeePerGas,\n          ...(extra.baseFeePerGas !== undefined\n            ? { baseFeePerGas: extra.baseFeePerGas }\n            : {}),\n        }\n      : { gasPrice: params.gasPrice }),\n    ...(extra.l1Fee !== undefined ? { l1Fee: extra.l1Fee } : {}),\n    ...(extra.operatorFee !== undefined ? { operatorFee: extra.operatorFee } : {}),\n    expected: gasLimit * expectedPrice + (extra.l1Fee ?? 0n) + (extra.operatorFee ?? 0n),\n  } satisfies EvmFeeDetails;\n  return {\n    kind: params.type === 'eip1559' ? 'evm-1559' : 'evm-legacy',\n    speed,\n    charges: [\n      { asset: 'native', amount: gasLimit * cap, label: 'network' },\n      ...(extra.l1Fee !== undefined\n        ? [{ asset: 'native' as const, amount: extra.l1Fee, label: 'l1-data' }]\n        : []),\n      ...(extra.operatorFee !== undefined\n        ? [{ asset: 'native' as const, amount: extra.operatorFee, label: 'operator' }]\n        : []),\n    ],\n    // The L1 data fee moves with L1 prices until inclusion, and the operator fee with the\n    // chain's operator settings, so either is only expected.\n    bound:\n      extra.l1Fee !== undefined || extra.operatorFee !== undefined ? 'expected' : 'upper',\n    details,\n  };\n}\n\n/** The gas limit and prices a fee draft's details hold. */\nexport function feeOf(details: Readonly<Record<string, unknown>>): {\n  readonly gasLimit: bigint;\n  readonly params: EvmFeeParams;\n} {\n  const { gasLimit, maxFeePerGas, maxPriorityFeePerGas, gasPrice } = details;\n  if (typeof gasLimit !== 'bigint') throw invalid('the fee holds no EVM gas limit');\n  if (typeof maxFeePerGas === 'bigint' && typeof maxPriorityFeePerGas === 'bigint') {\n    return { gasLimit, params: { type: 'eip1559', maxFeePerGas, maxPriorityFeePerGas } };\n  }\n  if (typeof gasPrice === 'bigint')\n    return { gasLimit, params: { type: 'legacy', gasPrice } };\n  throw invalid('the fee holds no EVM gas prices');\n}\n\n/**\n * Orders two fee settings by what a txpool compares on replacement: the fee cap (or gas\n * price), then the tip. A legacy gas price is compared as a fee cap and tip alike.\n */\nexport function comparePrices(a: EvmFeeParams, b: EvmFeeParams): number {\n  const pair = (p: EvmFeeParams): readonly [bigint, bigint] =>\n    p.type === 'eip1559'\n      ? [p.maxFeePerGas, p.maxPriorityFeePerGas]\n      : [p.gasPrice, p.gasPrice];\n  const [capA, tipA] = pair(a);\n  const [capB, tipB] = pair(b);\n  if (capA !== capB) return capA < capB ? -1 : 1;\n  return tipA === tipB ? 0 : tipA < tipB ? -1 : 1;\n}\n\n/**\n * Whether `next` may replace `previous` under a txpool's `percent` price bump: each price\n * strictly higher, and at least `percent` higher (geth), so a zero tip must still rise.\n */\nexport function meetsBump(\n  previous: EvmFeeParams,\n  next: EvmFeeParams,\n  percent: number,\n): boolean {\n  const factor = BigInt(100 + percent);\n  const bumped = (before: bigint, after: bigint) =>\n    after > before && after * 100n >= before * factor;\n  if (previous.type === 'eip1559' && next.type === 'eip1559') {\n    return (\n      bumped(previous.maxFeePerGas, next.maxFeePerGas) &&\n      bumped(previous.maxPriorityFeePerGas, next.maxPriorityFeePerGas)\n    );\n  }\n  if (previous.type === 'legacy' && next.type === 'legacy') {\n    return bumped(previous.gasPrice, next.gasPrice);\n  }\n  return false;\n}\n\n/** The smallest prices that meet the bump over `previous`: each strictly higher (geth). */\nexport function minimumBump(previous: EvmFeeParams, percent: number): EvmFeeParams {\n  const up = (value: bigint) => {\n    const bumped = ceilDiv(value * BigInt(100 + percent), 100n);\n    return bumped > value ? bumped : value + 1n;\n  };\n  return previous.type === 'eip1559'\n    ? {\n        type: 'eip1559',\n        maxFeePerGas: up(previous.maxFeePerGas),\n        maxPriorityFeePerGas: up(previous.maxPriorityFeePerGas),\n      }\n    : { type: 'legacy', gasPrice: up(previous.gasPrice) };\n}\n"]}

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

@@ -0,0 +1,20 @@
+/**
+ * `crypto-aio/evm`: EVM chains of your own (`evmChainPlugin`), the SDK-free EVM types, and
+ * the `crypto-aio/native` client types: importing this entry types `native(bc, 'ethers')`
+ * as an ethers `JsonRpcApiProvider` and `native(bc, 'web3')` as a `Web3` instance.
+ *
+ * @module crypto-aio/evm
+ */
+import type { JsonRpcApiProvider } from 'ethers';
+import type { Web3 } from 'web3';
+declare module '../../index' {
+    interface NativeClientMap {
+        ethers: JsonRpcApiProvider;
+        web3: Web3;
+    }
+}
+export { EVM_PEER_DEPENDENCIES, evmChainPlugin } from './plugin';
+export type { EvmChainPluginOptions } from './plugin';
+export { DEFAULT_MAX_FEE_PER_GAS, DEFAULT_MAX_GAS_LIMIT } from './fees';
+export { EVM_CAPABILITIES } from './network';
+export type { EvmExt, EvmFeeDetails, EvmFeeOverride } from './types';

package/dist/adapters/evm/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVM_CAPABILITIES = exports.DEFAULT_MAX_GAS_LIMIT = exports.DEFAULT_MAX_FEE_PER_GAS = exports.evmChainPlugin = exports.EVM_PEER_DEPENDENCIES = void 0;
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "EVM_PEER_DEPENDENCIES", { enumerable: true, get: function () { return plugin_1.EVM_PEER_DEPENDENCIES; } });
+Object.defineProperty(exports, "evmChainPlugin", { enumerable: true, get: function () { return plugin_1.evmChainPlugin; } });
+var fees_1 = require("./fees");
+Object.defineProperty(exports, "DEFAULT_MAX_FEE_PER_GAS", { enumerable: true, get: function () { return fees_1.DEFAULT_MAX_FEE_PER_GAS; } });
+Object.defineProperty(exports, "DEFAULT_MAX_GAS_LIMIT", { enumerable: true, get: function () { return fees_1.DEFAULT_MAX_GAS_LIMIT; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "EVM_CAPABILITIES", { enumerable: true, get: function () { return network_1.EVM_CAPABILITIES; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/evm/index.ts"],"names":[],"mappings":";;;AAmBA,mCAAiE;AAAxD,+GAAA,qBAAqB,OAAA;AAAE,wGAAA,cAAc,OAAA;AAE9C,+BAAwE;AAA/D,+GAAA,uBAAuB,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AACvD,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA","sourcesContent":["/**\n * `crypto-aio/evm`: EVM chains of your own (`evmChainPlugin`), the SDK-free EVM types, and\n * the `crypto-aio/native` client types: importing this entry types `native(bc, 'ethers')`\n * as an ethers `JsonRpcApiProvider` and `native(bc, 'web3')` as a `Web3` instance.\n *\n * @module crypto-aio/evm\n */\nimport type { JsonRpcApiProvider } from 'ethers';\nimport type { Web3 } from 'web3';\n\n// Through the package entry, never a core module. SDK types appear only here, in the\n// adapter's entry, so the main entry's typings name no SDK.\ndeclare module '../../index' {\n  interface NativeClientMap {\n    ethers: JsonRpcApiProvider;\n    web3: Web3;\n  }\n}\n\nexport { EVM_PEER_DEPENDENCIES, evmChainPlugin } from './plugin';\nexport type { EvmChainPluginOptions } from './plugin';\nexport { DEFAULT_MAX_FEE_PER_GAS, DEFAULT_MAX_GAS_LIMIT } from './fees';\nexport { EVM_CAPABILITIES } from './network';\nexport type { EvmExt, EvmFeeDetails, EvmFeeOverride } from './types';\n"]}