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

package/dist/error-decoder/results.js

@@ -0,0 +1,53 @@
+import { ErrorType } from './enums.js';
+const formatReason = (reason, defaultReason) => (reason && reason.trim() !== '' ? reason : defaultReason);
+const baseErrorResult = (params) => {
+    const { type, data, reason, fragment, args, selector, name, signature } = params;
+    return {
+        type,
+        reason: formatReason(reason, null),
+        data: data ?? null,
+        name: name ?? null,
+        selector: selector ?? null,
+        signature: signature ?? null,
+        args: args ?? null,
+        fragment: fragment ?? null,
+    };
+};
+export const emptyErrorResult = ({ data, reason }) => baseErrorResult({
+    type: ErrorType.EmptyError,
+    data,
+    reason,
+});
+export const userRejectErrorResult = ({ data = null, reason, }) => baseErrorResult({
+    type: ErrorType.UserRejectError,
+    reason: formatReason(reason, 'User has rejected the transaction'),
+    data,
+});
+export const revertErrorResult = (params) => baseErrorResult({ type: ErrorType.RevertError, ...params });
+export const unknownErrorResult = ({ data, reason, name, }) => baseErrorResult({
+    type: ErrorType.UnknownError,
+    reason: formatReason(reason, 'Unknown error'),
+    data,
+    name,
+});
+export const panicErrorResult = (params) => baseErrorResult({ type: ErrorType.PanicError, ...params });
+export const customErrorResult = ({ data, reason, fragment, args, }) => {
+    const selector = data && data.length >= 10 ? data.slice(0, 10) : null;
+    return baseErrorResult({
+        type: ErrorType.CustomError,
+        reason: formatReason(reason, `No ABI for custom error ${selector}`),
+        data,
+        fragment,
+        args,
+        selector,
+        name: fragment?.name ?? selector,
+        signature: fragment?.format() ?? null,
+    });
+};
+export const rpcErrorResult = ({ reason, name }) => baseErrorResult({
+    type: ErrorType.RpcError,
+    reason: formatReason(reason, 'Error from JSON RPC provider'),
+    data: null,
+    name: name?.toString() ?? null,
+});
+//# sourceMappingURL=results.js.map

package/dist/error-decoder/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/error-decoder/results.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAYvC,MAAM,YAAY,GAAG,CACnB,MAAiC,EACjC,aAA4B,EACb,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AAE9E,MAAM,eAAe,GAAG,CACtB,MAAuD,EACzC,EAAE;IAChB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IACjF,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC;QAClC,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,QAAQ,EAAE,QAAQ,IAAI,IAAI;QAC1B,SAAS,EAAE,SAAS,IAAI,IAAI;QAC5B,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,QAAQ,EAAE,QAAQ,IAAI,IAAI;KAC3B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAmD,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CACnG,eAAe,CAAC;IACd,IAAI,EAAE,SAAS,CAAC,UAAU;IAC1B,IAAI;IACJ,MAAM;CACP,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,qBAAqB,GAAmD,CAAC,EACpF,IAAI,GAAG,IAAI,EACX,MAAM,GACP,EAAE,EAAE,CACH,eAAe,CAAC;IACd,IAAI,EAAE,SAAS,CAAC,eAAe;IAC/B,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,mCAAmC,CAAC;IACjE,IAAI;CACL,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,iBAAiB,GAAmD,CAAC,MAAM,EAAE,EAAE,CAC1F,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,kBAAkB,GAAmD,CAAC,EACjF,IAAI,EACJ,MAAM,EACN,IAAI,GACL,EAAE,EAAE,CACH,eAAe,CAAC;IACd,IAAI,EAAE,SAAS,CAAC,YAAY;IAC5B,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC;IAC7C,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,gBAAgB,GAAmD,CAAC,MAAM,EAAE,EAAE,CACzF,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,iBAAiB,GAAmD,CAAC,EAChF,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,IAAI,GACL,EAAE,EAAE;IACH,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,2BAA2B,QAAQ,EAAE,CAAC;QACnE,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,QAAQ;QAChC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,IAAI;KACtC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAmD,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CACjG,eAAe,CAAC;IACd,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAC5D,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI;CAC/B,CAAC,CAAC"}

package/dist/error-decoder/types.d.ts

@@ -0,0 +1,31 @@
+import type { ErrorDescription, ErrorFragment, Interface, Result } from 'ethers';
+import { ErrorType } from './enums.js';
+/** Human-friendly decoded error, produced by `ErrorDecoder.decode` / `decodeError`. */
+export type DecodedError = {
+    /** Classification of the error. */
+    type: ErrorType;
+    /** Human-readable reason (decoded string, panic description, or fallback message). */
+    reason: string | null;
+    /** Raw revert data (`0x...`), if present. */
+    data: string | null;
+    /** Error name (custom error name, RPC error code, or null). */
+    name: string | null;
+    /** 4-byte selector `0x........` for custom errors. */
+    selector: string | null;
+    /** Canonical signature, e.g. `MyError(uint256,address)`. */
+    signature: string | null;
+    /** Parsed error arguments, when the ABI is known. */
+    args: Result | null;
+    /** Matched error fragment, when the ABI is known. */
+    fragment: ErrorFragment | null;
+    /** Full ethers `ErrorDescription` fields when a fragment matched. */
+    description?: ErrorDescription;
+};
+export interface ErrorHandlerInput {
+    errorInterface?: Interface;
+    error: Error;
+}
+export interface ErrorHandler {
+    predicate: (data: string | undefined, error: Error) => boolean;
+    handle: (data: string | undefined, input: ErrorHandlerInput) => DecodedError;
+}

package/dist/error-decoder/types.js

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

package/dist/error-decoder/types.js.map

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

package/dist/error-decoder/viem.d.ts

@@ -0,0 +1,19 @@
+import type { PublicClient } from 'viem';
+import type { AbiLike } from '../types.js';
+import type { DecodedError } from './types.js';
+/**
+ * Decode a viem-thrown error (e.g. from `simulateContract`, `readContract`,
+ * `call`, `waitForTransactionReceipt`).
+ *
+ * Unwraps `cause` chains (`CallExecutionError` -> `ContractFunctionRevertedError`),
+ * extracts revert data and decodes it with the provided ABIs. Errors without
+ * revert data are classified by message (user rejection / plain revert / RPC).
+ */
+export declare function decodeViemError(error: unknown, opts?: {
+    abis?: ReadonlyArray<AbiLike>;
+}): DecodedError;
+/**
+ * Recover the revert reason of a mined reverted transaction for viem clients
+ * by replaying it via `publicClient.call`.
+ */
+export declare function getRevertReasonViem(client: PublicClient, txHash: `0x${string}`, abis?: ReadonlyArray<AbiLike>): Promise<DecodedError>;

package/dist/error-decoder/viem.js

@@ -0,0 +1,47 @@
+import { extractRevertData, getErrorMessage, callRequestFromViem } from '../utils.js';
+import { ErrorDecoder, decodeRevertData } from './decoder.js';
+import { unknownErrorResult } from './results.js';
+/**
+ * Decode a viem-thrown error (e.g. from `simulateContract`, `readContract`,
+ * `call`, `waitForTransactionReceipt`).
+ *
+ * Unwraps `cause` chains (`CallExecutionError` -> `ContractFunctionRevertedError`),
+ * extracts revert data and decodes it with the provided ABIs. Errors without
+ * revert data are classified by message (user rejection / plain revert / RPC).
+ */
+export function decodeViemError(error, opts = {}) {
+    const revertData = extractRevertData(error);
+    const synth = new Error(getErrorMessage(error));
+    const code = error?.code;
+    if (code != null) {
+        synth.code = code;
+    }
+    return new ErrorDecoder(opts.abis).decodeData(revertData, synth);
+}
+/**
+ * Recover the revert reason of a mined reverted transaction for viem clients
+ * 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) {
+        return unknownErrorResult({ reason: 'Transaction not found' });
+    }
+    const callRequest = callRequestFromViem(tx);
+    let data;
+    let callError;
+    try {
+        await client.call({ ...callRequest, blockNumber: receipt?.blockNumber });
+        await client.call({ ...callRequest });
+    }
+    catch (e) {
+        data = extractRevertData(e);
+        callError = e;
+    }
+    return decodeRevertData(data, abis, callError);
+}
+//# sourceMappingURL=viem.js.map

package/dist/error-decoder/viem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem.js","sourceRoot":"","sources":["../../src/error-decoder/viem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,OAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAI,KAAa,EAAE,IAAI,CAAC;IAClC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAChB,KAAa,CAAC,IAAI,GAAG,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,MAAqB,EACrB,IAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,kBAAkB,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAwB,CAAC;IAC7B,IAAI,SAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC5B,SAAS,GAAG,CAAU,CAAC;IACzB,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './error-decoder/index.js';
+export * from './multicall/index.js';
+export * from './transaction/index.js';
+export * from './provider/index.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './error-decoder/index.js';
+export * from './multicall/index.js';
+export * from './transaction/index.js';
+export * from './provider/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/multicall/abi.d.ts

@@ -0,0 +1,7 @@
+export declare const MULTICALL3_ABI: string[];
+/**
+ * Multicall3 is deployed at the same deterministic address (CREATE2) on
+ * hundreds of chains: https://github.com/mds1/multicall
+ */
+export declare const MULTICALL3_CANONICAL = "0xcA11bde05977b3631167028862bE2a173976CA11";
+export declare function multicall3Address(_chainId?: number | bigint): string;

package/dist/multicall/abi.js

@@ -0,0 +1,27 @@
+export const MULTICALL3_ABI = [
+    'function aggregate((address target, bytes callData)[] calls) payable returns (uint256 blockNumber, bytes[] returnData)',
+    'function tryAggregate(bool requireSuccess, (address target, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)',
+    'function aggregate3((address target, bool allowFailure, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)',
+    'function aggregate3Value((address target, bool allowFailure, uint256 value, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)',
+    'function tryBlockAndAggregate(bool requireSuccess, (address target, bytes callData)[] calls) payable returns (uint256 blockNumber, (bool success, bytes returnData)[] returnData)',
+    'function getBlockHash(uint256 blockNumber) view returns (bytes32 blockHash)',
+    'function getLastBlockHash() view returns (bytes32 blockHash)',
+    'function getCurrentBlockCoinbase() view returns (address coinbase)',
+    'function getCurrentBlockDifficulty() view returns (uint256 difficulty)',
+    'function getCurrentBlockGasLimit() view returns (uint256 gaslimit)',
+    'function getCurrentBlockTimestamp() view returns (uint256 timestamp)',
+    'function getEthBalance(address addr) view returns (uint256 balance)',
+    'function getBasefee() view returns (uint256 basefee)',
+    'function getChainId() view returns (uint256 chainid)',
+];
+/**
+ * Multicall3 is deployed at the same deterministic address (CREATE2) on
+ * hundreds of chains: https://github.com/mds1/multicall
+ */
+export const MULTICALL3_CANONICAL = '0xcA11bde05977b3631167028862bE2a173976CA11';
+export function multicall3Address(_chainId) {
+    // Every known chain ships Multicall3 at the canonical address.
+    // Override via the `address` option if you use a custom deployment.
+    return MULTICALL3_CANONICAL;
+}
+//# sourceMappingURL=abi.js.map

package/dist/multicall/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../../src/multicall/abi.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,wHAAwH;IACxH,sJAAsJ;IACtJ,kJAAkJ;IAClJ,sKAAsK;IACtK,mLAAmL;IACnL,6EAA6E;IAC7E,8DAA8D;IAC9D,oEAAoE;IACpE,wEAAwE;IACxE,oEAAoE;IACpE,sEAAsE;IACtE,qEAAqE;IACrE,sDAAsD;IACtD,sDAAsD;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,4CAA4C,CAAC;AAEjF,MAAM,UAAU,iBAAiB,CAAC,QAA0B;IAC1D,+DAA+D;IAC/D,oEAAoE;IACpE,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/multicall/ethers.d.ts

@@ -0,0 +1,50 @@
+import { Interface, type BlockTag, type Provider } from 'ethers';
+import type { AbiLike, CallInput } from '../types.js';
+export interface PreparedCall {
+    target: string;
+    data: string;
+    iface?: Interface;
+    method?: string;
+    abi?: AbiLike;
+    allowFailure?: boolean;
+}
+/** Encode + prepare one call for multicall execution. Shared by ethers/viem backends. */
+export declare function prepareCall(call: CallInput, batchAllowFailure: boolean): PreparedCall;
+/** Decode a per-call return/revert data item. */
+export declare function decodeCallResult(call: PreparedCall, success: boolean, returnData: string): {
+    success: boolean;
+    returnData: string;
+    decoded: undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    returnData: string;
+    decoded: any[];
+    error?: undefined;
+} | {
+    success: boolean;
+    returnData: string;
+    error: import("../error-decoder/types.js").DecodedError;
+    decoded?: undefined;
+};
+export interface MulticallOptions {
+    provider: Provider;
+    calls: ReadonlyArray<CallInput>;
+    /** If true (default), individual call failures are returned instead of rejecting the whole batch. */
+    allowFailure?: boolean;
+    blockTag?: BlockTag;
+    /** Custom Multicall3 deployment address (defaults to canonical `0xcA11...CA11`). */
+    address?: string;
+}
+export interface MulticallResultItem {
+    success: boolean;
+    returnData: string | null;
+    decoded?: unknown;
+    error?: unknown;
+}
+export interface MulticallResponse {
+    blockNumber: bigint;
+    results: MulticallResultItem[];
+}
+/** Multicall for ethers v6 providers via the Multicall3 `aggregate3` entry point. */
+export declare function multicallEth(opts: MulticallOptions): Promise<MulticallResponse>;

package/dist/multicall/ethers.js

@@ -0,0 +1,78 @@
+import { AbiCoder, Interface } from 'ethers';
+import { toInterface } from '../utils.js';
+import { decodeRevertData } from '../error-decoder/index.js';
+import { multicall3Address } from './abi.js';
+const AGGREGATE3 = new Interface([
+    'function aggregate3((address target, bool allowFailure, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)',
+]);
+/** Encode + prepare one call for multicall execution. Shared by ethers/viem backends. */
+export function prepareCall(call, batchAllowFailure) {
+    if (call.data == null && !(call.abi != null && call.method != null)) {
+        throw new Error(`Call to ${call.target}: provide either "data" or "abi"+"method"`);
+    }
+    let data = call.data;
+    let iface;
+    if (call.abi != null && call.method != null) {
+        iface = toInterface(call.abi);
+        data = iface.encodeFunctionData(call.method, call.args ?? []);
+    }
+    return {
+        target: call.target,
+        data,
+        iface,
+        method: call.method,
+        abi: call.abi,
+        allowFailure: call.allowFailure ?? batchAllowFailure,
+    };
+}
+/** Decode a per-call return/revert data item. */
+export function decodeCallResult(call, success, returnData) {
+    if (success) {
+        if (!call.iface || !call.method) {
+            return { success: true, returnData, decoded: undefined };
+        }
+        try {
+            const decoded = call.iface.decodeFunctionResult(call.method, returnData).toArray();
+            return { success: true, returnData, decoded };
+        }
+        catch {
+            // e.g. call to an EOA: success with empty (0x) data
+            return { success: true, returnData, decoded: undefined };
+        }
+    }
+    const error = decodeRevertData(returnData, call.abi ? [call.abi] : undefined);
+    return { success: false, returnData, error };
+}
+/** Multicall for ethers v6 providers via the Multicall3 `aggregate3` entry point. */
+export async function multicallEth(opts) {
+    const { provider, calls, allowFailure = true, blockTag, address } = opts;
+    if (calls.length === 0) {
+        return { blockNumber: BigInt(await provider.getBlockNumber()), results: [] };
+    }
+    const prepared = calls.map((c) => prepareCall(c, allowFailure));
+    const data = AGGREGATE3.encodeFunctionData('aggregate3', [
+        prepared.map((c) => ({
+            target: c.target,
+            allowFailure: c.allowFailure,
+            callData: c.data,
+        })),
+    ]);
+    const resultData = await provider.call({
+        to: address ?? multicall3Address(),
+        data,
+        ...(blockTag != null ? { blockTag } : {}),
+    });
+    // aggregate3's wire format is canonical; tryBlockAndAggregate (3 outputs)
+    // is not reliably decoded by generic ABI decoders.
+    const decoded = AbiCoder.defaultAbiCoder().decode(['tuple(bool,bytes)[]'], resultData);
+    const items = decoded[0].toArray();
+    const results = prepared.map((call, i) => {
+        const [success, returnData] = items[i];
+        return { ...decodeCallResult(call, success, returnData) };
+    });
+    const blockNumber = typeof blockTag === 'number' || typeof blockTag === 'bigint'
+        ? BigInt(blockTag)
+        : BigInt(await provider.getBlockNumber());
+    return { blockNumber, results };
+}
+//# sourceMappingURL=ethers.js.map

package/dist/multicall/ethers.js.map

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

package/dist/multicall/index.d.ts

@@ -0,0 +1,21 @@
+import type { Provider } from 'ethers';
+import type { PublicClient as ViemPublicClient } from 'viem';
+import { multicallEth, prepareCall, decodeCallResult, type MulticallOptions, type MulticallResponse, type MulticallResultItem } from './ethers.js';
+import { multicallViem, type MulticallViemOptions } from './viem.js';
+import { MULTICALL3_ABI, MULTICALL3_CANONICAL, multicall3Address } from './abi.js';
+export interface MulticallUnifiedOptions {
+    /** ethers v6 provider. */
+    provider?: Provider;
+    /** viem public client. Takes precedence if both are given. */
+    client?: ViemPublicClient;
+    calls: ReadonlyArray<import('../types.js').CallInput>;
+    allowFailure?: boolean;
+    blockTag?: import('ethers').BlockTag;
+    blockNumber?: bigint;
+    address?: string;
+}
+export declare function isViemClient(x: unknown): x is ViemPublicClient;
+/** Unified multicall entry point: works with an ethers provider or a viem client. */
+export declare function multicall(opts: MulticallUnifiedOptions): Promise<MulticallResponse>;
+export { multicallEth, multicallViem, multicall3Address, MULTICALL3_ABI, MULTICALL3_CANONICAL, prepareCall, decodeCallResult, };
+export type { MulticallOptions, MulticallResponse, MulticallResultItem, MulticallViemOptions };

package/dist/multicall/index.js

@@ -0,0 +1,33 @@
+import { multicallEth, prepareCall, decodeCallResult, } from './ethers.js';
+import { multicallViem } from './viem.js';
+import { MULTICALL3_ABI, MULTICALL3_CANONICAL, multicall3Address } from './abi.js';
+export function isViemClient(x) {
+    return (typeof x === 'object' &&
+        x !== null &&
+        'readContract' in x &&
+        'getTransactionReceipt' in x);
+}
+/** Unified multicall entry point: works with an ethers provider or a viem client. */
+export async function multicall(opts) {
+    if (opts.client) {
+        return multicallViem({
+            client: opts.client,
+            calls: opts.calls,
+            allowFailure: opts.allowFailure,
+            blockNumber: opts.blockNumber,
+            address: opts.address,
+        });
+    }
+    if (opts.provider) {
+        return multicallEth({
+            provider: opts.provider,
+            calls: opts.calls,
+            allowFailure: opts.allowFailure,
+            blockTag: opts.blockTag,
+            address: opts.address,
+        });
+    }
+    throw new Error('multicall: provide either `provider` (ethers) or `client` (viem)');
+}
+export { multicallEth, multicallViem, multicall3Address, MULTICALL3_ABI, MULTICALL3_CANONICAL, prepareCall, decodeCallResult, };
+//# sourceMappingURL=index.js.map

package/dist/multicall/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/multicall/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,gBAAgB,GAIjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAA6B,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAcnF,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,cAAc,IAAI,CAAC;QACnB,uBAAuB,IAAI,CAAC,CAC7B,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAA6B;IAE7B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,OAAO,aAAa,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,YAAY,CAAC;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;AACtF,CAAC;AAED,OAAO,EACL,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,gBAAgB,GACjB,CAAC"}

package/dist/multicall/viem.d.ts

@@ -0,0 +1,14 @@
+import { type PublicClient } from 'viem';
+import type { CallInput } from '../types.js';
+import { type MulticallResponse } from './ethers.js';
+export interface MulticallViemOptions {
+    client: PublicClient;
+    calls: ReadonlyArray<CallInput>;
+    /** If true (default), individual call failures are returned instead of rejecting the whole batch. */
+    allowFailure?: boolean;
+    blockNumber?: bigint;
+    /** Custom Multicall3 deployment address (defaults to canonical `0xcA11...CA11`). */
+    address?: string;
+}
+/** Multicall for viem clients via the Multicall3 `aggregate3` entry point. */
+export declare function multicallViem(opts: MulticallViemOptions): Promise<MulticallResponse>;

package/dist/multicall/viem.js

@@ -0,0 +1,32 @@
+import { parseAbi } from 'viem';
+import { decodeCallResult, prepareCall } from './ethers.js';
+import { multicall3Address } from './abi.js';
+const AGGREGATE3 = parseAbi([
+    'function aggregate3((address target, bool allowFailure, bytes callData)[] calls) payable returns ((bool success, bytes returnData)[] returnData)',
+]);
+/** Multicall for viem clients via the Multicall3 `aggregate3` entry point. */
+export async function multicallViem(opts) {
+    const { client, calls, allowFailure = true, blockNumber, address } = opts;
+    if (calls.length === 0) {
+        return { blockNumber: await client.getBlockNumber(), results: [] };
+    }
+    const prepared = calls.map((c) => prepareCall(c, allowFailure));
+    const callsArg = prepared.map((c) => ({
+        target: c.target,
+        allowFailure: c.allowFailure,
+        callData: c.data,
+    }));
+    const items = (await client.readContract({
+        address: (address ?? multicall3Address()),
+        abi: AGGREGATE3,
+        functionName: 'aggregate3',
+        args: [callsArg],
+        blockNumber,
+    }));
+    const results = prepared.map((call, i) => {
+        const item = items[i];
+        return { ...decodeCallResult(call, item.success, item.returnData) };
+    });
+    return { blockNumber: blockNumber ?? (await client.getBlockNumber()), results };
+}
+//# sourceMappingURL=viem.js.map

package/dist/multicall/viem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem.js","sourceRoot":"","sources":["../../src/multicall/viem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA+B,MAAM,MAAM,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAoD,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,UAAU,GAAG,QAAQ,CAAC;IAC1B,kJAAkJ;CACnJ,CAAC,CAAC;AAYH,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,EAAE,CAAC,CAAC,MAAa;QACvB,YAAY,EAAE,CAAC,CAAC,YAAa;QAC7B,QAAQ,EAAE,CAAC,CAAC,IAAW;KACxB,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;QACvC,OAAO,EAAE,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAQ;QAChD,GAAG,EAAE,UAAU;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,WAAW;KACZ,CAAC,CAA+D,CAAC;IAElE,MAAM,OAAO,GAA0B,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,EAAyB,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,CAAC,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAClF,CAAC"}

package/dist/provider/fallback-full.d.ts

@@ -0,0 +1,124 @@
+import { JsonRpcApiProvider, Network, type JsonRpcApiProviderOptions, type JsonRpcError, type JsonRpcPayload, type JsonRpcResult, type Networkish } from 'ethers';
+export declare enum FallbackProviderError {
+    NO_PROVIDER = "At least one provider must be provided",
+    CANNOT_DETECT_NETWORKS = "Could not detect providers networks",
+    INCONSISTENT_NETWORKS = "All providers must be connected to the same network",
+    DESTROYED = "Provider has been destroyed",
+    ALL_PROVIDERS_UNAVAILABLE = "All providers are unavailable",
+    HALTED = "Chain has halted",
+    INVALID_FALLBACK_OPTIONS = "Invalid fallback options",
+    BLOCK_NUMBER_STORAGE_CONFIG_ERROR = "Both getStoredBlockNumber and setStoredBlockNumber must be provided or neither",
+    FAILED_TO_GET_BLOCKNUMBER = "Failed to get block number"
+}
+export declare const DEFAULT_RETRIES = 0;
+export declare const DEFAULT_TIMEOUT = 3000;
+export declare const RETRY_DELAY = 100;
+export declare const ALWAYS_SUPPORTED_METHODS: readonly string[];
+export interface ProviderConfig {
+    provider: JsonRpcApiProvider;
+    retries?: number;
+    timeout?: number;
+    retryDelay?: number;
+    id?: string;
+    isMevProtected?: boolean;
+    /** The JSON-RPC methods this provider is allowed to serve, matched exactly. */
+    supportedMethods?: string[];
+    /** The JSON-RPC methods this provider must not serve (takes precedence over supportedMethods). */
+    unsupportedMethods?: string[];
+    /** Gets the stored block number when conducting a liveliness check (shared cache). */
+    getStoredBlockNumber?: () => Promise<number | null>;
+    /** Sets the stored block number when conducting a liveliness check. */
+    setStoredBlockNumber?: (blockNumber: number) => Promise<void>;
+}
+export interface LoggingOptions {
+    debug?: (message: string, metadata?: any) => void;
+    info?: (message: string, metadata?: any) => void;
+    notice?: (message: string, metadata?: any) => void;
+    warn?: (message: string, metadata?: any) => void;
+    error?: (message: string, metadata?: any) => void;
+}
+export type FallbackProviderOptions = {
+    /** Maximum block lag allowed for the provider to be considered valid, measured against the median block number. */
+    allowableBlockLag?: number;
+    /**
+     * If the median block number is not updated for this amount of time, the chain is considered halted and calls will
+     * throw. Denominated in seconds. 0 disables halt detection. Default: 300 (5 minutes).
+     */
+    haltDetectionTime?: number;
+    /** Interval for the liveliness check of the chain and providers, in ms. 0 disables. Default: 0. */
+    livelinessPollingInterval?: number;
+    /** Hook to get the time at which a block was first discovered (UNIX epoch seconds), or null if unknown. */
+    getBlockDiscoveryTime?: (blockNumber: number) => Promise<number | null>;
+    /** Hook to set the time at which a block was first discovered; null clears it. */
+    setBlockDiscoveryTime?: (blockNumber: number, currentTime: number | null) => Promise<void>;
+    /** If true, signed transactions are broadcast to all active providers. Default: false. */
+    broadcastToAll?: boolean;
+    broadcastToAllConfig?: {
+        /** Delay in ms between broadcasting to each provider. Default: 0. */
+        delay?: number;
+        /** Max random jitter (ms) added to the delay. Default: 0. */
+        delayJitter?: number;
+    };
+    /** If true, signed transactions are only broadcast to MEV-protected providers. Default: false. */
+    broadcastOnlyToMevProtected?: boolean;
+    /**
+     * If true, the provider throws on the first blockchain error it encounters
+     * (CALL_EXCEPTION, INSUFFICIENT_FUNDS, NONCE_EXPIRED, ...). Default: true.
+     */
+    throwOnFirstBlockchainError?: boolean;
+};
+export declare const DEFAULT_FALLBACK_OPTIONS: Required<Pick<FallbackProviderOptions, 'allowableBlockLag' | 'haltDetectionTime' | 'livelinessPollingInterval' | 'broadcastToAll' | 'broadcastOnlyToMevProtected' | 'throwOnFirstBlockchainError'>>;
+export declare function isBlockchainError(e: any): boolean;
+export declare function isAlreadyKnownError(e: any): boolean;
+export declare const providerSupportsMethod: (config: ProviderConfig, method: string) => boolean;
+export declare const filterProvidersByMethod: (providers: ProviderConfig[], method: string) => ProviderConfig[];
+export declare const filterValidProviders: (providers: ProviderConfig[]) => Promise<{
+    network: Network;
+    providers: ProviderConfig[];
+}>;
+export declare function getBlockNumberWithTimeout(provider: JsonRpcApiProvider, timeout?: number): Promise<number>;
+export declare function getBlockNumber(providerConfig: ProviderConfig): Promise<number>;
+export declare const getBlockNumbersAndMedian: (providers: ProviderConfig[], logging?: LoggingOptions) => Promise<{
+    blockNumbers: ({
+        blockNumber: number;
+        fromCache: boolean;
+    } | null)[];
+    median: number;
+}>;
+/**
+ * Full-featured RPC fallback provider for ethers v6, ported from
+ * `ethers-v6-fallback-provider`.
+ *
+ * Features: per-provider retries/timeouts, provider failover, liveliness
+ * polling with median block-number lag filtering, chain halt detection,
+ * JSON-RPC method capability filtering, transaction broadcast to all /
+ * MEV-protected-only providers, and blockchain-vs-transport error
+ * classification (blockchain errors are never retried on another RPC).
+ */
+export declare class FallbackProvider extends JsonRpcApiProvider {
+    #private;
+    constructor(providers: ProviderConfig[], network?: Networkish, options?: JsonRpcApiProviderOptions, loggingOptions?: LoggingOptions, fallbackOptions?: FallbackProviderOptions);
+    activeProvidersCount(): number;
+    activeProviderIds(): string[];
+    isHalted(): boolean;
+    /** Runs the liveliness check on demand (also runs automatically when polling is enabled). */
+    refreshLiveliness(): Promise<void>;
+    private _validateFallbackOptions;
+    private sendWithProvider;
+    send(method: string, params: {
+        [name: string]: any;
+    }): Promise<any>;
+    _send(payload: JsonRpcPayload | Array<JsonRpcPayload>): Promise<Array<JsonRpcResult | JsonRpcError>>;
+    _detectNetwork(): Promise<Network>;
+    /**
+     * Gets the time at which a block was first discovered.
+     */
+    private _getBlockDiscoveryTime;
+    /**
+     * Sets the time at which a block was first discovered.
+     */
+    private _setBlockDiscoveryTime;
+    private _livelinessCheck;
+    _start(): void;
+    destroy(): void;
+}