crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/evm/plugin.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVM_PEER_DEPENDENCIES = void 0;
+exports.evmManifests = evmManifests;
+exports.evmPlugin = evmPlugin;
+exports.evmChainPlugin = evmChainPlugin;
+const error_1 = require("../../core/errors/error");
+const chains_1 = require("./chains");
+const network_1 = require("./network");
+const presets_1 = require("./presets");
+const tokens_1 = require("./tokens");
+/** The SDK versions this adapter is validated against. */
+exports.EVM_PEER_DEPENDENCIES = {
+    ethers: { name: 'ethers', range: '^6.17.0' },
+    web3: { name: 'web3', range: '^4.16.0' },
+};
+/**
+ * The manifests' `load` functions, shared by every `evmManifests(...)` call, so that
+ * registering `evmPlugin()` or the same `evmChainPlugin(...)` again is the same plugin:
+ * the registry compares a plugin's functions by identity, and refuses a different plugin
+ * under a registered name. Each `require`s its client module, and with it the SDK, only
+ * when called.
+ */
+const loadEthers = async () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const mod = require('./ethers-client');
+    return mod.ethersDriverFactory;
+};
+const loadWeb3 = async () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const mod = require('./web3-client');
+    return mod.web3DriverFactory;
+};
+/** The `ethers` and `web3` manifests for `chains`, keyed `<family>/<library>`. */
+function evmManifests(family, chains) {
+    return [
+        {
+            family,
+            library: 'ethers',
+            chains,
+            capabilities: network_1.EVM_CAPABILITIES,
+            peerDependencies: [exports.EVM_PEER_DEPENDENCIES.ethers],
+            load: loadEthers,
+        },
+        {
+            family,
+            library: 'web3',
+            chains,
+            capabilities: network_1.EVM_CAPABILITIES,
+            peerDependencies: [exports.EVM_PEER_DEPENDENCIES.web3],
+            load: loadWeb3,
+        },
+    ];
+}
+/**
+ * The built-in EVM family: Ethereum, BNB Smart Chain, Polygon PoS, Avalanche C-Chain,
+ * Arbitrum One, OP Mainnet and Base, with their testnets.
+ */
+function evmPlugin() {
+    return {
+        name: 'evm',
+        chains: chains_1.EVM_CHAINS,
+        adapters: evmManifests('evm', chains_1.EVM_CHAINS.map((chain) => chain.id)),
+        presets: presets_1.EVM_PRESETS,
+        assets: tokens_1.EVM_TOKENS,
+    };
+}
+/** A plugin name: lower-case letters, digits and hyphens, starting with a letter. */
+const PLUGIN_NAME = /^[a-z][a-z0-9-]*$/;
+/**
+ * A plugin for EVM chains of your own, served by the built-in EVM driver with either
+ * library. Every network is validated here, so bad data fails at registration.
+ */
+function evmChainPlugin(options) {
+    if (!PLUGIN_NAME.test(options.name)) {
+        throw new error_1.ConfigError('CONFIG_INVALID', `EVM chain plugin name ${JSON.stringify(options.name)} must match ${String(PLUGIN_NAME)}`);
+    }
+    const name = `evm:${options.name}`;
+    for (const chain of options.chains) {
+        const fail = (reason) => {
+            throw new error_1.ConfigError('CONFIG_INVALID', `EVM chain '${chain.id}': ${reason}`);
+        };
+        if (chain.family !== 'evm')
+            fail(`its family must be 'evm'`);
+        if (chain.model !== 'account' || chain.ordering !== 'nonce') {
+            fail(`it must use the account model and nonce ordering`);
+        }
+        if (chain.schemes.length !== 1 || chain.schemes[0] !== 'secp256k1-ecdsa') {
+            fail(`its only scheme must be 'secp256k1-ecdsa'`);
+        }
+        for (const network of Object.values(chain.networks))
+            (0, network_1.evmNetworkConfig)(chain, network);
+    }
+    return {
+        name,
+        chains: options.chains,
+        adapters: evmManifests(name, options.chains.map((chain) => chain.id)),
+        ...(options.presets ? { presets: options.presets } : {}),
+        ...(options.assets ? { assets: options.assets } : {}),
+    };
+}
+//# sourceMappingURL=plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/adapters/evm/plugin.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The EVM family plugin: chains, tokens and provider presets as data, plus one\n * adapter manifest per library. SDK-free: only a manifest's `load()` requires a client\n * module, and with it the SDK. `ethers` is registered first, so it is the family default.\n */\nimport type {\n  AdapterManifest,\n  DriverFactory,\n  PeerDependency,\n} from '../../core/driver/types';\nimport { ConfigError } from '../../core/errors/error';\nimport type { ChainInfo } from '../../core/model/chain';\nimport type { AssetRegistration } from '../../core/registry/assets';\nimport type { Plugin } from '../../core/registry/plugin';\nimport type { ProviderPreset } from '../../core/registry/providers';\nimport { EVM_CHAINS } from './chains';\nimport { EVM_CAPABILITIES, evmNetworkConfig } from './network';\nimport { EVM_PRESETS } from './presets';\nimport { EVM_TOKENS } from './tokens';\n\n/** The SDK versions this adapter is validated against. */\nexport const EVM_PEER_DEPENDENCIES: Readonly<Record<'ethers' | 'web3', PeerDependency>> =\n  {\n    ethers: { name: 'ethers', range: '^6.17.0' },\n    web3: { name: 'web3', range: '^4.16.0' },\n  };\n\n/**\n * The manifests' `load` functions, shared by every `evmManifests(...)` call, so that\n * registering `evmPlugin()` or the same `evmChainPlugin(...)` again is the same plugin:\n * the registry compares a plugin's functions by identity, and refuses a different plugin\n * under a registered name. Each `require`s its client module, and with it the SDK, only\n * when called.\n */\nconst loadEthers = async (): Promise<DriverFactory> => {\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const mod = require('./ethers-client') as typeof import('./ethers-client');\n  return mod.ethersDriverFactory;\n};\n\nconst loadWeb3 = async (): Promise<DriverFactory> => {\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const mod = require('./web3-client') as typeof import('./web3-client');\n  return mod.web3DriverFactory;\n};\n\n/** The `ethers` and `web3` manifests for `chains`, keyed `<family>/<library>`. */\nexport function evmManifests(\n  family: string,\n  chains: readonly string[],\n): AdapterManifest[] {\n  return [\n    {\n      family,\n      library: 'ethers',\n      chains,\n      capabilities: EVM_CAPABILITIES,\n      peerDependencies: [EVM_PEER_DEPENDENCIES.ethers],\n      load: loadEthers,\n    },\n    {\n      family,\n      library: 'web3',\n      chains,\n      capabilities: EVM_CAPABILITIES,\n      peerDependencies: [EVM_PEER_DEPENDENCIES.web3],\n      load: loadWeb3,\n    },\n  ];\n}\n\n/**\n * The built-in EVM family: Ethereum, BNB Smart Chain, Polygon PoS, Avalanche C-Chain,\n * Arbitrum One, OP Mainnet and Base, with their testnets.\n */\nexport function evmPlugin(): Plugin {\n  return {\n    name: 'evm',\n    chains: EVM_CHAINS,\n    adapters: evmManifests(\n      'evm',\n      EVM_CHAINS.map((chain) => chain.id),\n    ),\n    presets: EVM_PRESETS,\n    assets: EVM_TOKENS,\n  };\n}\n\n/** A plugin name: lower-case letters, digits and hyphens, starting with a letter. */\nconst PLUGIN_NAME = /^[a-z][a-z0-9-]*$/;\n\nexport interface EvmChainPluginOptions {\n  /**\n   * A unique name matching `/^[a-z][a-z0-9-]*$/`. The plugin registers as `evm:<name>`, so\n   * it never collides with a family plugin, and its manifests as `evm:<name>/ethers` and\n   * `evm:<name>/web3`.\n   */\n  readonly name: string;\n  /** Chains with `family: 'evm'`, nonce ordering and the `secp256k1-ecdsa` scheme. */\n  readonly chains: readonly ChainInfo[];\n  readonly presets?: readonly ProviderPreset[];\n  readonly assets?: readonly AssetRegistration[];\n}\n\n/**\n * A plugin for EVM chains of your own, served by the built-in EVM driver with either\n * library. Every network is validated here, so bad data fails at registration.\n */\nexport function evmChainPlugin(options: EvmChainPluginOptions): Plugin {\n  if (!PLUGIN_NAME.test(options.name)) {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `EVM chain plugin name ${JSON.stringify(options.name)} must match ${String(PLUGIN_NAME)}`,\n    );\n  }\n  const name = `evm:${options.name}`;\n  for (const chain of options.chains) {\n    const fail = (reason: string): never => {\n      throw new ConfigError('CONFIG_INVALID', `EVM chain '${chain.id}': ${reason}`);\n    };\n    if (chain.family !== 'evm') fail(`its family must be 'evm'`);\n    if (chain.model !== 'account' || chain.ordering !== 'nonce') {\n      fail(`it must use the account model and nonce ordering`);\n    }\n    if (chain.schemes.length !== 1 || chain.schemes[0] !== 'secp256k1-ecdsa') {\n      fail(`its only scheme must be 'secp256k1-ecdsa'`);\n    }\n    for (const network of Object.values(chain.networks)) evmNetworkConfig(chain, network);\n  }\n  return {\n    name,\n    chains: options.chains,\n    adapters: evmManifests(\n      name,\n      options.chains.map((chain) => chain.id),\n    ),\n    ...(options.presets ? { presets: options.presets } : {}),\n    ...(options.assets ? { assets: options.assets } : {}),\n  };\n}\n"]}

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

@@ -0,0 +1,2 @@
+import type { ProviderPreset } from '../../core/registry/providers';
+export declare const EVM_PRESETS: readonly ProviderPreset[];

package/dist/adapters/evm/presets.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVM_PRESETS = void 0;
+/**
+ * EVM provider presets. Only URL templates verified against the provider's own
+ * documentation are listed; a preset refuses every other network with `CONFIG_INVALID`.
+ * `public` has no Ethereum entry: no operator-run public endpoint is documented for it.
+ * Keyed URLs are `Secret`s, so the key never reaches logs or errors.
+ */
+const error_1 = require("../../core/errors/error");
+const secret_1 = require("../../core/secret/secret");
+/**
+ * Free public endpoints named in each chain's own documentation: the chain operator's, or a
+ * third party's where the docs list one (Polygon's are drpc's).
+ */
+const PUBLIC = {
+    bsc: {
+        mainnet: 'https://bsc-dataseed.bnbchain.org',
+        testnet: 'https://bsc-testnet-dataseed.bnbchain.org',
+    },
+    polygon: {
+        mainnet: 'https://polygon.drpc.org',
+        amoy: 'https://polygon-amoy.drpc.org',
+    },
+    avalanche: {
+        mainnet: 'https://api.avax.network/ext/bc/C/rpc',
+        fuji: 'https://api.avax-test.network/ext/bc/C/rpc',
+    },
+    arbitrum: {
+        mainnet: 'https://arb1.arbitrum.io/rpc',
+        sepolia: 'https://sepolia-rollup.arbitrum.io/rpc',
+    },
+    optimism: {
+        mainnet: 'https://mainnet.optimism.io',
+        sepolia: 'https://sepolia.optimism.io',
+    },
+    base: { mainnet: 'https://mainnet.base.org', sepolia: 'https://sepolia.base.org' },
+};
+/** `https://<host>.g.alchemy.com/v2/<key>`. */
+const ALCHEMY = {
+    ethereum: { mainnet: 'eth-mainnet', sepolia: 'eth-sepolia', hoodi: 'eth-hoodi' },
+    bsc: { mainnet: 'bnb-mainnet', testnet: 'bnb-testnet' },
+    polygon: { mainnet: 'polygon-mainnet', amoy: 'polygon-amoy' },
+    avalanche: { mainnet: 'avax-mainnet', fuji: 'avax-fuji' },
+    arbitrum: { mainnet: 'arb-mainnet', sepolia: 'arb-sepolia' },
+    optimism: { mainnet: 'opt-mainnet', sepolia: 'opt-sepolia' },
+    base: { mainnet: 'base-mainnet', sepolia: 'base-sepolia' },
+};
+/** `https://<host>.infura.io/v3/<key>`. */
+const INFURA = {
+    ethereum: { mainnet: 'mainnet', sepolia: 'sepolia', hoodi: 'hoodi' },
+    bsc: { mainnet: 'bsc-mainnet', testnet: 'bsc-testnet' },
+    polygon: { mainnet: 'polygon-mainnet', amoy: 'polygon-amoy' },
+    avalanche: { mainnet: 'avalanche-mainnet', fuji: 'avalanche-fuji' },
+    arbitrum: { mainnet: 'arbitrum-mainnet', sepolia: 'arbitrum-sepolia' },
+    optimism: { mainnet: 'optimism-mainnet', sepolia: 'optimism-sepolia' },
+    base: { mainnet: 'base-mainnet', sepolia: 'base-sepolia' },
+};
+/** `https://rpc.ankr.com/<path>/<key>`: only the paths Ankr's documentation shows. */
+const ANKR = {
+    ethereum: { mainnet: 'eth' },
+    bsc: { mainnet: 'bsc' },
+    avalanche: { mainnet: 'avalanche' },
+    arbitrum: { mainnet: 'arbitrum' },
+    base: { mainnet: 'base' },
+};
+function entry(table, input) {
+    const value = table[input.chain]?.[input.network];
+    // Unreachable through the catalog, which asks `supports` first.
+    if (value === undefined)
+        throw new Error(`no entry for ${input.chain}:${input.network}`);
+    return value;
+}
+/** The revealed key; the error names the preset and network, never the key. */
+function apiKeyOf(name, input) {
+    const key = input.apiKey === undefined ? undefined : (0, secret_1.reveal)(input.apiKey);
+    if (typeof key !== 'string' || key.trim() === '') {
+        throw new error_1.ConfigError('CONFIG_INVALID', `provider preset '${name}' requires a non-empty apiKey for ${input.chain}:${input.network}`);
+    }
+    return key;
+}
+function keyed(name, table, url) {
+    return {
+        name,
+        kind: 'rpc',
+        requiresApiKey: true,
+        supports: (chain, network) => table[chain]?.[network] !== undefined,
+        endpoints: (input) => [
+            { name, url: (0, secret_1.secret)(url(entry(table, input), apiKeyOf(name, input))) },
+        ],
+    };
+}
+exports.EVM_PRESETS = [
+    {
+        name: 'public',
+        kind: 'rpc',
+        production: false,
+        supports: (chain, network) => PUBLIC[chain]?.[network] !== undefined,
+        endpoints: (input) => [{ name: 'public', url: entry(PUBLIC, input) }],
+    },
+    keyed('alchemy', ALCHEMY, (host, key) => `https://${host}.g.alchemy.com/v2/${key}`),
+    keyed('infura', INFURA, (host, key) => `https://${host}.infura.io/v3/${key}`),
+    keyed('ankr', ANKR, (path, key) => `https://rpc.ankr.com/${path}/${key}`),
+];
+//# sourceMappingURL=presets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/adapters/evm/presets.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EVM provider presets. Only URL templates verified against the provider's own\n * documentation are listed; a preset refuses every other network with `CONFIG_INVALID`.\n * `public` has no Ethereum entry: no operator-run public endpoint is documented for it.\n * Keyed URLs are `Secret`s, so the key never reaches logs or errors.\n */\nimport { ConfigError } from '../../core/errors/error';\nimport type { PresetInput, ProviderPreset } from '../../core/registry/providers';\nimport { reveal, secret } from '../../core/secret/secret';\nimport type { EndpointConfig } from '../../core/transport/types';\n\ntype Table = Readonly<Record<string, Readonly<Record<string, string>>>>;\n\n/**\n * Free public endpoints named in each chain's own documentation: the chain operator's, or a\n * third party's where the docs list one (Polygon's are drpc's).\n */\nconst PUBLIC: Table = {\n  bsc: {\n    mainnet: 'https://bsc-dataseed.bnbchain.org',\n    testnet: 'https://bsc-testnet-dataseed.bnbchain.org',\n  },\n  polygon: {\n    mainnet: 'https://polygon.drpc.org',\n    amoy: 'https://polygon-amoy.drpc.org',\n  },\n  avalanche: {\n    mainnet: 'https://api.avax.network/ext/bc/C/rpc',\n    fuji: 'https://api.avax-test.network/ext/bc/C/rpc',\n  },\n  arbitrum: {\n    mainnet: 'https://arb1.arbitrum.io/rpc',\n    sepolia: 'https://sepolia-rollup.arbitrum.io/rpc',\n  },\n  optimism: {\n    mainnet: 'https://mainnet.optimism.io',\n    sepolia: 'https://sepolia.optimism.io',\n  },\n  base: { mainnet: 'https://mainnet.base.org', sepolia: 'https://sepolia.base.org' },\n};\n\n/** `https://<host>.g.alchemy.com/v2/<key>`. */\nconst ALCHEMY: Table = {\n  ethereum: { mainnet: 'eth-mainnet', sepolia: 'eth-sepolia', hoodi: 'eth-hoodi' },\n  bsc: { mainnet: 'bnb-mainnet', testnet: 'bnb-testnet' },\n  polygon: { mainnet: 'polygon-mainnet', amoy: 'polygon-amoy' },\n  avalanche: { mainnet: 'avax-mainnet', fuji: 'avax-fuji' },\n  arbitrum: { mainnet: 'arb-mainnet', sepolia: 'arb-sepolia' },\n  optimism: { mainnet: 'opt-mainnet', sepolia: 'opt-sepolia' },\n  base: { mainnet: 'base-mainnet', sepolia: 'base-sepolia' },\n};\n\n/** `https://<host>.infura.io/v3/<key>`. */\nconst INFURA: Table = {\n  ethereum: { mainnet: 'mainnet', sepolia: 'sepolia', hoodi: 'hoodi' },\n  bsc: { mainnet: 'bsc-mainnet', testnet: 'bsc-testnet' },\n  polygon: { mainnet: 'polygon-mainnet', amoy: 'polygon-amoy' },\n  avalanche: { mainnet: 'avalanche-mainnet', fuji: 'avalanche-fuji' },\n  arbitrum: { mainnet: 'arbitrum-mainnet', sepolia: 'arbitrum-sepolia' },\n  optimism: { mainnet: 'optimism-mainnet', sepolia: 'optimism-sepolia' },\n  base: { mainnet: 'base-mainnet', sepolia: 'base-sepolia' },\n};\n\n/** `https://rpc.ankr.com/<path>/<key>`: only the paths Ankr's documentation shows. */\nconst ANKR: Table = {\n  ethereum: { mainnet: 'eth' },\n  bsc: { mainnet: 'bsc' },\n  avalanche: { mainnet: 'avalanche' },\n  arbitrum: { mainnet: 'arbitrum' },\n  base: { mainnet: 'base' },\n};\n\nfunction entry(table: Table, input: PresetInput): string {\n  const value = table[input.chain]?.[input.network];\n  // Unreachable through the catalog, which asks `supports` first.\n  if (value === undefined)\n    throw new Error(`no entry for ${input.chain}:${input.network}`);\n  return value;\n}\n\n/** The revealed key; the error names the preset and network, never the key. */\nfunction apiKeyOf(name: string, input: PresetInput): string {\n  const key: unknown = input.apiKey === undefined ? undefined : reveal(input.apiKey);\n  if (typeof key !== 'string' || key.trim() === '') {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `provider preset '${name}' requires a non-empty apiKey for ${input.chain}:${input.network}`,\n    );\n  }\n  return key;\n}\n\nfunction keyed(\n  name: string,\n  table: Table,\n  url: (value: string, key: string) => string,\n): ProviderPreset {\n  return {\n    name,\n    kind: 'rpc',\n    requiresApiKey: true,\n    supports: (chain, network) => table[chain]?.[network] !== undefined,\n    endpoints: (input): readonly EndpointConfig[] => [\n      { name, url: secret(url(entry(table, input), apiKeyOf(name, input))) },\n    ],\n  };\n}\n\nexport const EVM_PRESETS: readonly ProviderPreset[] = [\n  {\n    name: 'public',\n    kind: 'rpc',\n    production: false,\n    supports: (chain, network) => PUBLIC[chain]?.[network] !== undefined,\n    endpoints: (input) => [{ name: 'public', url: entry(PUBLIC, input) }],\n  },\n  keyed('alchemy', ALCHEMY, (host, key) => `https://${host}.g.alchemy.com/v2/${key}`),\n  keyed('infura', INFURA, (host, key) => `https://${host}.infura.io/v3/${key}`),\n  keyed('ankr', ANKR, (path, key) => `https://rpc.ankr.com/${path}/${key}`),\n];\n"]}

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

@@ -0,0 +1,19 @@
+import type { BlockSource, ProofSource } from '../../core/driver/types';
+import { type EvmContext } from './reader';
+/**
+ * The lowest height at or below `final` where `consumed` holds, given that it holds at
+ * `final`. A gallop back (`final` less 1, 2, 4, …) finds a height where it does not, then a
+ * bisection the first where it does. `consumed` never turns false again as the height
+ * grows, since an account's nonce never falls. Beyond `MAX_SEARCH_READS` reads, it decides
+ * nothing.
+ */
+export declare function consumptionHeight(consumed: (height: bigint) => Promise<boolean>, final: bigint): Promise<bigint>;
+export declare function createEvmProofs(ctx: EvmContext): ProofSource;
+/**
+ * Whether a block's `logsBloom` may hold `value` (a log's address or topic), by the
+ * yellow paper's M3:2048: three bits, each the low 11 bits of a byte pair of the value's
+ * keccak-256. `false` is definitive; `true` may be a false positive. No bloom may hold
+ * anything.
+ */
+export declare function mayHold(bloom: string | undefined, value: string): boolean;
+export declare function createEvmBlocks(ctx: EvmContext): BlockSource;

package/dist/adapters/evm/proofs.js

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consumptionHeight = consumptionHeight;
+exports.createEvmProofs = createEvmProofs;
+exports.mayHold = mayHold;
+exports.createEvmBlocks = createEvmBlocks;
+/**
+ * Proofs and block scanning. Every proof read is a quorum read under `PROOF`, comparing
+ * only consensus facts (`rpc.ts`). No proof lets one endpoint choose the final height: a
+ * proof attests the fact it needs at that fact's own
+ * height, so honest endpoints disagree only while it is final on one and not yet on another,
+ * which decides nothing. The block source serves dense heights with native transfers and
+ * ERC-20 `Transfer` logs, as the chain reports them. Every error thrown here is a
+ * `PROVIDER_*` code, retryable by the code table: look again later.
+ */
+const sha3_1 = require("@noble/hashes/sha3");
+const utils_1 = require("@noble/hashes/utils");
+const error_1 = require("../../core/errors/error");
+const client_1 = require("./client");
+const decode_1 = require("./decode");
+const reader_1 = require("./reader");
+const rpc_1 = require("./rpc");
+/**
+ * A quorum key under which every endpoint whose nonce is past `nonce` agrees. A
+ * malformed answer throws, which the transport counts as a disagreement.
+ */
+const nonceAbove = (nonce) => (result) => (0, client_1.quantity)(result, 'nonce') > nonce;
+/**
+ * Node texts for state it does not hold: pruned, beyond its recent-state window, or
+ * not served at a tag (geth, op-geth, Nitro, BSC, Erigon, Reth, Besu wordings).
+ */
+const STATE_UNAVAILABLE = /missing trie node|historical state .* not available|header not found|state (is )?not available|pruned/i;
+/**
+ * The boundary of every proof. Only a definitive negative answer may
+ * say "no", and a JSON-RPC error answer is none: state the node does not hold, an index it
+ * is still building (geth's "transaction indexing is in progress"), or any other error,
+ * ambiguous or not. Every `RPC_ERROR` becomes a retryable `PROVIDER_UNAVAILABLE` (look again
+ * later, or elsewhere) that carries it as its cause, so no caller takes it for an answer and
+ * the monitor keeps watching. Every other error passes unchanged: `PROVIDER_MISCONFIGURED`
+ * stays final, and aborts and foreign errors stay what they are.
+ */
+async function undecided(proof) {
+    try {
+        return await proof();
+    }
+    catch (error) {
+        if (!(0, error_1.isCryptoAioError)(error, 'RPC_ERROR'))
+            throw error;
+        const message = String(error.details?.rpcMessage ?? error.message);
+        throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', STATE_UNAVAILABLE.test(message)
+            ? 'finalized state not available'
+            : 'the endpoints gave no answer', { cause: error });
+    }
+}
+/** A retryable "decide nothing": look again later, or elsewhere. */
+const undecidable = (reason) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', reason);
+/**
+ * At most this many nonce reads look for the height that consumed a nonce. The gallop
+ * and the bisection take about two reads per doubling of the distance back: at worst 60
+ * reads below a final height of 2^30, and 64 below 2^32, so this reaches every consumption
+ * on any chain served today.
+ */
+const MAX_SEARCH_READS = 64;
+/**
+ * The lowest height at or below `final` where `consumed` holds, given that it holds at
+ * `final`. A gallop back (`final` less 1, 2, 4, …) finds a height where it does not, then a
+ * bisection the first where it does. `consumed` never turns false again as the height
+ * grows, since an account's nonce never falls. Beyond `MAX_SEARCH_READS` reads, it decides
+ * nothing.
+ */
+async function consumptionHeight(consumed, final) {
+    let reads = 0;
+    const read = (height) => {
+        if (reads === MAX_SEARCH_READS) {
+            throw undecidable('the nonce was consumed too far back to look up');
+        }
+        reads += 1;
+        return consumed(height);
+    };
+    // Consumed at `high`; not at `low` (below genesis, until a read says otherwise).
+    let high = final;
+    let low = -1n;
+    for (let step = 1n; high > 0n && low < 0n; step *= 2n) {
+        const height = final > step ? final - step : 0n;
+        if (await read(height))
+            high = height;
+        else
+            low = height;
+    }
+    while (high - low > 1n) {
+        const middle = (low + high) / 2n;
+        if (await read(middle))
+            high = middle;
+        else
+            low = middle;
+    }
+    return high;
+}
+/**
+ * Whether `txHash` is final, when no endpoint serves its
+ * receipt. `null` is no proof of absence: a node answers it for every transaction outside its
+ * index (geth indexes the last 2,350,000 blocks by default, and pruning nodes of other
+ * clients drop theirs), so "not included" would prove a final, executed transfer `replaced`.
+ * The nonce's consumer decides instead. The quorum attests the nonce consumed at a final
+ * height, a search finds the block that consumed it, and the sender's transaction at that
+ * nonce there answers: another one proves ours is not included; ours is included, with the
+ * verdict its receipt in that block gives. Anything else decides nothing, and so does
+ * an endpoint without the historical state the search reads.
+ *
+ * Known gap: nothing caches the consumer per sender and nonce, so an undecided Attempt
+ * repeats the search on every monitor pass. A nonce that an EIP-7702 authorization
+ * consumed (no transaction from the sender) is never decided, the safe direction.
+ */
+async function nonceConsumer(ctx, txHash, ordering, from) {
+    if (ordering.kind !== 'nonce')
+        throw undecidable('no nonce to look the transaction up by');
+    const { client } = ctx;
+    const { nonce } = ordering;
+    const tags = { ...reader_1.PROOF, quorumKey: nonceAbove(nonce) };
+    const consumed = async (height) => (await client.getTransactionCount(from, height, tags)) > nonce;
+    const { height: final } = await (0, reader_1.provenFinal)(ctx, reader_1.PROOF);
+    if (!(await consumed(final)))
+        throw undecidable('the nonce is not consumed at finality');
+    const height = await consumptionHeight(consumed, final);
+    const block = await client.getBlockWithTransactions(height, {
+        ...reader_1.PROOF,
+        quorumKey: rpc_1.blockTransactionsKey,
+    });
+    if (block?.number !== height)
+        throw undecidable('the endpoints serve no final block');
+    const sender = from.toLowerCase();
+    const consumer = block.transactions.find((tx) => tx.from.toLowerCase() === sender && tx.nonce === nonce);
+    // No transaction from the sender used the nonce: an EIP-7702 authorization can.
+    if (!consumer)
+        throw undecidable('no transaction in its block used the nonce');
+    // Another transaction is final at our nonce: ours can never be included.
+    if (consumer.hash !== txHash.toLowerCase())
+        return { included: false };
+    const receipts = await client.getBlockReceipts(block.hash, reader_1.PROOF);
+    const receipt = receipts?.find((r) => r.transactionHash === consumer.hash);
+    if (receipt?.blockHash !== block.hash) {
+        throw undecidable('the final block has no receipts on the endpoints');
+    }
+    return {
+        included: true,
+        success: receipt.status === 1 && (0, decode_1.tokenTransferLanded)(client.abi, consumer, receipt),
+        blockHeight: height,
+        blockHash: block.hash,
+        txHash: consumer.hash,
+    };
+}
+function createEvmProofs(ctx) {
+    const { client } = ctx;
+    return {
+        finalizedHead: () => undecided(async () => {
+            const { height, block } = await (0, reader_1.provenFinal)(ctx, reader_1.PROOF);
+            const final = block ?? (await client.getBlock(height, reader_1.PROOF));
+            if (!final) {
+                throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the endpoints serve no finalized block');
+            }
+            return { height: final.number, hash: final.hash, timestamp: final.timestamp };
+        }),
+        includedFinal: (ref, ordering, from) => undecided(async () => {
+            const receipt = await client.getReceipt(ref.id, reader_1.PROOF);
+            // No receipt is no proof of absence; the transaction at our nonce decides.
+            if (!receipt)
+                return nonceConsumer(ctx, ref.id, ordering, from);
+            const final = await (0, reader_1.finalBlockAt)(ctx, receipt.blockNumber, reader_1.PROOF);
+            // The transaction is in a block, just not a final one on these endpoints yet.
+            // "Not included" would let the core prove a final transfer `replaced` (whenAbsent,
+            // after the slot was proven consumed on endpoints whose finality is further along),
+            // so this decides nothing.
+            if (!final) {
+                throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'receipt not yet final');
+            }
+            // The endpoints agree on a receipt from a block that is not the final one at its
+            // height: the chain reorganized between the reads, or their receipt index lags. The
+            // transaction may be final elsewhere, so this decides nothing.
+            if (final.hash !== receipt.blockHash) {
+                throw new error_1.ProviderError('PROVIDER_INCONSISTENT', 'the receipt is not in the final block at its height');
+            }
+            let success = receipt.status === 1;
+            if (success) {
+                // A token transfer that logged no transfer to its recipient paid it nothing
+                // (read from the ref alone, the call's arguments from its keyed calldata). The
+                // core proves only its own Attempts, so this is always a verdict.
+                const tx = await client.getTransaction(ref.id, reader_1.PROOF);
+                if (!tx) {
+                    throw new error_1.ProviderError('PROVIDER_INCONSISTENT', 'a receipt without its transaction');
+                }
+                success = (0, decode_1.tokenTransferLanded)(client.abi, tx, receipt);
+            }
+            return {
+                included: true,
+                success,
+                blockHeight: receipt.blockNumber,
+                blockHash: receipt.blockHash,
+                txHash: receipt.transactionHash,
+            };
+        }),
+        slotConsumed: (ordering, from, level) => undecided(async () => {
+            if (ordering.kind !== 'nonce')
+                return false;
+            if (level === 'latest') {
+                return ((await client.getTransactionCount(from, 'latest', reader_1.MONITOR)) > ordering.nonce);
+            }
+            // The nonce at a height the quorum attests final (one endpoint's view proposes
+            // it, trailed by PEER_SKEW), on tag and confirmation networks alike. State at a final
+            // height never changes, so honest endpoints agree however their heads move, and one
+            // that over-reports its finalized block cannot advance the height. A number,
+            // not the `finalized` tag: some nodes (BSC's) serve no state at the tag.
+            const { height } = await (0, reader_1.provenFinal)(ctx, reader_1.PROOF);
+            const count = await client.getTransactionCount(from, height, {
+                ...reader_1.PROOF,
+                quorumKey: nonceAbove(ordering.nonce),
+            });
+            return count > ordering.nonce;
+        }),
+        // Nonce ordering: an EVM transaction never expires.
+        expired: async () => false,
+        blockHash: (height, level) => undecided(async () => {
+            if (level === 'finalized') {
+                return (await (0, reader_1.finalBlockAt)(ctx, height, reader_1.PROOF))?.hash ?? null;
+            }
+            return (await client.getBlock(height, reader_1.PROOF))?.hash ?? null;
+        }),
+    };
+}
+const changed = (height) => new error_1.ProviderError('PROVIDER_INCONSISTENT', `block ${height} changed while scanning`);
+/**
+ * Whether a block's `logsBloom` may hold `value` (a log's address or topic), by the
+ * yellow paper's M3:2048: three bits, each the low 11 bits of a byte pair of the value's
+ * keccak-256. `false` is definitive; `true` may be a false positive. No bloom may hold
+ * anything.
+ */
+function mayHold(bloom, value) {
+    if (bloom === undefined)
+        return true;
+    const hash = (0, sha3_1.keccak_256)((0, utils_1.hexToBytes)(value.slice(2)));
+    for (let i = 0; i < 6; i += 2) {
+        const bit = ((hash[i] << 8) | hash[i + 1]) & 2047;
+        // Bit 0 is the last byte's lowest bit.
+        const byte = 255 - (bit >> 3);
+        const bits = Number.parseInt(bloom.slice(2 + 2 * byte, 4 + 2 * byte), 16);
+        if ((bits & (1 << (bit & 7))) === 0)
+            return false;
+    }
+    return true;
+}
+/** Provider texts for a method they do not serve, whatever their error code. */
+const METHOD_MISSING = /method .*(not found|not supported|does not exist|is not available)/i;
+/**
+ * A definitive answer that the node does not serve `eth_getBlockReceipts`: JSON-RPC's
+ * "method not found" (-32601), EIP-1474's "method not supported" (-32004), or a provider's
+ * own code with a text that says so.
+ */
+function methodMissing(error) {
+    if (!(0, error_1.isCryptoAioError)(error, 'RPC_ERROR') || error.ambiguous)
+        return false;
+    const { rpcCode, rpcMessage } = error.details ?? {};
+    return (rpcCode === -32601 ||
+        rpcCode === -32004 ||
+        METHOD_MISSING.test(String(rpcMessage ?? '')));
+}
+/**
+ * Every receipt of `block` in one call, by transaction hash. The node reads them by
+ * block, never through a log or transaction index that may lag. `undefined` when the node
+ * does not serve `eth_getBlockReceipts`.
+ */
+async function blockReceipts(client, block) {
+    let receipts;
+    try {
+        receipts = await client.getBlockReceipts(block.hash, reader_1.MONITOR);
+    }
+    catch (error) {
+        if (methodMissing(error))
+            return undefined;
+        throw error;
+    }
+    if (receipts === null)
+        throw changed(block.number);
+    return new Map(receipts.map((receipt) => [receipt.transactionHash, receipt]));
+}
+/** The fallback: one `eth_getTransactionReceipt` per transaction. */
+async function receiptsOf(client, txs) {
+    const receipts = await Promise.all(txs.map((tx) => client.getReceipt(tx.hash, reader_1.MONITOR)));
+    return new Map(receipts.flatMap((receipt, i) => receipt ? [[txs[i]?.hash, receipt]] : []));
+}
+/**
+ * The logs of every transaction of `block`. A receipt missing, or from another block, could
+ * hide a deposit, so it fails the scan retryably instead.
+ */
+function blockLogs(block, receipts) {
+    return block.transactions.flatMap((tx) => {
+        const receipt = receipts.get(tx.hash);
+        if (receipt?.blockHash !== block.hash)
+            throw changed(block.number);
+        return receipt.logs;
+    });
+}
+function createEvmBlocks(ctx) {
+    const { client, config } = ctx;
+    /**
+     * The block's `Transfer` logs without block receipts: `eth_getLogs`, which a lagging
+     * log index answers empty without an error. So when it answers nothing while the header's
+     * bloom may hold the topic, every transaction's receipt is read before the empty answer
+     * is trusted: any call may have logged one.
+     */
+    const transferLogs = async (block) => {
+        const topic = client.abi.transferTopic;
+        const logs = await client.getLogs({ blockHash: block.hash, topics: [topic] }, reader_1.MONITOR);
+        if (logs.length > 0 || !mayHold(block.logsBloom, topic))
+            return { logs };
+        const receipts = await receiptsOf(client, block.transactions);
+        return { logs: blockLogs(block, receipts), receipts };
+    };
+    return {
+        async header(height) {
+            const block = await client.getBlock(height, reader_1.MONITOR);
+            return block ? (0, reader_1.toDriverBlock)(block) : null;
+        },
+        async transactions(block, filter) {
+            const full = await client.getBlockWithTransactions(block.height, reader_1.MONITOR);
+            if (!full || full.hash !== block.hash)
+                throw changed(block.height);
+            // One call for every receipt of the block, filtered scans included.
+            let receipts = await blockReceipts(client, full);
+            let selected = full.transactions;
+            if (filter?.addresses?.length) {
+                const wanted = new Set(filter.addresses.map((a) => a.toLowerCase()));
+                const watched = (address) => address !== null && wanted.has(address.toLowerCase());
+                let logs;
+                if (receipts)
+                    logs = blockLogs(full, receipts);
+                else
+                    ({ logs, receipts } = await transferLogs(full));
+                const tokenTxs = new Set(logs
+                    .filter((log) => {
+                    const transfer = client.abi.decodeTransfer(log);
+                    return (transfer !== null && (watched(transfer.from) || watched(transfer.to)));
+                })
+                    .map((log) => log.transactionHash));
+                // A contract creation's recipient is only in its receipt, so every creation stays.
+                selected = full.transactions.filter((tx) => tx.to === null || watched(tx.from) || watched(tx.to) || tokenTxs.has(tx.hash));
+            }
+            receipts ??= await receiptsOf(client, selected);
+            return selected.map((tx) => {
+                const receipt = receipts.get(tx.hash);
+                if (!receipt || receipt.blockHash !== block.hash)
+                    throw changed(block.height);
+                // The chain's view, with the network's config so bor's system logs do not make a
+                // plain Polygon transfer `partial`.
+                return (0, decode_1.decodeTransaction)(client.abi, tx, receipt, full.timestamp, config);
+            });
+        },
+    };
+}
+//# sourceMappingURL=proofs.js.map