@1delta/providers 0.0.1

package/dist/evm.d.ts

@@ -0,0 +1,115 @@
+import { PublicClient } from "viem";
+export declare const crossfi: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Explorer";
+            readonly url: "https://xfiscan.com/";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        universalSignatureVerifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 4158;
+    name: "CrossFi Mainet";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "XFI";
+        readonly symbol: "XFI";
+    };
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.mainnet.ms/"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const botanix: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Explorer";
+            readonly url: "https://botanixscan.io/";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly multicall3: {
+            readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+            readonly blockCreated: 1;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 3637;
+    name: "Botanix";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "BTC";
+        readonly symbol: "BTC";
+    };
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.ankr.com/botanix_mainnet", "https://rpc.botanixlabs.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare const GraphLinq: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Explorer";
+            readonly url: "https://explorer.graphlinq.io";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: import("viem").ChainContract | {
+            [sourceId: number]: import("viem").ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: import("viem").ChainContract | undefined;
+        ensUniversalResolver?: import("viem").ChainContract | undefined;
+        multicall3?: import("viem").ChainContract | undefined;
+        universalSignatureVerifier?: import("viem").ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 614;
+    name: "GraphLinq Chain";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "GLQ";
+        readonly symbol: "GLQ";
+    };
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://glq-dataseed.graphlinq.io"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+};
+export declare function getEvmClient(chain: string, rpcId?: number): PublicClient;
+export declare function createMulticallRetry(customRpcs?: {
+    [chainId: string]: string[];
+}): (chain: string, calls: any[], abi: any, batchSize?: number, maxRetries?: number, providerId?: number, allowFailure?: boolean) => Promise<any[]>;
+export declare function multicallRetry(chain: string, calls: any[], abi: any, batchSize?: number, maxRetries?: number, providerId?: number): Promise<any[]>;
+//# sourceMappingURL=evm.d.ts.map

package/dist/evm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../src/evm.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyC,YAAY,EAAE,MAAM,MAAM,CAAA;AAkE1E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBlB,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBlB,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBpB,CAAC;AA8MH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,CAmBnE;AAID,wBAAgB,oBAAoB,CAAC,UAAU,CAAC,EAAE;IAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,IAEzE,OAAO,MAAM,EACb,OAAO,GAAG,EAAE,EACZ,KAAK,GAAG,EACR,kBAA8B,EAC9B,mBAAc,EACd,mBAAc,EACd,sBAAmB,oBA6B1B;AA0CD,wBAAsB,cAAc,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,GAAG,EAAE,EACZ,GAAG,EAAE,GAAG,EACR,SAAS,SAAqB,EAC9B,UAAU,SAAI,EACd,UAAU,SAAI,kBAIjB"}

package/dist/evm.js

@@ -0,0 +1,363 @@
+import { Chain, CHAIN_INFO } from "@1delta/asset-registry";
+import { isArray, uniq } from "lodash";
+import { createPublicClient, defineChain, http } from "viem";
+import { mantle, mainnet, optimism, arbitrum, bsc, avalanche, taiko, metis, polygon, zksync, scroll, gnosis, base, blast, kaia, opBNB, fantom, sonic, linea, hemi, neonMainnet, degen, gravity, lightlinkPhoenix, plume, abstract, peaq, flowMainnet, soneium, goat, berachain, rootstock, ink, vanar, fuse, superposition, story, apeChain, telos, flare, aurora, kava, iota, coreDao, unichain, mode, xLayer, zircuit, corn, bob, manta, harmonyOne, celo, bitlayer, merlin, sei, iotex, bsquared, zetachain, ronin, inEVM, } from "viem/chains";
+export const crossfi = defineChain({
+    id: 4158,
+    name: 'CrossFi Mainet',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'XFI',
+        symbol: 'XFI',
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://rpc.mainnet.ms/'],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Explorer', url: 'https://xfiscan.com/' },
+    },
+    // contracts: {
+    //     multicall3: {
+    //         address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+    //         blockCreated: 1,
+    //     }
+    // }
+});
+export const botanix = defineChain({
+    id: 3637,
+    name: 'Botanix',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'BTC',
+        symbol: 'BTC',
+    },
+    rpcUrls: {
+        default: {
+            http: [
+                "https://rpc.ankr.com/botanix_mainnet",
+                "https://rpc.botanixlabs.com"
+            ],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Explorer', url: 'https://botanixscan.io/' },
+    },
+    contracts: {
+        multicall3: {
+            address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+            blockCreated: 1,
+        }
+    }
+});
+export const GraphLinq = defineChain({
+    id: 614,
+    name: 'GraphLinq Chain',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'GLQ',
+        symbol: 'GLQ',
+    },
+    rpcUrls: {
+        default: {
+            http: ["https://glq-dataseed.graphlinq.io"],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Explorer', "url": "https://explorer.graphlinq.io", },
+    },
+    // contracts: {
+    //     multicall3: {
+    //         address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+    //         blockCreated: 1,
+    //     }
+    // }
+});
+function getEvmChain(chain) {
+    switch (chain) {
+        case Chain.ARBITRUM_ONE:
+            return arbitrum;
+        case Chain.ETHEREUM_MAINNET:
+            return mainnet;
+        case Chain.MANTLE:
+            return mantle;
+        case Chain.BNB_SMART_CHAIN_MAINNET:
+            return bsc;
+        case Chain.OPBNB_MAINNET:
+            return opBNB;
+        case Chain.TAIKO_ALETHIA:
+            return taiko;
+        case Chain.AVALANCHE_C_CHAIN:
+            return avalanche;
+        case Chain.OP_MAINNET:
+            return optimism;
+        case Chain.METIS_ANDROMEDA_MAINNET:
+            return metis;
+        case Chain.POLYGON_MAINNET:
+            return polygon;
+        case Chain.ZKSYNC_MAINNET:
+            return zksync;
+        case Chain.SCROLL:
+            return scroll;
+        case Chain.GNOSIS:
+            return gnosis;
+        case Chain.BASE:
+            return base;
+        case Chain.BLAST:
+            return blast;
+        case Chain.KAIA_MAINNET:
+            return kaia;
+        case Chain.FANTOM_OPERA:
+            return fantom;
+        case Chain.SONIC_MAINNET:
+            return sonic;
+        case Chain.LINEA:
+            return linea;
+        case Chain.HEMI_NETWORK:
+            return {
+                ...hemi,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            };
+        case Chain.NEON_EVM_MAINNET:
+            return neonMainnet;
+        case Chain.DEGEN_CHAIN:
+            return {
+                ...degen,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            };
+        case Chain.GRAVITY_ALPHA_MAINNET:
+            return gravity;
+        case Chain.LIGHTLINK_PHOENIX_MAINNET:
+            return lightlinkPhoenix;
+        case Chain.PLUME_MAINNET:
+            return plume;
+        case Chain.ABSTRACT:
+            return abstract;
+        case Chain.PEAQ:
+            return peaq;
+        case Chain.EVM_ON_FLOW:
+            return flowMainnet;
+        case Chain.SONEIUM:
+            return soneium;
+        case Chain.GOAT_NETWORK:
+            return goat;
+        case Chain.BERACHAIN:
+            return berachain;
+        case Chain.ROOTSTOCK_MAINNET:
+            return rootstock;
+        case Chain.VANAR_MAINNET:
+            return vanar;
+        case Chain.INK:
+            return {
+                ...ink,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            };
+        case Chain.FUSE_MAINNET:
+            return fuse;
+        case Chain.SUPERPOSITION:
+            return superposition;
+        case Chain.STORY:
+            return {
+                ...story,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            };
+        case Chain.APECHAIN:
+            return apeChain;
+        case Chain.IOTEX_NETWORK_MAINNET:
+            return iotex;
+        case Chain.TELOS_EVM_MAINNET:
+            return telos;
+        case Chain.FLARE_MAINNET:
+            return flare;
+        case Chain.AURA_MAINNET:
+            return aurora;
+        case Chain.KAVA:
+            return kava;
+        case Chain.IOTA_EVM:
+            return iota;
+        case Chain.AURORA_MAINNET:
+            return aurora;
+        case Chain.UNICHAIN:
+            return unichain;
+        case Chain.CORE_BLOCKCHAIN_MAINNET:
+            return coreDao;
+        case Chain.MODE:
+            return mode;
+        case Chain.CORN:
+            return corn;
+        case Chain.BOB:
+            return bob;
+        case Chain.RONIN_MAINNET:
+            return ronin;
+        case Chain.MANTA_PACIFIC_MAINNET:
+            return manta;
+        case Chain.ZIRCUIT_MAINNET:
+            return zircuit;
+        case Chain.GRAPHLINQ_BLOCKCHAIN_MAINNET:
+            return GraphLinq;
+        case Chain.ZETACHAIN_MAINNET:
+            return zetachain;
+        case Chain.BITLAYER_MAINNET:
+            return bitlayer;
+        case Chain.CROSSFI_MAINNET:
+            return crossfi;
+        case Chain.INEVM_MAINNET:
+            return inEVM;
+        case Chain.B2_MAINNET:
+            return {
+                ...bsquared,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            };
+        case Chain.SEI_NETWORK:
+            return sei;
+        case Chain.MERLIN_MAINNET:
+            return {
+                ...merlin,
+                contracts: {
+                    multicall3: {
+                        address: "0x46063722c010AF39E465d286B84936A12aFb81F0",
+                        blockCreated: 1,
+                    }
+                }
+            };
+        case Chain.X_LAYER_MAINNET:
+            return xLayer;
+        case Chain.CELO_MAINNET:
+            return celo;
+        case Chain.BOTANIX_MAINNET:
+            return botanix;
+        case Chain.HARMONY_MAINNET_SHARD_0:
+            return harmonyOne;
+        // case Chain.VANA:
+        //     return vana
+        // case Chain.RARI_CHAIN_MAINNET:
+        //     return rariChain
+        // case Chain.GLUE_MAINNET:
+        //     return glue
+        default: throw new Error("Not in VIEM: " + chain);
+    }
+}
+const RPC_OVERRIDES = {
+    [Chain.FANTOM_OPERA]: "https://rpc.fantom.network",
+    [Chain.BNB_SMART_CHAIN_MAINNET]: "https://bsc-dataseed2.ninicoin.io",
+    [Chain.METIS_ANDROMEDA_MAINNET]: "https://andromeda.metis.io/?owner=1088",
+    [Chain.X_LAYER_MAINNET]: "https://xlayerrpc.okx.com",
+};
+function trimTrailingSlash(url) {
+    if (!url)
+        return undefined;
+    return url.endsWith('/') ? url.slice(0, -1) : url;
+}
+export function getEvmClient(chain, rpcId = 0) {
+    const chainInfo = getEvmChain(chain);
+    let rpc;
+    if (rpcId === 0)
+        rpc = chainInfo.rpcUrls.default.http[0];
+    else {
+        const rpcsChain = CHAIN_INFO[chain].rpc?.filter(a => !a.includes("wss://"));
+        const rpcs = chainInfo.rpcUrls.default.http.map(a => trimTrailingSlash(a));
+        const rpcsAdded = rpcsChain.map(a => trimTrailingSlash(a));
+        const allRpcs = uniq([...rpcs, ...rpcsAdded]);
+        rpc = allRpcs[rpcId];
+    }
+    return createPublicClient({
+        chain: chainInfo,
+        transport: http(RPC_OVERRIDES[chain] ??
+            rpc)
+    });
+}
+const DEFAULT_BATCH_SIZE = 4096;
+export function createMulticallRetry(customRpcs) {
+    return async function multicallRetry(chain, calls, abi, batchSize = DEFAULT_BATCH_SIZE, maxRetries = 3, providerId = 0, allowFailure = true) {
+        try {
+            const provider = getEvmClientWithCustomRpcs(chain, providerId, customRpcs);
+            const abiIsArray = isArray(abi[0]);
+            const data = await provider.multicall({
+                batchSize: DEFAULT_BATCH_SIZE,
+                contracts: calls.map((call, i) => ({
+                    abi: abiIsArray ? abi?.[i] : abi,
+                    address: call.address,
+                    functionName: call.name,
+                    // @ts-ignore
+                    args: call.args ?? call.params ?? [],
+                })),
+                allowFailure,
+            });
+            if (allowFailure) {
+                return data.map(({ result, status }) => status !== "success" ? '0x' : result);
+            }
+            return data;
+        }
+        catch (e) {
+            // error if max retries achieved
+            if (maxRetries === 0)
+                throw e;
+            console.log(e);
+            return await multicallRetry(chain, calls, abi, batchSize, maxRetries - 1, providerId + 1);
+        }
+    };
+}
+function getEvmClientWithCustomRpcs(chain, rpcId = 0, customRpcs) {
+    const chainInfo = getEvmChain(chain);
+    let rpc;
+    if (customRpcs && customRpcs[chain]) {
+        // Use custom RPC list if any (make sure that they are unique and valid)
+        const customRpcList = uniq(customRpcs[chain]
+            .filter(Boolean) // Remove empty ones
+            .filter(a => !a.includes("wss://")) // filter websocket ones (like the default impl)
+            .map(url => trimTrailingSlash(url))
+            .filter((url) => Boolean(url)) // Type-safe filter for defined URLs
+        );
+        if (customRpcList.length === 0) {
+            throw new Error(`No valid custom RPCs provided for chain ${chain}`);
+        }
+        rpc = customRpcList[rpcId % customRpcList.length];
+    }
+    else {
+        // Fallback to existing logic
+        if (rpcId === 0)
+            rpc = chainInfo.rpcUrls.default.http[0];
+        else {
+            const rpcsChain = CHAIN_INFO[chain].rpc?.filter(a => !a.includes("wss://"));
+            const rpcs = chainInfo.rpcUrls.default.http.map(a => trimTrailingSlash(a));
+            const rpcsAdded = rpcsChain.map(a => trimTrailingSlash(a));
+            const allRpcs = uniq([...rpcs, ...rpcsAdded]);
+            rpc = allRpcs[rpcId];
+        }
+    }
+    return createPublicClient({
+        chain: chainInfo,
+        transport: http(RPC_OVERRIDES[chain] ??
+            rpc)
+    });
+}
+export async function multicallRetry(chain, calls, abi, batchSize = DEFAULT_BATCH_SIZE, maxRetries = 3, providerId = 0) {
+    const defaultMulticallRetry = createMulticallRetry();
+    return defaultMulticallRetry(chain, calls, abi, batchSize, maxRetries, providerId);
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./evm";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./evm";

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@1delta/providers",
+  "version": "0.0.1",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest"
+  }
+}

package/src/evm.ts

@@ -0,0 +1,460 @@
+import { Chain, CHAIN_INFO } from "@1delta/asset-registry"
+import { isArray, uniq } from "lodash";
+import { createPublicClient, defineChain, http, PublicClient } from "viem"
+import {
+    mantle,
+    mainnet,
+    optimism,
+    arbitrum,
+    bsc,
+    avalanche,
+    taiko,
+    metis,
+    polygon,
+    zksync,
+    scroll,
+    gnosis,
+    base,
+    blast,
+    kaia,
+    opBNB,
+    fantom,
+    sonic,
+    linea,
+    hemi,
+    neonMainnet,
+    degen,
+    gravity,
+    lightlinkPhoenix,
+    plume,
+    abstract,
+    peaq,
+    flowMainnet,
+    soneium,
+    goat,
+    berachain,
+    rootstock,
+    ink,
+    vanar,
+    fuse,
+    superposition,
+    story,
+    apeChain,
+    telos,
+    flare,
+    aurora,
+    kava,
+    iota,
+    coreDao,
+    unichain,
+    mode,
+    xLayer,
+    zircuit,
+    corn,
+    bob,
+    manta,
+    harmonyOne,
+    celo,
+    bitlayer,
+    merlin,
+    sei,
+    iotex,
+    bsquared,
+    zetachain,
+    ronin,
+    inEVM,
+} from "viem/chains"
+
+
+export const crossfi = defineChain({
+    id: 4158,
+    name: 'CrossFi Mainet',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'XFI',
+        symbol: 'XFI',
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://rpc.mainnet.ms/'],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Explorer', url: 'https://xfiscan.com/' },
+    },
+    // contracts: {
+    //     multicall3: {
+    //         address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+    //         blockCreated: 1,
+    //     }
+    // }
+});
+
+export const botanix = defineChain({
+    id: 3637,
+    name: 'Botanix',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'BTC',
+        symbol: 'BTC',
+    },
+    rpcUrls: {
+        default: {
+            http: [
+                "https://rpc.ankr.com/botanix_mainnet",
+                "https://rpc.botanixlabs.com"],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Explorer', url: 'https://botanixscan.io/' },
+    },
+    contracts: {
+        multicall3: {
+            address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+            blockCreated: 1,
+        }
+    }
+});
+
+
+export const GraphLinq = defineChain({
+    id: 614,
+    name: 'GraphLinq Chain',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'GLQ',
+        symbol: 'GLQ',
+    },
+    rpcUrls: {
+        default: {
+            http: ["https://glq-dataseed.graphlinq.io"],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Explorer', "url": "https://explorer.graphlinq.io", },
+    },
+    // contracts: {
+    //     multicall3: {
+    //         address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+    //         blockCreated: 1,
+    //     }
+    // }
+});
+
+
+
+function getEvmChain(chain: string) {
+    switch (chain) {
+        case Chain.ARBITRUM_ONE:
+            return arbitrum
+        case Chain.ETHEREUM_MAINNET:
+            return mainnet
+        case Chain.MANTLE:
+            return mantle
+        case Chain.BNB_SMART_CHAIN_MAINNET:
+            return bsc
+        case Chain.OPBNB_MAINNET:
+            return opBNB
+        case Chain.TAIKO_ALETHIA:
+            return taiko
+        case Chain.AVALANCHE_C_CHAIN:
+            return avalanche
+        case Chain.OP_MAINNET:
+            return optimism
+        case Chain.METIS_ANDROMEDA_MAINNET:
+            return metis
+        case Chain.POLYGON_MAINNET:
+            return polygon
+        case Chain.ZKSYNC_MAINNET:
+            return zksync
+        case Chain.SCROLL:
+            return scroll
+        case Chain.GNOSIS:
+            return gnosis
+        case Chain.BASE:
+            return base
+        case Chain.BLAST:
+            return blast
+        case Chain.KAIA_MAINNET:
+            return kaia
+        case Chain.FANTOM_OPERA:
+            return fantom
+        case Chain.SONIC_MAINNET:
+            return sonic
+        case Chain.LINEA:
+            return linea
+        case Chain.HEMI_NETWORK:
+            return {
+                ...hemi,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            }
+        case Chain.NEON_EVM_MAINNET:
+            return neonMainnet
+        case Chain.DEGEN_CHAIN:
+            return {
+                ...degen,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            }
+        case Chain.GRAVITY_ALPHA_MAINNET:
+            return gravity
+        case Chain.LIGHTLINK_PHOENIX_MAINNET:
+            return lightlinkPhoenix
+        case Chain.PLUME_MAINNET:
+            return plume
+        case Chain.ABSTRACT:
+            return abstract
+        case Chain.PEAQ:
+            return peaq
+        case Chain.EVM_ON_FLOW:
+            return flowMainnet
+        case Chain.SONEIUM:
+            return soneium
+        case Chain.GOAT_NETWORK:
+            return goat
+        case Chain.BERACHAIN:
+            return berachain
+        case Chain.ROOTSTOCK_MAINNET:
+            return rootstock
+        case Chain.VANAR_MAINNET:
+            return vanar
+        case Chain.INK:
+            return {
+                ...ink,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            }
+        case Chain.FUSE_MAINNET:
+            return fuse
+        case Chain.SUPERPOSITION:
+            return superposition
+        case Chain.STORY:
+            return {
+                ...story,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            }
+        case Chain.APECHAIN:
+            return apeChain
+        case Chain.IOTEX_NETWORK_MAINNET:
+            return iotex
+        case Chain.TELOS_EVM_MAINNET:
+            return telos
+        case Chain.FLARE_MAINNET:
+            return flare
+        case Chain.AURA_MAINNET:
+            return aurora
+        case Chain.KAVA:
+            return kava
+        case Chain.IOTA_EVM:
+            return iota
+        case Chain.AURORA_MAINNET:
+            return aurora
+        case Chain.UNICHAIN:
+            return unichain
+        case Chain.CORE_BLOCKCHAIN_MAINNET:
+            return coreDao
+        case Chain.MODE:
+            return mode
+        case Chain.CORN:
+            return corn
+        case Chain.BOB:
+            return bob
+        case Chain.RONIN_MAINNET:
+            return ronin
+        case Chain.MANTA_PACIFIC_MAINNET:
+            return manta
+        case Chain.ZIRCUIT_MAINNET:
+            return zircuit
+        case Chain.GRAPHLINQ_BLOCKCHAIN_MAINNET:
+            return GraphLinq
+        case Chain.ZETACHAIN_MAINNET:
+            return zetachain
+        case Chain.BITLAYER_MAINNET:
+            return bitlayer
+        case Chain.CROSSFI_MAINNET:
+            return crossfi
+        case Chain.INEVM_MAINNET:
+            return inEVM
+        case Chain.B2_MAINNET:
+            return {
+                ...bsquared,
+                contracts: {
+                    multicall3: {
+                        address: "0xcA11bde05977b3631167028862bE2a173976CA11",
+                        blockCreated: 1,
+                    }
+                }
+            }
+        case Chain.SEI_NETWORK:
+            return sei
+        case Chain.MERLIN_MAINNET:
+            return {
+                ...merlin,
+                contracts: {
+                    multicall3: {
+                        address: "0x46063722c010AF39E465d286B84936A12aFb81F0",
+                        blockCreated: 1,
+                    }
+                }
+            }
+        case Chain.X_LAYER_MAINNET:
+            return xLayer
+        case Chain.CELO_MAINNET:
+            return celo
+        case Chain.BOTANIX_MAINNET:
+            return botanix
+        case Chain.HARMONY_MAINNET_SHARD_0:
+            return harmonyOne
+        // case Chain.VANA:
+        //     return vana
+        // case Chain.RARI_CHAIN_MAINNET:
+        //     return rariChain
+        // case Chain.GLUE_MAINNET:
+        //     return glue
+        default: throw new Error("Not in VIEM: " + chain)
+    }
+}
+
+const RPC_OVERRIDES: any = {
+    [Chain.FANTOM_OPERA]: "https://rpc.fantom.network",
+    [Chain.BNB_SMART_CHAIN_MAINNET]: "https://bsc-dataseed2.ninicoin.io",
+    [Chain.METIS_ANDROMEDA_MAINNET]: "https://andromeda.metis.io/?owner=1088",
+    [Chain.X_LAYER_MAINNET]: "https://xlayerrpc.okx.com",
+}
+
+function trimTrailingSlash(url?: string) {
+    if (!url) return undefined
+    return url.endsWith('/') ? url.slice(0, -1) : url;
+}
+
+export function getEvmClient(chain: string, rpcId = 0): PublicClient {
+    const chainInfo = getEvmChain(chain)
+    let rpc: string
+    if (rpcId === 0) rpc = chainInfo.rpcUrls.default.http[0]
+    else {
+        const rpcsChain = CHAIN_INFO[chain].rpc?.filter(a => !a.includes("wss://"))
+        const rpcs = chainInfo.rpcUrls.default.http.map(a => trimTrailingSlash(a))
+        const rpcsAdded = rpcsChain.map(a => trimTrailingSlash(a))
+        const allRpcs = uniq([...rpcs, ...rpcsAdded])
+        rpc = allRpcs[rpcId] as any
+    }
+    return createPublicClient({
+        chain: chainInfo as any,
+        transport: http(
+            RPC_OVERRIDES[chain] ??
+            rpc
+        )
+    }) as any
+
+}
+
+const DEFAULT_BATCH_SIZE = 4096;
+
+export function createMulticallRetry(customRpcs?: { [chainId: string]: string[] }) {
+    return async function multicallRetry(
+        chain: string,
+        calls: any[],
+        abi: any,
+        batchSize = DEFAULT_BATCH_SIZE,
+        maxRetries = 3,
+        providerId = 0,
+        allowFailure = true,
+    ) {
+        try {
+            const provider = getEvmClientWithCustomRpcs(chain, providerId, customRpcs)
+            const abiIsArray = isArray(abi[0])
+            const data = await provider.multicall({
+                batchSize: DEFAULT_BATCH_SIZE,
+                contracts: calls.map((call, i) => ({
+                    abi: abiIsArray ? abi?.[i] : abi,
+                    address: call.address as any,
+                    functionName: call.name,
+                    // @ts-ignore
+                    args: call.args ?? call.params ?? [],
+                })),
+                allowFailure,
+            })
+            if (allowFailure) {
+                return (data as any[]).map(
+                    ({ result, status }: any) => status !== "success" ? '0x' : result
+                );
+            }
+            return data
+        } catch (e) {
+            // error if max retries achieved
+            if (maxRetries === 0) throw e
+            console.log(e)
+            return await multicallRetry(chain, calls, abi, batchSize, maxRetries - 1, providerId + 1)
+        }
+    }
+}
+
+function getEvmClientWithCustomRpcs(chain: string, rpcId = 0, customRpcs?: { [chainId: string]: string[] }): PublicClient {
+    const chainInfo = getEvmChain(chain)
+    let rpc: string
+
+    if (customRpcs && customRpcs[chain]) {
+        // Use custom RPC list if any (make sure that they are unique and valid)
+        const customRpcList = uniq(
+            customRpcs[chain]
+                .filter(Boolean) // Remove empty ones
+                .filter(a => !a.includes("wss://")) // filter websocket ones (like the default impl)
+                .map(url => trimTrailingSlash(url))
+                .filter((url): url is string => Boolean(url)) // Type-safe filter for defined URLs
+        )
+
+        if (customRpcList.length === 0) {
+            throw new Error(`No valid custom RPCs provided for chain ${chain}`)
+        }
+
+        rpc = customRpcList[rpcId % customRpcList.length]
+    } else {
+        // Fallback to existing logic
+        if (rpcId === 0) rpc = chainInfo.rpcUrls.default.http[0]
+        else {
+            const rpcsChain = CHAIN_INFO[chain].rpc?.filter(a => !a.includes("wss://"))
+            const rpcs = chainInfo.rpcUrls.default.http.map(a => trimTrailingSlash(a))
+            const rpcsAdded = rpcsChain.map(a => trimTrailingSlash(a))
+            const allRpcs = uniq([...rpcs, ...rpcsAdded])
+            rpc = allRpcs[rpcId] as any
+        }
+    }
+
+    return createPublicClient({
+        chain: chainInfo as any,
+        transport: http(
+            RPC_OVERRIDES[chain] ??
+            rpc
+        )
+    }) as any
+}
+
+export async function multicallRetry(
+    chain: string,
+    calls: any[],
+    abi: any,
+    batchSize = DEFAULT_BATCH_SIZE,
+    maxRetries = 3,
+    providerId = 0,
+) {
+    const defaultMulticallRetry = createMulticallRetry()
+    return defaultMulticallRetry(chain, calls, abi, batchSize, maxRetries, providerId)
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./evm"

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "module": "ESNext", // Ensure ESM (ES Modules) output
+    "target": "ESNext", // Output code that targets the latest ES features
+    "moduleResolution": "node", // Use Node.js module resolution
+    "esModuleInterop": true, // For compatibility with commonjs
+    "outDir": "dist", // Specify output directory
+    "rootDir": "src", // Specify output directory
+    "declaration": true, // Generate .d.ts files
+    "declarationMap": true, // Generate declaration map files
+    "allowJs": true, // Allow JavaScript files to be included
+    "resolveJsonModule": true, // Allow importing JSON files
+    "skipLibCheck": true, // Skip type checking of all declaration files
+    "strict": true, // Enable strict type checking
+    "isolatedModules": true // Allow isolated module builds
+  },
+  "include": [
+    "src/*"
+  ], // Include all the TypeScript files in src/
+  "exclude": [
+    "node_modules",
+    "dist"
+  ] // Exclude node_modules and dist from being compiled
+}