crypto-aio 0.0.2 → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/adapters/evm/reader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EVM addresses, reads, nonces, finality and the `ext.evm` API. Every call carries the tags\n * of the `ChainDriver` contract table (`src/core/driver/types.ts`): `read` for point\n * queries, `monitor` for heights, observations and nonces, and `proof` for the finality\n * that proofs attest.\n */\nimport type {\n  AddressCodec,\n  ChainReader,\n  DriverBlock,\n  SequenceSource,\n} from '../../core/driver/types';\nimport {\n  ProviderError,\n  ValidationError,\n  isCryptoAioError,\n  withContext,\n} from '../../core/errors/error';\nimport type { Logger } from '../../core/events/logger';\nimport type { AssetMetadata, AssetRef, TokenRef } from '../../core/model/asset';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport { quantity } from './client';\nimport { chainObservation, decodeTransaction, evmObservation } from './decode';\nimport type { EvmNetworkConfig } from './network';\nimport type { EvmBlock, EvmCallTags, EvmClient, EvmExt } from './types';\n\n/** What every EVM port is built from. */\nexport interface EvmContext {\n  readonly client: EvmClient;\n  readonly chain: ChainInfo;\n  readonly network: NetworkInfo;\n  readonly config: EvmNetworkConfig;\n  readonly log: Logger;\n}\n\nexport const READ: EvmCallTags = { purpose: 'read', retry: 'safe' };\nexport const MONITOR: EvmCallTags = { purpose: 'monitor', retry: 'safe' };\nexport const PROOF: EvmCallTags = { purpose: 'proof', retry: 'safe', quorum: 'proof' };\n\nexport const withSignal = (tags: EvmCallTags, signal?: AbortSignal): EvmCallTags =>\n  signal ? { ...tags, signal } : tags;\n\nexport function toDriverBlock(block: EvmBlock): DriverBlock {\n  return {\n    height: block.number,\n    hash: block.hash,\n    parentHash: block.parentHash,\n    timestamp: block.timestamp,\n    transactionIds: block.transactions,\n  };\n}\n\n/** Whether a definitive (non-ambiguous) JSON-RPC error says the call reverted. */\nexport function isRevert(error: unknown): boolean {\n  if (!isCryptoAioError(error, 'RPC_ERROR') || error.ambiguous) return false;\n  const { rpcCode, rpcMessage } = error.details ?? {};\n  return rpcCode === 3 || /revert/i.test(String(rpcMessage ?? error.message));\n}\n\n/**\n * How many blocks a proof's final height trails the one endpoint that proposed it, so\n * a quorum peer up to this far behind that endpoint still attests it.\n */\nexport const PEER_SKEW = 2n;\n\n/** `height - depth`, or genesis. */\nconst below = (height: bigint, depth: bigint): bigint =>\n  height > depth ? height - depth : 0n;\n\n/**\n * A quorum key under which every endpoint whose block is at or past `height` agrees,\n * so honest endpoints at different heights agree, and one that is not there disagrees.\n * A malformed answer throws, which the transport counts as a disagreement.\n */\nconst atOrPast =\n  (height: bigint) =>\n  (result: unknown): boolean =>\n    result !== null &&\n    quantity((result as { readonly number?: unknown }).number, 'block number') >= height;\n\n/** Whether every quorum endpoint's `finalized` block is at or past `height`. */\nasync function finalizedAtOrPast(\n  ctx: EvmContext,\n  height: bigint,\n  tags: EvmCallTags,\n): Promise<boolean> {\n  const block = await ctx.client.getBlock('finalized', {\n    ...tags,\n    quorumKey: atOrPast(height),\n  });\n  // The endpoints agreed on the predicate, so the first one's block states it for all.\n  return block !== null && block.number >= height;\n}\n\n/**\n * The highest final block as one endpoint sees it (a `monitor` view): the `finalized` tag,\n * or the head minus the confirmations; the head read carries the signal of `tags`. Proofs\n * never use it as a final height: `provenFinal` attests one.\n */\nexport async function finalizedHeight(\n  ctx: EvmContext,\n  tags: EvmCallTags,\n): Promise<bigint> {\n  const { finality } = ctx.config;\n  if (finality.kind === 'confirmations') {\n    const head = await ctx.client.blockNumber(withSignal(MONITOR, tags.signal));\n    return below(head, BigInt(finality.confirmations - 1));\n  }\n  const block = await ctx.client.getBlock('finalized', tags);\n  if (!block) {\n    throw new ProviderError(\n      'PROVIDER_UNAVAILABLE',\n      'the endpoint reports no finalized block',\n    );\n  }\n  return block.number;\n}\n\n/**\n * A height that is final on every endpoint of the proof quorum (`tags`), and the quorum's\n * block at it when the proof read that block anyway. One endpoint's view (a `monitor` read)\n * only proposes: the height trails it by `PEER_SKEW` blocks, and the quorum attests it. On\n * tag networks every quorum endpoint's `finalized` block must be at or past it; on\n * confirmation networks every one must hold the block that confirms it. So an\n * endpoint that over-reports cannot advance finality, and a peer that trails the proposer\n * by up to `PEER_SKEW` blocks still agrees.\n */\nexport async function provenFinal(\n  ctx: EvmContext,\n  tags: EvmCallTags,\n): Promise<{ readonly height: bigint; readonly block?: EvmBlock }> {\n  const { finality } = ctx.config;\n  const view = withSignal(MONITOR, tags.signal);\n  if (finality.kind === 'confirmations') {\n    const confirming = below(await ctx.client.blockNumber(view), PEER_SKEW);\n    const block = await ctx.client.getBlock(confirming, tags);\n    if (block?.number !== confirming) {\n      throw new ProviderError(\n        'PROVIDER_INCONSISTENT',\n        'the endpoints do not hold the confirming block',\n      );\n    }\n    const height = below(confirming, BigInt(finality.confirmations - 1));\n    return height === confirming ? { height, block } : { height };\n  }\n  const height = below(await finalizedHeight(ctx, view), PEER_SKEW);\n  if (!(await finalizedAtOrPast(ctx, height, tags))) {\n    throw new ProviderError(\n      'PROVIDER_INCONSISTENT',\n      'the endpoints do not attest the proposed finalized block',\n    );\n  }\n  return { height };\n}\n\n/**\n * The quorum's block at `height` when `height` is final on every endpoint of the proof\n * quorum (`tags`), else `null`. Anchored at `height` itself, not at any endpoint's view:\n * honest endpoints disagree only while `height` is final on one and not yet on another, and\n * that decides nothing (a retryable `PROVIDER_INCONSISTENT`).\n */\nexport async function finalBlockAt(\n  ctx: EvmContext,\n  height: bigint,\n  tags: EvmCallTags,\n): Promise<EvmBlock | null> {\n  const { client } = ctx;\n  const { finality } = ctx.config;\n  if (finality.kind === 'tag') {\n    if (!(await finalizedAtOrPast(ctx, height, tags))) return null;\n    return client.getBlock(height, tags);\n  }\n  // The block that gives `height` its confirmations; with one, it is `height`'s own.\n  const depth = BigInt(finality.confirmations - 1);\n  const confirming = await client.getBlock(height + depth, tags);\n  if (confirming === null) return null;\n  return depth === 0n ? confirming : client.getBlock(height, tags);\n}\n\nexport function createEvmAddressCodec(client: EvmClient): AddressCodec {\n  return {\n    validate: (value) => client.isAddress(value),\n    normalize: (value) => {\n      if (!client.isAddress(value)) {\n        throw new ValidationError('INVALID_ADDRESS', 'not an EVM address');\n      }\n      const canonical = client.checksum(value);\n      return { canonical, display: canonical };\n    },\n    fromPublicKey: (publicKey) => {\n      // The client's strict decode already throws a specific `INVALID_ADDRESS`.\n      const canonical = client.addressFromPublicKey(publicKey);\n      return { canonical, display: canonical };\n    },\n  };\n}\n\nconst assetError = (reason: string) => new ValidationError('ASSET_RESOLUTION', reason);\n\n/** geth's texts for an EVM that stopped the called code itself (`core/vm/errors.go`). */\nconst VM_FAILURE =\n  /^(out of gas|invalid opcode|invalid jump destination|stack (underflow|limit reached)|write protection|return data out of bounds)/i;\n\n/** Whether a definitive (non-ambiguous) JSON-RPC error says the EVM stopped the code. */\nexport function isExecutionFailure(error: unknown): boolean {\n  if (!isCryptoAioError(error, 'RPC_ERROR') || error.ambiguous) return false;\n  const { rpcMessage } = error.details ?? {};\n  return typeof rpcMessage === 'string' && VM_FAILURE.test(rpcMessage);\n}\n\n/** An ERC-20 `balanceOf` at `latest`; `ASSET_RESOLUTION` when the contract gives none. */\nexport async function erc20Balance(\n  client: EvmClient,\n  token: string,\n  owner: string,\n  tags: EvmCallTags,\n): Promise<bigint> {\n  const data = await client.call(\n    { to: token, data: client.abi.encodeBalanceOf(owner) },\n    'latest',\n    tags,\n  );\n  try {\n    return client.abi.decodeUint256(data);\n  } catch {\n    throw assetError('the token contract returned no balance');\n  }\n}\n\nfunction tokenOf(asset: AssetRef): string {\n  if (asset === 'native' || asset.standard !== 'erc20') {\n    throw assetError(`EVM tokens use the 'erc20' standard`);\n  }\n  return asset.contract;\n}\n\n/** The text of an ABI `string`, or of a `bytes32` (older tokens such as MKR return one). */\nfunction symbolText(client: EvmClient, data: string): string {\n  try {\n    return client.abi.decodeString(data);\n  } catch {\n    if (!/^0x[0-9a-fA-F]{64}$/.test(data))\n      throw assetError('the token symbol is unreadable');\n    return Buffer.from(data.slice(2), 'hex').toString('utf8').replace(/\\0+$/, '');\n  }\n}\n\n/**\n * Token metadata is read under the proof quorum, stricter than the contract table's\n * minimum. The core caches it for the container's life, and one endpoint's wrong `decimals`\n * (a lagging, misrouted or buggy backend) would mis-scale every amount by orders of\n * magnitude until restart. `decimals` never changes, so honest endpoints always agree.\n */\nconst METADATA: EvmCallTags = { ...READ, quorum: 'proof' };\n\nexport function createEvmReader(ctx: EvmContext): ChainReader {\n  const { client } = ctx;\n  /**\n   * A revert or a VM execution failure is the token's own permanent problem\n   * (`ASSET_RESOLUTION`, which the core caches until restart, even if the call would\n   * later run). Any other JSON-RPC error is the node's, so it is rethrown retryable: a\n   * provider fault never pins a token. Everything else propagates unchanged: a\n   * misconfigured endpoint stays final, and a retryable failure is already retryable.\n   */\n  const tokenCall = async (contract: string, data: string): Promise<string> => {\n    try {\n      return await client.call({ to: contract, data }, 'latest', METADATA);\n    } catch (error) {\n      if (isRevert(error)) throw assetError('the token contract reverted');\n      if (isExecutionFailure(error)) throw assetError('the token contract failed to run');\n      if (isCryptoAioError(error, 'RPC_ERROR')) {\n        throw withContext(error, {}, { retryable: true });\n      }\n      throw error;\n    }\n  };\n\n  return {\n    getBalance: async (address, asset) => {\n      if (asset === 'native') return client.getBalance(address, 'latest', READ);\n      return erc20Balance(client, tokenOf(asset), address, READ);\n    },\n    getBlockHeight: () => client.blockNumber(MONITOR),\n    getFinalizedHeight: () => finalizedHeight(ctx, MONITOR),\n    getBlock: async (ref) => {\n      const block = await client.getBlock(ref, READ);\n      return block ? toDriverBlock(block) : null;\n    },\n    getTransaction: async (id) => {\n      const tx = await client.getTransaction(id, READ);\n      if (!tx) return null;\n      const receipt = tx.blockHash !== null ? await client.getReceipt(id, READ) : null;\n      return decodeTransaction(client.abi, tx, receipt, undefined, ctx.config);\n    },\n    /**\n     * With an ordering, the token verdict on one of our own Attempts. Without one (a\n     * status lookup by id, for a transaction the library does not manage) the chain's\n     * view, so a third party's call that shares the `transfer` selector is not reported\n     * failed.\n     */\n    observe: async (ref, ordering) => {\n      const tx = await client.getTransaction(ref.id, MONITOR);\n      if (!tx) return { seen: 'none' };\n      const receipt =\n        tx.blockHash === null ? null : await client.getReceipt(ref.id, MONITOR);\n      return ordering === undefined\n        ? chainObservation(tx, receipt)\n        : evmObservation(client.abi, tx, receipt);\n    },\n    getTokenMetadata: async (ref: TokenRef): Promise<AssetMetadata> => {\n      const contract = tokenOf(ref);\n      const decimalsData = await tokenCall(contract, client.abi.encodeDecimals());\n      if (decimalsData === '0x') throw assetError('no token contract at this address');\n      let decimals: bigint;\n      try {\n        decimals = client.abi.decodeUint256(decimalsData);\n      } catch {\n        throw assetError('the token decimals are unreadable');\n      }\n      if (decimals > 255n) throw assetError('the token decimals are out of range');\n      const symbol = symbolText(\n        client,\n        await tokenCall(contract, client.abi.encodeSymbol()),\n      );\n      if (!symbol) throw assetError('the token has no symbol');\n      return { symbol, decimals: Number(decimals) };\n    },\n    normalizeTokenRef: (ref) => {\n      const contract = tokenOf(ref);\n      if (!client.isAddress(contract)) throw assetError('not an EVM contract address');\n      return { standard: 'erc20', contract: client.checksum(contract) };\n    },\n  };\n}\n\nexport function createEvmSequence(client: EvmClient): SequenceSource {\n  return {\n    pending: (address) => client.getTransactionCount(address, 'pending', MONITOR),\n    latest: (address) => client.getTransactionCount(address, 'latest', MONITOR),\n  };\n}\n\nexport function createEvmExt(client: EvmClient): EvmExt {\n  return {\n    evm: {\n      getNonce: async (address, block = 'latest') => {\n        if (block !== 'latest' && block !== 'pending') {\n          throw new ValidationError(\n            'INVALID_INTENT',\n            `block must be 'latest' or 'pending'`,\n          );\n        }\n        const codec = createEvmAddressCodec(client);\n        return client.getTransactionCount(\n          codec.normalize(address).canonical,\n          block,\n          READ,\n        );\n      },\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,39 @@
+/**
+ * The clients' common path to the core transport. `EthersClient` (directly) and
+ * `Web3Client` (through its EIP-1193 `request` object) end here, so each JSON-RPC
+ * call carries the purpose, retry class, quorum, fanout and signal of the driver method that
+ * made it.
+ */
+import type { Transport } from '../../core/transport/types';
+import type { EvmCallTags } from './types';
+/**
+ * The consensus facts of a block read with its transactions to find the one that
+ * consumed a nonce: the block's number and hash, and each transaction's hash, sender and
+ * nonce, with the recipient and calldata that the token verdict reads.
+ */
+export declare function blockTransactionsKey(result: unknown): unknown;
+/**
+ * The tags of a `crypto-aio/native` client's request: plain reads, except a broadcast, which
+ * is one: a failure after the transport may have delivered it is `ambiguous`, never an
+ * invitation to sign again with a new nonce.
+ */
+export declare const nativeTags: (method: string) => EvmCallTags;
+/**
+ * The consensus facts compared under a quorum, per JSON-RPC method. Node implementations
+ * return extra or differently formatted fields (`size`, `totalDifficulty`, L2 extras), so a
+ * quorum over whole objects would report disagreement where there is none.
+ */
+export declare function quorumKeyFor(method: string): ((result: unknown) => unknown) | undefined;
+/**
+ * One JSON-RPC call through the transport, under the calling driver method's tags. A quorum
+ * compares the caller's own `quorumKey` when it gives one, else the method's consensus
+ * facts; a key never travels without a quorum.
+ */
+export declare function transportCall(transport: Transport, method: string, params: unknown, tags: EvmCallTags): Promise<unknown>;
+/**
+ * Runs `request` (an SDK call whose bridge ends in `call`) and, when its last transport call
+ * failed, rethrows the transport's own error, never an SDK wrapper of it: web3 turns an
+ * "execution reverted" error into a `ContractExecutionError`, which would lose the error's
+ * code and ambiguity. A failure followed by a successful call is forgotten.
+ */
+export declare function throughSdk<T>(request: (call: (method: string, params: unknown) => Promise<unknown>) => Promise<T>, transport: Transport, tags: EvmCallTags): Promise<T>;

package/dist/adapters/evm/rpc.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nativeTags = void 0;
+exports.blockTransactionsKey = blockTransactionsKey;
+exports.quorumKeyFor = quorumKeyFor;
+exports.transportCall = transportCall;
+exports.throughSdk = throughSdk;
+const pick = (value, keys) => {
+    if (value === null || typeof value !== 'object')
+        return value;
+    const record = value;
+    return Object.fromEntries(keys.map((key) => [key, record[key] ?? null]));
+};
+const BLOCK = ['number', 'hash', 'parentHash', 'timestamp'];
+const RECEIPT = ['transactionHash', 'blockHash', 'blockNumber', 'status'];
+const TX = ['hash', 'blockHash', 'blockNumber', 'from', 'to', 'nonce'];
+const LOG = ['address', 'topics', 'data', 'logIndex'];
+const lowerCased = (value) => typeof value === 'string'
+    ? value.toLowerCase()
+    : Array.isArray(value)
+        ? value.map(lowerCased)
+        : value;
+/** The `keys` of `value`, each lower-cased: hex case is formatting, not consensus. */
+function lowerCasedFacts(value, keys) {
+    const facts = pick(value, keys);
+    return facts !== null && typeof facts === 'object'
+        ? Object.fromEntries(Object.entries(facts).map(([key, fact]) => [key, lowerCased(fact)]))
+        : facts;
+}
+/**
+ * A transaction's calldata as the client reads it: `input`, or `data` on older nodes,
+ * lower-cased. The token verdict decodes it, so a key must compare it under
+ * either name, or a first endpoint answering with `data` could alter it unseen.
+ */
+function calldataOf(tx) {
+    if (tx === null || typeof tx !== 'object')
+        return null;
+    const { input, data } = tx;
+    return lowerCased(input ?? data ?? null);
+}
+/** A transaction's `keys`, lower-cased when `lower`, and its calldata as `input`. */
+function txFacts(tx, keys, lower) {
+    if (tx === null || typeof tx !== 'object')
+        return tx;
+    const facts = (lower ? lowerCasedFacts(tx, keys) : pick(tx, keys));
+    return { ...facts, input: calldataOf(tx) };
+}
+/**
+ * A receipt's consensus facts include its logs, since a proven token verdict reads them:
+ * one endpoint that drops or alters a `Transfer` log must disagree. Hex case is
+ * formatting, not consensus, so each log's facts are compared lower-cased. A provider
+ * that formats logs another way fails proofs, but only retryably.
+ */
+function receiptKey(result) {
+    if (result === null || typeof result !== 'object')
+        return result;
+    const logs = result.logs;
+    return {
+        ...pick(result, RECEIPT),
+        logs: Array.isArray(logs) ? logs.map((log) => lowerCasedFacts(log, LOG)) : null,
+    };
+}
+const BLOCK_TX = ['hash', 'from', 'nonce', 'to'];
+/**
+ * The consensus facts of a block read with its transactions to find the one that
+ * consumed a nonce: the block's number and hash, and each transaction's hash, sender and
+ * nonce, with the recipient and calldata that the token verdict reads.
+ */
+function blockTransactionsKey(result) {
+    if (result === null || typeof result !== 'object')
+        return result;
+    const txs = result.transactions;
+    return {
+        ...lowerCasedFacts(result, ['number', 'hash']),
+        transactions: Array.isArray(txs)
+            ? txs.map((tx) => txFacts(tx, BLOCK_TX, true))
+            : null,
+    };
+}
+const NATIVE_READ = { purpose: 'read', retry: 'safe' };
+const NATIVE_BROADCAST = {
+    purpose: 'broadcast',
+    retry: 'ambiguous-on-failure',
+};
+/**
+ * The tags of a `crypto-aio/native` client's request: plain reads, except a broadcast, which
+ * is one: a failure after the transport may have delivered it is `ambiguous`, never an
+ * invitation to sign again with a new nonce.
+ */
+const nativeTags = (method) => method === 'eth_sendRawTransaction' ? NATIVE_BROADCAST : NATIVE_READ;
+exports.nativeTags = nativeTags;
+/**
+ * The consensus facts compared under a quorum, per JSON-RPC method. Node implementations
+ * return extra or differently formatted fields (`size`, `totalDifficulty`, L2 extras), so a
+ * quorum over whole objects would report disagreement where there is none.
+ */
+function quorumKeyFor(method) {
+    switch (method) {
+        case 'eth_getBlockByNumber':
+        case 'eth_getBlockByHash':
+            return (result) => pick(result, BLOCK);
+        case 'eth_getTransactionReceipt':
+            return receiptKey;
+        case 'eth_getBlockReceipts':
+            return (result) => (Array.isArray(result) ? result.map(receiptKey) : result);
+        case 'eth_getTransactionByHash':
+            return (result) => txFacts(result, TX, false);
+        default:
+            return undefined;
+    }
+}
+/**
+ * One JSON-RPC call through the transport, under the calling driver method's tags. A quorum
+ * compares the caller's own `quorumKey` when it gives one, else the method's consensus
+ * facts; a key never travels without a quorum.
+ */
+function transportCall(transport, method, params, tags) {
+    const { quorumKey: own, ...rest } = tags;
+    const quorumKey = rest.quorum !== undefined ? (own ?? quorumKeyFor(method)) : undefined;
+    return transport.rpc(method, params ?? [], {
+        ...rest,
+        ...(quorumKey ? { quorumKey } : {}),
+    });
+}
+/**
+ * Runs `request` (an SDK call whose bridge ends in `call`) and, when its last transport call
+ * failed, rethrows the transport's own error, never an SDK wrapper of it: web3 turns an
+ * "execution reverted" error into a `ContractExecutionError`, which would lose the error's
+ * code and ambiguity. A failure followed by a successful call is forgotten.
+ */
+async function throughSdk(request, transport, tags) {
+    let failure;
+    const call = async (method, params) => {
+        try {
+            const result = await transportCall(transport, method, params, tags);
+            // Only a failure the SDK did not recover from may replace the SDK's own error.
+            failure = undefined;
+            return result;
+        }
+        catch (error) {
+            failure = { error };
+            throw error;
+        }
+    };
+    try {
+        return await request(call);
+    }
+    catch (error) {
+        throw failure ? failure.error : error;
+    }
+}
+//# sourceMappingURL=rpc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/adapters/evm/rpc.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The clients' common path to the core transport. `EthersClient` (directly) and\n * `Web3Client` (through its EIP-1193 `request` object) end here, so each JSON-RPC\n * call carries the purpose, retry class, quorum, fanout and signal of the driver method that\n * made it.\n */\nimport type { Transport } from '../../core/transport/types';\nimport type { EvmCallTags } from './types';\n\ntype Json = Record<string, unknown> | null;\n\nconst pick = (value: unknown, keys: readonly string[]): unknown => {\n  if (value === null || typeof value !== 'object') return value;\n  const record = value as Record<string, unknown>;\n  return Object.fromEntries(keys.map((key) => [key, record[key] ?? null]));\n};\n\nconst BLOCK = ['number', 'hash', 'parentHash', 'timestamp'] as const;\nconst RECEIPT = ['transactionHash', 'blockHash', 'blockNumber', 'status'] as const;\nconst TX = ['hash', 'blockHash', 'blockNumber', 'from', 'to', 'nonce'] as const;\nconst LOG = ['address', 'topics', 'data', 'logIndex'] as const;\n\nconst lowerCased = (value: unknown): unknown =>\n  typeof value === 'string'\n    ? value.toLowerCase()\n    : Array.isArray(value)\n      ? value.map(lowerCased)\n      : value;\n\n/** The `keys` of `value`, each lower-cased: hex case is formatting, not consensus. */\nfunction lowerCasedFacts(value: unknown, keys: readonly string[]): unknown {\n  const facts = pick(value, keys);\n  return facts !== null && typeof facts === 'object'\n    ? Object.fromEntries(\n        Object.entries(facts).map(([key, fact]) => [key, lowerCased(fact)]),\n      )\n    : facts;\n}\n\n/**\n * A transaction's calldata as the client reads it: `input`, or `data` on older nodes,\n * lower-cased. The token verdict decodes it, so a key must compare it under\n * either name, or a first endpoint answering with `data` could alter it unseen.\n */\nfunction calldataOf(tx: unknown): unknown {\n  if (tx === null || typeof tx !== 'object') return null;\n  const { input, data } = tx as Record<string, unknown>;\n  return lowerCased(input ?? data ?? null);\n}\n\n/** A transaction's `keys`, lower-cased when `lower`, and its calldata as `input`. */\nfunction txFacts(tx: unknown, keys: readonly string[], lower: boolean): unknown {\n  if (tx === null || typeof tx !== 'object') return tx;\n  const facts = (lower ? lowerCasedFacts(tx, keys) : pick(tx, keys)) as Record<\n    string,\n    unknown\n  >;\n  return { ...facts, input: calldataOf(tx) };\n}\n\n/**\n * A receipt's consensus facts include its logs, since a proven token verdict reads them:\n * one endpoint that drops or alters a `Transfer` log must disagree. Hex case is\n * formatting, not consensus, so each log's facts are compared lower-cased. A provider\n * that formats logs another way fails proofs, but only retryably.\n */\nfunction receiptKey(result: unknown): unknown {\n  if (result === null || typeof result !== 'object') return result;\n  const logs = (result as Record<string, unknown>).logs;\n  return {\n    ...(pick(result, RECEIPT) as Record<string, unknown>),\n    logs: Array.isArray(logs) ? logs.map((log) => lowerCasedFacts(log, LOG)) : null,\n  };\n}\n\nconst BLOCK_TX = ['hash', 'from', 'nonce', 'to'] as const;\n\n/**\n * The consensus facts of a block read with its transactions to find the one that\n * consumed a nonce: the block's number and hash, and each transaction's hash, sender and\n * nonce, with the recipient and calldata that the token verdict reads.\n */\nexport function blockTransactionsKey(result: unknown): unknown {\n  if (result === null || typeof result !== 'object') return result;\n  const txs = (result as Record<string, unknown>).transactions;\n  return {\n    ...(lowerCasedFacts(result, ['number', 'hash']) as Record<string, unknown>),\n    transactions: Array.isArray(txs)\n      ? txs.map((tx) => txFacts(tx, BLOCK_TX, true))\n      : null,\n  };\n}\n\nconst NATIVE_READ: EvmCallTags = { purpose: 'read', retry: 'safe' };\nconst NATIVE_BROADCAST: EvmCallTags = {\n  purpose: 'broadcast',\n  retry: 'ambiguous-on-failure',\n};\n\n/**\n * The tags of a `crypto-aio/native` client's request: plain reads, except a broadcast, which\n * is one: a failure after the transport may have delivered it is `ambiguous`, never an\n * invitation to sign again with a new nonce.\n */\nexport const nativeTags = (method: string): EvmCallTags =>\n  method === 'eth_sendRawTransaction' ? NATIVE_BROADCAST : NATIVE_READ;\n\n/**\n * The consensus facts compared under a quorum, per JSON-RPC method. Node implementations\n * return extra or differently formatted fields (`size`, `totalDifficulty`, L2 extras), so a\n * quorum over whole objects would report disagreement where there is none.\n */\nexport function quorumKeyFor(method: string): ((result: unknown) => unknown) | undefined {\n  switch (method) {\n    case 'eth_getBlockByNumber':\n    case 'eth_getBlockByHash':\n      return (result) => pick(result as Json, BLOCK);\n    case 'eth_getTransactionReceipt':\n      return receiptKey;\n    case 'eth_getBlockReceipts':\n      return (result) => (Array.isArray(result) ? result.map(receiptKey) : result);\n    case 'eth_getTransactionByHash':\n      return (result) => txFacts(result, TX, false);\n    default:\n      return undefined;\n  }\n}\n\n/**\n * One JSON-RPC call through the transport, under the calling driver method's tags. A quorum\n * compares the caller's own `quorumKey` when it gives one, else the method's consensus\n * facts; a key never travels without a quorum.\n */\nexport function transportCall(\n  transport: Transport,\n  method: string,\n  params: unknown,\n  tags: EvmCallTags,\n): Promise<unknown> {\n  const { quorumKey: own, ...rest } = tags;\n  const quorumKey = rest.quorum !== undefined ? (own ?? quorumKeyFor(method)) : undefined;\n  return transport.rpc(method, params ?? [], {\n    ...rest,\n    ...(quorumKey ? { quorumKey } : {}),\n  });\n}\n\n/**\n * Runs `request` (an SDK call whose bridge ends in `call`) and, when its last transport call\n * failed, rethrows the transport's own error, never an SDK wrapper of it: web3 turns an\n * \"execution reverted\" error into a `ContractExecutionError`, which would lose the error's\n * code and ambiguity. A failure followed by a successful call is forgotten.\n */\nexport async function throughSdk<T>(\n  request: (call: (method: string, params: unknown) => Promise<unknown>) => Promise<T>,\n  transport: Transport,\n  tags: EvmCallTags,\n): Promise<T> {\n  let failure: { readonly error: unknown } | undefined;\n  const call = async (method: string, params: unknown): Promise<unknown> => {\n    try {\n      const result = await transportCall(transport, method, params, tags);\n      // Only a failure the SDK did not recover from may replace the SDK's own error.\n      failure = undefined;\n      return result;\n    } catch (error) {\n      failure = { error };\n      throw error;\n    }\n  };\n  try {\n    return await request(call);\n  } catch (error) {\n    throw failure ? failure.error : error;\n  }\n}\n"]}

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

@@ -0,0 +1,7 @@
+/**
+ * Well-known tokens: USDT and USDC where their issuers deploy them natively on
+ * a built-in mainnet (Tether's supported-protocols page, Circle's USDC addresses page).
+ * Addresses are EIP-55 checksummed; decimals are verified on each chain's explorer.
+ */
+import type { AssetRegistration } from '../../core/registry/assets';
+export declare const EVM_TOKENS: readonly AssetRegistration[];

package/dist/adapters/evm/tokens.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVM_TOKENS = void 0;
+function token(chain, symbol, contract) {
+    return {
+        chain,
+        network: 'mainnet',
+        ref: { standard: 'erc20', contract },
+        metadata: { symbol, decimals: 6 },
+        aliases: [symbol],
+    };
+}
+exports.EVM_TOKENS = [
+    token('ethereum', 'USDT', '0xdAC17F958D2ee523a2206206994597C13D831ec7'),
+    token('ethereum', 'USDC', '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'),
+    token('avalanche', 'USDT', '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7'),
+    token('avalanche', 'USDC', '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E'),
+    token('polygon', 'USDC', '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'),
+    token('arbitrum', 'USDC', '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'),
+    token('optimism', 'USDC', '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85'),
+    token('base', 'USDC', '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'),
+];
+//# sourceMappingURL=tokens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/adapters/evm/tokens.ts"],"names":[],"mappings":";;;AAOA,SAAS,KAAK,CACZ,KAAa,EACb,MAAuB,EACvB,QAAgB;IAEhB,OAAO;QACL,KAAK;QACL,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;QACpC,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;QACjC,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB,CAAC;AACJ,CAAC;AAEY,QAAA,UAAU,GAAiC;IACtD,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACvE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACvE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACxE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACxE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACtE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACvE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,4CAA4C,CAAC;IACvE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,4CAA4C,CAAC;CACpE,CAAC","sourcesContent":["/**\n * Well-known tokens: USDT and USDC where their issuers deploy them natively on\n * a built-in mainnet (Tether's supported-protocols page, Circle's USDC addresses page).\n * Addresses are EIP-55 checksummed; decimals are verified on each chain's explorer.\n */\nimport type { AssetRegistration } from '../../core/registry/assets';\n\nfunction token(\n  chain: string,\n  symbol: 'USDT' | 'USDC',\n  contract: string,\n): AssetRegistration {\n  return {\n    chain,\n    network: 'mainnet',\n    ref: { standard: 'erc20', contract },\n    metadata: { symbol, decimals: 6 },\n    aliases: [symbol],\n  };\n}\n\nexport const EVM_TOKENS: readonly AssetRegistration[] = [\n  token('ethereum', 'USDT', '0xdAC17F958D2ee523a2206206994597C13D831ec7'),\n  token('ethereum', 'USDC', '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'),\n  token('avalanche', 'USDT', '0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7'),\n  token('avalanche', 'USDC', '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E'),\n  token('polygon', 'USDC', '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'),\n  token('arbitrum', 'USDC', '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'),\n  token('optimism', 'USDC', '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85'),\n  token('base', 'USDC', '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'),\n];\n"]}

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

@@ -0,0 +1,255 @@
+/**
+ * SDK-free types of the EVM family: the `ext.evm` API, fee details and overrides, and the
+ * narrow `EvmClient` strategy that `EthersClient` and `Web3Client` implement.
+ * Nothing here imports an SDK, so the composition root can export these types.
+ */
+import type { DisposableNativeClient } from '../../core/driver/types';
+import type { CallOptions } from '../../core/transport/types';
+declare module '../../index' {
+    interface ChainRegistry {
+        ethereum: {
+            family: 'evm';
+            network: 'mainnet' | 'sepolia' | 'hoodi';
+        };
+        bsc: {
+            family: 'evm';
+            network: 'mainnet' | 'testnet';
+        };
+        polygon: {
+            family: 'evm';
+            network: 'mainnet' | 'amoy';
+        };
+        avalanche: {
+            family: 'evm';
+            network: 'mainnet' | 'fuji';
+        };
+        arbitrum: {
+            family: 'evm';
+            network: 'mainnet' | 'sepolia';
+        };
+        optimism: {
+            family: 'evm';
+            network: 'mainnet' | 'sepolia';
+        };
+        base: {
+            family: 'evm';
+            network: 'mainnet' | 'sepolia';
+        };
+    }
+    interface FamilyRegistry {
+        evm: {
+            library: 'ethers' | 'web3';
+            ext: EvmExt;
+            fee: EvmFeeDetails;
+        };
+    }
+}
+/** `bc.ext.evm`: the EVM family extension. */
+export interface EvmExt {
+    readonly evm: {
+        /** The account nonce at `latest` (default) or including the mempool (`pending`). */
+        getNonce(address: string, block?: 'latest' | 'pending'): Promise<bigint>;
+    };
+}
+/** `FeeEstimate.details` of the `evm-1559` and `evm-legacy` fee kinds (wei, gas units). */
+export interface EvmFeeDetails {
+    readonly gasLimit: bigint;
+    /** `evm-1559` only. */
+    readonly maxFeePerGas?: bigint;
+    /** `evm-1559` only. */
+    readonly maxPriorityFeePerGas?: bigint;
+    /** `evm-1559` only: the base fee the estimate expects for the next block. */
+    readonly baseFeePerGas?: bigint;
+    /** `evm-legacy` only. */
+    readonly gasPrice?: bigint;
+    /** OP Stack networks: the L1 data fee estimate, also charged as `l1-data`. */
+    readonly l1Fee?: bigint;
+    /** The expected total cost in wei; the `network` charge is its upper bound. */
+    readonly expected: bigint;
+}
+/**
+ * An explicit EVM fee (`TransferIntent.fee`). It must match the network's fee model:
+ * `evm-1559` networks take `{ maxFeePerGas, maxPriorityFeePerGas }`, `evm-legacy` networks
+ * take `{ gasPrice }`. `gasLimit` replaces the node's gas estimate.
+ */
+export type EvmFeeOverride = {
+    readonly maxFeePerGas: bigint;
+    readonly maxPriorityFeePerGas: bigint;
+    readonly gasLimit?: bigint;
+} | {
+    readonly gasPrice: bigint;
+    readonly gasLimit?: bigint;
+};
+/**
+ * The transport tags every EVM I/O call carries: purpose, retry, quorum, fanout,
+ * signal. Under a quorum, `quorumKey` replaces the method's consensus facts (`rpc.ts`) with
+ * the caller's own projection, e.g. a proof's finality attestation.
+ */
+export type EvmCallTags = Pick<CallOptions, 'purpose' | 'retry' | 'quorum' | 'quorumKey' | 'fanout' | 'signal'>;
+/** A block number or a JSON-RPC block tag. */
+export type EvmBlockTag = bigint | 'latest' | 'pending' | 'safe' | 'finalized';
+export interface EvmBlock {
+    readonly number: bigint;
+    readonly hash: string;
+    readonly parentHash: string;
+    readonly timestamp: number;
+    readonly baseFeePerGas?: bigint;
+    readonly transactions: readonly string[];
+}
+export interface EvmTx {
+    readonly hash: string;
+    readonly from: string;
+    readonly to: string | null;
+    readonly nonce: bigint;
+    readonly value: bigint;
+    readonly input: string;
+    readonly type: number;
+    readonly gasLimit: bigint;
+    readonly gasPrice?: bigint;
+    readonly maxFeePerGas?: bigint;
+    readonly maxPriorityFeePerGas?: bigint;
+    readonly blockHash: string | null;
+    readonly blockNumber: bigint | null;
+}
+export interface EvmFullBlock extends Omit<EvmBlock, 'transactions'> {
+    readonly transactions: readonly EvmTx[];
+    /** The block's 256-byte log bloom, when the node serves a well-formed one. */
+    readonly logsBloom?: string;
+}
+export interface EvmLog {
+    readonly address: string;
+    readonly topics: readonly string[];
+    readonly data: string;
+    readonly logIndex: number;
+    readonly blockHash: string;
+    readonly blockNumber: bigint;
+    readonly transactionHash: string;
+    readonly removed: boolean;
+}
+export interface EvmReceipt {
+    readonly transactionHash: string;
+    readonly blockHash: string;
+    readonly blockNumber: bigint;
+    readonly status: 0 | 1;
+    readonly from: string;
+    readonly to: string | null;
+    readonly contractAddress: string | null;
+    readonly gasUsed: bigint;
+    readonly effectiveGasPrice: bigint;
+    /** OP Stack receipts: the L1 data fee paid. */
+    readonly l1Fee?: bigint;
+    /** Arbitrum receipts: the part of `gasUsed` that paid for L1 data. */
+    readonly gasUsedForL1?: bigint;
+    readonly logs: readonly EvmLog[];
+}
+export interface EvmFeeHistory {
+    readonly oldestBlock: bigint;
+    /** One entry per block, plus the next block's base fee last. */
+    readonly baseFeePerGas: readonly bigint[];
+    /** Per block, the requested percentiles of the priority fees paid. */
+    readonly reward: readonly (readonly bigint[])[];
+    readonly gasUsedRatio: readonly number[];
+}
+export interface EvmCallRequest {
+    readonly from?: string;
+    readonly to: string;
+    readonly value?: bigint;
+    readonly data?: string;
+}
+interface EvmTxFieldsBase {
+    readonly chainId: bigint;
+    readonly nonce: bigint;
+    readonly to: string;
+    readonly value: bigint;
+    readonly data: string;
+    readonly gasLimit: bigint;
+}
+/** The fields of an unsigned transaction: EIP-1559 (type 2) or legacy with EIP-155. */
+export type EvmTxFields = EvmTxFieldsBase & ({
+    readonly type: 'eip1559';
+    readonly maxFeePerGas: bigint;
+    readonly maxPriorityFeePerGas: bigint;
+} | {
+    readonly type: 'legacy';
+    readonly gasPrice: bigint;
+});
+/** A secp256k1 signature: 32-byte `r` and `s` as 0x-hex, and the y parity (0 or 1). */
+export interface EvmSignature {
+    readonly r: string;
+    readonly s: string;
+    readonly yParity: 0 | 1;
+}
+/** ABI work for the ERC-20 calls and events the driver uses, done by the SDK. */
+export interface EvmAbi {
+    /** `keccak256("Transfer(address,address,uint256)")`. */
+    readonly transferTopic: string;
+    encodeTransfer(to: string, amount: bigint): string;
+    encodeBalanceOf(owner: string): string;
+    encodeDecimals(): string;
+    encodeSymbol(): string;
+    /** OP Stack `GasPriceOracle.getL1Fee(bytes)` over an unsigned serialized transaction. */
+    encodeGetL1Fee(unsignedTx: string): string;
+    /** Throws on data that is not one ABI `uint256` word. */
+    decodeUint256(data: string): bigint;
+    /** Throws on data that is not an ABI `string`. */
+    decodeString(data: string): string;
+    /** An ERC-20 `Transfer` log's parties and amount; `null` for any other log. */
+    decodeTransfer(log: {
+        readonly topics: readonly string[];
+        readonly data: string;
+    }): {
+        readonly from: string;
+        readonly to: string;
+        readonly amount: bigint;
+    } | null;
+}
+/**
+ * The EVM strategy: the SDK-specific part of the EVM driver. I/O methods take the call's
+ * transport tags and return plain data (bigint, hex strings, plain objects), never SDK
+ * objects, so any result can go into a store record; `null` means not found. Codec
+ * methods are synchronous.
+ */
+export interface EvmClient {
+    readonly library: string;
+    blockNumber(tags: EvmCallTags): Promise<bigint>;
+    getBalance(address: string, block: EvmBlockTag, tags: EvmCallTags): Promise<bigint>;
+    getTransactionCount(address: string, block: EvmBlockTag, tags: EvmCallTags): Promise<bigint>;
+    call(request: EvmCallRequest, block: EvmBlockTag, tags: EvmCallTags): Promise<string>;
+    estimateGas(request: EvmCallRequest, tags: EvmCallTags): Promise<bigint>;
+    gasPrice(tags: EvmCallTags): Promise<bigint>;
+    feeHistory(blockCount: number, newest: EvmBlockTag, percentiles: readonly number[], tags: EvmCallTags): Promise<EvmFeeHistory>;
+    /** By number or tag, or by hash when `block` is a 0x-prefixed 32-byte hash. */
+    getBlock(block: EvmBlockTag | string, tags: EvmCallTags): Promise<EvmBlock | null>;
+    getBlockWithTransactions(block: bigint, tags: EvmCallTags): Promise<EvmFullBlock | null>;
+    getTransaction(hash: string, tags: EvmCallTags): Promise<EvmTx | null>;
+    getReceipt(hash: string, tags: EvmCallTags): Promise<EvmReceipt | null>;
+    /**
+     * Every receipt of the block with this hash, in block order (`eth_getBlockReceipts`):
+     * read by block, so a node serves them without a transaction or log index. `null` for a
+     * block the node does not know.
+     */
+    getBlockReceipts(blockHash: string, tags: EvmCallTags): Promise<readonly EvmReceipt[] | null>;
+    getLogs(filter: {
+        readonly blockHash: string;
+        readonly topics: readonly (string | null)[];
+    }, tags: EvmCallTags): Promise<readonly EvmLog[]>;
+    /** Resolves with the transaction hash the node reports. */
+    sendRawTransaction(raw: string, tags: EvmCallTags): Promise<string>;
+    /** Strict: `0x` and 40 hex digits; mixed case must be a valid EIP-55 checksum. */
+    isAddress(value: string): boolean;
+    /** EIP-55 checksum form; throws on an invalid address. */
+    checksum(address: string): string;
+    /** From a 33-byte compressed or 65-byte uncompressed secp256k1 public key. */
+    addressFromPublicKey(publicKey: Uint8Array): string;
+    serializeUnsigned(tx: EvmTxFields): string;
+    /** The keccak-256 digest a signer signs. */
+    unsignedHash(tx: EvmTxFields): string;
+    serializeSigned(tx: EvmTxFields, signature: EvmSignature): {
+        readonly raw: string;
+        readonly hash: string;
+    };
+    readonly abi: EvmAbi;
+    /** A fresh SDK client on the same transport, for `crypto-aio/native`. */
+    createNative(): DisposableNativeClient;
+}
+export {};

package/dist/{type/account.js → adapters/evm/types.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=account.js.map
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/evm/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * SDK-free types of the EVM family: the `ext.evm` API, fee details and overrides, and the\n * narrow `EvmClient` strategy that `EthersClient` and `Web3Client` implement.\n * Nothing here imports an SDK, so the composition root can export these types.\n */\nimport type { DisposableNativeClient } from '../../core/driver/types';\nimport type { CallOptions } from '../../core/transport/types';\n\n// Augment the registries through the package entry, as users do with 'crypto-aio'.\ndeclare module '../../index' {\n  interface ChainRegistry {\n    ethereum: { family: 'evm'; network: 'mainnet' | 'sepolia' | 'hoodi' };\n    bsc: { family: 'evm'; network: 'mainnet' | 'testnet' };\n    polygon: { family: 'evm'; network: 'mainnet' | 'amoy' };\n    avalanche: { family: 'evm'; network: 'mainnet' | 'fuji' };\n    arbitrum: { family: 'evm'; network: 'mainnet' | 'sepolia' };\n    optimism: { family: 'evm'; network: 'mainnet' | 'sepolia' };\n    base: { family: 'evm'; network: 'mainnet' | 'sepolia' };\n  }\n  interface FamilyRegistry {\n    evm: { library: 'ethers' | 'web3'; ext: EvmExt; fee: EvmFeeDetails };\n  }\n}\n\n/** `bc.ext.evm`: the EVM family extension. */\nexport interface EvmExt {\n  readonly evm: {\n    /** The account nonce at `latest` (default) or including the mempool (`pending`). */\n    getNonce(address: string, block?: 'latest' | 'pending'): Promise<bigint>;\n  };\n}\n\n/** `FeeEstimate.details` of the `evm-1559` and `evm-legacy` fee kinds (wei, gas units). */\nexport interface EvmFeeDetails {\n  readonly gasLimit: bigint;\n  /** `evm-1559` only. */\n  readonly maxFeePerGas?: bigint;\n  /** `evm-1559` only. */\n  readonly maxPriorityFeePerGas?: bigint;\n  /** `evm-1559` only: the base fee the estimate expects for the next block. */\n  readonly baseFeePerGas?: bigint;\n  /** `evm-legacy` only. */\n  readonly gasPrice?: bigint;\n  /** OP Stack networks: the L1 data fee estimate, also charged as `l1-data`. */\n  readonly l1Fee?: bigint;\n  /** The expected total cost in wei; the `network` charge is its upper bound. */\n  readonly expected: bigint;\n}\n\n/**\n * An explicit EVM fee (`TransferIntent.fee`). It must match the network's fee model:\n * `evm-1559` networks take `{ maxFeePerGas, maxPriorityFeePerGas }`, `evm-legacy` networks\n * take `{ gasPrice }`. `gasLimit` replaces the node's gas estimate.\n */\nexport type EvmFeeOverride =\n  | {\n      readonly maxFeePerGas: bigint;\n      readonly maxPriorityFeePerGas: bigint;\n      readonly gasLimit?: bigint;\n    }\n  | { readonly gasPrice: bigint; readonly gasLimit?: bigint };\n\n/**\n * The transport tags every EVM I/O call carries: purpose, retry, quorum, fanout,\n * signal. Under a quorum, `quorumKey` replaces the method's consensus facts (`rpc.ts`) with\n * the caller's own projection, e.g. a proof's finality attestation.\n */\nexport type EvmCallTags = Pick<\n  CallOptions,\n  'purpose' | 'retry' | 'quorum' | 'quorumKey' | 'fanout' | 'signal'\n>;\n\n/** A block number or a JSON-RPC block tag. */\nexport type EvmBlockTag = bigint | 'latest' | 'pending' | 'safe' | 'finalized';\n\nexport interface EvmBlock {\n  readonly number: bigint;\n  readonly hash: string;\n  readonly parentHash: string;\n  readonly timestamp: number;\n  readonly baseFeePerGas?: bigint;\n  readonly transactions: readonly string[];\n}\n\nexport interface EvmTx {\n  readonly hash: string;\n  readonly from: string;\n  readonly to: string | null;\n  readonly nonce: bigint;\n  readonly value: bigint;\n  readonly input: string;\n  readonly type: number;\n  readonly gasLimit: bigint;\n  readonly gasPrice?: bigint;\n  readonly maxFeePerGas?: bigint;\n  readonly maxPriorityFeePerGas?: bigint;\n  readonly blockHash: string | null;\n  readonly blockNumber: bigint | null;\n}\n\nexport interface EvmFullBlock extends Omit<EvmBlock, 'transactions'> {\n  readonly transactions: readonly EvmTx[];\n  /** The block's 256-byte log bloom, when the node serves a well-formed one. */\n  readonly logsBloom?: string;\n}\n\nexport interface EvmLog {\n  readonly address: string;\n  readonly topics: readonly string[];\n  readonly data: string;\n  readonly logIndex: number;\n  readonly blockHash: string;\n  readonly blockNumber: bigint;\n  readonly transactionHash: string;\n  readonly removed: boolean;\n}\n\nexport interface EvmReceipt {\n  readonly transactionHash: string;\n  readonly blockHash: string;\n  readonly blockNumber: bigint;\n  readonly status: 0 | 1;\n  readonly from: string;\n  readonly to: string | null;\n  readonly contractAddress: string | null;\n  readonly gasUsed: bigint;\n  readonly effectiveGasPrice: bigint;\n  /** OP Stack receipts: the L1 data fee paid. */\n  readonly l1Fee?: bigint;\n  /** Arbitrum receipts: the part of `gasUsed` that paid for L1 data. */\n  readonly gasUsedForL1?: bigint;\n  readonly logs: readonly EvmLog[];\n}\n\nexport interface EvmFeeHistory {\n  readonly oldestBlock: bigint;\n  /** One entry per block, plus the next block's base fee last. */\n  readonly baseFeePerGas: readonly bigint[];\n  /** Per block, the requested percentiles of the priority fees paid. */\n  readonly reward: readonly (readonly bigint[])[];\n  readonly gasUsedRatio: readonly number[];\n}\n\nexport interface EvmCallRequest {\n  readonly from?: string;\n  readonly to: string;\n  readonly value?: bigint;\n  readonly data?: string;\n}\n\ninterface EvmTxFieldsBase {\n  readonly chainId: bigint;\n  readonly nonce: bigint;\n  readonly to: string;\n  readonly value: bigint;\n  readonly data: string;\n  readonly gasLimit: bigint;\n}\n\n/** The fields of an unsigned transaction: EIP-1559 (type 2) or legacy with EIP-155. */\nexport type EvmTxFields = EvmTxFieldsBase &\n  (\n    | {\n        readonly type: 'eip1559';\n        readonly maxFeePerGas: bigint;\n        readonly maxPriorityFeePerGas: bigint;\n      }\n    | { readonly type: 'legacy'; readonly gasPrice: bigint }\n  );\n\n/** A secp256k1 signature: 32-byte `r` and `s` as 0x-hex, and the y parity (0 or 1). */\nexport interface EvmSignature {\n  readonly r: string;\n  readonly s: string;\n  readonly yParity: 0 | 1;\n}\n\n/** ABI work for the ERC-20 calls and events the driver uses, done by the SDK. */\nexport interface EvmAbi {\n  /** `keccak256(\"Transfer(address,address,uint256)\")`. */\n  readonly transferTopic: string;\n  encodeTransfer(to: string, amount: bigint): string;\n  encodeBalanceOf(owner: string): string;\n  encodeDecimals(): string;\n  encodeSymbol(): string;\n  /** OP Stack `GasPriceOracle.getL1Fee(bytes)` over an unsigned serialized transaction. */\n  encodeGetL1Fee(unsignedTx: string): string;\n  /** Throws on data that is not one ABI `uint256` word. */\n  decodeUint256(data: string): bigint;\n  /** Throws on data that is not an ABI `string`. */\n  decodeString(data: string): string;\n  /** An ERC-20 `Transfer` log's parties and amount; `null` for any other log. */\n  decodeTransfer(log: {\n    readonly topics: readonly string[];\n    readonly data: string;\n  }): { readonly from: string; readonly to: string; readonly amount: bigint } | null;\n}\n\n/**\n * The EVM strategy: the SDK-specific part of the EVM driver. I/O methods take the call's\n * transport tags and return plain data (bigint, hex strings, plain objects), never SDK\n * objects, so any result can go into a store record; `null` means not found. Codec\n * methods are synchronous.\n */\nexport interface EvmClient {\n  readonly library: string;\n  blockNumber(tags: EvmCallTags): Promise<bigint>;\n  getBalance(address: string, block: EvmBlockTag, tags: EvmCallTags): Promise<bigint>;\n  getTransactionCount(\n    address: string,\n    block: EvmBlockTag,\n    tags: EvmCallTags,\n  ): Promise<bigint>;\n  call(request: EvmCallRequest, block: EvmBlockTag, tags: EvmCallTags): Promise<string>;\n  estimateGas(request: EvmCallRequest, tags: EvmCallTags): Promise<bigint>;\n  gasPrice(tags: EvmCallTags): Promise<bigint>;\n  feeHistory(\n    blockCount: number,\n    newest: EvmBlockTag,\n    percentiles: readonly number[],\n    tags: EvmCallTags,\n  ): Promise<EvmFeeHistory>;\n  /** By number or tag, or by hash when `block` is a 0x-prefixed 32-byte hash. */\n  getBlock(block: EvmBlockTag | string, tags: EvmCallTags): Promise<EvmBlock | null>;\n  getBlockWithTransactions(\n    block: bigint,\n    tags: EvmCallTags,\n  ): Promise<EvmFullBlock | null>;\n  getTransaction(hash: string, tags: EvmCallTags): Promise<EvmTx | null>;\n  getReceipt(hash: string, tags: EvmCallTags): Promise<EvmReceipt | null>;\n  /**\n   * Every receipt of the block with this hash, in block order (`eth_getBlockReceipts`):\n   * read by block, so a node serves them without a transaction or log index. `null` for a\n   * block the node does not know.\n   */\n  getBlockReceipts(\n    blockHash: string,\n    tags: EvmCallTags,\n  ): Promise<readonly EvmReceipt[] | null>;\n  getLogs(\n    filter: { readonly blockHash: string; readonly topics: readonly (string | null)[] },\n    tags: EvmCallTags,\n  ): Promise<readonly EvmLog[]>;\n  /** Resolves with the transaction hash the node reports. */\n  sendRawTransaction(raw: string, tags: EvmCallTags): Promise<string>;\n  /** Strict: `0x` and 40 hex digits; mixed case must be a valid EIP-55 checksum. */\n  isAddress(value: string): boolean;\n  /** EIP-55 checksum form; throws on an invalid address. */\n  checksum(address: string): string;\n  /** From a 33-byte compressed or 65-byte uncompressed secp256k1 public key. */\n  addressFromPublicKey(publicKey: Uint8Array): string;\n  serializeUnsigned(tx: EvmTxFields): string;\n  /** The keccak-256 digest a signer signs. */\n  unsignedHash(tx: EvmTxFields): string;\n  serializeSigned(\n    tx: EvmTxFields,\n    signature: EvmSignature,\n  ): { readonly raw: string; readonly hash: string };\n  readonly abi: EvmAbi;\n  /** A fresh SDK client on the same transport, for `crypto-aio/native`. */\n  createNative(): DisposableNativeClient;\n}\n"]}

package/dist/adapters/evm/web3-client.d.ts

@@ -0,0 +1,23 @@
+import type { DisposableNativeClient } from '../../core/driver/types';
+import type { Transport } from '../../core/transport/types';
+import { EvmClientBase } from './client';
+import type { EvmAbi, EvmCallTags, EvmSignature, EvmTxFields } from './types';
+export declare class Web3Client extends EvmClientBase {
+    #private;
+    readonly library = "web3";
+    readonly abi: EvmAbi;
+    constructor(transport: Transport, chainId: bigint);
+    protected send(method: string, params: readonly unknown[], tags: EvmCallTags): Promise<unknown>;
+    isAddress(value: string): boolean;
+    checksum(address: string): string;
+    addressFromPublicKey(publicKey: Uint8Array): string;
+    protected encodeUnsigned(tx: EvmTxFields): string;
+    protected hashUnsigned(tx: EvmTxFields): string;
+    protected encodeSigned(tx: EvmTxFields, signature: EvmSignature): {
+        raw: string;
+        hash: string;
+    };
+    createNative(): DisposableNativeClient;
+}
+/** The `web3` adapter's driver factory; the manifest's `load()` returns it. */
+export declare const web3DriverFactory: import("../../core/driver/types").DriverFactory;