crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/evm/client.js

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

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,170 @@
+"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' };
+}
+/** 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 { ...observation, success: false, reason: 'token transfer failed' };\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;