crypto-aio 0.0.3 → 0.2.0

package/dist/adapters/evm/chains.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVM_CHAINS = void 0;
+const freeze_1 = require("../../core/util/freeze");
+const FINALIZED_TAG = {
+    kind: 'tag',
+    tag: 'finalized',
+    fallbackConfirmations: 128,
+};
+function evmNetwork(chain, spec) {
+    return {
+        id: spec.id,
+        identity: String(spec.chainId),
+        testnet: spec.testnet,
+        feeModel: chain.feeModel,
+        finality: chain.finality ?? FINALIZED_TAG,
+        defaultConfirmations: 1,
+        reorgWindow: 128,
+        ...(spec.maxLagBlocks !== undefined ? { maxLagBlocks: spec.maxLagBlocks } : {}),
+        ...(spec.explorer !== undefined
+            ? {
+                explorer: {
+                    tx: `${spec.explorer}/tx/{id}`,
+                    address: `${spec.explorer}/address/{address}`,
+                },
+            }
+            : {}),
+        ...(chain.replacement === false ? {} : { replacement: { minBumpPercent: 10 } }),
+        ...(chain.remove ? { capabilities: { remove: chain.remove } } : {}),
+        ...(chain.params || spec.params
+            ? { params: { ...chain.params, ...spec.params } }
+            : {}),
+    };
+}
+function evmChain(spec) {
+    return {
+        id: spec.id,
+        family: 'evm',
+        model: 'account',
+        ordering: 'nonce',
+        schemes: ['secp256k1-ecdsa'],
+        nativeAsset: { symbol: spec.symbol, decimals: 18, name: spec.name },
+        defaultNetwork: 'mainnet',
+        networks: Object.fromEntries(spec.networks.map((n) => [n.id, evmNetwork(spec, n)])),
+    };
+}
+const OP_STACK = { l1DataFee: 'op-stack' };
+/**
+ * Frozen all the way down, as `BUILTIN_SCHEMES` is: networks share `FINALIZED_TAG`, and a
+ * chain's networks share its `remove` list, so no caller may change them.
+ */
+exports.EVM_CHAINS = (0, freeze_1.deepFreeze)([
+    evmChain({
+        id: 'ethereum',
+        symbol: 'ETH',
+        name: 'Ether',
+        feeModel: 'evm-1559',
+        networks: [
+            { id: 'mainnet', chainId: 1, testnet: false, explorer: 'https://etherscan.io' },
+            {
+                id: 'sepolia',
+                chainId: 11155111,
+                testnet: true,
+                explorer: 'https://sepolia.etherscan.io',
+            },
+            {
+                id: 'hoodi',
+                chainId: 560048,
+                testnet: true,
+                explorer: 'https://hoodi.etherscan.io',
+            },
+        ],
+    }),
+    evmChain({
+        id: 'bsc',
+        symbol: 'BNB',
+        name: 'BNB',
+        // BEP-226: type-2 transactions are accepted, but the base fee is always 0.
+        feeModel: 'evm-legacy',
+        remove: ['fee-market-1559'],
+        networks: [
+            {
+                id: 'mainnet',
+                chainId: 56,
+                testnet: false,
+                explorer: 'https://bscscan.com',
+                maxLagBlocks: 134,
+            },
+            {
+                id: 'testnet',
+                chainId: 97,
+                testnet: true,
+                explorer: 'https://testnet.bscscan.com',
+            },
+        ],
+    }),
+    evmChain({
+        id: 'polygon',
+        symbol: 'POL',
+        name: 'POL',
+        feeModel: 'evm-1559',
+        // bor, Polygon PoS's client, adds system logs to receipts.
+        params: { systemLogs: 'bor' },
+        networks: [
+            {
+                id: 'mainnet',
+                chainId: 137,
+                testnet: false,
+                explorer: 'https://polygonscan.com',
+                // The Polygon Gas Station docs: mainnet requires a 25 gwei priority fee.
+                params: { minPriorityFeePerGas: 25000000000n },
+            },
+            {
+                id: 'amoy',
+                chainId: 80002,
+                testnet: true,
+                explorer: 'https://amoy.polygonscan.com',
+            },
+        ],
+    }),
+    evmChain({
+        id: 'avalanche',
+        symbol: 'AVAX',
+        name: 'Avalanche',
+        feeModel: 'evm-1559',
+        // The C-Chain's `latest` block is final (accepted); it has no deeper finality to wait for.
+        finality: { kind: 'confirmations', confirmations: 1 },
+        remove: ['finality-tag'],
+        networks: [
+            { id: 'mainnet', chainId: 43114, testnet: false },
+            { id: 'fuji', chainId: 43113, testnet: true },
+        ],
+    }),
+    evmChain({
+        id: 'arbitrum',
+        symbol: 'ETH',
+        name: 'Ether',
+        feeModel: 'evm-1559',
+        // No mempool: the sequencer runs transactions first come, first served.
+        replacement: false,
+        remove: ['replace-fee', 'cancel'],
+        networks: [
+            {
+                id: 'mainnet',
+                chainId: 42161,
+                testnet: false,
+                explorer: 'https://arbiscan.io',
+                maxLagBlocks: 240,
+            },
+            {
+                id: 'sepolia',
+                chainId: 421614,
+                testnet: true,
+                explorer: 'https://sepolia.arbiscan.io',
+            },
+        ],
+    }),
+    evmChain({
+        id: 'optimism',
+        symbol: 'ETH',
+        name: 'Ether',
+        feeModel: 'evm-1559',
+        params: OP_STACK,
+        networks: [
+            {
+                id: 'mainnet',
+                chainId: 10,
+                testnet: false,
+                explorer: 'https://explorer.optimism.io',
+                maxLagBlocks: 30,
+            },
+            {
+                id: 'sepolia',
+                chainId: 11155420,
+                testnet: true,
+                explorer: 'https://testnet-explorer.optimism.io',
+            },
+        ],
+    }),
+    evmChain({
+        id: 'base',
+        symbol: 'ETH',
+        name: 'Ether',
+        feeModel: 'evm-1559',
+        params: OP_STACK,
+        networks: [
+            {
+                id: 'mainnet',
+                chainId: 8453,
+                testnet: false,
+                explorer: 'https://basescan.org',
+                maxLagBlocks: 30,
+            },
+            {
+                id: 'sepolia',
+                chainId: 84532,
+                testnet: true,
+                explorer: 'https://sepolia.basescan.org',
+            },
+        ],
+    }),
+]);
+//# sourceMappingURL=chains.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/adapters/evm/chains.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Built-in EVM chains and networks. Every value is verified against the chain's own\n * documentation or its EIP, or is a documented library policy; what could not be verified\n * (an Avalanche explorer, most testnets' block times) is left out:\n * - `defaultConfirmations: 1`: `waitForConfirmation` waits for inclusion by default;\n *   credit deposits on `final`.\n * - `reorgWindow: 128` and `fallbackConfirmations: 128`: the library's scanner window. The\n *   EVM driver never falls back from the `finalized` tag to confirmations.\n * - `maxLagBlocks`: about 60 seconds of blocks, only where the block time is verified.\n * - `replacement.minBumpPercent: 10`: the spec's default (geth's `--txpool.pricebump`).\n */\nimport type { KnownCapability } from '../../core/model/capability';\nimport type { ChainInfo, FinalityPolicy, NetworkInfo } from '../../core/model/chain';\nimport { deepFreeze } from '../../core/util/freeze';\n\nconst FINALIZED_TAG: FinalityPolicy = {\n  kind: 'tag',\n  tag: 'finalized',\n  fallbackConfirmations: 128,\n};\n\ninterface NetworkSpec {\n  readonly id: string;\n  readonly chainId: number;\n  readonly testnet: boolean;\n  readonly explorer?: string;\n  readonly maxLagBlocks?: number;\n  readonly params?: Readonly<Record<string, unknown>>;\n}\n\ninterface ChainSpec {\n  readonly id: string;\n  readonly symbol: string;\n  readonly name: string;\n  readonly feeModel: 'evm-1559' | 'evm-legacy';\n  readonly finality?: FinalityPolicy;\n  /** Network capabilities removed from the EVM manifests' list. */\n  readonly remove?: readonly KnownCapability[];\n  /** `false` on chains without a mempool to replace transactions in (Arbitrum). */\n  readonly replacement?: boolean;\n  readonly params?: Readonly<Record<string, unknown>>;\n  readonly networks: readonly NetworkSpec[];\n}\n\nfunction evmNetwork(chain: ChainSpec, spec: NetworkSpec): NetworkInfo {\n  return {\n    id: spec.id,\n    identity: String(spec.chainId),\n    testnet: spec.testnet,\n    feeModel: chain.feeModel,\n    finality: chain.finality ?? FINALIZED_TAG,\n    defaultConfirmations: 1,\n    reorgWindow: 128,\n    ...(spec.maxLagBlocks !== undefined ? { maxLagBlocks: spec.maxLagBlocks } : {}),\n    ...(spec.explorer !== undefined\n      ? {\n          explorer: {\n            tx: `${spec.explorer}/tx/{id}`,\n            address: `${spec.explorer}/address/{address}`,\n          },\n        }\n      : {}),\n    ...(chain.replacement === false ? {} : { replacement: { minBumpPercent: 10 } }),\n    ...(chain.remove ? { capabilities: { remove: chain.remove } } : {}),\n    ...(chain.params || spec.params\n      ? { params: { ...chain.params, ...spec.params } }\n      : {}),\n  };\n}\n\nfunction evmChain(spec: ChainSpec): ChainInfo {\n  return {\n    id: spec.id,\n    family: 'evm',\n    model: 'account',\n    ordering: 'nonce',\n    schemes: ['secp256k1-ecdsa'],\n    nativeAsset: { symbol: spec.symbol, decimals: 18, name: spec.name },\n    defaultNetwork: 'mainnet',\n    networks: Object.fromEntries(spec.networks.map((n) => [n.id, evmNetwork(spec, n)])),\n  };\n}\n\nconst OP_STACK = { l1DataFee: 'op-stack' } as const;\n\n/**\n * Frozen all the way down, as `BUILTIN_SCHEMES` is: networks share `FINALIZED_TAG`, and a\n * chain's networks share its `remove` list, so no caller may change them.\n */\nexport const EVM_CHAINS: readonly ChainInfo[] = deepFreeze([\n  evmChain({\n    id: 'ethereum',\n    symbol: 'ETH',\n    name: 'Ether',\n    feeModel: 'evm-1559',\n    networks: [\n      { id: 'mainnet', chainId: 1, testnet: false, explorer: 'https://etherscan.io' },\n      {\n        id: 'sepolia',\n        chainId: 11155111,\n        testnet: true,\n        explorer: 'https://sepolia.etherscan.io',\n      },\n      {\n        id: 'hoodi',\n        chainId: 560048,\n        testnet: true,\n        explorer: 'https://hoodi.etherscan.io',\n      },\n    ],\n  }),\n  evmChain({\n    id: 'bsc',\n    symbol: 'BNB',\n    name: 'BNB',\n    // BEP-226: type-2 transactions are accepted, but the base fee is always 0.\n    feeModel: 'evm-legacy',\n    remove: ['fee-market-1559'],\n    networks: [\n      {\n        id: 'mainnet',\n        chainId: 56,\n        testnet: false,\n        explorer: 'https://bscscan.com',\n        maxLagBlocks: 134,\n      },\n      {\n        id: 'testnet',\n        chainId: 97,\n        testnet: true,\n        explorer: 'https://testnet.bscscan.com',\n      },\n    ],\n  }),\n  evmChain({\n    id: 'polygon',\n    symbol: 'POL',\n    name: 'POL',\n    feeModel: 'evm-1559',\n    // bor, Polygon PoS's client, adds system logs to receipts.\n    params: { systemLogs: 'bor' },\n    networks: [\n      {\n        id: 'mainnet',\n        chainId: 137,\n        testnet: false,\n        explorer: 'https://polygonscan.com',\n        // The Polygon Gas Station docs: mainnet requires a 25 gwei priority fee.\n        params: { minPriorityFeePerGas: 25_000_000_000n },\n      },\n      {\n        id: 'amoy',\n        chainId: 80002,\n        testnet: true,\n        explorer: 'https://amoy.polygonscan.com',\n      },\n    ],\n  }),\n  evmChain({\n    id: 'avalanche',\n    symbol: 'AVAX',\n    name: 'Avalanche',\n    feeModel: 'evm-1559',\n    // The C-Chain's `latest` block is final (accepted); it has no deeper finality to wait for.\n    finality: { kind: 'confirmations', confirmations: 1 },\n    remove: ['finality-tag'],\n    networks: [\n      { id: 'mainnet', chainId: 43114, testnet: false },\n      { id: 'fuji', chainId: 43113, testnet: true },\n    ],\n  }),\n  evmChain({\n    id: 'arbitrum',\n    symbol: 'ETH',\n    name: 'Ether',\n    feeModel: 'evm-1559',\n    // No mempool: the sequencer runs transactions first come, first served.\n    replacement: false,\n    remove: ['replace-fee', 'cancel'],\n    networks: [\n      {\n        id: 'mainnet',\n        chainId: 42161,\n        testnet: false,\n        explorer: 'https://arbiscan.io',\n        maxLagBlocks: 240,\n      },\n      {\n        id: 'sepolia',\n        chainId: 421614,\n        testnet: true,\n        explorer: 'https://sepolia.arbiscan.io',\n      },\n    ],\n  }),\n  evmChain({\n    id: 'optimism',\n    symbol: 'ETH',\n    name: 'Ether',\n    feeModel: 'evm-1559',\n    params: OP_STACK,\n    networks: [\n      {\n        id: 'mainnet',\n        chainId: 10,\n        testnet: false,\n        explorer: 'https://explorer.optimism.io',\n        maxLagBlocks: 30,\n      },\n      {\n        id: 'sepolia',\n        chainId: 11155420,\n        testnet: true,\n        explorer: 'https://testnet-explorer.optimism.io',\n      },\n    ],\n  }),\n  evmChain({\n    id: 'base',\n    symbol: 'ETH',\n    name: 'Ether',\n    feeModel: 'evm-1559',\n    params: OP_STACK,\n    networks: [\n      {\n        id: 'mainnet',\n        chainId: 8453,\n        testnet: false,\n        explorer: 'https://basescan.org',\n        maxLagBlocks: 30,\n      },\n      {\n        id: 'sepolia',\n        chainId: 84532,\n        testnet: true,\n        explorer: 'https://sepolia.basescan.org',\n      },\n    ],\n  }),\n]);\n"]}

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

@@ -0,0 +1,84 @@
+import type { DisposableNativeClient } from '../../core/driver/types';
+import type { EvmAbi, EvmBlock, EvmBlockTag, EvmCallRequest, EvmCallTags, EvmClient, EvmFeeHistory, EvmFullBlock, EvmLog, EvmReceipt, EvmSignature, EvmTx, EvmTxFields } from './types';
+/** `0x` and 40 hex digits; the checksum is the SDK's to check. */
+export declare const ADDRESS: RegExp;
+/**
+ * The 65-byte uncompressed form of a secp256k1 public key, accepted only as a 33-byte
+ * compressed key (`0x02`/`0x03`) or a 65-byte `0x04` key that decodes to a point on the
+ * curve. Both clients derive addresses from its result, never from the caller's bytes: an
+ * SDK may read 32 bytes as a *private* key or 64 bytes as an unprefixed public key, and
+ * either would yield an address nobody holds the key to. The error never echoes the input.
+ */
+export declare function uncompressedPublicKey(publicKey: Uint8Array): Uint8Array;
+/**
+ * A JSON-RPC quantity (`0x` and hex digits) as a bigint. Anything else throws a retryable
+ * `PROVIDER_UNAVAILABLE` naming `field`: the one check of every hex quantity the driver
+ * reads, quorum keys and health probes included (a key that throws is a disagreement).
+ */
+export declare function quantity(value: unknown, field: string): bigint;
+/** One ABI word: 32 bytes. */
+export declare const ABI_WORD: RegExp;
+/** An ABI-encoded address: 12 zero bytes, then 20 address bytes. */
+export declare const ADDRESS_WORD: RegExp;
+/**
+ * The three ABI words of an ERC-20 `Transfer` log (`from`, `to`, amount), or `null`. Anyone
+ * can emit a look-alike event: anything but the topic and three well-formed words is not a
+ * transfer, and never an error that would fail a whole block scan.
+ */
+export declare function transferLogWords(log: {
+    readonly topics: readonly string[];
+    readonly data: string;
+}, topic: string): {
+    readonly from: string;
+    readonly to: string;
+    readonly data: string;
+} | null;
+export declare function blockParam(block: EvmBlockTag): string;
+export declare abstract class EvmClientBase implements EvmClient {
+    #private;
+    abstract readonly library: string;
+    abstract readonly abi: EvmAbi;
+    /** The chain id of the network this client serves. */
+    protected readonly chainId: bigint;
+    constructor(chainId: bigint);
+    /** One JSON-RPC request through the SDK's bridge, under `tags`; resolves with `result`. */
+    protected abstract send(method: string, params: readonly unknown[], tags: EvmCallTags): Promise<unknown>;
+    abstract isAddress(value: string): boolean;
+    abstract checksum(address: string): string;
+    abstract addressFromPublicKey(publicKey: Uint8Array): string;
+    abstract createNative(): DisposableNativeClient;
+    /** The SDK codec, reached only through the chain-id guard below. */
+    protected abstract encodeUnsigned(tx: EvmTxFields): string;
+    protected abstract hashUnsigned(tx: EvmTxFields): string;
+    protected abstract encodeSigned(tx: EvmTxFields, signature: EvmSignature): {
+        readonly raw: string;
+        readonly hash: string;
+    };
+    serializeUnsigned(tx: EvmTxFields): string;
+    unsignedHash(tx: EvmTxFields): string;
+    serializeSigned(tx: EvmTxFields, signature: EvmSignature): {
+        readonly raw: string;
+        readonly hash: string;
+    };
+    /** Runs the SDK's checksum; `INVALID_ADDRESS` for anything but a valid hex address. */
+    protected checked(address: string, checksum: (value: string) => string): 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>;
+    getBlock(block: EvmBlockTag | string, tags: EvmCallTags): Promise<EvmBlock | null>;
+    getBlockWithTransactions(block: bigint, tags: EvmCallTags): Promise<EvmFullBlock | null>;
+    /** An answer about another transaction is malformed, never another's facts. */
+    getTransaction(txHash: string, tags: EvmCallTags): Promise<EvmTx | null>;
+    /** An answer about another transaction is malformed, never another's receipt. */
+    getReceipt(txHash: string, tags: EvmCallTags): Promise<EvmReceipt | null>;
+    getBlockReceipts(blockHash: string, tags: EvmCallTags): Promise<readonly EvmReceipt[] | null>;
+    getLogs(filter: {
+        readonly blockHash: string;
+        readonly topics: readonly (string | null)[];
+    }, tags: EvmCallTags): Promise<readonly EvmLog[]>;
+    sendRawTransaction(raw: string, tags: EvmCallTags): Promise<string>;
+}

package/dist/adapters/evm/client.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvmClientBase = exports.ADDRESS_WORD = exports.ABI_WORD = exports.ADDRESS = void 0;
+exports.uncompressedPublicKey = uncompressedPublicKey;
+exports.quantity = quantity;
+exports.transferLogWords = transferLogWords;
+exports.blockParam = blockParam;
+/**
+ * The SDK-free half of every `EvmClient`: the JSON-RPC methods the driver calls and the
+ * normalization of their answers into plain data. A subclass supplies the SDK half: the
+ * `send` bridge (the SDK's own JSON-RPC primitive, wired to the transport) and the codec.
+ *
+ * I/O never uses an SDK's high-level helpers: those
+ * issue extra calls under the wrong tags (ethers `broadcastTransaction` also reads the block
+ * number; `getTransactionReceipt` may fetch the transaction), throw on not-found (web3
+ * `TransactionNotFound`) or drop chain fields the fees need (OP `l1Fee`, Arbitrum
+ * `gasUsedForL1`). So one driver call is exactly one tagged JSON-RPC request.
+ */
+const secp256k1_1 = require("@noble/curves/secp256k1");
+const error_1 = require("../../core/errors/error");
+/** `0x` and 40 hex digits; the checksum is the SDK's to check. */
+exports.ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+/**
+ * The 65-byte uncompressed form of a secp256k1 public key, accepted only as a 33-byte
+ * compressed key (`0x02`/`0x03`) or a 65-byte `0x04` key that decodes to a point on the
+ * curve. Both clients derive addresses from its result, never from the caller's bytes: an
+ * SDK may read 32 bytes as a *private* key or 64 bytes as an unprefixed public key, and
+ * either would yield an address nobody holds the key to. The error never echoes the input.
+ */
+function uncompressedPublicKey(publicKey) {
+    const prefix = publicKey instanceof Uint8Array ? publicKey[0] : undefined;
+    const shaped = ((prefix === 0x02 || prefix === 0x03) && publicKey.length === 33) ||
+        (prefix === 0x04 && publicKey.length === 65);
+    try {
+        if (shaped)
+            return secp256k1_1.secp256k1.ProjectivePoint.fromHex(publicKey).toRawBytes(false);
+    }
+    catch {
+        // Not a point on the curve.
+    }
+    throw new error_1.ValidationError('INVALID_ADDRESS', 'public key must be a 33- or 65-byte secp256k1 point');
+}
+const HASH = /^0x[0-9a-fA-F]{64}$/;
+const QUANTITY = /^0x[0-9a-fA-F]+$/;
+const DATA = /^0x(?:[0-9a-fA-F]{2})*$/;
+const BLOOM = /^0x[0-9a-fA-F]{512}$/;
+function malformed(field) {
+    return new error_1.ProviderError('PROVIDER_UNAVAILABLE', `malformed ${field} in a JSON-RPC answer`);
+}
+/**
+ * A JSON-RPC quantity (`0x` and hex digits) as a bigint. Anything else throws a retryable
+ * `PROVIDER_UNAVAILABLE` naming `field`: the one check of every hex quantity the driver
+ * reads, quorum keys and health probes included (a key that throws is a disagreement).
+ */
+function quantity(value, field) {
+    if (typeof value !== 'string' || !QUANTITY.test(value))
+        throw malformed(field);
+    return BigInt(value);
+}
+function optionalQuantity(value, field) {
+    return value === undefined || value === null ? undefined : quantity(value, field);
+}
+function hash(value, field) {
+    if (typeof value !== 'string' || !HASH.test(value))
+        throw malformed(field);
+    return value.toLowerCase();
+}
+function data(value, field) {
+    if (typeof value !== 'string' || !DATA.test(value))
+        throw malformed(field);
+    return value.toLowerCase();
+}
+function object(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        throw malformed(field);
+    return value;
+}
+/** One ABI word: 32 bytes. */
+exports.ABI_WORD = /^0x[0-9a-fA-F]{64}$/;
+/** An ABI-encoded address: 12 zero bytes, then 20 address bytes. */
+exports.ADDRESS_WORD = /^0x0{24}[0-9a-fA-F]{40}$/;
+/**
+ * The three ABI words of an ERC-20 `Transfer` log (`from`, `to`, amount), or `null`. Anyone
+ * can emit a look-alike event: anything but the topic and three well-formed words is not a
+ * transfer, and never an error that would fail a whole block scan.
+ */
+function transferLogWords(log, topic) {
+    const [first, from, to] = log.topics;
+    if (log.topics.length !== 3 ||
+        first !== topic ||
+        !exports.ADDRESS_WORD.test(from) ||
+        !exports.ADDRESS_WORD.test(to) ||
+        !exports.ABI_WORD.test(log.data)) {
+        return null;
+    }
+    return { from: from, to: to, data: log.data };
+}
+function blockParam(block) {
+    return typeof block === 'bigint' ? `0x${block.toString(16)}` : block;
+}
+const hexOf = (value) => `0x${value.toString(16)}`;
+class EvmClientBase {
+    /** The chain id of the network this client serves. */
+    chainId;
+    constructor(chainId) {
+        this.chainId = chainId;
+    }
+    serializeUnsigned(tx) {
+        return this.encodeUnsigned(this.#onNetwork(tx));
+    }
+    unsignedHash(tx) {
+        return this.hashUnsigned(this.#onNetwork(tx));
+    }
+    serializeSigned(tx, signature) {
+        return this.encodeSigned(this.#onNetwork(tx), signature);
+    }
+    /**
+     * A transaction for another chain is refused before any codec work. The SDKs
+     * disagree about it: ethers commits to `tx.chainId`, web3 to the client's chain id (and
+     * throws a plain `Error` for a type-2 mismatch), so without this guard the two clients
+     * would produce different signing bytes for the same fields.
+     */
+    #onNetwork(tx) {
+        if (tx.chainId !== this.chainId) {
+            throw new error_1.ValidationError('INVALID_INTENT', 'transaction chain id does not match the network');
+        }
+        return tx;
+    }
+    /** Runs the SDK's checksum; `INVALID_ADDRESS` for anything but a valid hex address. */
+    checked(address, checksum) {
+        try {
+            if (exports.ADDRESS.test(address))
+                return checksum(address);
+        }
+        catch {
+            // A mixed-case address with a wrong checksum.
+        }
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'not an EVM address');
+    }
+    async blockNumber(tags) {
+        return quantity(await this.send('eth_blockNumber', [], tags), 'block number');
+    }
+    async getBalance(address, block, tags) {
+        const result = await this.send('eth_getBalance', [address, blockParam(block)], tags);
+        return quantity(result, 'balance');
+    }
+    async getTransactionCount(address, block, tags) {
+        const params = [address, blockParam(block)];
+        return quantity(await this.send('eth_getTransactionCount', params, tags), 'nonce');
+    }
+    async call(request, block, tags) {
+        const result = await this.send('eth_call', [this.#request(request), blockParam(block)], tags);
+        return data(result, 'call result');
+    }
+    async estimateGas(request, tags) {
+        return quantity(await this.send('eth_estimateGas', [this.#request(request)], tags), 'gas');
+    }
+    async gasPrice(tags) {
+        return quantity(await this.send('eth_gasPrice', [], tags), 'gas price');
+    }
+    async feeHistory(blockCount, newest, percentiles, tags) {
+        const params = [hexOf(BigInt(blockCount)), blockParam(newest), [...percentiles]];
+        const json = object(await this.send('eth_feeHistory', params, tags), 'fee history');
+        const list = (value, field) => {
+            if (!Array.isArray(value))
+                throw malformed(field);
+            return value;
+        };
+        return {
+            oldestBlock: quantity(json.oldestBlock, 'oldest block'),
+            baseFeePerGas: list(json.baseFeePerGas, 'base fees').map((v) => quantity(v, 'base fee')),
+            reward: list(json.reward ?? [], 'rewards').map((row) => list(row, 'rewards').map((v) => quantity(v, 'reward'))),
+            gasUsedRatio: list(json.gasUsedRatio ?? [], 'gas used ratios').map((v) => {
+                if (typeof v !== 'number')
+                    throw malformed('gas used ratio');
+                return v;
+            }),
+        };
+    }
+    async getBlock(block, tags) {
+        const byHash = typeof block === 'string' && HASH.test(block);
+        const result = byHash
+            ? await this.send('eth_getBlockByHash', [block, false], tags)
+            : await this.send('eth_getBlockByNumber', [blockParam(block), false], tags);
+        if (result === null)
+            return null;
+        const json = object(result, 'block');
+        return {
+            ...this.#header(json),
+            transactions: this.#list(json.transactions, 'block transactions').map((t) => hash(typeof t === 'string' ? t : t?.hash, 'transaction hash')),
+        };
+    }
+    async getBlockWithTransactions(block, tags) {
+        const result = await this.send('eth_getBlockByNumber', [blockParam(block), true], tags);
+        if (result === null)
+            return null;
+        const json = object(result, 'block');
+        const { logsBloom } = json;
+        return {
+            ...this.#header(json),
+            transactions: this.#list(json.transactions, 'block transactions').map((t) => this.#tx(object(t, 'transaction'))),
+            // Only a hint for scans: a missing or malformed bloom may hold anything.
+            ...(typeof logsBloom === 'string' && BLOOM.test(logsBloom)
+                ? { logsBloom: logsBloom.toLowerCase() }
+                : {}),
+        };
+    }
+    /** An answer about another transaction is malformed, never another's facts. */
+    async getTransaction(txHash, tags) {
+        const result = await this.send('eth_getTransactionByHash', [txHash], tags);
+        if (result === null)
+            return null;
+        const tx = this.#tx(object(result, 'transaction'));
+        if (tx.hash !== txHash.toLowerCase())
+            throw malformed('transaction hash');
+        return tx;
+    }
+    /** An answer about another transaction is malformed, never another's receipt. */
+    async getReceipt(txHash, tags) {
+        const result = await this.send('eth_getTransactionReceipt', [txHash], tags);
+        if (result === null)
+            return null;
+        const receipt = this.#receipt(object(result, 'receipt'));
+        if (receipt.transactionHash !== txHash.toLowerCase()) {
+            throw malformed('transaction hash');
+        }
+        return receipt;
+    }
+    async getBlockReceipts(blockHash, tags) {
+        const result = await this.send('eth_getBlockReceipts', [blockHash], tags);
+        if (result === null)
+            return null;
+        return this.#list(result, 'block receipts').map((receipt) => this.#receipt(object(receipt, 'receipt')));
+    }
+    #receipt(json) {
+        const status = quantity(json.status, 'receipt status');
+        if (status !== 0n && status !== 1n)
+            throw malformed('receipt status');
+        const l1Fee = optionalQuantity(json.l1Fee, 'L1 fee');
+        const gasUsedForL1 = optionalQuantity(json.gasUsedForL1, 'L1 gas');
+        return {
+            transactionHash: hash(json.transactionHash, 'transaction hash'),
+            blockHash: hash(json.blockHash, 'block hash'),
+            blockNumber: quantity(json.blockNumber, 'block number'),
+            status: status === 1n ? 1 : 0,
+            from: this.#address(json.from, 'sender'),
+            to: json.to === null || json.to === undefined
+                ? null
+                : this.#address(json.to, 'recipient'),
+            contractAddress: json.contractAddress === null || json.contractAddress === undefined
+                ? null
+                : this.#address(json.contractAddress, 'contract address'),
+            gasUsed: quantity(json.gasUsed, 'gas used'),
+            effectiveGasPrice: quantity(json.effectiveGasPrice, 'effective gas price'),
+            ...(l1Fee !== undefined ? { l1Fee } : {}),
+            ...(gasUsedForL1 !== undefined ? { gasUsedForL1 } : {}),
+            logs: this.#list(json.logs, 'receipt logs').map((log) => this.#log(object(log, 'log'))),
+        };
+    }
+    async getLogs(filter, tags) {
+        const params = [{ blockHash: filter.blockHash, topics: [...filter.topics] }];
+        const result = await this.send('eth_getLogs', params, tags);
+        return this.#list(result, 'logs').map((log) => this.#log(object(log, 'log')));
+    }
+    async sendRawTransaction(raw, tags) {
+        return hash(await this.send('eth_sendRawTransaction', [raw], tags), 'transaction hash');
+    }
+    #request(request) {
+        return {
+            ...(request.from !== undefined ? { from: request.from } : {}),
+            to: request.to,
+            ...(request.value !== undefined ? { value: hexOf(request.value) } : {}),
+            ...(request.data !== undefined ? { data: request.data } : {}),
+        };
+    }
+    #list(value, field) {
+        if (!Array.isArray(value))
+            throw malformed(field);
+        return value;
+    }
+    #address(value, field) {
+        if (typeof value !== 'string' || !exports.ADDRESS.test(value))
+            throw malformed(field);
+        return this.checksum(value.toLowerCase());
+    }
+    #header(json) {
+        const baseFeePerGas = optionalQuantity(json.baseFeePerGas, 'base fee');
+        return {
+            number: quantity(json.number, 'block number'),
+            hash: hash(json.hash, 'block hash'),
+            parentHash: hash(json.parentHash, 'parent hash'),
+            timestamp: Number(quantity(json.timestamp, 'timestamp')),
+            ...(baseFeePerGas !== undefined ? { baseFeePerGas } : {}),
+        };
+    }
+    #tx(json) {
+        const gasPrice = optionalQuantity(json.gasPrice, 'gas price');
+        const maxFeePerGas = optionalQuantity(json.maxFeePerGas, 'max fee');
+        const maxPriorityFeePerGas = optionalQuantity(json.maxPriorityFeePerGas, 'priority fee');
+        const blockHash = json.blockHash ?? null;
+        const blockNumber = json.blockNumber ?? null;
+        return {
+            hash: hash(json.hash, 'transaction hash'),
+            from: this.#address(json.from, 'sender'),
+            to: json.to === null || json.to === undefined
+                ? null
+                : this.#address(json.to, 'recipient'),
+            nonce: quantity(json.nonce, 'nonce'),
+            value: quantity(json.value, 'value'),
+            // No calldata field is malformed, never an empty call (older nodes say `data`).
+            input: data(json.input ?? json.data, 'input'),
+            type: Number(optionalQuantity(json.type, 'type') ?? 0n),
+            gasLimit: quantity(json.gas, 'gas limit'),
+            ...(gasPrice !== undefined ? { gasPrice } : {}),
+            ...(maxFeePerGas !== undefined ? { maxFeePerGas } : {}),
+            ...(maxPriorityFeePerGas !== undefined ? { maxPriorityFeePerGas } : {}),
+            blockHash: blockHash === null ? null : hash(blockHash, 'block hash'),
+            blockNumber: blockNumber === null ? null : quantity(blockNumber, 'block number'),
+        };
+    }
+    #log(json) {
+        return {
+            address: this.#address(json.address, 'log address'),
+            topics: this.#list(json.topics, 'log topics').map((t) => hash(t, 'log topic')),
+            data: data(json.data, 'log data'),
+            logIndex: Number(quantity(json.logIndex, 'log index')),
+            blockHash: hash(json.blockHash, 'block hash'),
+            blockNumber: quantity(json.blockNumber, 'block number'),
+            transactionHash: hash(json.transactionHash, 'transaction hash'),
+            removed: json.removed === true,
+        };
+    }
+}
+exports.EvmClientBase = EvmClientBase;
+//# sourceMappingURL=client.js.map