@octaflowlabs/onchain-sdk 1.3.8 → 1.4.1

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

@@ -8,6 +8,7 @@ export interface NetworkField {
     iconUrl: string;
     symbol: string;
     failoverRpcUrl?: string;
+    blockTime?: number;
 }
 export interface NetworkRegistry {
     category: string;

package/dist/cjs/constants/NETWORKS_REGISTRY.js

@@ -15,6 +15,7 @@ exports.NETWORKS_REGISTRY = [
                 iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
                 symbol: 'ETH',
                 failoverRpcUrl: 'https://eth.llamarpc.com',
+                blockTime: 12,
             },
             {
                 id: 'bnb-smart-chain',
@@ -22,10 +23,11 @@ exports.NETWORKS_REGISTRY = [
                 nameForDisplay: 'BNB Smart Chain',
                 chainId: 56,
                 rpcUrl: 'https://bsc-dataseed.bnbchain.org',
-                explorerUrl: 'https://bscscan.com/',
+                explorerUrl: 'https://bscscan.com',
                 iconUrl: 'https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png',
                 symbol: 'BNB',
                 failoverRpcUrl: 'https://bsc.llamarpc.com',
+                blockTime: 3,
             },
             {
                 id: 'polygon-mainnet',
@@ -37,6 +39,7 @@ exports.NETWORKS_REGISTRY = [
                 explorerUrl: 'https://polygonscan.com',
                 symbol: 'POL',
                 failoverRpcUrl: 'https://polygon.llamarpc.com',
+                blockTime: 2,
             },
             {
                 id: 'arbitrum-mainnet',
@@ -48,6 +51,7 @@ exports.NETWORKS_REGISTRY = [
                 iconUrl: 'https://assets.coingecko.com/coins/images/16547/large/photo_2023-03-29_21.47.00.jpeg',
                 symbol: 'ARB',
                 failoverRpcUrl: 'https://arb.llamarpc.com',
+                blockTime: 1,
             },
         ],
     },
@@ -64,6 +68,7 @@ exports.NETWORKS_REGISTRY = [
                 iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
                 symbol: 'ETH',
                 failoverRpcUrl: 'https://eth-sepolia.llamarpc.com',
+                blockTime: 12,
             },
         ],
     },

package/dist/cjs/index.d.ts

@@ -3,7 +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 { NetworkField, NetworkRegistry, NETWORKS_REGISTRY, } from './constants/NETWORKS_REGISTRY';
+export { NetworkField, NetworkRegistry, NETWORKS_REGISTRY } from './constants/NETWORKS_REGISTRY';
 export { BASIC_TOKENS_BY_CHAIN, BasicTokenData, BasicTokenSymbol, ChainTokenDataMap, } from './constants/BASIC_TOKENS_REGISTRY';
 /** basic blockchain exports */
 export { buildBaseUnsignedTransferTx, buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
@@ -26,5 +26,7 @@ export { NATIVE_TOKENS };
 export { formattedAmountForDisplay, parsedAmount } from './utils/formatAmount';
 export { handleErrorMessages, errorMessagesForBroadcast, errorMessagesForGasLimitEstimation, } from './utils/handleErrorMessages';
 export { normalizeAddress } from './utils/normalizeAddress';
+export { toGwei, tryParseGweiToWei, parseGasLimit } from './utils/parseGasFees';
+export { getFeePresets, calcReserve, estimateSeconds, getBlockTime, BLOCK_TIME_BY_CHAIN, } from './utils/feePresets';
 /** types exports */
-export { BroadcastTransactionOptions, BuildMaxNativeTransferTxOptions, BuildUnsignedTransferTxOptions, EstimateGasLimitFromProviderProps, GasEstimateResult, TxStatusOptions, BuildBaseUnsignedTransferTxParams, TxStatusResponse, EstimateTransactionOptions, EstimateTransactionResult, PrepareTransactionParams, PrepareTransactionResult, FormatAmountOptions, TransactionRequest, GetBalanceParams, GetBalancesParams, GetBalancesChainRequest, GetBalanceResult, ChainBalances, TokenBalance, ChainGroup, } from './types/common';
+export { BroadcastTransactionOptions, BuildMaxNativeTransferTxOptions, BuildUnsignedTransferTxOptions, EstimateGasLimitFromProviderProps, GasEstimateResult, TxStatusOptions, BuildBaseUnsignedTransferTxParams, TxStatusResponse, EstimateTransactionOptions, EstimateTransactionResult, PrepareTransactionParams, PrepareTransactionResult, FormatAmountOptions, TransactionRequest, GetBalanceParams, GetBalancesParams, GetBalancesChainRequest, GetBalanceResult, ChainBalances, TokenBalance, ChainGroup, FeePreset, FeePresetLabel, FeeEstimateSeconds, ResolvedFees, EIP1559Fees, LegacyFees, FeeModel, FeeHistoryData, FeeDataInput, } 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.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.prepareTransaction = exports.estimateTransaction = exports.getBalances = exports.getBalance = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.buildBaseUnsignedTransferTx = exports.BASIC_TOKENS_BY_CHAIN = exports.NETWORKS_REGISTRY = exports.MULTICALL3_ADDRESS = exports.GAS_LIMIT_PER_TX_TYPE = exports.ERC20_TOKEN_CONTRACT_ABI = void 0;
+exports.BLOCK_TIME_BY_CHAIN = exports.getBlockTime = exports.estimateSeconds = exports.calcReserve = exports.getFeePresets = exports.parseGasLimit = exports.tryParseGweiToWei = exports.toGwei = 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.prepareTransaction = exports.estimateTransaction = exports.getBalances = exports.getBalance = exports.txStatus = exports.getProvider = exports.estimateGasLimitFromProvider = exports.broadcastTransaction = exports.buildUnsignedTransferTx = exports.buildMaxNativeTransferTx = exports.buildBaseUnsignedTransferTx = exports.BASIC_TOKENS_BY_CHAIN = 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;
@@ -59,3 +59,13 @@ 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; } });
+var parseGasFees_1 = require("./utils/parseGasFees");
+Object.defineProperty(exports, "toGwei", { enumerable: true, get: function () { return parseGasFees_1.toGwei; } });
+Object.defineProperty(exports, "tryParseGweiToWei", { enumerable: true, get: function () { return parseGasFees_1.tryParseGweiToWei; } });
+Object.defineProperty(exports, "parseGasLimit", { enumerable: true, get: function () { return parseGasFees_1.parseGasLimit; } });
+var feePresets_1 = require("./utils/feePresets");
+Object.defineProperty(exports, "getFeePresets", { enumerable: true, get: function () { return feePresets_1.getFeePresets; } });
+Object.defineProperty(exports, "calcReserve", { enumerable: true, get: function () { return feePresets_1.calcReserve; } });
+Object.defineProperty(exports, "estimateSeconds", { enumerable: true, get: function () { return feePresets_1.estimateSeconds; } });
+Object.defineProperty(exports, "getBlockTime", { enumerable: true, get: function () { return feePresets_1.getBlockTime; } });
+Object.defineProperty(exports, "BLOCK_TIME_BY_CHAIN", { enumerable: true, get: function () { return feePresets_1.BLOCK_TIME_BY_CHAIN; } });

package/dist/cjs/types/common.d.ts

@@ -130,3 +130,46 @@ export interface ChainGroup {
     nativeBalanceRequests: GetBalanceParams[];
     tokenBalanceRequests: GetBalanceParams[];
 }
+export type EIP1559Fees = {
+    mode: 'eip1559';
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    gasLimit: bigint;
+};
+export type LegacyFees = {
+    mode: 'legacy';
+    gasPrice: bigint;
+    gasLimit: bigint;
+};
+export type ResolvedFees = EIP1559Fees | LegacyFees;
+export type FeeModel = 'eip1559' | 'legacy';
+export type FeePresetLabel = 'Low' | 'Standard' | 'High';
+export type FeeEstimateSeconds = {
+    min: number;
+    max: number;
+};
+export type FeePreset = {
+    label: FeePresetLabel;
+    fees: ResolvedFees;
+    humanReadableGasReserve: string;
+    humanReadableEstimatedCost: string;
+    estimatedSeconds?: FeeEstimateSeconds;
+};
+export type FeeHistoryData = {
+    currentBaseFee: string;
+    range12h: {
+        minBaseFee: string;
+        maxBaseFee: string;
+        minPriorityFee: string;
+        maxPriorityFee: string;
+    };
+};
+export type FeeDataInput = {
+    chainId?: number;
+    gasLimit?: bigint | string | number;
+    feeData?: {
+        maxFeePerGas?: bigint | string;
+        maxPriorityFeePerGas?: bigint | string;
+        gasPrice?: bigint | string;
+    };
+};

package/dist/cjs/utils/feePresets.d.ts

@@ -0,0 +1,6 @@
+import { FeeDataInput, FeeEstimateSeconds, FeePreset } from '../types/common';
+export declare const BLOCK_TIME_BY_CHAIN: Record<number, number>;
+export declare function getBlockTime(chainId: number): number;
+export declare function calcReserve(gasLimit: bigint, pricePerGas: bigint): string;
+export declare function estimateSeconds(presetPriority: bigint, standardPriority: bigint, blockTime: number): FeeEstimateSeconds;
+export declare function getFeePresets(tx: FeeDataInput): FeePreset[];

package/dist/cjs/utils/feePresets.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLOCK_TIME_BY_CHAIN = void 0;
+exports.getBlockTime = getBlockTime;
+exports.calcReserve = calcReserve;
+exports.estimateSeconds = estimateSeconds;
+exports.getFeePresets = getFeePresets;
+const NETWORKS_REGISTRY_1 = require("../constants/NETWORKS_REGISTRY");
+const formatAmount_1 = require("./formatAmount");
+const DEFAULT_BLOCK_TIME = 12;
+const FORMAT_OPTS = { useGroupSeparator: false, decimalsToShow: 18 };
+exports.BLOCK_TIME_BY_CHAIN = Object.fromEntries(NETWORKS_REGISTRY_1.NETWORKS_REGISTRY.flatMap((r) => r.networks)
+    .filter((n) => n.blockTime != null)
+    .map((n) => [n.chainId, n.blockTime]));
+function getBlockTime(chainId) {
+    return exports.BLOCK_TIME_BY_CHAIN[chainId] ?? DEFAULT_BLOCK_TIME;
+}
+function calcReserve(gasLimit, pricePerGas) {
+    return (0, formatAmount_1.formattedAmountForDisplay)(gasLimit * pricePerGas, 18, FORMAT_OPTS);
+}
+function estimateSeconds(presetPriority, standardPriority, blockTime) {
+    if (standardPriority === 0n) {
+        return { min: blockTime, max: blockTime * 4 };
+    }
+    const ratio = Number((presetPriority * 1000n) / standardPriority) / 1000;
+    if (ratio >= 1.4)
+        return { min: blockTime, max: blockTime * 2 };
+    if (ratio >= 0.9)
+        return { min: blockTime, max: blockTime * 3 };
+    return { min: blockTime, max: blockTime * 4 };
+}
+function getFeePresets(tx) {
+    const builtTx = tx;
+    const { maxFeePerGas, maxPriorityFeePerGas, gasPrice } = builtTx.feeData ?? {};
+    const gasLimit = builtTx.gasLimit
+        ? BigInt(builtTx.gasLimit)
+        : BigInt(builtTx.unsignedTx?.gasLimit ?? 21000);
+    // EIP-1559
+    if (maxFeePerGas != null && maxPriorityFeePerGas != null) {
+        const priority = BigInt(maxPriorityFeePerGas);
+        const baseFee = BigInt(maxFeePerGas) - BigInt(maxPriorityFeePerGas);
+        const estimatedCostPerGas = (priority) => baseFee + priority;
+        const chainId = builtTx.unsignedTx?.chainId ?? 1;
+        const blockTime = getBlockTime(chainId);
+        const lowPriority = (priority * 75n) / 100n;
+        const highPriority = (priority * 150n) / 100n;
+        const build = (label, priority, seconds) => {
+            const presetMaxFeePerGas = baseFee + priority;
+            return {
+                label,
+                fees: {
+                    mode: 'eip1559',
+                    maxFeePerGas: presetMaxFeePerGas,
+                    maxPriorityFeePerGas: priority,
+                    gasLimit,
+                },
+                humanReadableGasReserve: calcReserve(gasLimit, presetMaxFeePerGas),
+                humanReadableEstimatedCost: calcReserve(gasLimit, estimatedCostPerGas(priority)),
+                estimatedSeconds: seconds,
+            };
+        };
+        return [
+            build('Low', lowPriority, estimateSeconds(lowPriority, priority, blockTime)),
+            build('Standard', priority, estimateSeconds(priority, priority, blockTime)),
+            build('High', highPriority, estimateSeconds(highPriority, priority, blockTime)),
+        ];
+    }
+    // Legacy
+    if (gasPrice != null) {
+        const price = BigInt(gasPrice);
+        const build = (label, price, estimatedSeconds) => ({
+            label,
+            fees: { mode: 'legacy', gasPrice: price, gasLimit },
+            humanReadableGasReserve: calcReserve(gasLimit, price),
+            humanReadableEstimatedCost: calcReserve(gasLimit, price),
+            estimatedSeconds,
+        });
+        return [
+            build('Low', (price * 90n) / 100n, { min: 180, max: 180 }),
+            build('Standard', price, { min: 60, max: 60 }),
+            build('High', (price * 115n) / 100n, { min: 20, max: 20 }),
+        ];
+    }
+    throw new Error('feeData missing from unsignedTx');
+}

package/dist/cjs/utils/parseGasFees.d.ts

@@ -0,0 +1,3 @@
+export declare function toGwei(wei: bigint): string;
+export declare function tryParseGweiToWei(input: string): bigint | null;
+export declare function parseGasLimit(input: string): bigint | null;

package/dist/cjs/utils/parseGasFees.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toGwei = toGwei;
+exports.tryParseGweiToWei = tryParseGweiToWei;
+exports.parseGasLimit = parseGasLimit;
+const __1 = require("..");
+const DECIMAL_PATTERN = /^\d*(\.\d*)?$/;
+const UINT_PATTERN = /^\d+$/;
+function toGwei(wei) {
+    return (0, __1.formattedAmountForDisplay)(wei, 9, {
+        useGroupSeparator: false,
+        decimalsToShow: 9,
+    });
+}
+function tryParseGweiToWei(input) {
+    const valueNormalized = input.trim().replace(/,/g, '.');
+    if (!valueNormalized || valueNormalized === '.')
+        return null;
+    if (!DECIMAL_PATTERN.test(valueNormalized))
+        return null;
+    try {
+        return (0, __1.parsedAmount)(valueNormalized, 9);
+    }
+    catch {
+        return null;
+    }
+}
+function parseGasLimit(input) {
+    const trimmed = input.trim().replace(/\s/g, '');
+    if (!UINT_PATTERN.test(trimmed))
+        return null;
+    const value = BigInt(trimmed);
+    // 21000 is the minimum - protcol-enforced floor for any tx
+    if (value < 21000n)
+        return null;
+    return value;
+}

package/dist/constants/NETWORKS_REGISTRY.d.ts

@@ -8,6 +8,7 @@ export interface NetworkField {
     iconUrl: string;
     symbol: string;
     failoverRpcUrl?: string;
+    blockTime?: number;
 }
 export interface NetworkRegistry {
     category: string;

package/dist/constants/NETWORKS_REGISTRY.js

@@ -12,6 +12,7 @@ export const NETWORKS_REGISTRY = [
                 iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
                 symbol: 'ETH',
                 failoverRpcUrl: 'https://eth.llamarpc.com',
+                blockTime: 12,
             },
             {
                 id: 'bnb-smart-chain',
@@ -19,10 +20,11 @@ export const NETWORKS_REGISTRY = [
                 nameForDisplay: 'BNB Smart Chain',
                 chainId: 56,
                 rpcUrl: 'https://bsc-dataseed.bnbchain.org',
-                explorerUrl: 'https://bscscan.com/',
+                explorerUrl: 'https://bscscan.com',
                 iconUrl: 'https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png',
                 symbol: 'BNB',
                 failoverRpcUrl: 'https://bsc.llamarpc.com',
+                blockTime: 3,
             },
             {
                 id: 'polygon-mainnet',
@@ -34,6 +36,7 @@ export const NETWORKS_REGISTRY = [
                 explorerUrl: 'https://polygonscan.com',
                 symbol: 'POL',
                 failoverRpcUrl: 'https://polygon.llamarpc.com',
+                blockTime: 2,
             },
             {
                 id: 'arbitrum-mainnet',
@@ -45,6 +48,7 @@ export const NETWORKS_REGISTRY = [
                 iconUrl: 'https://assets.coingecko.com/coins/images/16547/large/photo_2023-03-29_21.47.00.jpeg',
                 symbol: 'ARB',
                 failoverRpcUrl: 'https://arb.llamarpc.com',
+                blockTime: 1,
             },
         ],
     },
@@ -61,6 +65,7 @@ export const NETWORKS_REGISTRY = [
                 iconUrl: 'https://assets.coingecko.com/coins/images/279/large/ethereum.png',
                 symbol: 'ETH',
                 failoverRpcUrl: 'https://eth-sepolia.llamarpc.com',
+                blockTime: 12,
             },
         ],
     },

package/dist/index.d.ts

@@ -3,7 +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 { NetworkField, NetworkRegistry, NETWORKS_REGISTRY, } from './constants/NETWORKS_REGISTRY';
+export { NetworkField, NetworkRegistry, NETWORKS_REGISTRY } from './constants/NETWORKS_REGISTRY';
 export { BASIC_TOKENS_BY_CHAIN, BasicTokenData, BasicTokenSymbol, ChainTokenDataMap, } from './constants/BASIC_TOKENS_REGISTRY';
 /** basic blockchain exports */
 export { buildBaseUnsignedTransferTx, buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
@@ -26,5 +26,7 @@ export { NATIVE_TOKENS };
 export { formattedAmountForDisplay, parsedAmount } from './utils/formatAmount';
 export { handleErrorMessages, errorMessagesForBroadcast, errorMessagesForGasLimitEstimation, } from './utils/handleErrorMessages';
 export { normalizeAddress } from './utils/normalizeAddress';
+export { toGwei, tryParseGweiToWei, parseGasLimit } from './utils/parseGasFees';
+export { getFeePresets, calcReserve, estimateSeconds, getBlockTime, BLOCK_TIME_BY_CHAIN, } from './utils/feePresets';
 /** types exports */
-export { BroadcastTransactionOptions, BuildMaxNativeTransferTxOptions, BuildUnsignedTransferTxOptions, EstimateGasLimitFromProviderProps, GasEstimateResult, TxStatusOptions, BuildBaseUnsignedTransferTxParams, TxStatusResponse, EstimateTransactionOptions, EstimateTransactionResult, PrepareTransactionParams, PrepareTransactionResult, FormatAmountOptions, TransactionRequest, GetBalanceParams, GetBalancesParams, GetBalancesChainRequest, GetBalanceResult, ChainBalances, TokenBalance, ChainGroup, } from './types/common';
+export { BroadcastTransactionOptions, BuildMaxNativeTransferTxOptions, BuildUnsignedTransferTxOptions, EstimateGasLimitFromProviderProps, GasEstimateResult, TxStatusOptions, BuildBaseUnsignedTransferTxParams, TxStatusResponse, EstimateTransactionOptions, EstimateTransactionResult, PrepareTransactionParams, PrepareTransactionResult, FormatAmountOptions, TransactionRequest, GetBalanceParams, GetBalancesParams, GetBalancesChainRequest, GetBalanceResult, ChainBalances, TokenBalance, ChainGroup, FeePreset, FeePresetLabel, FeeEstimateSeconds, ResolvedFees, EIP1559Fees, LegacyFees, FeeModel, FeeHistoryData, FeeDataInput, } from './types/common';

package/dist/index.js

@@ -3,7 +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';
+export { NETWORKS_REGISTRY } from './constants/NETWORKS_REGISTRY';
 export { BASIC_TOKENS_BY_CHAIN, } from './constants/BASIC_TOKENS_REGISTRY';
 /** basic blockchain exports */
 export { buildBaseUnsignedTransferTx, buildMaxNativeTransferTx, buildUnsignedTransferTx, } from './blockchain/buildUnsignedTransferTx';
@@ -25,3 +25,5 @@ export { NATIVE_TOKENS };
 export { formattedAmountForDisplay, parsedAmount } from './utils/formatAmount';
 export { handleErrorMessages, errorMessagesForBroadcast, errorMessagesForGasLimitEstimation, } from './utils/handleErrorMessages';
 export { normalizeAddress } from './utils/normalizeAddress';
+export { toGwei, tryParseGweiToWei, parseGasLimit } from './utils/parseGasFees';
+export { getFeePresets, calcReserve, estimateSeconds, getBlockTime, BLOCK_TIME_BY_CHAIN, } from './utils/feePresets';

package/dist/types/common.d.ts

@@ -130,3 +130,46 @@ export interface ChainGroup {
     nativeBalanceRequests: GetBalanceParams[];
     tokenBalanceRequests: GetBalanceParams[];
 }
+export type EIP1559Fees = {
+    mode: 'eip1559';
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    gasLimit: bigint;
+};
+export type LegacyFees = {
+    mode: 'legacy';
+    gasPrice: bigint;
+    gasLimit: bigint;
+};
+export type ResolvedFees = EIP1559Fees | LegacyFees;
+export type FeeModel = 'eip1559' | 'legacy';
+export type FeePresetLabel = 'Low' | 'Standard' | 'High';
+export type FeeEstimateSeconds = {
+    min: number;
+    max: number;
+};
+export type FeePreset = {
+    label: FeePresetLabel;
+    fees: ResolvedFees;
+    humanReadableGasReserve: string;
+    humanReadableEstimatedCost: string;
+    estimatedSeconds?: FeeEstimateSeconds;
+};
+export type FeeHistoryData = {
+    currentBaseFee: string;
+    range12h: {
+        minBaseFee: string;
+        maxBaseFee: string;
+        minPriorityFee: string;
+        maxPriorityFee: string;
+    };
+};
+export type FeeDataInput = {
+    chainId?: number;
+    gasLimit?: bigint | string | number;
+    feeData?: {
+        maxFeePerGas?: bigint | string;
+        maxPriorityFeePerGas?: bigint | string;
+        gasPrice?: bigint | string;
+    };
+};

package/dist/utils/feePresets.d.ts

@@ -0,0 +1,6 @@
+import { FeeDataInput, FeeEstimateSeconds, FeePreset } from '../types/common';
+export declare const BLOCK_TIME_BY_CHAIN: Record<number, number>;
+export declare function getBlockTime(chainId: number): number;
+export declare function calcReserve(gasLimit: bigint, pricePerGas: bigint): string;
+export declare function estimateSeconds(presetPriority: bigint, standardPriority: bigint, blockTime: number): FeeEstimateSeconds;
+export declare function getFeePresets(tx: FeeDataInput): FeePreset[];

package/dist/utils/feePresets.js

@@ -0,0 +1,78 @@
+import { NETWORKS_REGISTRY } from '../constants/NETWORKS_REGISTRY';
+import { formattedAmountForDisplay } from './formatAmount';
+const DEFAULT_BLOCK_TIME = 12;
+const FORMAT_OPTS = { useGroupSeparator: false, decimalsToShow: 18 };
+export const BLOCK_TIME_BY_CHAIN = Object.fromEntries(NETWORKS_REGISTRY.flatMap((r) => r.networks)
+    .filter((n) => n.blockTime != null)
+    .map((n) => [n.chainId, n.blockTime]));
+export function getBlockTime(chainId) {
+    return BLOCK_TIME_BY_CHAIN[chainId] ?? DEFAULT_BLOCK_TIME;
+}
+export function calcReserve(gasLimit, pricePerGas) {
+    return formattedAmountForDisplay(gasLimit * pricePerGas, 18, FORMAT_OPTS);
+}
+export function estimateSeconds(presetPriority, standardPriority, blockTime) {
+    if (standardPriority === 0n) {
+        return { min: blockTime, max: blockTime * 4 };
+    }
+    const ratio = Number((presetPriority * 1000n) / standardPriority) / 1000;
+    if (ratio >= 1.4)
+        return { min: blockTime, max: blockTime * 2 };
+    if (ratio >= 0.9)
+        return { min: blockTime, max: blockTime * 3 };
+    return { min: blockTime, max: blockTime * 4 };
+}
+export function getFeePresets(tx) {
+    const builtTx = tx;
+    const { maxFeePerGas, maxPriorityFeePerGas, gasPrice } = builtTx.feeData ?? {};
+    const gasLimit = builtTx.gasLimit
+        ? BigInt(builtTx.gasLimit)
+        : BigInt(builtTx.unsignedTx?.gasLimit ?? 21000);
+    // EIP-1559
+    if (maxFeePerGas != null && maxPriorityFeePerGas != null) {
+        const priority = BigInt(maxPriorityFeePerGas);
+        const baseFee = BigInt(maxFeePerGas) - BigInt(maxPriorityFeePerGas);
+        const estimatedCostPerGas = (priority) => baseFee + priority;
+        const chainId = builtTx.unsignedTx?.chainId ?? 1;
+        const blockTime = getBlockTime(chainId);
+        const lowPriority = (priority * 75n) / 100n;
+        const highPriority = (priority * 150n) / 100n;
+        const build = (label, priority, seconds) => {
+            const presetMaxFeePerGas = baseFee + priority;
+            return {
+                label,
+                fees: {
+                    mode: 'eip1559',
+                    maxFeePerGas: presetMaxFeePerGas,
+                    maxPriorityFeePerGas: priority,
+                    gasLimit,
+                },
+                humanReadableGasReserve: calcReserve(gasLimit, presetMaxFeePerGas),
+                humanReadableEstimatedCost: calcReserve(gasLimit, estimatedCostPerGas(priority)),
+                estimatedSeconds: seconds,
+            };
+        };
+        return [
+            build('Low', lowPriority, estimateSeconds(lowPriority, priority, blockTime)),
+            build('Standard', priority, estimateSeconds(priority, priority, blockTime)),
+            build('High', highPriority, estimateSeconds(highPriority, priority, blockTime)),
+        ];
+    }
+    // Legacy
+    if (gasPrice != null) {
+        const price = BigInt(gasPrice);
+        const build = (label, price, estimatedSeconds) => ({
+            label,
+            fees: { mode: 'legacy', gasPrice: price, gasLimit },
+            humanReadableGasReserve: calcReserve(gasLimit, price),
+            humanReadableEstimatedCost: calcReserve(gasLimit, price),
+            estimatedSeconds,
+        });
+        return [
+            build('Low', (price * 90n) / 100n, { min: 180, max: 180 }),
+            build('Standard', price, { min: 60, max: 60 }),
+            build('High', (price * 115n) / 100n, { min: 20, max: 20 }),
+        ];
+    }
+    throw new Error('feeData missing from unsignedTx');
+}

package/dist/utils/parseGasFees.d.ts

@@ -0,0 +1,3 @@
+export declare function toGwei(wei: bigint): string;
+export declare function tryParseGweiToWei(input: string): bigint | null;
+export declare function parseGasLimit(input: string): bigint | null;

package/dist/utils/parseGasFees.js

@@ -0,0 +1,32 @@
+import { formattedAmountForDisplay, parsedAmount } from '..';
+const DECIMAL_PATTERN = /^\d*(\.\d*)?$/;
+const UINT_PATTERN = /^\d+$/;
+export function toGwei(wei) {
+    return formattedAmountForDisplay(wei, 9, {
+        useGroupSeparator: false,
+        decimalsToShow: 9,
+    });
+}
+export function tryParseGweiToWei(input) {
+    const valueNormalized = input.trim().replace(/,/g, '.');
+    if (!valueNormalized || valueNormalized === '.')
+        return null;
+    if (!DECIMAL_PATTERN.test(valueNormalized))
+        return null;
+    try {
+        return parsedAmount(valueNormalized, 9);
+    }
+    catch {
+        return null;
+    }
+}
+export function parseGasLimit(input) {
+    const trimmed = input.trim().replace(/\s/g, '');
+    if (!UINT_PATTERN.test(trimmed))
+        return null;
+    const value = BigInt(trimmed);
+    // 21000 is the minimum - protcol-enforced floor for any tx
+    if (value < 21000n)
+        return null;
+    return value;
+}

package/package.json

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