@sudobility/types 1.8.21

package/dist/utils/blockchain/rpc-helpers.js

@@ -0,0 +1,865 @@
+"use strict";
+/**
+ * RPC and API endpoint helper utilities
+ *
+ * Provides helper functions to build RPC endpoints and block explorer API URLs
+ * from API keys and chain identifiers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcHelpers = void 0;
+const enums_1 = require("../../types/business/enums");
+/**
+ * Alchemy network identifier mappings
+ * Maps Chain enum values to Alchemy-specific network identifiers
+ */
+const ALCHEMY_NETWORK_MAP = {
+    // Ethereum - direct mapping
+    [enums_1.Chain.ETH_MAINNET]: 'eth-mainnet',
+    [enums_1.Chain.ETH_SEPOLIA]: 'eth-sepolia',
+    [enums_1.Chain.ETH_GOERLI]: 'eth-goerli',
+    // Polygon - direct mapping
+    [enums_1.Chain.POLYGON_MAINNET]: 'polygon-mainnet',
+    [enums_1.Chain.POLYGON_MUMBAI]: 'polygon-mumbai',
+    [enums_1.Chain.POLYGON_AMOY]: 'polygon-amoy',
+    // Optimism - uses 'opt' prefix
+    [enums_1.Chain.OPTIMISM_MAINNET]: 'opt-mainnet',
+    [enums_1.Chain.OPTIMISM_SEPOLIA]: 'opt-sepolia',
+    [enums_1.Chain.OPTIMISM_GOERLI]: 'opt-goerli',
+    // Arbitrum - uses 'arb' prefix
+    [enums_1.Chain.ARBITRUM_MAINNET]: 'arb-mainnet',
+    [enums_1.Chain.ARBITRUM_SEPOLIA]: 'arb-sepolia',
+    [enums_1.Chain.ARBITRUM_GOERLI]: 'arb-goerli',
+    // Base - direct mapping
+    [enums_1.Chain.BASE_MAINNET]: 'base-mainnet',
+    [enums_1.Chain.BASE_SEPOLIA]: 'base-sepolia',
+    [enums_1.Chain.BASE_GOERLI]: 'base-goerli',
+    // Avalanche
+    [enums_1.Chain.AVALANCHE_MAINNET]: 'avax-mainnet',
+    [enums_1.Chain.AVALANCHE_FUJI]: 'avax-fuji',
+    // BNB Chain
+    [enums_1.Chain.BNB_MAINNET]: 'bnb-mainnet',
+    [enums_1.Chain.BNB_TESTNET]: 'bnb-testnet',
+    // Gnosis Chain
+    [enums_1.Chain.GNOSIS_MAINNET]: 'gnosis-mainnet',
+    [enums_1.Chain.GNOSIS_CHIADO]: 'gnosis-chiado',
+    // Celo
+    [enums_1.Chain.CELO_MAINNET]: 'celo-mainnet',
+    [enums_1.Chain.CELO_ALFAJORES]: 'celo-alfajores',
+    // zkSync
+    [enums_1.Chain.ZKSYNC_MAINNET]: 'zksync-mainnet',
+    [enums_1.Chain.ZKSYNC_SEPOLIA]: 'zksync-sepolia',
+    // Linea
+    [enums_1.Chain.LINEA_MAINNET]: 'linea-mainnet',
+    [enums_1.Chain.LINEA_SEPOLIA]: 'linea-sepolia',
+    // Scroll
+    [enums_1.Chain.SCROLL_MAINNET]: 'scroll-mainnet',
+    [enums_1.Chain.SCROLL_SEPOLIA]: 'scroll-sepolia',
+    // Monad
+    [enums_1.Chain.MONAD_MAINNET]: '',
+    [enums_1.Chain.MONAD_TESTNET]: '',
+    // Story Protocol
+    [enums_1.Chain.STORY_MAINNET]: '',
+    [enums_1.Chain.STORY_TESTNET]: '',
+    // Plume Network
+    [enums_1.Chain.PLUME_MAINNET]: '',
+    [enums_1.Chain.PLUME_TESTNET]: '',
+    // Nexus
+    [enums_1.Chain.NEXUS_MAINNET]: '',
+    [enums_1.Chain.NEXUS_TESTNET]: '',
+    // HyperEVM
+    [enums_1.Chain.HYPEREVM_MAINNET]: '',
+    [enums_1.Chain.HYPEREVM_TESTNET]: '',
+    // Sonic
+    [enums_1.Chain.SONIC_MAINNET]: '',
+    [enums_1.Chain.SONIC_TESTNET]: '',
+    [enums_1.Chain.SONIC_BLAZE]: '',
+    // Unichain
+    [enums_1.Chain.UNICHAIN_MAINNET]: '',
+    [enums_1.Chain.UNICHAIN_SEPOLIA]: '',
+    // World Chain
+    [enums_1.Chain.WORLD_MAINNET]: '',
+    // XDC Network
+    [enums_1.Chain.XDC_MAINNET]: '',
+    // Ink
+    [enums_1.Chain.INK_TESTNET]: '',
+    // Fetch.ai
+    [enums_1.Chain.FETCH_MAINNET]: '',
+    [enums_1.Chain.FETCH_TESTNET]: '',
+    // Gensyn
+    [enums_1.Chain.GENSYN_MAINNET]: '',
+    [enums_1.Chain.GENSYN_TESTNET]: '',
+    // Ritual
+    [enums_1.Chain.RITUAL_MAINNET]: '',
+    [enums_1.Chain.RITUAL_TESTNET]: '',
+    // Solana - simple names
+    [enums_1.Chain.SOLANA_MAINNET]: 'mainnet',
+    [enums_1.Chain.SOLANA_DEVNET]: 'devnet',
+    [enums_1.Chain.SOLANA_TESTNET]: 'testnet',
+    // Local development - no Alchemy support
+    [enums_1.Chain.EVM_LOCAL]: '',
+    [enums_1.Chain.SOLANA_LOCAL]: '',
+};
+/**
+ * Block explorer domain mappings
+ */
+const EXPLORER_DOMAIN_MAP = {
+    // Ethereum
+    [enums_1.Chain.ETH_MAINNET]: 'api.etherscan.io',
+    [enums_1.Chain.ETH_SEPOLIA]: 'api-sepolia.etherscan.io',
+    [enums_1.Chain.ETH_GOERLI]: 'api-goerli.etherscan.io',
+    // Polygon
+    [enums_1.Chain.POLYGON_MAINNET]: 'api.polygonscan.com',
+    [enums_1.Chain.POLYGON_MUMBAI]: 'api-testnet.polygonscan.com',
+    [enums_1.Chain.POLYGON_AMOY]: 'api-amoy.polygonscan.com',
+    // Optimism
+    [enums_1.Chain.OPTIMISM_MAINNET]: 'api-optimistic.etherscan.io',
+    [enums_1.Chain.OPTIMISM_SEPOLIA]: 'api-sepolia-optimistic.etherscan.io',
+    [enums_1.Chain.OPTIMISM_GOERLI]: 'api-goerli-optimistic.etherscan.io',
+    // Arbitrum
+    [enums_1.Chain.ARBITRUM_MAINNET]: 'api.arbiscan.io',
+    [enums_1.Chain.ARBITRUM_SEPOLIA]: 'api-sepolia.arbiscan.io',
+    [enums_1.Chain.ARBITRUM_GOERLI]: 'api-goerli.arbiscan.io',
+    // Base
+    [enums_1.Chain.BASE_MAINNET]: 'api.basescan.org',
+    [enums_1.Chain.BASE_SEPOLIA]: 'api-sepolia.basescan.org',
+    [enums_1.Chain.BASE_GOERLI]: 'api-goerli.basescan.org',
+    // Avalanche
+    [enums_1.Chain.AVALANCHE_MAINNET]: 'api.snowtrace.io',
+    [enums_1.Chain.AVALANCHE_FUJI]: 'api-testnet.snowtrace.io',
+    // BNB Chain
+    [enums_1.Chain.BNB_MAINNET]: 'api.bscscan.com',
+    [enums_1.Chain.BNB_TESTNET]: 'api-testnet.bscscan.com',
+    // Gnosis Chain
+    [enums_1.Chain.GNOSIS_MAINNET]: 'api.gnosisscan.io',
+    [enums_1.Chain.GNOSIS_CHIADO]: 'api-chiado.gnosisscan.io',
+    // Celo
+    [enums_1.Chain.CELO_MAINNET]: 'api.celoscan.io',
+    [enums_1.Chain.CELO_ALFAJORES]: 'api-alfajores.celoscan.io',
+    // zkSync
+    [enums_1.Chain.ZKSYNC_MAINNET]: 'api-era.zksync.network',
+    [enums_1.Chain.ZKSYNC_SEPOLIA]: 'api-sepolia-era.zksync.network',
+    // Linea
+    [enums_1.Chain.LINEA_MAINNET]: 'api.lineascan.build',
+    [enums_1.Chain.LINEA_SEPOLIA]: 'api-sepolia.lineascan.build',
+    // Scroll
+    [enums_1.Chain.SCROLL_MAINNET]: 'api.scrollscan.com',
+    [enums_1.Chain.SCROLL_SEPOLIA]: 'api-sepolia.scrollscan.com',
+    // Monad
+    [enums_1.Chain.MONAD_MAINNET]: '',
+    [enums_1.Chain.MONAD_TESTNET]: '',
+    // Story Protocol
+    [enums_1.Chain.STORY_MAINNET]: '',
+    [enums_1.Chain.STORY_TESTNET]: '',
+    // Plume Network
+    [enums_1.Chain.PLUME_MAINNET]: '',
+    [enums_1.Chain.PLUME_TESTNET]: '',
+    // Nexus
+    [enums_1.Chain.NEXUS_MAINNET]: '',
+    [enums_1.Chain.NEXUS_TESTNET]: '',
+    // HyperEVM
+    [enums_1.Chain.HYPEREVM_MAINNET]: '',
+    [enums_1.Chain.HYPEREVM_TESTNET]: '',
+    // Sonic
+    [enums_1.Chain.SONIC_MAINNET]: '',
+    [enums_1.Chain.SONIC_TESTNET]: '',
+    [enums_1.Chain.SONIC_BLAZE]: '',
+    // Unichain
+    [enums_1.Chain.UNICHAIN_MAINNET]: '',
+    [enums_1.Chain.UNICHAIN_SEPOLIA]: '',
+    // World Chain
+    [enums_1.Chain.WORLD_MAINNET]: '',
+    // XDC Network
+    [enums_1.Chain.XDC_MAINNET]: '',
+    // Ink
+    [enums_1.Chain.INK_TESTNET]: '',
+    // Fetch.ai
+    [enums_1.Chain.FETCH_MAINNET]: '',
+    [enums_1.Chain.FETCH_TESTNET]: '',
+    // Gensyn
+    [enums_1.Chain.GENSYN_MAINNET]: '',
+    [enums_1.Chain.GENSYN_TESTNET]: '',
+    // Ritual
+    [enums_1.Chain.RITUAL_MAINNET]: '',
+    [enums_1.Chain.RITUAL_TESTNET]: '',
+    // Solana - no block explorer API in this format
+    [enums_1.Chain.SOLANA_MAINNET]: '',
+    [enums_1.Chain.SOLANA_DEVNET]: '',
+    [enums_1.Chain.SOLANA_TESTNET]: '',
+    // Local development - no block explorer API
+    [enums_1.Chain.EVM_LOCAL]: '',
+    [enums_1.Chain.SOLANA_LOCAL]: '',
+};
+/**
+ * Block explorer browser URL mappings
+ */
+const EXPLORER_BROWSER_MAP = {
+    // Ethereum
+    [enums_1.Chain.ETH_MAINNET]: 'etherscan.io',
+    [enums_1.Chain.ETH_SEPOLIA]: 'sepolia.etherscan.io',
+    [enums_1.Chain.ETH_GOERLI]: 'goerli.etherscan.io',
+    // Polygon
+    [enums_1.Chain.POLYGON_MAINNET]: 'polygonscan.com',
+    [enums_1.Chain.POLYGON_MUMBAI]: 'mumbai.polygonscan.com',
+    [enums_1.Chain.POLYGON_AMOY]: 'amoy.polygonscan.com',
+    // Optimism
+    [enums_1.Chain.OPTIMISM_MAINNET]: 'optimistic.etherscan.io',
+    [enums_1.Chain.OPTIMISM_SEPOLIA]: 'sepolia-optimistic.etherscan.io',
+    [enums_1.Chain.OPTIMISM_GOERLI]: 'goerli-optimistic.etherscan.io',
+    // Arbitrum
+    [enums_1.Chain.ARBITRUM_MAINNET]: 'arbiscan.io',
+    [enums_1.Chain.ARBITRUM_SEPOLIA]: 'sepolia.arbiscan.io',
+    [enums_1.Chain.ARBITRUM_GOERLI]: 'goerli.arbiscan.io',
+    // Base
+    [enums_1.Chain.BASE_MAINNET]: 'basescan.org',
+    [enums_1.Chain.BASE_SEPOLIA]: 'sepolia.basescan.org',
+    [enums_1.Chain.BASE_GOERLI]: 'goerli.basescan.org',
+    // Avalanche
+    [enums_1.Chain.AVALANCHE_MAINNET]: 'snowtrace.io',
+    [enums_1.Chain.AVALANCHE_FUJI]: 'testnet.snowtrace.io',
+    // BNB Chain
+    [enums_1.Chain.BNB_MAINNET]: 'bscscan.com',
+    [enums_1.Chain.BNB_TESTNET]: 'testnet.bscscan.com',
+    // Gnosis Chain
+    [enums_1.Chain.GNOSIS_MAINNET]: 'gnosisscan.io',
+    [enums_1.Chain.GNOSIS_CHIADO]: 'gnosis-chiado.blockscout.com',
+    // Celo
+    [enums_1.Chain.CELO_MAINNET]: 'celoscan.io',
+    [enums_1.Chain.CELO_ALFAJORES]: 'alfajores.celoscan.io',
+    // zkSync
+    [enums_1.Chain.ZKSYNC_MAINNET]: 'explorer.zksync.io',
+    [enums_1.Chain.ZKSYNC_SEPOLIA]: 'sepolia.explorer.zksync.io',
+    // Linea
+    [enums_1.Chain.LINEA_MAINNET]: 'lineascan.build',
+    [enums_1.Chain.LINEA_SEPOLIA]: 'sepolia.lineascan.build',
+    // Scroll
+    [enums_1.Chain.SCROLL_MAINNET]: 'scrollscan.com',
+    [enums_1.Chain.SCROLL_SEPOLIA]: 'sepolia.scrollscan.com',
+    // Monad
+    [enums_1.Chain.MONAD_MAINNET]: 'explorer.monad.xyz',
+    [enums_1.Chain.MONAD_TESTNET]: 'testnet.explorer.monad.xyz',
+    // Story Protocol
+    [enums_1.Chain.STORY_MAINNET]: 'explorer.story.foundation',
+    [enums_1.Chain.STORY_TESTNET]: 'testnet.explorer.story.foundation',
+    // Plume Network
+    [enums_1.Chain.PLUME_MAINNET]: 'explorer.plumenetwork.xyz',
+    [enums_1.Chain.PLUME_TESTNET]: 'testnet.explorer.plumenetwork.xyz',
+    // Nexus
+    [enums_1.Chain.NEXUS_MAINNET]: 'explorer.nexus.xyz',
+    [enums_1.Chain.NEXUS_TESTNET]: 'testnet.explorer.nexus.xyz',
+    // HyperEVM
+    [enums_1.Chain.HYPEREVM_MAINNET]: 'app.hyperliquid.xyz/explorer',
+    [enums_1.Chain.HYPEREVM_TESTNET]: 'app.hyperliquid-testnet.xyz/explorer',
+    // Sonic
+    [enums_1.Chain.SONIC_MAINNET]: 'sonicscan.org',
+    [enums_1.Chain.SONIC_TESTNET]: 'testnet.sonicscan.org',
+    [enums_1.Chain.SONIC_BLAZE]: 'blaze.sonicscan.org',
+    // Unichain
+    [enums_1.Chain.UNICHAIN_MAINNET]: 'uniscan.xyz',
+    [enums_1.Chain.UNICHAIN_SEPOLIA]: 'sepolia.uniscan.xyz',
+    // World Chain
+    [enums_1.Chain.WORLD_MAINNET]: 'worldscan.org',
+    // XDC Network
+    [enums_1.Chain.XDC_MAINNET]: 'xdcscan.io',
+    // Ink
+    [enums_1.Chain.INK_TESTNET]: 'explorer.inkonchain.com',
+    // Fetch.ai
+    [enums_1.Chain.FETCH_MAINNET]: 'explore.fetch.ai',
+    [enums_1.Chain.FETCH_TESTNET]: 'explore-testnet.fetch.ai',
+    // Gensyn
+    [enums_1.Chain.GENSYN_MAINNET]: 'explorer.gensyn.ai',
+    [enums_1.Chain.GENSYN_TESTNET]: 'testnet.explorer.gensyn.ai',
+    // Ritual
+    [enums_1.Chain.RITUAL_MAINNET]: 'explorer.ritual.net',
+    [enums_1.Chain.RITUAL_TESTNET]: 'testnet.explorer.ritual.net',
+    // Solana
+    [enums_1.Chain.SOLANA_MAINNET]: 'explorer.solana.com',
+    [enums_1.Chain.SOLANA_DEVNET]: 'explorer.solana.com/?cluster=devnet',
+    [enums_1.Chain.SOLANA_TESTNET]: 'explorer.solana.com/?cluster=testnet',
+    // Local development - no block explorer
+    [enums_1.Chain.EVM_LOCAL]: '',
+    [enums_1.Chain.SOLANA_LOCAL]: '',
+};
+/**
+ * EVM chains (used for type checking)
+ */
+const EVM_CHAINS = new Set([
+    enums_1.Chain.ETH_MAINNET,
+    enums_1.Chain.ETH_SEPOLIA,
+    enums_1.Chain.ETH_GOERLI,
+    enums_1.Chain.POLYGON_MAINNET,
+    enums_1.Chain.POLYGON_MUMBAI,
+    enums_1.Chain.POLYGON_AMOY,
+    enums_1.Chain.OPTIMISM_MAINNET,
+    enums_1.Chain.OPTIMISM_SEPOLIA,
+    enums_1.Chain.OPTIMISM_GOERLI,
+    enums_1.Chain.ARBITRUM_MAINNET,
+    enums_1.Chain.ARBITRUM_SEPOLIA,
+    enums_1.Chain.ARBITRUM_GOERLI,
+    enums_1.Chain.BASE_MAINNET,
+    enums_1.Chain.BASE_SEPOLIA,
+    enums_1.Chain.BASE_GOERLI,
+    enums_1.Chain.AVALANCHE_MAINNET,
+    enums_1.Chain.AVALANCHE_FUJI,
+    enums_1.Chain.BNB_MAINNET,
+    enums_1.Chain.BNB_TESTNET,
+    enums_1.Chain.GNOSIS_MAINNET,
+    enums_1.Chain.GNOSIS_CHIADO,
+    enums_1.Chain.CELO_MAINNET,
+    enums_1.Chain.CELO_ALFAJORES,
+    enums_1.Chain.ZKSYNC_MAINNET,
+    enums_1.Chain.ZKSYNC_SEPOLIA,
+    enums_1.Chain.LINEA_MAINNET,
+    enums_1.Chain.LINEA_SEPOLIA,
+    enums_1.Chain.SCROLL_MAINNET,
+    enums_1.Chain.SCROLL_SEPOLIA,
+    enums_1.Chain.MONAD_MAINNET,
+    enums_1.Chain.MONAD_TESTNET,
+    enums_1.Chain.STORY_MAINNET,
+    enums_1.Chain.STORY_TESTNET,
+    enums_1.Chain.PLUME_MAINNET,
+    enums_1.Chain.PLUME_TESTNET,
+    enums_1.Chain.NEXUS_MAINNET,
+    enums_1.Chain.NEXUS_TESTNET,
+    enums_1.Chain.HYPEREVM_MAINNET,
+    enums_1.Chain.HYPEREVM_TESTNET,
+    enums_1.Chain.SONIC_MAINNET,
+    enums_1.Chain.SONIC_TESTNET,
+    enums_1.Chain.SONIC_BLAZE,
+    enums_1.Chain.UNICHAIN_MAINNET,
+    enums_1.Chain.UNICHAIN_SEPOLIA,
+    enums_1.Chain.WORLD_MAINNET,
+    enums_1.Chain.XDC_MAINNET,
+    enums_1.Chain.INK_TESTNET,
+    enums_1.Chain.FETCH_MAINNET,
+    enums_1.Chain.FETCH_TESTNET,
+    enums_1.Chain.GENSYN_MAINNET,
+    enums_1.Chain.GENSYN_TESTNET,
+    enums_1.Chain.RITUAL_MAINNET,
+    enums_1.Chain.RITUAL_TESTNET,
+    enums_1.Chain.EVM_LOCAL,
+]);
+/**
+ * Solana chains (used for type checking)
+ */
+const SOLANA_CHAINS = new Set([
+    enums_1.Chain.SOLANA_MAINNET,
+    enums_1.Chain.SOLANA_DEVNET,
+    enums_1.Chain.SOLANA_TESTNET,
+    enums_1.Chain.SOLANA_LOCAL,
+]);
+/**
+ * Chain ID mappings
+ * EVM chains use positive IDs, Solana chains use negative IDs
+ */
+const CHAIN_ID_MAP = {
+    // Ethereum
+    [enums_1.Chain.ETH_MAINNET]: 1,
+    [enums_1.Chain.ETH_SEPOLIA]: 11155111,
+    [enums_1.Chain.ETH_GOERLI]: 5,
+    // Polygon
+    [enums_1.Chain.POLYGON_MAINNET]: 137,
+    [enums_1.Chain.POLYGON_MUMBAI]: 80001,
+    [enums_1.Chain.POLYGON_AMOY]: 80002,
+    // Optimism
+    [enums_1.Chain.OPTIMISM_MAINNET]: 10,
+    [enums_1.Chain.OPTIMISM_SEPOLIA]: 11155420,
+    [enums_1.Chain.OPTIMISM_GOERLI]: 420,
+    // Arbitrum
+    [enums_1.Chain.ARBITRUM_MAINNET]: 42161,
+    [enums_1.Chain.ARBITRUM_SEPOLIA]: 421614,
+    [enums_1.Chain.ARBITRUM_GOERLI]: 421613,
+    // Base
+    [enums_1.Chain.BASE_MAINNET]: 8453,
+    [enums_1.Chain.BASE_SEPOLIA]: 84532,
+    [enums_1.Chain.BASE_GOERLI]: 84531,
+    // Avalanche
+    [enums_1.Chain.AVALANCHE_MAINNET]: 43114,
+    [enums_1.Chain.AVALANCHE_FUJI]: 43113,
+    // BNB Chain
+    [enums_1.Chain.BNB_MAINNET]: 56,
+    [enums_1.Chain.BNB_TESTNET]: 97,
+    // Gnosis Chain
+    [enums_1.Chain.GNOSIS_MAINNET]: 100,
+    [enums_1.Chain.GNOSIS_CHIADO]: 10200,
+    // Celo
+    [enums_1.Chain.CELO_MAINNET]: 42220,
+    [enums_1.Chain.CELO_ALFAJORES]: 44787,
+    // zkSync
+    [enums_1.Chain.ZKSYNC_MAINNET]: 324,
+    [enums_1.Chain.ZKSYNC_SEPOLIA]: 300,
+    // Linea
+    [enums_1.Chain.LINEA_MAINNET]: 59144,
+    [enums_1.Chain.LINEA_SEPOLIA]: 59141,
+    // Scroll
+    [enums_1.Chain.SCROLL_MAINNET]: 534352,
+    [enums_1.Chain.SCROLL_SEPOLIA]: 534351,
+    // Monad
+    [enums_1.Chain.MONAD_MAINNET]: 10000, // TBD - placeholder
+    [enums_1.Chain.MONAD_TESTNET]: 10001, // TBD - placeholder
+    // Story Protocol
+    [enums_1.Chain.STORY_MAINNET]: 1516, // Actual Story chain ID
+    [enums_1.Chain.STORY_TESTNET]: 1513, // Story testnet chain ID
+    // Plume Network
+    [enums_1.Chain.PLUME_MAINNET]: 98865, // Plume mainnet
+    [enums_1.Chain.PLUME_TESTNET]: 98864, // Plume testnet
+    // Nexus
+    [enums_1.Chain.NEXUS_MAINNET]: 9999, // TBD - placeholder
+    [enums_1.Chain.NEXUS_TESTNET]: 9998, // TBD - placeholder
+    // HyperEVM
+    [enums_1.Chain.HYPEREVM_MAINNET]: 998, // HyperEVM L1
+    [enums_1.Chain.HYPEREVM_TESTNET]: 997, // HyperEVM testnet
+    // Sonic
+    [enums_1.Chain.SONIC_MAINNET]: 146, // Sonic mainnet
+    [enums_1.Chain.SONIC_TESTNET]: 64165, // Sonic testnet (S)
+    [enums_1.Chain.SONIC_BLAZE]: 57054, // Sonic Blaze testnet (deprecated soon)
+    // Unichain
+    [enums_1.Chain.UNICHAIN_MAINNET]: 1, // TBD - mainnet not launched yet, placeholder
+    [enums_1.Chain.UNICHAIN_SEPOLIA]: 1301, // Unichain Sepolia testnet
+    // World Chain
+    [enums_1.Chain.WORLD_MAINNET]: 480, // World Chain mainnet
+    // XDC Network
+    [enums_1.Chain.XDC_MAINNET]: 50, // XDC Network mainnet
+    // Ink
+    [enums_1.Chain.INK_TESTNET]: 763373, // Ink testnet (Sepolia)
+    // Fetch.ai (Cosmos-based but supports EVM)
+    [enums_1.Chain.FETCH_MAINNET]: 2154, // Fetch.ai EVM
+    [enums_1.Chain.FETCH_TESTNET]: 2153, // Fetch.ai testnet
+    // Gensyn
+    [enums_1.Chain.GENSYN_MAINNET]: 8888, // TBD - placeholder
+    [enums_1.Chain.GENSYN_TESTNET]: 8887, // TBD - placeholder
+    // Ritual
+    [enums_1.Chain.RITUAL_MAINNET]: 7777, // TBD - placeholder
+    [enums_1.Chain.RITUAL_TESTNET]: 7776, // TBD - placeholder
+    // Solana (negative IDs)
+    [enums_1.Chain.SOLANA_MAINNET]: -101,
+    [enums_1.Chain.SOLANA_DEVNET]: -102,
+    [enums_1.Chain.SOLANA_TESTNET]: -103,
+    // Local development
+    [enums_1.Chain.EVM_LOCAL]: 31337,
+    [enums_1.Chain.SOLANA_LOCAL]: -104,
+};
+/**
+ * USDC address/mint mappings
+ * EVM chains have contract addresses, Solana chains have mint addresses
+ * Source: https://developers.circle.com/stablecoins/usdc-contract-addresses
+ */
+const USDC_ADDRESS_MAP = {
+    // Ethereum - Official Circle USDC
+    [enums_1.Chain.ETH_MAINNET]: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+    [enums_1.Chain.ETH_SEPOLIA]: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+    [enums_1.Chain.ETH_GOERLI]: '0x07865c6E87B9F70255377e024ace6630C1Eaa37F', // Deprecated
+    // Polygon - Official Circle USDC (native USDC)
+    [enums_1.Chain.POLYGON_MAINNET]: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    [enums_1.Chain.POLYGON_MUMBAI]: '0x9999f7Fea5938fD3b1E26A12c3f2fb024e194f97', // Deprecated
+    [enums_1.Chain.POLYGON_AMOY]: '0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582',
+    // Optimism - Official Circle USDC
+    [enums_1.Chain.OPTIMISM_MAINNET]: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    [enums_1.Chain.OPTIMISM_SEPOLIA]: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
+    [enums_1.Chain.OPTIMISM_GOERLI]: '0xe05606174bac4A6364B31bd0eCA4bf4dD368f8C6', // Deprecated
+    // Arbitrum - Official Circle USDC
+    [enums_1.Chain.ARBITRUM_MAINNET]: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    [enums_1.Chain.ARBITRUM_SEPOLIA]: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
+    [enums_1.Chain.ARBITRUM_GOERLI]: '0xfd064A18f3BF249cf1f87FC203E90D8f650f2d63', // Deprecated
+    // Base - Official Circle USDC
+    [enums_1.Chain.BASE_MAINNET]: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    [enums_1.Chain.BASE_SEPOLIA]: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+    [enums_1.Chain.BASE_GOERLI]: '0xF175520C52418dfE19C8098071a252da48Cd1C19', // Deprecated
+    // Avalanche - Official Circle USDC
+    [enums_1.Chain.AVALANCHE_MAINNET]: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
+    [enums_1.Chain.AVALANCHE_FUJI]: '0x5425890298aed601595a70AB815c96711a31Bc65',
+    // BNB Chain
+    [enums_1.Chain.BNB_MAINNET]: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d',
+    [enums_1.Chain.BNB_TESTNET]: '0x64544969ed7EBf5f083679233325356EbE738930',
+    // Gnosis Chain
+    [enums_1.Chain.GNOSIS_MAINNET]: '0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83',
+    [enums_1.Chain.GNOSIS_CHIADO]: '0x',
+    // Celo
+    [enums_1.Chain.CELO_MAINNET]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+    [enums_1.Chain.CELO_ALFAJORES]: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
+    // zkSync - Official Circle USDC
+    [enums_1.Chain.ZKSYNC_MAINNET]: '0x1d17CBcF0D6D143135aE902365D2E5e2A16538D4',
+    [enums_1.Chain.ZKSYNC_SEPOLIA]: '0x',
+    // Linea
+    [enums_1.Chain.LINEA_MAINNET]: '0x176211869cA2b568f2A7D4EE941E073a821EE1ff',
+    [enums_1.Chain.LINEA_SEPOLIA]: '0x',
+    // Scroll
+    [enums_1.Chain.SCROLL_MAINNET]: '0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4',
+    [enums_1.Chain.SCROLL_SEPOLIA]: '0x',
+    // Monad
+    [enums_1.Chain.MONAD_MAINNET]: '0x',
+    [enums_1.Chain.MONAD_TESTNET]: '0x',
+    // Story Protocol
+    [enums_1.Chain.STORY_MAINNET]: '0x',
+    [enums_1.Chain.STORY_TESTNET]: '0x',
+    // Plume Network
+    [enums_1.Chain.PLUME_MAINNET]: '0x222365EF19F7947e5484218551B56bb3965Aa7aF',
+    [enums_1.Chain.PLUME_TESTNET]: '0xcB5f30e335672893c7eb944B374c196392C19D18',
+    // Nexus
+    [enums_1.Chain.NEXUS_MAINNET]: '0x',
+    [enums_1.Chain.NEXUS_TESTNET]: '0x',
+    // HyperEVM
+    [enums_1.Chain.HYPEREVM_MAINNET]: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
+    [enums_1.Chain.HYPEREVM_TESTNET]: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
+    // Sonic
+    [enums_1.Chain.SONIC_MAINNET]: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894',
+    [enums_1.Chain.SONIC_TESTNET]: '0x0BA304580ee7c9a980CF72e55f5Ed2E9fd30Bc51',
+    [enums_1.Chain.SONIC_BLAZE]: '0xA4879Fed32Ecbef99399e5cbC247E533421C4eC6',
+    // Unichain
+    [enums_1.Chain.UNICHAIN_MAINNET]: '0x078D782b760474a361dDA0AF3839290b0EF57AD6',
+    [enums_1.Chain.UNICHAIN_SEPOLIA]: '0x31d0220469e10c4E71834a79b1f276E153D00a2D',
+    // World Chain
+    [enums_1.Chain.WORLD_MAINNET]: '0x79A02482A880bCe3F13E09da970dC34dB4cD24D1',
+    // XDC Network
+    [enums_1.Chain.XDC_MAINNET]: '0x',
+    // Ink
+    [enums_1.Chain.INK_TESTNET]: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
+    // Fetch.ai
+    [enums_1.Chain.FETCH_MAINNET]: '0x',
+    [enums_1.Chain.FETCH_TESTNET]: '0x',
+    // Gensyn
+    [enums_1.Chain.GENSYN_MAINNET]: '0x',
+    [enums_1.Chain.GENSYN_TESTNET]: '0x',
+    // Ritual
+    [enums_1.Chain.RITUAL_MAINNET]: '0x',
+    [enums_1.Chain.RITUAL_TESTNET]: '0x',
+    // Solana (mint addresses)
+    [enums_1.Chain.SOLANA_MAINNET]: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    [enums_1.Chain.SOLANA_DEVNET]: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+    [enums_1.Chain.SOLANA_TESTNET]: '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+    // Local development - mock addresses
+    [enums_1.Chain.EVM_LOCAL]: '0x0000000000000000000000000000000000000000',
+    [enums_1.Chain.SOLANA_LOCAL]: '11111111111111111111111111111111',
+};
+/**
+ * User-friendly chain name mappings
+ */
+const CHAIN_NAME_MAP = {
+    // Ethereum
+    [enums_1.Chain.ETH_MAINNET]: 'Ethereum',
+    [enums_1.Chain.ETH_SEPOLIA]: 'Ethereum Sepolia',
+    [enums_1.Chain.ETH_GOERLI]: 'Ethereum Goerli',
+    // Polygon
+    [enums_1.Chain.POLYGON_MAINNET]: 'Polygon',
+    [enums_1.Chain.POLYGON_MUMBAI]: 'Polygon Mumbai',
+    [enums_1.Chain.POLYGON_AMOY]: 'Polygon Amoy',
+    // Optimism
+    [enums_1.Chain.OPTIMISM_MAINNET]: 'Optimism',
+    [enums_1.Chain.OPTIMISM_SEPOLIA]: 'Optimism Sepolia',
+    [enums_1.Chain.OPTIMISM_GOERLI]: 'Optimism Goerli',
+    // Arbitrum
+    [enums_1.Chain.ARBITRUM_MAINNET]: 'Arbitrum',
+    [enums_1.Chain.ARBITRUM_SEPOLIA]: 'Arbitrum Sepolia',
+    [enums_1.Chain.ARBITRUM_GOERLI]: 'Arbitrum Goerli',
+    // Base
+    [enums_1.Chain.BASE_MAINNET]: 'Base',
+    [enums_1.Chain.BASE_SEPOLIA]: 'Base Sepolia',
+    [enums_1.Chain.BASE_GOERLI]: 'Base Goerli',
+    // Avalanche
+    [enums_1.Chain.AVALANCHE_MAINNET]: 'Avalanche',
+    [enums_1.Chain.AVALANCHE_FUJI]: 'Avalanche Fuji',
+    // BNB Chain
+    [enums_1.Chain.BNB_MAINNET]: 'BNB Chain',
+    [enums_1.Chain.BNB_TESTNET]: 'BNB Chain Testnet',
+    // Gnosis Chain
+    [enums_1.Chain.GNOSIS_MAINNET]: 'Gnosis',
+    [enums_1.Chain.GNOSIS_CHIADO]: 'Gnosis Chiado',
+    // Celo
+    [enums_1.Chain.CELO_MAINNET]: 'Celo',
+    [enums_1.Chain.CELO_ALFAJORES]: 'Celo Alfajores',
+    // zkSync
+    [enums_1.Chain.ZKSYNC_MAINNET]: 'zkSync',
+    [enums_1.Chain.ZKSYNC_SEPOLIA]: 'zkSync Sepolia',
+    // Linea
+    [enums_1.Chain.LINEA_MAINNET]: 'Linea',
+    [enums_1.Chain.LINEA_SEPOLIA]: 'Linea Sepolia',
+    // Scroll
+    [enums_1.Chain.SCROLL_MAINNET]: 'Scroll',
+    [enums_1.Chain.SCROLL_SEPOLIA]: 'Scroll Sepolia',
+    // Monad
+    [enums_1.Chain.MONAD_MAINNET]: 'Monad',
+    [enums_1.Chain.MONAD_TESTNET]: 'Monad Testnet',
+    // Story Protocol
+    [enums_1.Chain.STORY_MAINNET]: 'Story',
+    [enums_1.Chain.STORY_TESTNET]: 'Story Testnet',
+    // Plume Network
+    [enums_1.Chain.PLUME_MAINNET]: 'Plume',
+    [enums_1.Chain.PLUME_TESTNET]: 'Plume Testnet',
+    // Nexus
+    [enums_1.Chain.NEXUS_MAINNET]: 'Nexus',
+    [enums_1.Chain.NEXUS_TESTNET]: 'Nexus Testnet',
+    // HyperEVM
+    [enums_1.Chain.HYPEREVM_MAINNET]: 'HyperEVM',
+    [enums_1.Chain.HYPEREVM_TESTNET]: 'HyperEVM Testnet',
+    // Sonic
+    [enums_1.Chain.SONIC_MAINNET]: 'Sonic',
+    [enums_1.Chain.SONIC_TESTNET]: 'Sonic Testnet',
+    [enums_1.Chain.SONIC_BLAZE]: 'Sonic Blaze',
+    // Unichain
+    [enums_1.Chain.UNICHAIN_MAINNET]: 'Unichain',
+    [enums_1.Chain.UNICHAIN_SEPOLIA]: 'Unichain Sepolia',
+    // World Chain
+    [enums_1.Chain.WORLD_MAINNET]: 'World Chain',
+    // XDC Network
+    [enums_1.Chain.XDC_MAINNET]: 'XDC Network',
+    // Ink
+    [enums_1.Chain.INK_TESTNET]: 'Ink Testnet',
+    // Fetch.ai
+    [enums_1.Chain.FETCH_MAINNET]: 'Fetch.ai',
+    [enums_1.Chain.FETCH_TESTNET]: 'Fetch.ai Testnet',
+    // Gensyn
+    [enums_1.Chain.GENSYN_MAINNET]: 'Gensyn',
+    [enums_1.Chain.GENSYN_TESTNET]: 'Gensyn Testnet',
+    // Ritual
+    [enums_1.Chain.RITUAL_MAINNET]: 'Ritual',
+    [enums_1.Chain.RITUAL_TESTNET]: 'Ritual Testnet',
+    // Solana
+    [enums_1.Chain.SOLANA_MAINNET]: 'Solana',
+    [enums_1.Chain.SOLANA_DEVNET]: 'Solana Devnet',
+    [enums_1.Chain.SOLANA_TESTNET]: 'Solana Testnet',
+    // Local development
+    [enums_1.Chain.EVM_LOCAL]: 'Local EVM',
+    [enums_1.Chain.SOLANA_LOCAL]: 'Local Solana',
+};
+/**
+ * Helper class for building RPC endpoints and block explorer API URLs
+ */
+class RpcHelpers {
+    /**
+     * Check if a chain is an EVM chain
+     * @param chain - Chain identifier to check
+     * @returns True if the chain is an EVM chain
+     */
+    static isEvmChain(chain) {
+        return EVM_CHAINS.has(chain);
+    }
+    /**
+     * Check if a chain is a Solana chain
+     * @param chain - Chain identifier to check
+     * @returns True if the chain is a Solana chain
+     */
+    static isSolanaChain(chain) {
+        return SOLANA_CHAINS.has(chain);
+    }
+    /**
+     * Get the chain type (EVM or Solana) for a given chain
+     * @param chain - Chain identifier
+     * @returns ChainType.EVM or ChainType.SOLANA
+     * @throws Error if the chain is not recognized
+     * @example
+     * ```typescript
+     * const type = RpcHelpers.getChainType(Chain.ETH_MAINNET);
+     * // Returns: ChainType.EVM
+     *
+     * const solanaType = RpcHelpers.getChainType(Chain.SOLANA_MAINNET);
+     * // Returns: ChainType.SOLANA
+     * ```
+     */
+    static getChainType(chain) {
+        if (this.isEvmChain(chain)) {
+            return enums_1.ChainType.EVM;
+        }
+        if (this.isSolanaChain(chain)) {
+            return enums_1.ChainType.SOLANA;
+        }
+        throw new Error(`Unknown chain: ${chain}`);
+    }
+    /**
+     * Get the chain ID for a given chain
+     * @param chain - Chain identifier
+     * @returns Numeric chain ID for EVM chains, or negative ID for Solana chains
+     * @throws Error if the chain is not recognized or has no chain ID
+     * @example
+     * ```typescript
+     * const ethChainId = RpcHelpers.getChainId(Chain.ETH_MAINNET);
+     * // Returns: 1
+     *
+     * const polygonChainId = RpcHelpers.getChainId(Chain.POLYGON_MAINNET);
+     * // Returns: 137
+     *
+     * const solanaChainId = RpcHelpers.getChainId(Chain.SOLANA_MAINNET);
+     * // Returns: -101
+     *
+     * const localChainId = RpcHelpers.getChainId(Chain.EVM_LOCAL);
+     * // Returns: 31337
+     * ```
+     */
+    static getChainId(chain) {
+        const chainId = CHAIN_ID_MAP[chain];
+        if (chainId === undefined) {
+            throw new Error(`Unknown chain: ${chain}`);
+        }
+        return chainId;
+    }
+    /**
+     * Get the USDC address/mint for a given chain
+     * @param chain - Chain identifier
+     * @returns USDC contract address for EVM chains, or mint address for Solana chains
+     * @throws Error if the chain is not recognized
+     * @example
+     * ```typescript
+     * const ethUSDC = RpcHelpers.getUSDCAddress(Chain.ETH_MAINNET);
+     * // Returns: '0xA0b86a33E6441146a8A8e27c01f0D9B1F5E42E92'
+     *
+     * const polygonUSDC = RpcHelpers.getUSDCAddress(Chain.POLYGON_MAINNET);
+     * // Returns: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
+     *
+     * const solanaUSDC = RpcHelpers.getUSDCAddress(Chain.SOLANA_MAINNET);
+     * // Returns: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+     * ```
+     */
+    static getUSDCAddress(chain) {
+        const address = USDC_ADDRESS_MAP[chain];
+        if (address === undefined) {
+            throw new Error(`Unknown chain: ${chain}`);
+        }
+        return address;
+    }
+    /**
+     * Get the user-friendly display name for a chain
+     * @param chain - Chain identifier
+     * @returns Human-readable chain name
+     * @throws Error if the chain is not recognized
+     * @example
+     * ```typescript
+     * const ethName = RpcHelpers.getUserFriendlyName(Chain.ETH_MAINNET);
+     * // Returns: 'Ethereum'
+     *
+     * const polygonName = RpcHelpers.getUserFriendlyName(Chain.POLYGON_MAINNET);
+     * // Returns: 'Polygon'
+     *
+     * const sepoliaName = RpcHelpers.getUserFriendlyName(Chain.ETH_SEPOLIA);
+     * // Returns: 'Ethereum Sepolia'
+     *
+     * const localName = RpcHelpers.getUserFriendlyName(Chain.EVM_LOCAL);
+     * // Returns: 'Local EVM'
+     * ```
+     */
+    static getUserFriendlyName(chain) {
+        const name = CHAIN_NAME_MAP[chain];
+        if (name === undefined) {
+            throw new Error(`Unknown chain: ${chain}`);
+        }
+        return name;
+    }
+    /**
+     * Get the list of visible chains for the application
+     * @param isDev - Whether to include development/testnet chains
+     * @returns Array of Chain values to display
+     * @example
+     * ```typescript
+     * const prodChains = RpcHelpers.getVisibleChains(false);
+     * // Returns: [Chain.ETH_MAINNET, Chain.BASE_MAINNET, Chain.POLYGON_MAINNET, Chain.OPTIMISM_MAINNET]
+     *
+     * const devChains = RpcHelpers.getVisibleChains(true);
+     * // Returns: [Chain.ETH_MAINNET, Chain.BASE_MAINNET, Chain.POLYGON_MAINNET, Chain.OPTIMISM_MAINNET, Chain.ETH_SEPOLIA]
+     * ```
+     */
+    static getVisibleChains(isDev) {
+        const mainnetChains = [
+            enums_1.Chain.ETH_MAINNET,
+            enums_1.Chain.BASE_MAINNET,
+            enums_1.Chain.POLYGON_MAINNET,
+            enums_1.Chain.OPTIMISM_MAINNET,
+        ];
+        if (isDev) {
+            return [...mainnetChains, enums_1.Chain.ETH_SEPOLIA];
+        }
+        return mainnetChains;
+    }
+    /**
+     * Derive all chain information from a ChainConfig
+     * @param config - Chain configuration with API keys
+     * @returns Object with all derived chain information
+     * @example
+     * ```typescript
+     * const config: ChainConfig = {
+     *   chain: Chain.ETH_MAINNET,
+     *   alchemyApiKey: 'your-alchemy-key',
+     *   etherscanApiKey: 'your-etherscan-key'
+     * };
+     *
+     * const info = RpcHelpers.getChainInfo(config);
+     * // Returns: {
+     * //   chain: Chain.ETH_MAINNET,
+     * //   chainId: 1,
+     * //   chainType: ChainType.EVM,
+     * //   name: 'Ethereum',
+     * //   rpcUrl: 'https://eth-mainnet.g.alchemy.com/v2/your-alchemy-key',
+     * //   explorerApiUrl: 'https://api.etherscan.io/api?apikey=your-etherscan-key',
+     * //   explorerUrl: 'https://etherscan.io',
+     * //   usdcAddress: '0xA0b86a33E6441146a8A8e27c01f0D9B1F5E42E92'
+     * // }
+     * ```
+     */
+    static getChainInfo(config) {
+        return {
+            chain: config.chain,
+            chainId: this.getChainId(config.chain),
+            chainType: this.getChainType(config.chain),
+            name: this.getUserFriendlyName(config.chain),
+            rpcUrl: this.getRpcUrl(config.alchemyApiKey, config.chain),
+            explorerApiUrl: this.getExplorerApiUrl(config.etherscanApiKey, config.chain),
+            explorerUrl: this.getBlockExplorerUrl(config.chain),
+            usdcAddress: this.getUSDCAddress(config.chain),
+        };
+    }
+    static getRpcUrl(apiKeyOrApis, chain) {
+        const alchemyApiKey = typeof apiKeyOrApis === 'string'
+            ? apiKeyOrApis
+            : apiKeyOrApis.alchemyApiKey;
+        if (!alchemyApiKey) {
+            return undefined;
+        }
+        const network = ALCHEMY_NETWORK_MAP[chain];
+        if (!network) {
+            return undefined;
+        }
+        if (this.isSolanaChain(chain)) {
+            return `https://solana-${network}.g.alchemy.com/v2/${alchemyApiKey}`;
+        }
+        return `https://${network}.g.alchemy.com/v2/${alchemyApiKey}`;
+    }
+    static getExplorerApiUrl(apiKeyOrApis, chain) {
+        const etherscanApiKey = typeof apiKeyOrApis === 'string'
+            ? apiKeyOrApis
+            : apiKeyOrApis.etherscanApiKey;
+        if (!etherscanApiKey) {
+            return undefined;
+        }
+        if (this.isSolanaChain(chain)) {
+            return undefined;
+        }
+        const domain = EXPLORER_DOMAIN_MAP[chain];
+        if (!domain) {
+            return undefined;
+        }
+        return `https://${domain}/api?apikey=${etherscanApiKey}`;
+    }
+    /**
+     * Get block explorer browser URL
+     *
+     * @param chain - Chain identifier from Chain enum
+     * @returns Browser URL for the explorer, or undefined if no explorer available
+     *
+     * @example
+     * ```typescript
+     * const etherscanUrl = RpcHelpers.getBlockExplorerUrl(Chain.ETH_MAINNET);
+     * // Returns: https://etherscan.io
+     *
+     * const basescanUrl = RpcHelpers.getBlockExplorerUrl(Chain.BASE_MAINNET);
+     * // Returns: https://basescan.org
+     *
+     * const solanaUrl = RpcHelpers.getBlockExplorerUrl(Chain.SOLANA_MAINNET);
+     * // Returns: https://explorer.solana.com
+     * ```
+     */
+    static getBlockExplorerUrl(chain) {
+        const domain = EXPLORER_BROWSER_MAP[chain];
+        if (!domain) {
+            return undefined;
+        }
+        return `https://${domain}`;
+    }
+}
+exports.RpcHelpers = RpcHelpers;
+//# sourceMappingURL=rpc-helpers.js.map