@lidofinance/lsv-cli 1.1.0 → 1.3.0

package/dist/providers/wallet.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'fs';
 import { program } from '../command/index.js';
-import { createPublicClient, createWalletClient, http, } from 'viem';
+import { createPublicClient, createWalletClient, http, createTestClient, walletActions, publicActions, } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { Keystore } from 'ox';
 import { envs, getConfig, getChainId, getElUrl, getChain } from '../configs/index.js';
@@ -51,17 +51,27 @@ export const getAccount = async () => {
     }
     return privateKeyToAccount(privateKey);
 };
-export const getPublicClient = () => {
+export const getPublicClient = async () => {
     return createPublicClient({
-        chain: getChain(),
+        chain: await getChain(),
         transport: http(getElUrl()),
     });
 };
+export const getTestClient = async () => {
+    return createTestClient({
+        chain: await getChain(),
+        mode: 'anvil',
+        transport: http(getElUrl()),
+    })
+        .extend(publicActions)
+        .extend(walletActions);
+};
 export const getWalletWithAccount = async () => {
     const account = await getAccount();
+    const chain = await getChain();
     return createWalletClient({
         account,
-        chain: getChain(),
+        chain,
         transport: http(getElUrl()),
     });
 };

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/deposits.test.d.ts

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

package/dist/tests/integration/deposits.test.js

@@ -0,0 +1,67 @@
+import { describe, test, expect, beforeAll } from 'vitest';
+import { checkValidatorInfo, checkPdgIsPaused } from '../../features/index.js';
+import { getPredepositGuaranteeContract } from '../../contracts/pdg.js';
+import { loadTestConfig } from './helpers/test-config.js';
+import { setupIntegrationTestsBeforeEach } from './helpers/test-setup.js';
+describe('Deposits Integration Tests', () => {
+    setupIntegrationTestsBeforeEach();
+    let pdgContract;
+    beforeAll(async () => {
+        loadTestConfig();
+        pdgContract = await getPredepositGuaranteeContract();
+    });
+    test('should check PDG is paused status', async () => {
+        const isPaused = await checkPdgIsPaused(pdgContract);
+        expect(typeof isPaused).toBe('boolean');
+        // PDG can be paused or not, both are valid states
+    });
+    test('should validate validator info with valid data', async () => {
+        const validValidator = {
+            pubkey: ('0x' + '0'.repeat(96)),
+            effectiveBalance: 32000000000, // 32 ETH in gwei
+            activationEpoch: 0,
+            slashed: false,
+        };
+        const result = await checkValidatorInfo(validValidator);
+        expect(result).toBeDefined();
+        expect(result).toHaveProperty('isValid');
+        expect(result).toHaveProperty('skip');
+        expect(typeof result.isValid).toBe('boolean');
+        expect(typeof result.skip).toBe('boolean');
+    });
+    test('should handle validator with low effective balance', async () => {
+        const invalidValidator = {
+            pubkey: ('0x' + '0'.repeat(96)),
+            effectiveBalance: 1000000000, // Less than 32 ETH
+            activationEpoch: 0,
+            slashed: false,
+        };
+        const { isValid, skip } = await checkValidatorInfo(invalidValidator);
+        // Either result is defined or error is thrown
+        expect(isValid).toBe(false);
+        expect(skip).toBe(true);
+    });
+    test('should handle validator that is not activated', async () => {
+        const notActivatedValidator = {
+            pubkey: ('0x' + '0'.repeat(96)),
+            effectiveBalance: 32000000000,
+            activationEpoch: Infinity, // Not activated
+            slashed: false,
+        };
+        const { isValid, skip } = await checkValidatorInfo(notActivatedValidator);
+        expect(isValid).toBe(false);
+        expect(skip).toBe(true);
+    });
+    test('should handle slashed validator', async () => {
+        const slashedValidator = {
+            pubkey: ('0x' + '0'.repeat(96)),
+            effectiveBalance: 32000000000,
+            activationEpoch: 0,
+            slashed: true,
+        };
+        const { isValid, skip } = await checkValidatorInfo(slashedValidator);
+        expect(isValid).toBe(false);
+        expect(skip).toBe(true);
+    });
+});
+//# sourceMappingURL=deposits.test.js.map

package/dist/tests/integration/deposits.test.js.map

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

package/dist/tests/integration/globalSetup.d.ts

@@ -0,0 +1 @@
+export default function globalSetup(): Promise<() => Promise<void>>;

package/dist/tests/integration/globalSetup.js

@@ -0,0 +1,55 @@
+import { createAnvil } from '@viem/anvil';
+import * as dotenv from 'dotenv';
+import path from 'path';
+// Load environment variables from .env.test or .env
+dotenv.config({ path: path.resolve(process.cwd(), '.env.test') });
+dotenv.config(); // Fallback to .env if .env.test doesn't exist
+// Global anvil instance
+let anvilInstance = null;
+export default async function globalSetup() {
+    const ANVIL_PORT = Number(process.env.ANVIL_PORT || '8545');
+    const FORK_URL = process.env.EL_URL;
+    const FORK_BLOCK_NUMBER = process.env.FORK_BLOCK_NUMBER
+        ? Number(process.env.FORK_BLOCK_NUMBER)
+        : undefined;
+    const CHAIN_ID = Number(process.env.CHAIN_ID || '1');
+    if (!FORK_URL) {
+        throw new Error('EL_URL environment variable is required for integration tests');
+    }
+    console.info('Starting Anvil fork...');
+    console.info(`Fork URL: ${FORK_URL}`);
+    console.info(`Fork Block Number: ${FORK_BLOCK_NUMBER || 'latest'}`);
+    console.info(`Chain ID: ${CHAIN_ID}`);
+    console.info(`Port: ${ANVIL_PORT}`);
+    // Create Anvil instance
+    const anvil = createAnvil({
+        port: ANVIL_PORT,
+        forkUrl: FORK_URL,
+        forkBlockNumber: FORK_BLOCK_NUMBER,
+        chainId: CHAIN_ID,
+    });
+    // Start Anvil
+    await anvil.start();
+    // Update EL_URL to point to local anvil
+    const anvilRpcUrl = `http://127.0.0.1:${ANVIL_PORT}`;
+    process.env.EL_URL = anvilRpcUrl;
+    console.info(`Anvil started successfully`);
+    console.info(`Anvil RPC URL: ${anvilRpcUrl}`);
+    // Store instance for teardown
+    anvilInstance = anvil;
+    // Return a teardown function for Vitest
+    return async () => {
+        try {
+            if (anvilInstance) {
+                console.info('Stopping Anvil...');
+                await anvilInstance.stop();
+                console.info('Anvil stopped');
+                anvilInstance = null;
+            }
+        }
+        catch (error) {
+            console.error(`Error during teardown: ${error.message}`);
+        }
+    };
+}
+//# sourceMappingURL=globalSetup.js.map

package/dist/tests/integration/globalSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalSetup.js","sourceRoot":"","sources":["../../../tests/integration/globalSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,oDAAoD;AACpD,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,8CAA8C;AAE/D,wBAAwB;AACxB,IAAI,aAAa,GAAmD,IAAI,CAAC;AAEzE,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,WAAW;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;IACpC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACrD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACvC,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAErD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,sBAAsB,iBAAiB,IAAI,QAAQ,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAEpC,wBAAwB;IACxB,MAAM,KAAK,GAAG,WAAW,CAAC;QACxB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,QAAQ;QACjB,eAAe,EAAE,iBAAiB;QAClC,OAAO,EAAE,QAAQ;KAClB,CAAC,CAAC;IAEH,cAAc;IACd,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IAEpB,wCAAwC;IACxC,MAAM,WAAW,GAAG,oBAAoB,UAAU,EAAE,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;IAEjC,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,kBAAkB,WAAW,EAAE,CAAC,CAAC;IAE9C,8BAA8B;IAC9B,aAAa,GAAG,KAAK,CAAC;IAEtB,wCAAwC;IACxC,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC;YACH,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBAClC,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC9B,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tests/integration/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './test-client.js';
+export * from './test-config.js';
+export * from './test-assertions.js';

package/dist/tests/integration/helpers/index.js

@@ -0,0 +1,4 @@
+export * from './test-client.js';
+export * from './test-config.js';
+export * from './test-assertions.js';
+//# sourceMappingURL=index.js.map

package/dist/tests/integration/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../tests/integration/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/tests/integration/helpers/test-assertions.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Helper functions to capture and validate data from features functions
+ * These functions use spies to intercept logResult/logTable calls
+ */
+/**
+ * Captures data passed to logResult during function execution
+ */
+export declare const captureLogResult: <T>(fn: () => Promise<void>) => Promise<T | null>;
+/**
+ * Captures data passed to logTable during function execution
+ */
+export declare const captureLogTable: <T>(fn: () => Promise<void>) => Promise<T | null>;
+/**
+ * Validates that an address is valid (20 bytes / 40 hex chars)
+ */
+export declare const isValidAddress: (address: string) => boolean;
+/**
+ * Validates that a bytes32 hash is valid (32 bytes / 64 hex chars)
+ * Used for role hashes, keccak256 values, etc.
+ */
+export declare const isValidBytes32: (hash: string) => boolean;
+/**
+ * Validates that a bigint value is non-negative
+ */
+export declare const isNonNegativeBigInt: (value: bigint) => boolean;
+/**
+ * Validates that actual data matches expected data with informative error messages
+ * Performs two-way validation:
+ * 1. All expected keys exist in actual data with correct values
+ * 2. All actual keys exist in expected data with correct values
+ */
+export declare const validateExpectedData: <T extends Record<string, any>>(actualData: T, expectedData: T, expect: any) => void;

package/dist/tests/integration/helpers/test-assertions.js

@@ -0,0 +1,92 @@
+/**
+ * Helper functions to capture and validate data from features functions
+ * These functions use spies to intercept logResult/logTable calls
+ */
+import { vi } from 'vitest';
+/**
+ * Captures data passed to logResult or logTable during function execution
+ */
+const captureLogData = async (fn, logFunctionName) => {
+    let capturedData = null;
+    // Spy on logResult or logTable
+    const utilsModule = await import('../../../utils/index.js');
+    const logSpy = vi
+        .spyOn(utilsModule, logFunctionName)
+        .mockImplementation((data) => {
+        if (data && data.data) {
+            // Convert array of [key, value] pairs back to object
+            const obj = {};
+            for (const [key, value] of data.data) {
+                obj[key] = value;
+            }
+            capturedData = obj;
+        }
+    });
+    try {
+        await fn();
+    }
+    finally {
+        logSpy.mockRestore();
+    }
+    return capturedData;
+};
+/**
+ * Captures data passed to logResult during function execution
+ */
+export const captureLogResult = async (fn) => {
+    return captureLogData(fn, 'logResult');
+};
+/**
+ * Captures data passed to logTable during function execution
+ */
+export const captureLogTable = async (fn) => {
+    return captureLogData(fn, 'logTable');
+};
+/**
+ * Validates that an address is valid (20 bytes / 40 hex chars)
+ */
+export const isValidAddress = (address) => {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+};
+/**
+ * Validates that a bytes32 hash is valid (32 bytes / 64 hex chars)
+ * Used for role hashes, keccak256 values, etc.
+ */
+export const isValidBytes32 = (hash) => {
+    return /^0x[a-fA-F0-9]{64}$/.test(hash);
+};
+/**
+ * Validates that a bigint value is non-negative
+ */
+export const isNonNegativeBigInt = (value) => {
+    return value >= 0n;
+};
+/**
+ * Validates that actual data matches expected data with informative error messages
+ * Performs two-way validation:
+ * 1. All expected keys exist in actual data with correct values
+ * 2. All actual keys exist in expected data with correct values
+ */
+export const validateExpectedData = (actualData, expectedData, expect) => {
+    // Check all data from expectedData
+    for (const key in expectedData) {
+        const actualValue = actualData[key];
+        const expectedValue = expectedData[key];
+        expect(actualValue).toBeDefined();
+        if (actualValue !== expectedValue) {
+            throw new Error(`Key "${key}" value mismatch:\n  Got: ${actualValue}\n  Expected: ${expectedValue}`);
+        }
+        expect(actualValue).toBe(expectedValue);
+    }
+    // Check all data from actualData in expectedData
+    for (const key in actualData) {
+        const actualValue = actualData[key];
+        const expectedValue = expectedData[key];
+        expect(actualValue).toBeDefined();
+        if (actualValue !== expectedValue) {
+            throw new Error(`Key "${key}" value mismatch:\n  Got: ${actualValue}\n  Expected: ${expectedValue}`);
+        }
+        expect(actualValue).toBe(expectedValue);
+    }
+};
+//# sourceMappingURL=test-assertions.js.map

package/dist/tests/integration/helpers/test-assertions.js.map

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