@octaflowlabs/onchain-sdk 1.1.2 → 1.1.4

package/dist/blockchain/broadcastTransaction.js

@@ -3,7 +3,10 @@ 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,7 +3,10 @@ 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/blockchain/estimateGasLimitFromProvider.js

@@ -29,6 +29,12 @@ export const estimateGasLimitFromProvider = async ({ provider, unsignedTx, walle
         }
         const bufferPercentage = Math.min(Math.max(Math.round(congestionFactor * 5), 5), 30); // 5% to 30% buffer
         const newGasLimit = gasEstimated + (gasEstimated * BigInt(bufferPercentage)) / BigInt(100);
+        // let suggested: GasFeesApiResponse | undefined = undefined
+        // try {
+        //   suggested = await this.getSuggestedGasPrice((await provider.getNetwork()).chainId)
+        // } catch {
+        //   suggested = undefined
+        // }
         return {
             gasEstimated,
             gasLimit: newGasLimit,

package/dist/cjs/blockchain/broadcastTransaction.js

@@ -6,7 +6,10 @@ 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,7 +6,10 @@ 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/blockchain/estimateGasLimitFromProvider.js

@@ -32,6 +32,12 @@ const estimateGasLimitFromProvider = async ({ provider, unsignedTx, walletAddres
         }
         const bufferPercentage = Math.min(Math.max(Math.round(congestionFactor * 5), 5), 30); // 5% to 30% buffer
         const newGasLimit = gasEstimated + (gasEstimated * BigInt(bufferPercentage)) / BigInt(100);
+        // let suggested: GasFeesApiResponse | undefined = undefined
+        // try {
+        //   suggested = await this.getSuggestedGasPrice((await provider.getNetwork()).chainId)
+        // } catch {
+        //   suggested = undefined
+        // }
         return {
             gasEstimated,
             gasLimit: newGasLimit,

package/dist/cjs/index.d.ts

@@ -19,5 +19,9 @@ export { transformBigInt } from './utils/transformBigInt';
 import NATIVE_TOKENS from './utils/tokens';
 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, } 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.parsedAmount = exports.formattedAmountForDisplay = exports.NATIVE_TOKENS = exports.transformBigInt = exports.getShortenData = exports.getShortenTransactionHashOrAddress = exports.signTransaction = exports.signMessage = exports.createWallet = exports.EvmWalletService = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.GAS_LIMIT_PER_TX_TYPE = exports.ERC20_TOKEN_CONTRACT_ABI = void 0;
+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.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = 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;
@@ -40,3 +40,14 @@ exports.NATIVE_TOKENS = tokens_1.default;
 var formatAmount_1 = require("./utils/formatAmount");
 Object.defineProperty(exports, "formattedAmountForDisplay", { enumerable: true, get: function () { return formatAmount_1.formattedAmountForDisplay; } });
 Object.defineProperty(exports, "parsedAmount", { enumerable: true, get: function () { return formatAmount_1.parsedAmount; } });
+var handleErrorMessages_1 = require("./utils/handleErrorMessages");
+Object.defineProperty(exports, "handleErrorMessages", { enumerable: true, get: function () { return handleErrorMessages_1.handleErrorMessages; } });
+Object.defineProperty(exports, "errorMessagesForBroadcast", { enumerable: true, get: function () { return handleErrorMessages_1.errorMessagesForBroadcast; } });
+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/cjs/rpc/index.d.ts

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,69 @@
+"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/cjs/utils/normalizeAddress.d.ts

@@ -0,0 +1 @@
+export declare const normalizeAddress: (address: string) => string;

package/dist/cjs/utils/normalizeAddress.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAddress = void 0;
+/** npm imports */
+const ethers_1 = require("ethers");
+const normalizeAddress = (address) => {
+    try {
+        return (0, ethers_1.getAddress)(address);
+    }
+    catch (e) {
+        console.log('Error normalizing address:', e);
+        throw new Error('Error normalizing address: ' + (e instanceof Error ? e.message : String(e)));
+    }
+};
+exports.normalizeAddress = normalizeAddress;

package/dist/index.d.ts

@@ -19,5 +19,9 @@ export { transformBigInt } from './utils/transformBigInt';
 import NATIVE_TOKENS from './utils/tokens';
 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, } from './types/common';

package/dist/index.js

@@ -18,3 +18,7 @@ export { transformBigInt } from './utils/transformBigInt';
 import NATIVE_TOKENS from './utils/tokens';
 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/dist/rpc/index.d.ts

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,60 @@
+/** 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}`);
+    }
+};

package/dist/utils/normalizeAddress.d.ts

@@ -0,0 +1 @@
+export declare const normalizeAddress: (address: string) => string;

package/dist/utils/normalizeAddress.js

@@ -0,0 +1,11 @@
+/** npm imports */
+import { getAddress } from 'ethers';
+export const normalizeAddress = (address) => {
+    try {
+        return getAddress(address);
+    }
+    catch (e) {
+        console.log('Error normalizing address:', e);
+        throw new Error('Error normalizing address: ' + (e instanceof Error ? e.message : String(e)));
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaflowlabs/onchain-sdk",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "onchain methods for web3",
   "repository": "https://github.com/crisramb665/onchain-sdk.git",
   "license": "MIT",
@@ -16,6 +16,7 @@
     "prepublishOnly": "yarn run build"
   },
   "devDependencies": {
+    "@types/node": "^25.2.2",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",