crypto-aio 0.0.3 → 0.2.0

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,10 @@
+/**
+ * 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.
+ * Ethereum's USDT is Tether's `TetherToken`, which can deprecate itself for an upgraded
+ * contract; the builder then refuses its transfers (`ASSET_RESOLUTION`) until the alias
+ * moves.
+ */
+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":";;;AAUA,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 * Ethereum's USDT is Tether's `TetherToken`, which can deprecate itself for an upgraded\n * contract; the builder then refuses its transfers (`ASSET_RESOLUTION`) until the alias\n * moves.\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,265 @@
+/**
+ * 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;
+    /**
+     * OP Stack networks since Isthmus, where it is not zero: the operator fee for the whole
+     * gas limit (an upper bound at the chain's current operator settings), also charged as
+     * `operator`.
+     */
+    readonly operatorFee?: 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;
+    /** `deprecated()`, which Tether's `TetherToken` answers `true` once it forwards transfers. */
+    encodeDeprecated(): string;
+    /** OP Stack `GasPriceOracle.getL1Fee(bytes)` over an unsigned serialized transaction. */
+    encodeGetL1Fee(unsignedTx: string): string;
+    /** OP Stack `GasPriceOracle.getOperatorFee(uint256)` for `gasUsed` (since Isthmus). */
+    encodeGetOperatorFee(gasUsed: bigint): 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  /**\n   * OP Stack networks since Isthmus, where it is not zero: the operator fee for the whole\n   * gas limit (an upper bound at the chain's current operator settings), also charged as\n   * `operator`.\n   */\n  readonly operatorFee?: 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  /** `deprecated()`, which Tether's `TetherToken` answers `true` once it forwards transfers. */\n  encodeDeprecated(): string;\n  /** OP Stack `GasPriceOracle.getL1Fee(bytes)` over an unsigned serialized transaction. */\n  encodeGetL1Fee(unsignedTx: string): string;\n  /** OP Stack `GasPriceOracle.getOperatorFee(uint256)` for `gasUsed` (since Isthmus). */\n  encodeGetOperatorFee(gasUsed: bigint): 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,26 @@
+import type { DisposableNativeClient, DriverFactory } 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 strategy's factory: its first driver in a process warns, once, that the library
+ * is deprecated (a Node.js `DeprecationWarning`, code `CRYPTO_AIO_WEB3`).
+ */
+export declare const web3DriverFactory: DriverFactory;