@octaflowlabs/onchain-sdk 1.2.0 → 1.2.2

package/README.md

@@ -47,6 +47,22 @@ ABIs and constants
 - Multicall3 ABI and address for batched reads.
 - Gas limit defaults per transaction type.
 
+Networks registry
+
+- The SDK includes a predefined networks registry in `src/constants/NETWORKS_REGISTRY.ts`.
+- Networks are grouped by `category` (for example: `popular`, `custom`).
+- Each network entry includes:
+	- `id`: stable internal identifier.
+	- `name`: human-readable network name.
+	- `chainId`: EVM chain ID.
+	- `rpcUrl`: primary RPC endpoint.
+	- `failoverRpcUrl` (optional): fallback RPC endpoint.
+	- `explorerUrl`: block explorer base URL.
+	- `iconUrl`: network icon URL.
+	- `symbol`: native currency symbol.
+- This registry is useful for network selection UIs, chain metadata lookup, and RPC fallback handling.
+- You can use `chainId` with SDK helpers and pass `rpcUrl` (or `failoverRpcUrl`) to provider-based calls.
+
 ## Design notes
 
 - The SDK is stateless and transport-agnostic. It expects a caller-provided RPC URL.

package/dist/blockchain/broadcastTransaction.js

@@ -3,10 +3,7 @@ import { Transaction } from 'ethers';
 /** local imports */
 import { getProvider } from './getProvider';
 import { errorMessagesForBroadcast, handleErrorMessages } from '../utils/handleErrorMessages';
-import { ensurePublicHost, testJsonRpc } from '../rpc';
 export const broadcastTransaction = async ({ signedTx, rpcUrl, chainId, waitConfirmations = 0, }) => {
-    await ensurePublicHost(rpcUrl);
-    await testJsonRpc(rpcUrl, 'eth_chainId', []);
     const provider = getProvider(rpcUrl, chainId);
     if (!provider)
         throw new Error('Could not create provider with given rpcUrl');

package/dist/blockchain/buildUnsignedTransferTx.js

@@ -3,10 +3,7 @@ import { Interface, formatUnits, parseUnits } from 'ethers';
 /** local imports */
 import { getProvider } from './getProvider';
 import { estimateGasLimitFromProvider } from './estimateGasLimitFromProvider';
-import { ensurePublicHost, testJsonRpc } from '../rpc';
 export const buildUnsignedTransferTx = async (options) => {
-    await ensurePublicHost(options.rpcUrl);
-    await testJsonRpc(options.rpcUrl, 'eth_chainId', []);
     const provider = getProvider(options.rpcUrl, options.chainId);
     if (!provider)
         throw new Error('Could not create provider with given rpcUrl and chainId');

package/dist/cjs/blockchain/broadcastTransaction.js

@@ -6,10 +6,7 @@ const ethers_1 = require("ethers");
 /** local imports */
 const getProvider_1 = require("./getProvider");
 const handleErrorMessages_1 = require("../utils/handleErrorMessages");
-const rpc_1 = require("../rpc");
 const broadcastTransaction = async ({ signedTx, rpcUrl, chainId, waitConfirmations = 0, }) => {
-    await (0, rpc_1.ensurePublicHost)(rpcUrl);
-    await (0, rpc_1.testJsonRpc)(rpcUrl, 'eth_chainId', []);
     const provider = (0, getProvider_1.getProvider)(rpcUrl, chainId);
     if (!provider)
         throw new Error('Could not create provider with given rpcUrl');

package/dist/cjs/blockchain/buildUnsignedTransferTx.js

@@ -6,10 +6,7 @@ const ethers_1 = require("ethers");
 /** local imports */
 const getProvider_1 = require("./getProvider");
 const estimateGasLimitFromProvider_1 = require("./estimateGasLimitFromProvider");
-const rpc_1 = require("../rpc");
 const buildUnsignedTransferTx = async (options) => {
-    await (0, rpc_1.ensurePublicHost)(options.rpcUrl);
-    await (0, rpc_1.testJsonRpc)(options.rpcUrl, 'eth_chainId', []);
     const provider = (0, getProvider_1.getProvider)(options.rpcUrl, options.chainId);
     if (!provider)
         throw new Error('Could not create provider with given rpcUrl and chainId');

package/dist/cjs/constants/NETWORKS_REGISTRY.d.ts

@@ -0,0 +1,15 @@
+export interface NetworkField {
+    id: string;
+    name: string;
+    chainId: number;
+    rpcUrl: string;
+    explorerUrl: string;
+    iconUrl: string;
+    symbol: string;
+    failoverRpcUrl?: string;
+}
+export interface NetworkRegistry {
+    category: string;
+    networks: NetworkField[];
+}
+export declare const NETWORKS_REGISTRY: NetworkRegistry[];

package/dist/cjs/constants/NETWORKS_REGISTRY.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORKS_REGISTRY = void 0;
+exports.NETWORKS_REGISTRY = [
+    {
+        category: 'popular',
+        networks: [
+            {
+                id: 'ethereum-mainnet',
+                name: 'Ethereum Mainnet',
+                chainId: 1,
+                rpcUrl: 'https://ethereum-rpc.publicnode.com',
+                explorerUrl: 'https://etherscan.io',
+                iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
+                symbol: 'ETH',
+                failoverRpcUrl: 'https://eth.llamarpc.com',
+            },
+            {
+                id: 'bnb-smart-chain',
+                name: 'BNB Smart Chain',
+                chainId: 56,
+                rpcUrl: 'https://bsc-dataseed.bnbchain.org',
+                explorerUrl: 'https://bscscan.com/',
+                iconUrl: 'https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png',
+                symbol: 'BNB',
+                failoverRpcUrl: 'https://bsc.llamarpc.com',
+            },
+            {
+                id: 'polygon-mainnet',
+                name: 'Polygon Mainnet',
+                iconUrl: 'https://assets.coingecko.com/coins/images/4713/large/matic-token-icon.png',
+                chainId: 137,
+                rpcUrl: 'https://polygon.publicnode.com',
+                explorerUrl: 'https://polygonscan.com',
+                symbol: 'POL',
+                failoverRpcUrl: 'https://polygon.llamarpc.com',
+            },
+            {
+                id: 'arbitrum-mainnet',
+                name: 'Arbitrum Mainnet',
+                chainId: 42161,
+                rpcUrl: 'https://public-arb-mainnet.fastnode.io',
+                explorerUrl: 'https://arbiscan.io',
+                iconUrl: 'https://assets.coingecko.com/coins/images/16547/large/photo_2023-03-29_21.47.00.jpeg',
+                symbol: 'ARB',
+                failoverRpcUrl: 'https://arb.llamarpc.com',
+            },
+        ],
+    },
+    {
+        category: 'custom',
+        networks: [
+            {
+                id: 'sepolia-eth',
+                name: 'Sepolia Testnet',
+                chainId: 11155111,
+                rpcUrl: 'https://ethereum-sepolia-rpc.publicnode.com',
+                explorerUrl: 'https://sepolia.etherscan.io',
+                iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
+                symbol: 'ETH',
+                failoverRpcUrl: 'https://eth-sepolia.llamarpc.com',
+            },
+        ],
+    },
+];

package/dist/cjs/index.d.ts

@@ -3,6 +3,7 @@ import ERC20_TOKEN_CONTRACT_ABI from './ABIs/ERC20_TOKEN_CONTRACT_ABI';
 export { ERC20_TOKEN_CONTRACT_ABI };
 /** constants exports */
 export { GAS_LIMIT_PER_TX_TYPE, MULTICALL3_ADDRESS } from './constants/constants';
+export { NETWORKS_REGISTRY, NetworkField, NetworkRegistry } from './constants/NETWORKS_REGISTRY';
 /** basic blockchain exports */
 export { buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
 export { broadcastTransaction } from './blockchain/broadcastTransaction';
@@ -22,7 +23,5 @@ export { NATIVE_TOKENS };
 export { formattedAmountForDisplay, parsedAmount } from './utils/formatAmount';
 export { handleErrorMessages, errorMessagesForBroadcast, errorMessagesForGasLimitEstimation, } from './utils/handleErrorMessages';
 export { normalizeAddress } from './utils/normalizeAddress';
-/** rpc exports */
-export { validateRpcUrl, ensurePublicHost, testJsonRpc } from './rpc/index';
 /** types exports */
 export { BroadcastTransactionOptions, BuildMaxNativeTransferTxOptions, BuildMaxNativeTransferTxResponse, BuildUnsignedTransferTxOptions, EstimateGasLimitFromProviderProps, GasEstimateResult, TxStatusOptions, TxStatusResponse, UnsignedTransferTxResponse, FormatAmountOptions, TransactionRequest, GetBalanceParams, GetBalancesParams, GetBalancesChainRequest, GetBalanceResult, ChainBalances, TokenBalance, ChainGroup, } from './types/common';

package/dist/cjs/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.testJsonRpc = exports.ensurePublicHost = exports.validateRpcUrl = exports.normalizeAddress = exports.errorMessagesForGasLimitEstimation = exports.errorMessagesForBroadcast = exports.handleErrorMessages = exports.parsedAmount = exports.formattedAmountForDisplay = exports.NATIVE_TOKENS = exports.transformBigInt = exports.getShortenData = exports.getShortenTransactionHashOrAddress = exports.signTransaction = exports.signMessage = exports.createWallet = exports.EvmWalletService = exports.getBalances = exports.getBalance = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.MULTICALL3_ADDRESS = exports.GAS_LIMIT_PER_TX_TYPE = exports.ERC20_TOKEN_CONTRACT_ABI = void 0;
+exports.normalizeAddress = exports.errorMessagesForGasLimitEstimation = exports.errorMessagesForBroadcast = exports.handleErrorMessages = exports.parsedAmount = exports.formattedAmountForDisplay = exports.NATIVE_TOKENS = exports.transformBigInt = exports.getShortenData = exports.getShortenTransactionHashOrAddress = exports.signTransaction = exports.signMessage = exports.createWallet = exports.EvmWalletService = exports.getBalances = exports.getBalance = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.NETWORKS_REGISTRY = exports.MULTICALL3_ADDRESS = exports.GAS_LIMIT_PER_TX_TYPE = exports.ERC20_TOKEN_CONTRACT_ABI = void 0;
 /** ABIs exports */
 const ERC20_TOKEN_CONTRACT_ABI_1 = __importDefault(require("./ABIs/ERC20_TOKEN_CONTRACT_ABI"));
 exports.ERC20_TOKEN_CONTRACT_ABI = ERC20_TOKEN_CONTRACT_ABI_1.default;
@@ -11,6 +11,8 @@ exports.ERC20_TOKEN_CONTRACT_ABI = ERC20_TOKEN_CONTRACT_ABI_1.default;
 var constants_1 = require("./constants/constants");
 Object.defineProperty(exports, "GAS_LIMIT_PER_TX_TYPE", { enumerable: true, get: function () { return constants_1.GAS_LIMIT_PER_TX_TYPE; } });
 Object.defineProperty(exports, "MULTICALL3_ADDRESS", { enumerable: true, get: function () { return constants_1.MULTICALL3_ADDRESS; } });
+var NETWORKS_REGISTRY_1 = require("./constants/NETWORKS_REGISTRY");
+Object.defineProperty(exports, "NETWORKS_REGISTRY", { enumerable: true, get: function () { return NETWORKS_REGISTRY_1.NETWORKS_REGISTRY; } });
 /** basic blockchain exports */
 var buildUnsignedTransferTx_1 = require("./blockchain/buildUnsignedTransferTx");
 Object.defineProperty(exports, "buildMaxNativeTransferTx", { enumerable: true, get: function () { return buildUnsignedTransferTx_1.buildMaxNativeTransferTx; } });
@@ -50,8 +52,3 @@ Object.defineProperty(exports, "errorMessagesForBroadcast", { enumerable: true,
 Object.defineProperty(exports, "errorMessagesForGasLimitEstimation", { enumerable: true, get: function () { return handleErrorMessages_1.errorMessagesForGasLimitEstimation; } });
 var normalizeAddress_1 = require("./utils/normalizeAddress");
 Object.defineProperty(exports, "normalizeAddress", { enumerable: true, get: function () { return normalizeAddress_1.normalizeAddress; } });
-/** rpc exports */
-var index_1 = require("./rpc/index");
-Object.defineProperty(exports, "validateRpcUrl", { enumerable: true, get: function () { return index_1.validateRpcUrl; } });
-Object.defineProperty(exports, "ensurePublicHost", { enumerable: true, get: function () { return index_1.ensurePublicHost; } });
-Object.defineProperty(exports, "testJsonRpc", { enumerable: true, get: function () { return index_1.testJsonRpc; } });

package/dist/constants/NETWORKS_REGISTRY.d.ts

@@ -0,0 +1,15 @@
+export interface NetworkField {
+    id: string;
+    name: string;
+    chainId: number;
+    rpcUrl: string;
+    explorerUrl: string;
+    iconUrl: string;
+    symbol: string;
+    failoverRpcUrl?: string;
+}
+export interface NetworkRegistry {
+    category: string;
+    networks: NetworkField[];
+}
+export declare const NETWORKS_REGISTRY: NetworkRegistry[];

package/dist/constants/NETWORKS_REGISTRY.js

@@ -0,0 +1,62 @@
+export const NETWORKS_REGISTRY = [
+    {
+        category: 'popular',
+        networks: [
+            {
+                id: 'ethereum-mainnet',
+                name: 'Ethereum Mainnet',
+                chainId: 1,
+                rpcUrl: 'https://ethereum-rpc.publicnode.com',
+                explorerUrl: 'https://etherscan.io',
+                iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
+                symbol: 'ETH',
+                failoverRpcUrl: 'https://eth.llamarpc.com',
+            },
+            {
+                id: 'bnb-smart-chain',
+                name: 'BNB Smart Chain',
+                chainId: 56,
+                rpcUrl: 'https://bsc-dataseed.bnbchain.org',
+                explorerUrl: 'https://bscscan.com/',
+                iconUrl: 'https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png',
+                symbol: 'BNB',
+                failoverRpcUrl: 'https://bsc.llamarpc.com',
+            },
+            {
+                id: 'polygon-mainnet',
+                name: 'Polygon Mainnet',
+                iconUrl: 'https://assets.coingecko.com/coins/images/4713/large/matic-token-icon.png',
+                chainId: 137,
+                rpcUrl: 'https://polygon.publicnode.com',
+                explorerUrl: 'https://polygonscan.com',
+                symbol: 'POL',
+                failoverRpcUrl: 'https://polygon.llamarpc.com',
+            },
+            {
+                id: 'arbitrum-mainnet',
+                name: 'Arbitrum Mainnet',
+                chainId: 42161,
+                rpcUrl: 'https://public-arb-mainnet.fastnode.io',
+                explorerUrl: 'https://arbiscan.io',
+                iconUrl: 'https://assets.coingecko.com/coins/images/16547/large/photo_2023-03-29_21.47.00.jpeg',
+                symbol: 'ARB',
+                failoverRpcUrl: 'https://arb.llamarpc.com',
+            },
+        ],
+    },
+    {
+        category: 'custom',
+        networks: [
+            {
+                id: 'sepolia-eth',
+                name: 'Sepolia Testnet',
+                chainId: 11155111,
+                rpcUrl: 'https://ethereum-sepolia-rpc.publicnode.com',
+                explorerUrl: 'https://sepolia.etherscan.io',
+                iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
+                symbol: 'ETH',
+                failoverRpcUrl: 'https://eth-sepolia.llamarpc.com',
+            },
+        ],
+    },
+];

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import ERC20_TOKEN_CONTRACT_ABI from './ABIs/ERC20_TOKEN_CONTRACT_ABI';
 export { ERC20_TOKEN_CONTRACT_ABI };
 /** constants exports */
 export { GAS_LIMIT_PER_TX_TYPE, MULTICALL3_ADDRESS } from './constants/constants';
+export { NETWORKS_REGISTRY, NetworkField, NetworkRegistry } from './constants/NETWORKS_REGISTRY';
 /** basic blockchain exports */
 export { buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
 export { broadcastTransaction } from './blockchain/broadcastTransaction';
@@ -22,7 +23,5 @@ export { NATIVE_TOKENS };
 export { formattedAmountForDisplay, parsedAmount } from './utils/formatAmount';
 export { handleErrorMessages, errorMessagesForBroadcast, errorMessagesForGasLimitEstimation, } from './utils/handleErrorMessages';
 export { normalizeAddress } from './utils/normalizeAddress';
-/** rpc exports */
-export { validateRpcUrl, ensurePublicHost, testJsonRpc } from './rpc/index';
 /** types exports */
 export { BroadcastTransactionOptions, BuildMaxNativeTransferTxOptions, BuildMaxNativeTransferTxResponse, BuildUnsignedTransferTxOptions, EstimateGasLimitFromProviderProps, GasEstimateResult, TxStatusOptions, TxStatusResponse, UnsignedTransferTxResponse, FormatAmountOptions, TransactionRequest, GetBalanceParams, GetBalancesParams, GetBalancesChainRequest, GetBalanceResult, ChainBalances, TokenBalance, ChainGroup, } from './types/common';

package/dist/index.js

@@ -3,6 +3,7 @@ import ERC20_TOKEN_CONTRACT_ABI from './ABIs/ERC20_TOKEN_CONTRACT_ABI';
 export { ERC20_TOKEN_CONTRACT_ABI };
 /** constants exports */
 export { GAS_LIMIT_PER_TX_TYPE, MULTICALL3_ADDRESS } from './constants/constants';
+export { NETWORKS_REGISTRY } from './constants/NETWORKS_REGISTRY';
 /** basic blockchain exports */
 export { buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
 export { broadcastTransaction } from './blockchain/broadcastTransaction';
@@ -21,5 +22,3 @@ export { NATIVE_TOKENS };
 export { formattedAmountForDisplay, parsedAmount } from './utils/formatAmount';
 export { handleErrorMessages, errorMessagesForBroadcast, errorMessagesForGasLimitEstimation, } from './utils/handleErrorMessages';
 export { normalizeAddress } from './utils/normalizeAddress';
-/** rpc exports */
-export { validateRpcUrl, ensurePublicHost, testJsonRpc } from './rpc/index';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaflowlabs/onchain-sdk",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "onchain methods for web3",
   "repository": "https://github.com/crisramb665/onchain-sdk.git",
   "license": "MIT",

package/dist/cjs/rpc/index.d.ts

@@ -1,3 +0,0 @@
-export declare const validateRpcUrl: (rpcUrl: string, allowLocal?: boolean) => URL;
-export declare const ensurePublicHost: (rpcUrl: string) => Promise<boolean>;
-export declare const testJsonRpc: (rpcUrl: string, method?: string, params?: any[]) => Promise<unknown>;

package/dist/cjs/rpc/index.js

@@ -1,69 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.testJsonRpc = exports.ensurePublicHost = exports.validateRpcUrl = void 0;
-/** npm imports */
-const promises_1 = __importDefault(require("dns/promises"));
-const net_1 = __importDefault(require("net"));
-const PRIVATE_IP_RANGES = [
-    /^127\./,
-    /^10\./,
-    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
-    /^192\.168\./,
-    /^169\.254\./,
-];
-const validateRpcUrl = (rpcUrl, allowLocal = false) => {
-    let url;
-    try {
-        url = new URL(rpcUrl);
-        if (!allowLocal && ['localhost', '127.0.0.1', '::1'].includes(url.hostname))
-            throw new Error('Localhost URLs are not allowed');
-    }
-    catch {
-        throw new Error('Invalid RPC URL');
-    }
-    if (!['http:', 'https:', 'ws:', 'wss:'].includes(url.protocol))
-        throw new Error('Unsupported protocol. Only http, https, ws, and wss are allowed.');
-    if (['localhost', '127.0.0.1'].includes(url.hostname))
-        throw new Error('Localhost RPC not allowed');
-    return url;
-};
-exports.validateRpcUrl = validateRpcUrl;
-const ensurePublicHost = async (rpcUrl) => {
-    const url = (0, exports.validateRpcUrl)(rpcUrl);
-    try {
-        const addresses = await promises_1.default.lookup(url.hostname, { all: true });
-        const hasPrivateIp = addresses
-            .filter((a) => net_1.default.isIP(a.address))
-            .some((a) => PRIVATE_IP_RANGES.some((r) => r.test(a.address)));
-        if (hasPrivateIp)
-            throw new Error('RPC URL resolves to a private IP address');
-        return true;
-    }
-    catch (error) {
-        console.error('Error validating RPC URL:', error);
-        throw new Error('Failed to validate RPC URL');
-    }
-};
-exports.ensurePublicHost = ensurePublicHost;
-const testJsonRpc = async (rpcUrl, method = 'eth_chainId', params = []) => {
-    await (0, exports.ensurePublicHost)(rpcUrl);
-    const payload = { jsonrpc: '2.0', id: 1, method, params };
-    try {
-        const res = await fetch(rpcUrl, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(payload),
-            signal: AbortSignal.timeout(5000),
-        });
-        const data = await res.json();
-        return data;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`RPC test failed: ${errorMessage}`);
-    }
-};
-exports.testJsonRpc = testJsonRpc;

package/dist/rpc/index.d.ts

@@ -1,3 +0,0 @@
-export declare const validateRpcUrl: (rpcUrl: string, allowLocal?: boolean) => URL;
-export declare const ensurePublicHost: (rpcUrl: string) => Promise<boolean>;
-export declare const testJsonRpc: (rpcUrl: string, method?: string, params?: any[]) => Promise<unknown>;

package/dist/rpc/index.js

@@ -1,60 +0,0 @@
-/** npm imports */
-import dns from 'dns/promises';
-import net from 'net';
-const PRIVATE_IP_RANGES = [
-    /^127\./,
-    /^10\./,
-    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
-    /^192\.168\./,
-    /^169\.254\./,
-];
-export const validateRpcUrl = (rpcUrl, allowLocal = false) => {
-    let url;
-    try {
-        url = new URL(rpcUrl);
-        if (!allowLocal && ['localhost', '127.0.0.1', '::1'].includes(url.hostname))
-            throw new Error('Localhost URLs are not allowed');
-    }
-    catch {
-        throw new Error('Invalid RPC URL');
-    }
-    if (!['http:', 'https:', 'ws:', 'wss:'].includes(url.protocol))
-        throw new Error('Unsupported protocol. Only http, https, ws, and wss are allowed.');
-    if (['localhost', '127.0.0.1'].includes(url.hostname))
-        throw new Error('Localhost RPC not allowed');
-    return url;
-};
-export const ensurePublicHost = async (rpcUrl) => {
-    const url = validateRpcUrl(rpcUrl);
-    try {
-        const addresses = await dns.lookup(url.hostname, { all: true });
-        const hasPrivateIp = addresses
-            .filter((a) => net.isIP(a.address))
-            .some((a) => PRIVATE_IP_RANGES.some((r) => r.test(a.address)));
-        if (hasPrivateIp)
-            throw new Error('RPC URL resolves to a private IP address');
-        return true;
-    }
-    catch (error) {
-        console.error('Error validating RPC URL:', error);
-        throw new Error('Failed to validate RPC URL');
-    }
-};
-export const testJsonRpc = async (rpcUrl, method = 'eth_chainId', params = []) => {
-    await ensurePublicHost(rpcUrl);
-    const payload = { jsonrpc: '2.0', id: 1, method, params };
-    try {
-        const res = await fetch(rpcUrl, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(payload),
-            signal: AbortSignal.timeout(5000),
-        });
-        const data = await res.json();
-        return data;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`RPC test failed: ${errorMessage}`);
-    }
-};