crypto-aio 0.0.3 → 0.2.0

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * Transactions and receipts into the driver model: native value and ERC-20 `Transfer`
+ * logs as transfers, fees in the native asset, and `decoding: 'partial'` whenever
+ * contract code ran, since internal transfers need traces, which the driver does not
+ * read.
+ */
+import type { DriverTransaction, DriverTxObservation } from '../../core/driver/types';
+import { type EvmNetworkConfig } from './network';
+import type { EvmAbi, EvmReceipt, EvmTx } from './types';
+/**
+ * No phantom success: a token `transfer` call worked only if the token logged a
+ * `Transfer` from the sender to the call's recipient, of a positive amount whenever the
+ * call asked for one. ERC-20 requires the event, and some tokens return `false` instead
+ * of reverting, so a successful receipt alone would report a transfer that moved nothing;
+ * a log to anyone else, or of nothing, pays the recipient nothing either. A
+ * fee-on-transfer token logs less than asked, and still counts; a non-compliant token
+ * that moves value without the event is reported failed. The call's arguments come from
+ * its signed calldata. Only verdicts on our own transactions apply it (`evmObservation`,
+ * `includedFinal`), never the decoder.
+ */
+export declare function tokenTransferLanded(abi: EvmAbi, tx: EvmTx, receipt: EvmReceipt): boolean;
+/** What the chain reports: where the transaction is, and its receipt's status. */
+export declare function chainObservation(tx: EvmTx, receipt: EvmReceipt | null): DriverTxObservation;
+/**
+ * The verdict on one of our own transactions: the chain's status, and a successful token
+ * `transfer` that logged no transfer to its recipient is `success: false`.
+ */
+export declare function evmObservation(abi: EvmAbi, tx: EvmTx, receipt: EvmReceipt | null): DriverTxObservation;
+/**
+ * Any transaction as the chain reports it: the receipt's status, never the token
+ * verdict, so a third party's call that shares the `transfer` selector is not misreported.
+ * Pass the network's config so bor's system logs do not make a plain Polygon transfer
+ * `partial`.
+ */
+export declare function decodeTransaction(abi: EvmAbi, tx: EvmTx, receipt: EvmReceipt | null, timestamp?: number, network?: Pick<EvmNetworkConfig, 'polygonSystemLogs'>): DriverTransaction;

package/dist/adapters/evm/decode.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenTransferLanded = tokenTransferLanded;
+exports.chainObservation = chainObservation;
+exports.evmObservation = evmObservation;
+exports.decodeTransaction = decodeTransaction;
+const client_1 = require("./client");
+const fees_1 = require("./fees");
+const network_1 = require("./network");
+const TRANSFER_SELECTOR = '0xa9059cbb';
+/**
+ * The recipient (lower-cased) and amount of an ERC-20 `transfer(address,uint256)`
+ * call: the selector, then two ABI words. `null` for any other calldata.
+ */
+function transferCall(input) {
+    const to = `0x${input.slice(10, 74)}`;
+    const amount = `0x${input.slice(74)}`;
+    if (!input.startsWith(TRANSFER_SELECTOR) ||
+        !client_1.ADDRESS_WORD.test(to) ||
+        !client_1.ABI_WORD.test(amount)) {
+        return null;
+    }
+    return { to: `0x${to.slice(26)}`.toLowerCase(), amount: BigInt(amount) };
+}
+/**
+ * No phantom success: a token `transfer` call worked only if the token logged a
+ * `Transfer` from the sender to the call's recipient, of a positive amount whenever the
+ * call asked for one. ERC-20 requires the event, and some tokens return `false` instead
+ * of reverting, so a successful receipt alone would report a transfer that moved nothing;
+ * a log to anyone else, or of nothing, pays the recipient nothing either. A
+ * fee-on-transfer token logs less than asked, and still counts; a non-compliant token
+ * that moves value without the event is reported failed. The call's arguments come from
+ * its signed calldata. Only verdicts on our own transactions apply it (`evmObservation`,
+ * `includedFinal`), never the decoder.
+ */
+function tokenTransferLanded(abi, tx, receipt) {
+    if (tx.to === null || !tx.input.startsWith(TRANSFER_SELECTOR))
+        return true;
+    const call = transferCall(tx.input);
+    if (!call)
+        return false;
+    return receipt.logs.some((log) => {
+        const transfer = log.address === tx.to ? abi.decodeTransfer(log) : null;
+        return (transfer !== null &&
+            transfer.from === tx.from &&
+            transfer.to.toLowerCase() === call.to &&
+            (call.amount === 0n || transfer.amount > 0n));
+    });
+}
+/** What the chain reports: where the transaction is, and its receipt's status. */
+function chainObservation(tx, receipt) {
+    if (receipt) {
+        return {
+            seen: 'block',
+            txHash: tx.hash,
+            blockHeight: receipt.blockNumber,
+            blockHash: receipt.blockHash,
+            success: receipt.status === 1,
+            ...(receipt.status === 0 ? { reason: 'reverted' } : {}),
+        };
+    }
+    if (tx.blockHash !== null && tx.blockNumber !== null) {
+        return {
+            seen: 'block',
+            txHash: tx.hash,
+            blockHeight: tx.blockNumber,
+            blockHash: tx.blockHash,
+        };
+    }
+    return { seen: 'mempool', txHash: tx.hash };
+}
+/**
+ * The verdict on one of our own transactions: the chain's status, and a successful token
+ * `transfer` that logged no transfer to its recipient is `success: false`.
+ */
+function evmObservation(abi, tx, receipt) {
+    const observation = chainObservation(tx, receipt);
+    if (!receipt || receipt.status === 0 || tokenTransferLanded(abi, tx, receipt)) {
+        return observation;
+    }
+    return {
+        ...observation,
+        success: false,
+        reason: 'token transfer failed',
+        failure: 'unevidenced',
+    };
+}
+/** bor's fee log or native transfer log, from the MRC20 predeploy. */
+const isPolygonSystemLog = (log) => log.address.toLowerCase() === network_1.POLYGON_FEE_LOG.address &&
+    (log.topics[0] === network_1.POLYGON_FEE_LOG.topic ||
+        log.topics[0] === network_1.POLYGON_TRANSFER_LOG.topic);
+/**
+ * Whether contract code ran: calldata, logs, or more execution gas than a plain transfer.
+ * On Polygon PoS, a plain transfer (no calldata, exactly 21,000 execution gas) also
+ * carries bor's system logs, which are no sign of code: its value is `tx.value`.
+ */
+function ranCode(tx, receipt, polygonSystemLogs) {
+    const executionGas = receipt.gasUsed - (receipt.gasUsedForL1 ?? 0n);
+    if (tx.input !== '0x' || executionGas !== fees_1.TRANSFER_GAS)
+        return true;
+    const logs = polygonSystemLogs
+        ? receipt.logs.filter((log) => !isPolygonSystemLog(log))
+        : receipt.logs;
+    return logs.length > 0;
+}
+/**
+ * Any transaction as the chain reports it: the receipt's status, never the token
+ * verdict, so a third party's call that shares the `transfer` selector is not misreported.
+ * Pass the network's config so bor's system logs do not make a plain Polygon transfer
+ * `partial`.
+ */
+function decodeTransaction(abi, tx, receipt, timestamp, network = { polygonSystemLogs: false }) {
+    const transfers = [];
+    const executed = receipt === null || receipt.status === 1;
+    const to = tx.to ?? receipt?.contractAddress ?? null;
+    if (executed && tx.value > 0n && to !== null) {
+        transfers.push({
+            locator: 'native',
+            from: [tx.from],
+            to,
+            asset: 'native',
+            amount: tx.value,
+            source: 'native',
+        });
+    }
+    for (const log of receipt?.status === 1 ? receipt.logs : []) {
+        const decoded = abi.decodeTransfer(log);
+        if (!decoded)
+            continue;
+        transfers.push({
+            locator: `log:${log.logIndex}`,
+            from: [decoded.from],
+            to: decoded.to,
+            asset: { standard: 'erc20', contract: log.address },
+            amount: decoded.amount,
+            source: 'token-event',
+        });
+    }
+    const decoding = receipt === null
+        ? 'partial'
+        : receipt.status === 0 || !ranCode(tx, receipt, network.polygonSystemLogs)
+            ? 'complete'
+            : 'partial';
+    return {
+        id: tx.hash,
+        observation: chainObservation(tx, receipt),
+        ...(receipt
+            ? {
+                fee: [
+                    {
+                        asset: 'native',
+                        amount: receipt.gasUsed * receipt.effectiveGasPrice + (receipt.l1Fee ?? 0n),
+                    },
+                ],
+            }
+            : {}),
+        transfers,
+        decoding,
+        ...(timestamp !== undefined ? { timestamp } : {}),
+        details: {
+            nonce: tx.nonce,
+            type: tx.type,
+            gasLimit: tx.gasLimit,
+            ...(receipt
+                ? {
+                    gasUsed: receipt.gasUsed,
+                    effectiveGasPrice: receipt.effectiveGasPrice,
+                    status: receipt.status,
+                }
+                : {}),
+            ...(receipt?.l1Fee !== undefined ? { l1Fee: receipt.l1Fee } : {}),
+        },
+    };
+}
+//# sourceMappingURL=decode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/adapters/evm/decode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Transactions and receipts into the driver model: native value and ERC-20 `Transfer`\n * logs as transfers, fees in the native asset, and `decoding: 'partial'` whenever\n * contract code ran, since internal transfers need traces, which the driver does not\n * read.\n */\nimport type {\n  DriverTransaction,\n  DriverTransfer,\n  DriverTxObservation,\n} from '../../core/driver/types';\nimport { ABI_WORD, ADDRESS_WORD } from './client';\nimport { TRANSFER_GAS } from './fees';\nimport { POLYGON_FEE_LOG, POLYGON_TRANSFER_LOG, type EvmNetworkConfig } from './network';\nimport type { EvmAbi, EvmLog, EvmReceipt, EvmTx } from './types';\n\nconst TRANSFER_SELECTOR = '0xa9059cbb';\n\n/**\n * The recipient (lower-cased) and amount of an ERC-20 `transfer(address,uint256)`\n * call: the selector, then two ABI words. `null` for any other calldata.\n */\nfunction transferCall(\n  input: string,\n): { readonly to: string; readonly amount: bigint } | null {\n  const to = `0x${input.slice(10, 74)}`;\n  const amount = `0x${input.slice(74)}`;\n  if (\n    !input.startsWith(TRANSFER_SELECTOR) ||\n    !ADDRESS_WORD.test(to) ||\n    !ABI_WORD.test(amount)\n  ) {\n    return null;\n  }\n  return { to: `0x${to.slice(26)}`.toLowerCase(), amount: BigInt(amount) };\n}\n\n/**\n * No phantom success: a token `transfer` call worked only if the token logged a\n * `Transfer` from the sender to the call's recipient, of a positive amount whenever the\n * call asked for one. ERC-20 requires the event, and some tokens return `false` instead\n * of reverting, so a successful receipt alone would report a transfer that moved nothing;\n * a log to anyone else, or of nothing, pays the recipient nothing either. A\n * fee-on-transfer token logs less than asked, and still counts; a non-compliant token\n * that moves value without the event is reported failed. The call's arguments come from\n * its signed calldata. Only verdicts on our own transactions apply it (`evmObservation`,\n * `includedFinal`), never the decoder.\n */\nexport function tokenTransferLanded(\n  abi: EvmAbi,\n  tx: EvmTx,\n  receipt: EvmReceipt,\n): boolean {\n  if (tx.to === null || !tx.input.startsWith(TRANSFER_SELECTOR)) return true;\n  const call = transferCall(tx.input);\n  if (!call) return false;\n  return receipt.logs.some((log) => {\n    const transfer = log.address === tx.to ? abi.decodeTransfer(log) : null;\n    return (\n      transfer !== null &&\n      transfer.from === tx.from &&\n      transfer.to.toLowerCase() === call.to &&\n      (call.amount === 0n || transfer.amount > 0n)\n    );\n  });\n}\n\n/** What the chain reports: where the transaction is, and its receipt's status. */\nexport function chainObservation(\n  tx: EvmTx,\n  receipt: EvmReceipt | null,\n): DriverTxObservation {\n  if (receipt) {\n    return {\n      seen: 'block',\n      txHash: tx.hash,\n      blockHeight: receipt.blockNumber,\n      blockHash: receipt.blockHash,\n      success: receipt.status === 1,\n      ...(receipt.status === 0 ? { reason: 'reverted' } : {}),\n    };\n  }\n  if (tx.blockHash !== null && tx.blockNumber !== null) {\n    return {\n      seen: 'block',\n      txHash: tx.hash,\n      blockHeight: tx.blockNumber,\n      blockHash: tx.blockHash,\n    };\n  }\n  return { seen: 'mempool', txHash: tx.hash };\n}\n\n/**\n * The verdict on one of our own transactions: the chain's status, and a successful token\n * `transfer` that logged no transfer to its recipient is `success: false`.\n */\nexport function evmObservation(\n  abi: EvmAbi,\n  tx: EvmTx,\n  receipt: EvmReceipt | null,\n): DriverTxObservation {\n  const observation = chainObservation(tx, receipt);\n  if (!receipt || receipt.status === 0 || tokenTransferLanded(abi, tx, receipt)) {\n    return observation;\n  }\n  return {\n    ...observation,\n    success: false,\n    reason: 'token transfer failed',\n    failure: 'unevidenced',\n  };\n}\n\n/** bor's fee log or native transfer log, from the MRC20 predeploy. */\nconst isPolygonSystemLog = (log: EvmLog): boolean =>\n  log.address.toLowerCase() === POLYGON_FEE_LOG.address &&\n  (log.topics[0] === POLYGON_FEE_LOG.topic ||\n    log.topics[0] === POLYGON_TRANSFER_LOG.topic);\n\n/**\n * Whether contract code ran: calldata, logs, or more execution gas than a plain transfer.\n * On Polygon PoS, a plain transfer (no calldata, exactly 21,000 execution gas) also\n * carries bor's system logs, which are no sign of code: its value is `tx.value`.\n */\nfunction ranCode(tx: EvmTx, receipt: EvmReceipt, polygonSystemLogs: boolean): boolean {\n  const executionGas = receipt.gasUsed - (receipt.gasUsedForL1 ?? 0n);\n  if (tx.input !== '0x' || executionGas !== TRANSFER_GAS) return true;\n  const logs = polygonSystemLogs\n    ? receipt.logs.filter((log) => !isPolygonSystemLog(log))\n    : receipt.logs;\n  return logs.length > 0;\n}\n\n/**\n * Any transaction as the chain reports it: the receipt's status, never the token\n * verdict, so a third party's call that shares the `transfer` selector is not misreported.\n * Pass the network's config so bor's system logs do not make a plain Polygon transfer\n * `partial`.\n */\nexport function decodeTransaction(\n  abi: EvmAbi,\n  tx: EvmTx,\n  receipt: EvmReceipt | null,\n  timestamp?: number,\n  network: Pick<EvmNetworkConfig, 'polygonSystemLogs'> = { polygonSystemLogs: false },\n): DriverTransaction {\n  const transfers: DriverTransfer[] = [];\n  const executed = receipt === null || receipt.status === 1;\n  const to = tx.to ?? receipt?.contractAddress ?? null;\n  if (executed && tx.value > 0n && to !== null) {\n    transfers.push({\n      locator: 'native',\n      from: [tx.from],\n      to,\n      asset: 'native',\n      amount: tx.value,\n      source: 'native',\n    });\n  }\n  for (const log of receipt?.status === 1 ? receipt.logs : []) {\n    const decoded = abi.decodeTransfer(log);\n    if (!decoded) continue;\n    transfers.push({\n      locator: `log:${log.logIndex}`,\n      from: [decoded.from],\n      to: decoded.to,\n      asset: { standard: 'erc20', contract: log.address },\n      amount: decoded.amount,\n      source: 'token-event',\n    });\n  }\n  const decoding =\n    receipt === null\n      ? 'partial'\n      : receipt.status === 0 || !ranCode(tx, receipt, network.polygonSystemLogs)\n        ? 'complete'\n        : 'partial';\n  return {\n    id: tx.hash,\n    observation: chainObservation(tx, receipt),\n    ...(receipt\n      ? {\n          fee: [\n            {\n              asset: 'native' as const,\n              amount: receipt.gasUsed * receipt.effectiveGasPrice + (receipt.l1Fee ?? 0n),\n            },\n          ],\n        }\n      : {}),\n    transfers,\n    decoding,\n    ...(timestamp !== undefined ? { timestamp } : {}),\n    details: {\n      nonce: tx.nonce,\n      type: tx.type,\n      gasLimit: tx.gasLimit,\n      ...(receipt\n        ? {\n            gasUsed: receipt.gasUsed,\n            effectiveGasPrice: receipt.effectiveGasPrice,\n            status: receipt.status,\n          }\n        : {}),\n      ...(receipt?.l1Fee !== undefined ? { l1Fee: receipt.l1Fee } : {}),\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,8 @@
+/**
+ * `EvmDriver`: all EVM logic, over the `EvmClient` strategy. One factory serves
+ * every EVM chain and network; each network's registry data configures it.
+ */
+import type { DriverFactory } from '../../core/driver/types';
+import type { Transport } from '../../core/transport/types';
+import type { EvmClient } from './types';
+export declare function evmDriverFactory(makeClient: (transport: Transport, chainId: bigint) => EvmClient): DriverFactory;

package/dist/adapters/evm/driver.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evmDriverFactory = evmDriverFactory;
+const builder_1 = require("./builder");
+const client_1 = require("./client");
+const network_1 = require("./network");
+const proofs_1 = require("./proofs");
+const reader_1 = require("./reader");
+const probe = async (call, method) => (0, client_1.quantity)(await call.rpc(method), method);
+/**
+ * Identity is the decimal `eth_chainId`, the form of the network's registry identity; the
+ * height is `eth_blockNumber`. Only endpoints whose identity matches feed health heights.
+ */
+function probes(expectedIdentity) {
+    return {
+        identity: async (call) => (await probe(call, 'eth_chainId')).toString(),
+        ...(expectedIdentity !== undefined ? { expectedIdentity } : {}),
+        height: (call) => probe(call, 'eth_blockNumber'),
+    };
+}
+function evmDriverFactory(makeClient) {
+    return {
+        async create(ctx) {
+            // The handle's options too (`maxFeePerGas`); an unknown one is refused, so a
+            // misspelt key never passes silently.
+            const config = (0, network_1.evmNetworkConfig)(ctx.chain, ctx.network, ctx.options);
+            // Probes go on every transport this driver receives, before any traffic: an
+            // endpoint without them stays unverified.
+            ctx.transport.setProbes(probes(ctx.network.identity));
+            ctx.indexer?.setProbes(probes(ctx.network.identity));
+            const client = makeClient(ctx.transport, config.chainId);
+            const evm = {
+                client,
+                chain: ctx.chain,
+                network: ctx.network,
+                config,
+                log: ctx.log,
+            };
+            const replacement = (0, builder_1.createEvmReplacement)(evm);
+            const ext = (0, reader_1.createEvmExt)(client);
+            return {
+                ordering: 'nonce',
+                capabilities: config.capabilities,
+                address: (0, reader_1.createEvmAddressCodec)(client),
+                reader: (0, reader_1.createEvmReader)(evm),
+                builder: (0, builder_1.createEvmBuilder)(evm),
+                broadcaster: (0, builder_1.createEvmBroadcaster)(client, config.chainId),
+                proofs: (0, proofs_1.createEvmProofs)(evm),
+                sequence: (0, reader_1.createEvmSequence)(client),
+                ...(replacement ? { replacement } : {}),
+                blocks: (0, proofs_1.createEvmBlocks)(evm),
+                ext: { evm: { getNonce: ext.evm.getNonce } },
+                limits: () => ({ maxOutputs: 1 }),
+                // A fresh SDK client on every call, never the driver's own: a caller may mutate
+                // it (listeners, polling) without touching other handles.
+                createNativeClient: () => client.createNative(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/adapters/evm/driver.ts"],"names":[],"mappings":";;AAkCA,4CAyCC;AArED,uCAAyF;AACzF,qCAAoC;AACpC,uCAA6C;AAC7C,qCAA4D;AAC5D,qCAMkB;AAGlB,MAAM,KAAK,GAAG,KAAK,EAAE,IAAkB,EAAE,MAAc,EAAmB,EAAE,CAC1E,IAAA,iBAAQ,EAAC,MAAM,IAAI,CAAC,GAAG,CAAU,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAEpD;;;GAGG;AACH,SAAS,MAAM,CAAC,gBAAoC;IAClD,OAAO;QACL,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE;QACvE,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAC9B,UAAgE;IAEhE,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,6EAA6E;YAC7E,sCAAsC;YACtC,MAAM,MAAM,GAAG,IAAA,0BAAgB,EAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACrE,4EAA4E;YAC5E,0CAA0C;YAC1C,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtD,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,GAAG,GAAe;gBACtB,MAAM;gBACN,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,MAAM;gBACN,GAAG,EAAE,GAAG,CAAC,GAAG;aACb,CAAC;YACF,MAAM,WAAW,GAAG,IAAA,8BAAoB,EAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,MAAM,CAAC,CAAC;YACjC,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,OAAO,EAAE,IAAA,8BAAqB,EAAC,MAAM,CAAC;gBACtC,MAAM,EAAE,IAAA,wBAAe,EAAC,GAAG,CAAC;gBAC5B,OAAO,EAAE,IAAA,0BAAgB,EAAC,GAAG,CAAC;gBAC9B,WAAW,EAAE,IAAA,8BAAoB,EAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;gBACzD,MAAM,EAAE,IAAA,wBAAe,EAAC,GAAG,CAAC;gBAC5B,QAAQ,EAAE,IAAA,0BAAiB,EAAC,MAAM,CAAC;gBACnC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,MAAM,EAAE,IAAA,wBAAe,EAAC,GAAG,CAAC;gBAC5B,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC5C,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;gBACjC,gFAAgF;gBAChF,0DAA0D;gBAC1D,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;aAChD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * `EvmDriver`: all EVM logic, over the `EvmClient` strategy. One factory serves\n * every EVM chain and network; each network's registry data configures it.\n */\nimport type { ChainDriver, DriverFactory } from '../../core/driver/types';\nimport type { EndpointCall, HealthProbes, Transport } from '../../core/transport/types';\nimport { createEvmBroadcaster, createEvmBuilder, createEvmReplacement } from './builder';\nimport { quantity } from './client';\nimport { evmNetworkConfig } from './network';\nimport { createEvmBlocks, createEvmProofs } from './proofs';\nimport {\n  createEvmAddressCodec,\n  createEvmExt,\n  createEvmReader,\n  createEvmSequence,\n  type EvmContext,\n} from './reader';\nimport type { EvmClient } from './types';\n\nconst probe = async (call: EndpointCall, method: string): Promise<bigint> =>\n  quantity(await call.rpc<unknown>(method), method);\n\n/**\n * Identity is the decimal `eth_chainId`, the form of the network's registry identity; the\n * height is `eth_blockNumber`. Only endpoints whose identity matches feed health heights.\n */\nfunction probes(expectedIdentity: string | undefined): HealthProbes {\n  return {\n    identity: async (call) => (await probe(call, 'eth_chainId')).toString(),\n    ...(expectedIdentity !== undefined ? { expectedIdentity } : {}),\n    height: (call) => probe(call, 'eth_blockNumber'),\n  };\n}\n\nexport function evmDriverFactory(\n  makeClient: (transport: Transport, chainId: bigint) => EvmClient,\n): DriverFactory {\n  return {\n    async create(ctx): Promise<ChainDriver> {\n      // The handle's options too (`maxFeePerGas`); an unknown one is refused, so a\n      // misspelt key never passes silently.\n      const config = evmNetworkConfig(ctx.chain, ctx.network, ctx.options);\n      // Probes go on every transport this driver receives, before any traffic: an\n      // endpoint without them stays unverified.\n      ctx.transport.setProbes(probes(ctx.network.identity));\n      ctx.indexer?.setProbes(probes(ctx.network.identity));\n      const client = makeClient(ctx.transport, config.chainId);\n      const evm: EvmContext = {\n        client,\n        chain: ctx.chain,\n        network: ctx.network,\n        config,\n        log: ctx.log,\n      };\n      const replacement = createEvmReplacement(evm);\n      const ext = createEvmExt(client);\n      return {\n        ordering: 'nonce',\n        capabilities: config.capabilities,\n        address: createEvmAddressCodec(client),\n        reader: createEvmReader(evm),\n        builder: createEvmBuilder(evm),\n        broadcaster: createEvmBroadcaster(client, config.chainId),\n        proofs: createEvmProofs(evm),\n        sequence: createEvmSequence(client),\n        ...(replacement ? { replacement } : {}),\n        blocks: createEvmBlocks(evm),\n        ext: { evm: { getNonce: ext.evm.getNonce } },\n        limits: () => ({ maxOutputs: 1 }),\n        // A fresh SDK client on every call, never the driver's own: a caller may mutate\n        // it (listeners, polling) without touching other handles.\n        createNativeClient: () => client.createNative(),\n      };\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,20 @@
+/**
+ * Classifies a node's answer to `eth_sendRawTransaction`. The patterns are
+ * geth's texts (txpool and RPC), which the geth-derived clients of most built-in chains
+ * share; an Ethereum endpoint may run any client, so a text not listed here falls to the
+ * safe default, a generic refusal. The returned reasons are short, fixed texts: a
+ * node's own text can carry addresses and amounts ("insufficient funds …: address 0x… have
+ * … want …") and is never passed on. Every result is frozen, so no caller can alter a later
+ * one.
+ */
+import type { BroadcastResult } from '../../core/driver/types';
+/** The node's answer at its word (see `classifyOwnBroadcast` for the bytes we sent). */
+export declare function classifyBroadcastError(message: string): BroadcastResult;
+/**
+ * A node's rejection is a claim. The answer to `sentHex`, the
+ * bytes this driver sent on the network whose chain id is `chainId`: a `rejected` stands
+ * only when its reason holds for those bytes, read SDK-free (`readSentTx`); otherwise it is a
+ * refusal, so a lying endpoint that relays our bytes can never end the Operation and invite
+ * a second payment. Every other answer is the node's, as `classifyBroadcastError` reads it.
+ */
+export declare function classifyOwnBroadcast(message: string, sentHex: string, chainId: bigint): BroadcastResult;

package/dist/adapters/evm/errors.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyBroadcastError = classifyBroadcastError;
+exports.classifyOwnBroadcast = classifyOwnBroadcast;
+const rawtx_1 = require("./rawtx");
+const refused = (code, reason) => Object.freeze({ kind: 'refused', code, reason });
+const rejected = (reason) => Object.freeze({ kind: 'rejected', reason });
+/** Success: the node already holds these bytes, or they are already mined. */
+const ALREADY_KNOWN = /already known|known transaction|already imported|alreadyknown|already exists|already in chain/i;
+const ALREADY_KNOWN_RESULT = Object.freeze({ kind: 'already-known' });
+/**
+ * State-dependent or node policy: the same bytes may become valid later or on another node,
+ * or may already be included (observed only).
+ */
+const REFUSED = [
+    [/nonce too low/i, refused('NONCE_CONFLICT', 'nonce too low')],
+    [/nonce too high|nonce gap/i, refused('NONCE_TOO_HIGH', 'nonce too high')],
+    [/insufficient funds/i, refused('INSUFFICIENT_FUNDS', 'insufficient funds')],
+    [
+        /replacement transaction underpriced/i,
+        refused('FEE_TOO_LOW', 'replacement underpriced'),
+    ],
+    [
+        /underpriced|fee too low|less than block base fee|gas price too low|below minimum/i,
+        refused('FEE_TOO_LOW', 'fee too low'),
+    ],
+    // The block gas limit can rise.
+    [
+        /exceeds block gas limit/i,
+        refused('TX_REFUSED', 'gas limit above the block gas limit'),
+    ],
+    // A pool gates types on the forks active at its head (a syncing node) and on its config.
+    [
+        /transaction type not supported|tx type not supported/i,
+        refused('TX_REFUSED', 'unsupported transaction type'),
+    ],
+    // Arbitrum's intrinsic gas includes the L1 poster cost, which moves.
+    [/intrinsic gas too low/i, refused('TX_REFUSED', 'gas limit below intrinsic gas')],
+    // Node policy: another node may accept the same bytes.
+    [/only replay-protected/i, refused('TX_REFUSED', 'replay protection required')],
+    [/oversized data/i, refused('TX_REFUSED', 'transaction too large')],
+];
+/**
+ * Invalid by construction: these bytes can never be included on any node. Exact texts only,
+ * so a state-dependent cause that merely shares a word is never taken for one of these.
+ * `invalid chain id` comes first: geth wraps it as "invalid sender: invalid chain id …".
+ */
+const REJECTED = [
+    {
+        pattern: /invalid chain id/i,
+        result: rejected('wrong chain id'),
+        holds: (sent, chainId) => sent !== 'malformed' && sent.chainId !== undefined && sent.chainId !== chainId,
+    },
+    {
+        pattern: /invalid sender|invalid signature|invalid transaction v, r, s values/i,
+        result: rejected('invalid signature'),
+        holds: (sent) => sent !== 'malformed' && !(0, rawtx_1.signatureValuesValid)(sent),
+    },
+    {
+        pattern: /\brlp:|typed transaction too short/i,
+        result: rejected('malformed transaction'),
+        holds: (sent) => sent === 'malformed',
+    },
+    {
+        pattern: /max priority fee per gas higher than max fee per gas|tip above fee cap/i,
+        result: rejected('priority fee above the fee cap'),
+        holds: (sent) => sent !== 'malformed' &&
+            sent.type === 2 &&
+            sent.maxPriorityFeePerGas > sent.maxFeePerGas,
+    },
+];
+const REFUSED_BY_NODE = refused('TX_REFUSED', 'refused by the node');
+/**
+ * `rejected` ends an Attempt without proof, so any doubt falls toward `refused`: the
+ * refusal patterns are checked first ("invalid sender: transaction type not supported" is a
+ * refusal), and an unlisted text is a refusal.
+ */
+function classified(message) {
+    if (ALREADY_KNOWN.test(message))
+        return { result: ALREADY_KNOWN_RESULT };
+    for (const [pattern, result] of REFUSED) {
+        if (pattern.test(message))
+            return { result };
+    }
+    const rejection = REJECTED.find((entry) => entry.pattern.test(message));
+    return rejection
+        ? { result: rejection.result, rejection }
+        : { result: REFUSED_BY_NODE };
+}
+/** The node's answer at its word (see `classifyOwnBroadcast` for the bytes we sent). */
+function classifyBroadcastError(message) {
+    return classified(message).result;
+}
+/** A rejection this driver cannot confirm for the bytes it sent: observed, never terminal. */
+const UNCONFIRMED = refused('TX_REFUSED', 'the node claimed the transaction is invalid');
+/**
+ * A node's rejection is a claim. The answer to `sentHex`, the
+ * bytes this driver sent on the network whose chain id is `chainId`: a `rejected` stands
+ * only when its reason holds for those bytes, read SDK-free (`readSentTx`); otherwise it is a
+ * refusal, so a lying endpoint that relays our bytes can never end the Operation and invite
+ * a second payment. Every other answer is the node's, as `classifyBroadcastError` reads it.
+ */
+function classifyOwnBroadcast(message, sentHex, chainId) {
+    const { result, rejection } = classified(message);
+    if (!rejection)
+        return result;
+    const sent = (0, rawtx_1.readSentTx)(sentHex);
+    return sent !== undefined && rejection.holds(sent, chainId) ? result : UNCONFIRMED;
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adapters/evm/errors.ts"],"names":[],"mappings":";;AAsHA,wDAEC;AAeD,oDASC;AAtID,mCAA2E;AAI3E,MAAM,OAAO,GAAG,CAAC,IAAiB,EAAE,MAAc,EAAmB,EAAE,CACrE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAmB,EAAE,CACnD,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;AAE9C,8EAA8E;AAC9E,MAAM,aAAa,GACjB,gGAAgG,CAAC;AACnG,MAAM,oBAAoB,GAAoB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,OAAO,GAAoD;IAC/D,CAAC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAC9D,CAAC,2BAA2B,EAAE,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IAC1E,CAAC,qBAAqB,EAAE,OAAO,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IAC5E;QACE,sCAAsC;QACtC,OAAO,CAAC,aAAa,EAAE,yBAAyB,CAAC;KAClD;IACD;QACE,mFAAmF;QACnF,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC;KACtC;IACD,gCAAgC;IAChC;QACE,0BAA0B;QAC1B,OAAO,CAAC,YAAY,EAAE,qCAAqC,CAAC;KAC7D;IACD,yFAAyF;IACzF;QACE,uDAAuD;QACvD,OAAO,CAAC,YAAY,EAAE,8BAA8B,CAAC;KACtD;IACD,qEAAqE;IACrE,CAAC,wBAAwB,EAAE,OAAO,CAAC,YAAY,EAAE,+BAA+B,CAAC,CAAC;IAClF,uDAAuD;IACvD,CAAC,wBAAwB,EAAE,OAAO,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IAC/E,CAAC,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;CACpE,CAAC;AASF;;;;GAIG;AACH,MAAM,QAAQ,GAAyB;IACrC;QACE,OAAO,EAAE,mBAAmB;QAC5B,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC;QAClC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACvB,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;KACjF;IACD;QACE,OAAO,EAAE,sEAAsE;QAC/E,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC;QACrC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,IAAA,4BAAoB,EAAC,IAAI,CAAC;KACrE;IACD;QACE,OAAO,EAAE,qCAAqC;QAC9C,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC;QACzC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW;KACtC;IACD;QACE,OAAO,EAAE,yEAAyE;QAClF,MAAM,EAAE,QAAQ,CAAC,gCAAgC,CAAC;QAClD,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CACd,IAAI,KAAK,WAAW;YACpB,IAAI,CAAC,IAAI,KAAK,CAAC;YACd,IAAI,CAAC,oBAA+B,GAAI,IAAI,CAAC,YAAuB;KACxE;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;AAErE;;;;GAIG;AACH,SAAS,UAAU,CAAC,OAAe;IAIjC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACzE,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,OAAO,SAAS;QACd,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE;QACzC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAClC,CAAC;AAED,wFAAwF;AACxF,SAAgB,sBAAsB,CAAC,OAAe;IACpD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACpC,CAAC;AAED,8FAA8F;AAC9F,MAAM,WAAW,GAAoB,OAAO,CAC1C,YAAY,EACZ,6CAA6C,CAC9C,CAAC;AAEF;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,OAAe,EACf,OAAe,EACf,OAAe;IAEf,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC;IACjC,OAAO,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;AACrF,CAAC","sourcesContent":["/**\n * Classifies a node's answer to `eth_sendRawTransaction`. The patterns are\n * geth's texts (txpool and RPC), which the geth-derived clients of most built-in chains\n * share; an Ethereum endpoint may run any client, so a text not listed here falls to the\n * safe default, a generic refusal. The returned reasons are short, fixed texts: a\n * node's own text can carry addresses and amounts (\"insufficient funds …: address 0x… have\n * … want …\") and is never passed on. Every result is frozen, so no caller can alter a later\n * one.\n */\nimport type { BroadcastResult } from '../../core/driver/types';\nimport { readSentTx, signatureValuesValid, type EvmSentTx } from './rawtx';\n\ntype RefusalCode = Extract<BroadcastResult, { kind: 'refused' }>['code'];\n\nconst refused = (code: RefusalCode, reason: string): BroadcastResult =>\n  Object.freeze({ kind: 'refused', code, reason });\nconst rejected = (reason: string): BroadcastResult =>\n  Object.freeze({ kind: 'rejected', reason });\n\n/** Success: the node already holds these bytes, or they are already mined. */\nconst ALREADY_KNOWN =\n  /already known|known transaction|already imported|alreadyknown|already exists|already in chain/i;\nconst ALREADY_KNOWN_RESULT: BroadcastResult = Object.freeze({ kind: 'already-known' });\n\n/**\n * State-dependent or node policy: the same bytes may become valid later or on another node,\n * or may already be included (observed only).\n */\nconst REFUSED: readonly (readonly [RegExp, BroadcastResult])[] = [\n  [/nonce too low/i, refused('NONCE_CONFLICT', 'nonce too low')],\n  [/nonce too high|nonce gap/i, refused('NONCE_TOO_HIGH', 'nonce too high')],\n  [/insufficient funds/i, refused('INSUFFICIENT_FUNDS', 'insufficient funds')],\n  [\n    /replacement transaction underpriced/i,\n    refused('FEE_TOO_LOW', 'replacement underpriced'),\n  ],\n  [\n    /underpriced|fee too low|less than block base fee|gas price too low|below minimum/i,\n    refused('FEE_TOO_LOW', 'fee too low'),\n  ],\n  // The block gas limit can rise.\n  [\n    /exceeds block gas limit/i,\n    refused('TX_REFUSED', 'gas limit above the block gas limit'),\n  ],\n  // A pool gates types on the forks active at its head (a syncing node) and on its config.\n  [\n    /transaction type not supported|tx type not supported/i,\n    refused('TX_REFUSED', 'unsupported transaction type'),\n  ],\n  // Arbitrum's intrinsic gas includes the L1 poster cost, which moves.\n  [/intrinsic gas too low/i, refused('TX_REFUSED', 'gas limit below intrinsic gas')],\n  // Node policy: another node may accept the same bytes.\n  [/only replay-protected/i, refused('TX_REFUSED', 'replay protection required')],\n  [/oversized data/i, refused('TX_REFUSED', 'transaction too large')],\n];\n\n/** A rejection and the check that confirms it for the bytes we sent. */\ninterface Rejection {\n  readonly pattern: RegExp;\n  readonly result: BroadcastResult;\n  readonly holds: (sent: EvmSentTx | 'malformed', chainId: bigint) => boolean;\n}\n\n/**\n * Invalid by construction: these bytes can never be included on any node. Exact texts only,\n * so a state-dependent cause that merely shares a word is never taken for one of these.\n * `invalid chain id` comes first: geth wraps it as \"invalid sender: invalid chain id …\".\n */\nconst REJECTED: readonly Rejection[] = [\n  {\n    pattern: /invalid chain id/i,\n    result: rejected('wrong chain id'),\n    holds: (sent, chainId) =>\n      sent !== 'malformed' && sent.chainId !== undefined && sent.chainId !== chainId,\n  },\n  {\n    pattern: /invalid sender|invalid signature|invalid transaction v, r, s values/i,\n    result: rejected('invalid signature'),\n    holds: (sent) => sent !== 'malformed' && !signatureValuesValid(sent),\n  },\n  {\n    pattern: /\\brlp:|typed transaction too short/i,\n    result: rejected('malformed transaction'),\n    holds: (sent) => sent === 'malformed',\n  },\n  {\n    pattern: /max priority fee per gas higher than max fee per gas|tip above fee cap/i,\n    result: rejected('priority fee above the fee cap'),\n    holds: (sent) =>\n      sent !== 'malformed' &&\n      sent.type === 2 &&\n      (sent.maxPriorityFeePerGas as bigint) > (sent.maxFeePerGas as bigint),\n  },\n];\n\nconst REFUSED_BY_NODE = refused('TX_REFUSED', 'refused by the node');\n\n/**\n * `rejected` ends an Attempt without proof, so any doubt falls toward `refused`: the\n * refusal patterns are checked first (\"invalid sender: transaction type not supported\" is a\n * refusal), and an unlisted text is a refusal.\n */\nfunction classified(message: string): {\n  readonly result: BroadcastResult;\n  readonly rejection?: Rejection;\n} {\n  if (ALREADY_KNOWN.test(message)) return { result: ALREADY_KNOWN_RESULT };\n  for (const [pattern, result] of REFUSED) {\n    if (pattern.test(message)) return { result };\n  }\n  const rejection = REJECTED.find((entry) => entry.pattern.test(message));\n  return rejection\n    ? { result: rejection.result, rejection }\n    : { result: REFUSED_BY_NODE };\n}\n\n/** The node's answer at its word (see `classifyOwnBroadcast` for the bytes we sent). */\nexport function classifyBroadcastError(message: string): BroadcastResult {\n  return classified(message).result;\n}\n\n/** A rejection this driver cannot confirm for the bytes it sent: observed, never terminal. */\nconst UNCONFIRMED: BroadcastResult = refused(\n  'TX_REFUSED',\n  'the node claimed the transaction is invalid',\n);\n\n/**\n * A node's rejection is a claim. The answer to `sentHex`, the\n * bytes this driver sent on the network whose chain id is `chainId`: a `rejected` stands\n * only when its reason holds for those bytes, read SDK-free (`readSentTx`); otherwise it is a\n * refusal, so a lying endpoint that relays our bytes can never end the Operation and invite\n * a second payment. Every other answer is the node's, as `classifyBroadcastError` reads it.\n */\nexport function classifyOwnBroadcast(\n  message: string,\n  sentHex: string,\n  chainId: bigint,\n): BroadcastResult {\n  const { result, rejection } = classified(message);\n  if (!rejection) return result;\n  const sent = readSentTx(sentHex);\n  return sent !== undefined && rejection.holds(sent, chainId) ? result : UNCONFIRMED;\n}\n"]}

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

@@ -0,0 +1,43 @@
+/**
+ * `EthersClient`: the ethers v6 strategy (the EVM default). Driver I/O goes straight to the
+ * core transport under each call's tags, never through ethers' provider: ethers' request
+ * queue drains on a real 0 ms timer that fake-clock tests cannot step deterministically,
+ * and the driver needs none of it (one request per call). ethers does the codec work, and
+ * `TransportJsonRpcProvider` (static network, no batching, no cache, no polling, `_send` →
+ * transport) is the `crypto-aio/native` client.
+ */
+import { JsonRpcApiProvider, Network, type JsonRpcPayload, type JsonRpcResult } from 'ethers';
+import type { DisposableNativeClient } from '../../core/driver/types';
+import type { Transport } from '../../core/transport/types';
+import { EvmClientBase } from './client';
+import type { EvmAbi, EvmCallTags, EvmSignature, EvmTxFields } from './types';
+type Call = (method: string, params: unknown) => Promise<unknown>;
+/**
+ * The ethers provider bridged onto the core transport through `call`: the native client
+ * only.
+ */
+export declare class TransportJsonRpcProvider extends JsonRpcApiProvider {
+    #private;
+    constructor(network: Network, call: Call);
+    _send(payload: JsonRpcPayload | JsonRpcPayload[]): Promise<JsonRpcResult[]>;
+}
+export declare class EthersClient extends EvmClientBase {
+    #private;
+    readonly library = "ethers";
+    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 `ethers` adapter's driver factory; the manifest's `load()` returns it. */
+export declare const ethersDriverFactory: import("../../core/driver/types").DriverFactory;
+export {};