web3-mev-error-decoder 0.0.0-stage → 0.1.0

package/dist/transaction/viem.js

@@ -0,0 +1,86 @@
+import { extractRevertData, callRequestFromViem, toInterface } from '../utils.js';
+import { ErrorDecoder } from '../error-decoder/index.js';
+import { TransactionRevertedError, TransactionTimeoutError, } from './types.js';
+/**
+ * Wait for a transaction with timeout, confirmations, replacement callback,
+ * decoded logs, and automatic revert decoding.
+ */
+export async function waitForTransactionViem(opts) {
+    const { client, hash, confirmations = 1, timeout = 120_000, abis, onReplaced, throwOnRevert = true } = opts;
+    const receipt = await client.waitForTransactionReceipt({
+        hash: hash,
+        confirmations,
+        timeout,
+        onReplaced: onReplaced,
+    });
+    if (receipt.status === 'reverted') {
+        const decoded = await getRevertReasonViem(client, hash, abis ? Object.values(abis) : undefined);
+        if (throwOnRevert) {
+            throw new TransactionRevertedError(receipt, decoded, hash);
+        }
+        return { receipt, logs: [], decodedError: decoded };
+    }
+    return { receipt, logs: decodeViemReceiptLogs(receipt, abis) };
+}
+/** Send a transaction via a wallet client, then wait with full decode/timeout handling. */
+export async function sendAndConfirmViem(wallet, request, opts = {}) {
+    const client = opts.publicClient ?? wallet;
+    const hash = (await wallet.sendTransaction(request));
+    const result = await waitForTransactionViem({
+        client,
+        hash,
+        confirmations: opts.confirmations,
+        timeout: opts.timeout,
+        abis: opts.abis,
+        throwOnRevert: opts.throwOnRevert,
+    });
+    return { ...result, hash };
+}
+/**
+ * Recover + decode the revert reason of a mined reverted transaction for viem
+ * by replaying it via `publicClient.call`.
+ */
+export async function getRevertReasonViem(client, txHash, abis) {
+    const receipt = await client.getTransactionReceipt({ hash: txHash });
+    if (receipt && receipt.status === 'success') {
+        throw new Error('Transaction succeeded — there is no revert reason');
+    }
+    const tx = await client.getTransaction({ hash: txHash });
+    if (!tx) {
+        throw new Error(`Transaction ${txHash} not found`);
+    }
+    const callRequest = callRequestFromViem(tx);
+    let data;
+    try {
+        await client.call({ ...callRequest, blockNumber: receipt?.blockNumber });
+        await client.call({ ...callRequest });
+    }
+    catch (e) {
+        data = extractRevertData(e);
+    }
+    return new ErrorDecoder(abis).decodeData(data);
+}
+/** Decode logs of a viem receipt using the provided ABI map (parsed with ethers Interface). */
+export function decodeViemReceiptLogs(receipt, abis) {
+    if (!abis)
+        return [];
+    const out = [];
+    for (const log of receipt.logs) {
+        const abi = abis[log.address.toLowerCase()];
+        if (!abi)
+            continue;
+        try {
+            const parsed = toInterface(abi).parseLog({
+                topics: [...(log.topics ?? [])],
+                data: log.data,
+            });
+            out.push({ log, name: parsed?.name ?? null, args: parsed?.args?.toArray() ?? [] });
+        }
+        catch {
+            out.push({ log, name: null });
+        }
+    }
+    return out;
+}
+export { TransactionTimeoutError };
+//# sourceMappingURL=viem.js.map

package/dist/transaction/viem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem.js","sourceRoot":"","sources":["../../src/transaction/viem.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+import type { Interface } from 'ethers';
+/** Anything that ethers `new Interface(...)` accepts: JSON ABI array, human-readable ABI (string or array), or an Interface. */
+export type AbiLike = Interface | string | readonly (string | Record<string, unknown>)[];
+/** A single call item accepted by multicall helpers. */
+export interface CallInput {
+    /** Contract address. */
+    target: string;
+    /** Raw calldata. If omitted, `abi` + `method` (+ `args`) are required. */
+    data?: string;
+    /** Contract ABI used to encode/decode. */
+    abi?: AbiLike;
+    /** Function name to call. */
+    method?: string;
+    /** Function arguments. */
+    args?: readonly unknown[];
+    /** Per-call override: whether failures are allowed (defaults to batch-level `allowFailure`). */
+    allowFailure?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,59 @@
+import { Interface, type TransactionResponse } from 'ethers';
+import type { AbiLike } from './types.js';
+/**
+ * Normalize an ABI-like value into ethers-compatible fragments.
+ *
+ * A bare human-readable string must be passed to `new Interface` as an array
+ * (a bare string is interpreted as JSON); JSON-encoded ABI strings are parsed.
+ */
+export declare function normalizeAbi(abi: string | readonly (string | Record<string, unknown>)[]): any[];
+/** Convert a JSON ABI / human-readable ABI / fragments into an ethers Interface. */
+export declare function toInterface(abi: AbiLike): Interface;
+/** Merge several ABIs (or Interfaces) into a single Interface (for custom error decoding). */
+export declare function mergeAbis(abis: readonly AbiLike[]): Interface;
+/**
+ * Extract raw revert data (`0x...`) from an arbitrary thrown error.
+ * Handles:
+ *  - ethers CALL_EXCEPTION errors (`error.data`, `error.info.data`, `error.error.data`)
+ *  - viem `ContractFunctionRevertedError` (`rawData`, `data`)
+ *  - nested `cause` chains
+ */
+export declare function extractRevertData(error: unknown): string | undefined;
+export declare function getErrorMessage(error: unknown): string;
+/** Reject with a timeout error if the promise does not settle within `ms`. */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
+/** Resolve after `delay` ms (optionally with a value). */
+export declare function wait<T = undefined>(delay: number, returnValue?: T): Promise<T | undefined>;
+/** First settled-resolved value among `promises`, checked synchronously (never rethrows). */
+export declare function checkAnyResolved(promises: Promise<any>[]): Promise<any | null>;
+/** Rejection reasons of already-settled promises; null while any may still resolve. */
+export declare function checkAllRejected(promises: Promise<any>[]): Promise<any[] | null>;
+/** Build an ethers `call` request from a mined/sent transaction (for revert replay). */
+export declare function callRequestFromTx(tx: TransactionResponse): {
+    from: string;
+    to: string | null;
+    data: string;
+    value: bigint;
+    gasLimit: bigint;
+    gasPrice: bigint;
+    maxFeePerGas: bigint | undefined;
+    maxPriorityFeePerGas: bigint | undefined;
+    accessList: import("ethers").AccessList | undefined;
+    type: number;
+};
+export declare function isPlainHex(value: unknown): value is string;
+/** Build a viem `call` request from a viem transaction object (for revert replay). */
+export declare function callRequestFromViem(tx: {
+    to?: `0x${string}` | null;
+    data?: `0x${string}` | null;
+    value?: bigint | null;
+    gas?: bigint | null;
+    gasPrice?: bigint | null;
+    maxFeePerGas?: bigint | null;
+    maxPriorityFeePerGas?: bigint | null;
+}): {
+    to: `0x${string}` | undefined;
+    data: `0x${string}` | undefined;
+    value: bigint | undefined;
+    gas: bigint | undefined;
+};

package/dist/utils.js

@@ -0,0 +1,140 @@
+import { Interface } from 'ethers';
+/**
+ * Normalize an ABI-like value into ethers-compatible fragments.
+ *
+ * A bare human-readable string must be passed to `new Interface` as an array
+ * (a bare string is interpreted as JSON); JSON-encoded ABI strings are parsed.
+ */
+export function normalizeAbi(abi) {
+    if (typeof abi === 'string') {
+        const trimmed = abi.trim();
+        if (trimmed.startsWith('[')) {
+            return JSON.parse(trimmed);
+        }
+        return abi.includes('\n') ? abi.split('\n') : [abi];
+    }
+    return [...abi];
+}
+/** Convert a JSON ABI / human-readable ABI / fragments into an ethers Interface. */
+export function toInterface(abi) {
+    if (abi instanceof Interface)
+        return abi;
+    return new Interface(normalizeAbi(abi));
+}
+/** Merge several ABIs (or Interfaces) into a single Interface (for custom error decoding). */
+export function mergeAbis(abis) {
+    const fragments = [];
+    for (const abi of abis) {
+        if (abi instanceof Interface) {
+            fragments.push(...abi.fragments);
+        }
+        else {
+            fragments.push(...normalizeAbi(abi));
+        }
+    }
+    return new Interface(fragments);
+}
+/**
+ * Extract raw revert data (`0x...`) from an arbitrary thrown error.
+ * Handles:
+ *  - ethers CALL_EXCEPTION errors (`error.data`, `error.info.data`, `error.error.data`)
+ *  - viem `ContractFunctionRevertedError` (`rawData`, `data`)
+ *  - nested `cause` chains
+ */
+export function extractRevertData(error) {
+    if (!error)
+        return undefined;
+    let cur = error;
+    let depth = 0;
+    while (cur && depth < 10) {
+        const candidates = [
+            cur.data,
+            cur.error?.data,
+            cur.info?.error?.data,
+            cur.info?.data,
+            cur.rawData,
+            cur.cause?.rawData,
+        ];
+        for (const c of candidates) {
+            if (typeof c === 'string' && c.startsWith('0x') && c !== '0x')
+                return c;
+            if (c &&
+                typeof c === 'object' &&
+                typeof c.data === 'string' &&
+                c.data.startsWith('0x') &&
+                c.data !== '0x') {
+                return c.data;
+            }
+        }
+        cur = cur.cause ?? cur.error ?? undefined;
+        depth++;
+    }
+    return undefined;
+}
+export function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+/** Reject with a timeout error if the promise does not settle within `ms`. */
+export function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Timed out after ${ms}ms`)), ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+/** Resolve after `delay` ms (optionally with a value). */
+export function wait(delay, returnValue) {
+    return new Promise((resolve) => setTimeout(() => resolve(returnValue), delay));
+}
+/** First settled-resolved value among `promises`, checked synchronously (never rethrows). */
+export function checkAnyResolved(promises) {
+    return Promise.race([
+        ...promises.map((p) => p.then((value) => ({ resolved: true, value }), () => ({ resolved: false }))),
+        new Promise((resolve) => setTimeout(() => resolve({ resolved: false }), 0)),
+    ]).then((result) => (result.resolved ? result.value : null));
+}
+/** Rejection reasons of already-settled promises; null while any may still resolve. */
+export function checkAllRejected(promises) {
+    return Promise.all(promises.map((p) => Promise.race([
+        p.then(() => null, (reason) => reason),
+        new Promise((resolve) => setTimeout(() => resolve(null), 0)),
+    ]))).then((results) => {
+        const rejected = results.filter((value) => value !== null);
+        return rejected.length > 0 ? rejected : null;
+    });
+}
+/** Build an ethers `call` request from a mined/sent transaction (for revert replay). */
+export function callRequestFromTx(tx) {
+    return {
+        from: tx.from,
+        to: tx.to,
+        data: tx.data,
+        value: tx.value,
+        gasLimit: tx.gasLimit,
+        gasPrice: tx.gasPrice ?? undefined,
+        maxFeePerGas: tx.maxFeePerGas ?? undefined,
+        maxPriorityFeePerGas: tx.maxPriorityFeePerGas ?? undefined,
+        accessList: tx.accessList ?? undefined,
+        type: tx.type ?? undefined,
+    };
+}
+export function isPlainHex(value) {
+    return typeof value === 'string' && /^0x[0-9a-fA-F]*$/.test(value);
+}
+/** Build a viem `call` request from a viem transaction object (for revert replay). */
+export function callRequestFromViem(tx) {
+    return {
+        to: tx.to ?? undefined,
+        data: tx.data ?? undefined,
+        value: tx.value ?? undefined,
+        gas: tx.gas ?? undefined,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,108 @@
 {
   "name": "web3-mev-error-decoder",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Multicall batching with per-call revert decoding, waitForTransaction with timeout and replacement handling, a custom error & revert reason decoder for ethers v6 and viem, and RPC fallback providers with liveliness checks.",
+  "keywords": [
+    "web3",
+    "web3 development",
+    "smart contracts",
+    "smart contract development",
+    "solidity",
+    "solidity errors",
+    "mev",
+    "mev bot",
+    "mev bots",
+    "mev infrastructure",
+    "sniper bot",
+    "sniper bots",
+    "arbitrage bot",
+    "trading bot",
+    "telegram bot",
+    "blockchain",
+    "ethereum",
+    "defi",
+    "dapp",
+    "dapp development",
+    "ethers",
+    "ethers v6",
+    "ethers multicall",
+    "viem",
+    "viem multicall",
+    "batch call",
+    "error decoder",
+    "decode error",
+    "decode revert",
+    "decode revert reason",
+    "revert reason decoder",
+    "decode custom error",
+    "custom error decode",
+    "parse revert data",
+    "ethers error handling",
+    "viem error handling",
+    "waitForTransaction",
+    "wait for transaction",
+    "transaction helper",
+    "transaction receipt error",
+    "simulate transaction error",
+    "call exception decode",
+    "ethers CALL_EXCEPTION",
+    "fallback provider",
+    "fallback rpc",
+    "rpc fallback",
+    "rpc failover",
+    "gas optimization",
+    "revert"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./error-decoder": {
+      "types": "./dist/error-decoder/index.d.ts",
+      "import": "./dist/error-decoder/index.js"
+    },
+    "./multicall": {
+      "types": "./dist/multicall/index.d.ts",
+      "import": "./dist/multicall/index.js"
+    },
+    "./transaction": {
+      "types": "./dist/transaction/index.d.ts",
+      "import": "./dist/transaction/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider/index.d.ts",
+      "import": "./dist/provider/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "smoke": "node scripts/smoke.mjs && node scripts/smoke2.mjs && node scripts/smoke3.mjs"
+  },
+  "peerDependencies": {
+    "ethers": "^6.13.0",
+    "viem": "^2.0.0"
+  },
+  "dependencies": {
+    "multicall-error-decoder": "github:outgoingyang/multicall-error-decoder"
+  },
+  "devDependencies": {
+    "ethers": "^6.13.4",
+    "typescript": "^5.6.3",
+    "viem": "^2.21.0",
+    "vitest": "^5.1.0"
+  }
+}