@lidofinance/lsv-cli 1.7.0 → 1.9.0

package/dist/providers/wallet.js

@@ -5,6 +5,78 @@ import { privateKeyToAccount } from 'viem/accounts';
 import { Keystore } from 'ox';
 import { envs, getConfig, getChainId, getElUrl, getChain } from '../configs/index.js';
 import { createWalletConnectClient } from '../utils/index.js';
+const MAX_UINT256_HEX = '0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff';
+// Cached after the first eth_estimateGas call to avoid a double RPC
+// roundtrip on every subsequent estimation when the node lacks support.
+let nodeSupportsStateOverride = null;
+const isStateOverrideError = (err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    return (msg.includes('stateOverride') ||
+        msg.includes('too many arguments') ||
+        msg.includes('invalid argument 2') ||
+        msg.includes('Invalid method parameters') ||
+        msg.includes('eth_estimateGas does not support'));
+};
+/**
+ * Wraps viem's http() transport to inject a `stateOverride` into every
+ * `eth_estimateGas` RPC call, setting the sender's balance to maxUint256.
+ *
+ * Why: viem's `prepareTransactionRequest` fills `maxFeePerGas` BEFORE
+ * calling `eth_estimateGas`. The node then checks
+ * `balance >= blockGasLimit * maxFeePerGas`, which fails for low-balance
+ * accounts even though the actual TX cost is much lower.
+ *
+ * Operating at the transport level guarantees the override is applied
+ * regardless of how viem resolves its internal action chain (the
+ * `client.extend()` approach does not work because viem's bound methods
+ * close over the original base client and `getAction` short-circuits).
+ *
+ * Falls back to the original call if the RPC does not support
+ * `stateOverride` (geth < 1.13), and caches the result so subsequent
+ * calls skip the failed attempt.
+ */
+export const balanceAwareTransport = (url) => {
+    const baseTransport = http(url);
+    return ((params) => {
+        const base = baseTransport(params);
+        return {
+            ...base,
+            async request(args) {
+                if (args.method === 'eth_estimateGas' &&
+                    Array.isArray(args.params) &&
+                    args.params[0]?.from) {
+                    if (nodeSupportsStateOverride === false) {
+                        return base.request(args);
+                    }
+                    const from = args.params[0].from;
+                    const txRequest = args.params[0];
+                    const blockTag = args.params[1] ?? 'latest';
+                    const existingOverride = args.params[2] ?? {};
+                    const stateOverride = {
+                        ...existingOverride,
+                        [from]: { balance: MAX_UINT256_HEX },
+                    };
+                    try {
+                        const result = await base.request({
+                            method: 'eth_estimateGas',
+                            params: [txRequest, blockTag, stateOverride],
+                        });
+                        nodeSupportsStateOverride = true;
+                        return result;
+                    }
+                    catch (err) {
+                        if (isStateOverrideError(err)) {
+                            nodeSupportsStateOverride = false;
+                            return await base.request(args);
+                        }
+                        throw err;
+                    }
+                }
+                return base.request(args);
+            },
+        };
+    });
+};
 const getPrivateKey = async () => {
     const { PRIVATE_KEY, ACCOUNT_FILE, ACCOUNT_FILE_PASSWORD } = getConfig();
     const id = await getChainId();
@@ -59,7 +131,7 @@ export const getPublicClient = async () => {
     }
     const publicClient = createPublicClient({
         chain,
-        transport: http(getElUrl()),
+        transport: balanceAwareTransport(getElUrl()),
     });
     PUBLIC_CLIENT_CACHE[chain.id] = publicClient;
     return publicClient;
@@ -79,7 +151,7 @@ export const getWalletWithAccount = async () => {
     return createWalletClient({
         account,
         chain,
-        transport: http(getElUrl()),
+        transport: balanceAwareTransport(getElUrl()),
     });
 };
 export const getWalletConnectClient = async () => {

package/dist/providers/wallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../providers/wallet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../providers/wallet.ts"],"names":[],"mappings":"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"}

package/dist/tests/integration/gas-estimation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/integration/gas-estimation.test.js

@@ -0,0 +1,76 @@
+import { describe, test, expect, beforeAll } from 'vitest';
+import { createPublicClient, http, parseEther, maxUint256 } from 'viem';
+import { getChain } from '../../configs/index.js';
+import { loadTestConfig } from './helpers/test-config.js';
+import { createAnvilTestClient, mintEth, getAccountFromPrivateKey, } from './helpers/test-client.js';
+import { setupIntegrationTestsBeforeEach } from './helpers/test-setup.js';
+/**
+ * Integration tests for the gas estimation stateOverride fix.
+ *
+ * Proves that stateOverride in eth_estimateGas allows accurate gas estimation
+ * for low-balance accounts on a real Anvil fork.
+ */
+// Anvil's default account #1 (not the one used by the test suite)
+const LOW_BALANCE_KEY = '0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d';
+describe('gas estimation with stateOverride', () => {
+    setupIntegrationTestsBeforeEach();
+    let rpcUrl;
+    let chainObj;
+    beforeAll(async () => {
+        const config = loadTestConfig();
+        rpcUrl = config.EL_URL;
+        chainObj = await getChain();
+    });
+    test('stateOverride: low-balance account succeeds with balance override', async () => {
+        const testClient = createAnvilTestClient(chainObj, rpcUrl);
+        const lowBalanceAccount = getAccountFromPrivateKey(LOW_BALANCE_KEY);
+        await mintEth(testClient, lowBalanceAccount.address, parseEther('0.0001'));
+        const publicClient = createPublicClient({
+            chain: chainObj,
+            transport: http(rpcUrl),
+        });
+        // With stateOverride — estimation succeeds regardless of real balance
+        const gas = await publicClient.estimateGas({
+            account: lowBalanceAccount,
+            to: '0x0000000000000000000000000000000000000001',
+            value: 0n,
+            stateOverride: [
+                {
+                    address: lowBalanceAccount.address,
+                    balance: maxUint256,
+                },
+            ],
+        });
+        expect(gas).toBeGreaterThan(0n);
+        expect(gas).toBeLessThanOrEqual(100000n);
+    });
+    test('contract interaction: estimateGas with stateOverride on ERC-20 approve', async () => {
+        const testClient = createAnvilTestClient(chainObj, rpcUrl);
+        const lowBalanceAccount = getAccountFromPrivateKey(LOW_BALANCE_KEY);
+        await mintEth(testClient, lowBalanceAccount.address, parseEther('0.0001'));
+        const publicClient = createPublicClient({
+            chain: chainObj,
+            transport: http(rpcUrl),
+        });
+        // ERC-20 approve(spender, amount) on WETH
+        const WETH = '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2';
+        const approveData = '0x095ea7b3' +
+            '000000000000000000000000deadbeefdeadbeefdeadbeefdeadbeefdeadbeef' +
+            'ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff';
+        const gas = await publicClient.estimateGas({
+            account: lowBalanceAccount,
+            to: WETH,
+            data: approveData,
+            stateOverride: [
+                {
+                    address: lowBalanceAccount.address,
+                    balance: maxUint256,
+                },
+            ],
+        });
+        // approve() typically costs ~46k gas
+        expect(gas).toBeGreaterThan(20000n);
+        expect(gas).toBeLessThan(200000n);
+    });
+});
+//# sourceMappingURL=gas-estimation.test.js.map

package/dist/tests/integration/gas-estimation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-estimation.test.js","sourceRoot":"","sources":["../../../tests/integration/gas-estimation.test.ts"],"names":[],"mappings":"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"}