@lidofinance/lsv-cli 1.0.0-alpha.62 → 1.0.0-alpha.63

package/dist/programs/defi-wrapper/use-cases/health/read.js

@@ -0,0 +1,338 @@
+import { formatEther, formatUnits } from 'viem';
+import { health } from './main.js';
+import { getStvStethPoolContract } from '../../../../contracts/defi-wrapper/index.js';
+import { getStethContract } from '../../../../contracts/index.js';
+import { stringToAddress, logTable, logInfo, callReadMethodSilent, stringToNumber, formatBP, } from '../../../../utils/index.js';
+import { getPublicClient } from '../../../../providers/index.js';
+import { isThresholdBreached, calculateEffectiveLTV, calculateThresholdExcess, calculateBalancesFromEvents, } from './utils.js';
+const healthRead = health
+    .command('read')
+    .aliases(['r'])
+    .description('health read commands');
+healthRead
+    .command('list-unhealthy')
+    .description('list all unhealthy positions in the pool')
+    .argument('<address>', 'stv-steth-pool address', stringToAddress)
+    .option('--from-block <number>', 'from block number', stringToNumber)
+    .option('--to-block <number>', 'to block number (default: latest)', stringToNumber)
+    .option('--batch-size <number>', 'max blocks per RPC call (default: 30000)', stringToNumber)
+    .option('--verbose', 'show verbose output', false)
+    .action(async (address, options) => {
+    const poolContract = await getStvStethPoolContract(address);
+    const stethContract = await getStethContract();
+    logInfo('Fetching pool configuration...');
+    // Get pool configuration
+    const [forcedRebalanceThresholdBP, name, symbol] = await Promise.all([
+        callReadMethodSilent(poolContract, 'forcedRebalanceThresholdBP'),
+        callReadMethodSilent(poolContract, 'name'),
+        callReadMethodSilent(poolContract, 'symbol'),
+    ]);
+    logInfo(`Pool: ${name} (${symbol}) at ${address}\nForced Rebalance Threshold: ${formatBP(forcedRebalanceThresholdBP)}\n`);
+    // Check health for each account
+    const unhealthyPositions = [];
+    // Calculate balances from indexed events
+    logInfo('📊 Calculating balances from indexed events');
+    const balances = await calculateBalancesFromEvents({
+        poolAddress: address,
+        fromBlock: options.fromBlock,
+        toBlock: options.toBlock,
+        batchSize: options.batchSize,
+    });
+    logInfo(`Found ${balances.size} accounts with positions. Checking health...\n`);
+    for (const [account, balance] of balances) {
+        try {
+            const stvBalance = balance.stvBalance;
+            const debtShares = balance.debtShares;
+            // Still check contract's isHealthy for comparison
+            const isHealthy = await callReadMethodSilent(poolContract, 'isHealthyOf', [account]);
+            if (options.verbose) {
+                logInfo(`Account: ${account}
+            stvBalance: ${formatUnits(stvBalance, 27)} STV
+            debtShares: ${formatEther(debtShares)} shares 
+            isHealthy (from contract): ${isHealthy}
+          `);
+            }
+            // Skip accounts with no position
+            if (stvBalance === 0n && debtShares === 0n) {
+                if (options.verbose) {
+                    logInfo(`  Skipping account ${account} - no position\n`);
+                }
+                continue;
+            }
+            // Calculate values in ETH
+            const stvInEth = stvBalance > 0n
+                ? await callReadMethodSilent(poolContract, 'previewRedeem', [
+                    stvBalance,
+                ])
+                : 0n;
+            const debtInEth = debtShares > 0n
+                ? await callReadMethodSilent(stethContract, 'getPooledEthBySharesRoundUp', [debtShares])
+                : 0n;
+            if (options.verbose) {
+                logInfo(`  stvInEth: ${formatEther(stvInEth)} ETH`);
+                logInfo(`  debtInEth: ${formatEther(debtInEth)} ETH`);
+                logInfo(`  forcedRebalanceThresholdBP: ${formatBP(forcedRebalanceThresholdBP)}`);
+            }
+            // Use contract-accurate threshold check
+            const thresholdBreached = isThresholdBreached({
+                assets: stvInEth,
+                stethShares: debtShares,
+                debtInEth,
+                forcedRebalanceThresholdBP,
+                verbose: options.verbose,
+            });
+            // Calculate display metrics
+            const ltvRatio = calculateEffectiveLTV({
+                assets: stvInEth,
+                debtInEth,
+            });
+            const thresholdExcess = calculateThresholdExcess({
+                assets: stvInEth,
+                stethShares: debtShares,
+                debtInEth,
+                forcedRebalanceThresholdBP,
+                verbose: options.verbose,
+            });
+            if (options.verbose) {
+                logInfo(`  thresholdBreached (our calc): ${thresholdBreached}
+              ltvRatio: ${ltvRatio / 100}%
+              thresholdExcess: ${thresholdExcess / 100}%
+            `);
+            }
+            // Sanity check: contract's isHealthy should be inverse of our thresholdBreached
+            // isHealthy = true means healthy, thresholdBreached = false means healthy
+            if (isHealthy === thresholdBreached) {
+                logInfo(`  ⚠️  MISMATCH: Contract isHealthy=${isHealthy}, our thresholdBreached=${thresholdBreached}`);
+                logInfo(`⚠️  WARNING: Health check mismatch for ${account}! Contract isHealthy=${isHealthy}, but our thresholdBreached=${thresholdBreached}`);
+            }
+            else {
+                if (options.verbose) {
+                    logInfo('  ✅ Health check matches contract');
+                }
+            }
+            if (!isHealthy && stvBalance > 0n) {
+                unhealthyPositions.push({
+                    account,
+                    stvBalance,
+                    stvInEth,
+                    debtShares,
+                    debtInEth,
+                    ltvRatio,
+                    isHealthy,
+                    thresholdExcess,
+                });
+            }
+        }
+        catch (error) {
+            logInfo(`Error checking account ${account}: ${error}`);
+        }
+    }
+    // Sort by threshold excess descending (most critical first)
+    unhealthyPositions.sort((a, b) => b.thresholdExcess - a.thresholdExcess);
+    if (unhealthyPositions.length === 0) {
+        logInfo('✅ No unhealthy positions found!');
+        return;
+    }
+    logInfo('⚠️  Unhealthy Positions Report\n');
+    const tableData = unhealthyPositions.map((p) => [
+        p.account,
+        `${formatUnits(p.stvBalance, 27)} STV`,
+        `${formatEther(p.debtShares)} shares`,
+        `${formatEther(p.debtInEth)} ETH`,
+        `${(p.ltvRatio / 100).toFixed(2)}%`, // Display LTV
+        `+${(p.thresholdExcess / 100).toFixed(2)}%`, // How much over threshold
+        p.thresholdExcess > 1000 // > 10% over threshold
+            ? '🚨 CRITICAL'
+            : '⚠️  UNHEALTHY',
+    ]);
+    logTable({
+        params: {
+            head: [
+                'Account',
+                'STV Balance',
+                'Debt (shares)',
+                'Debt (ETH)',
+                'LTV Ratio',
+                'Over Threshold',
+                'Status',
+            ],
+        },
+        data: tableData,
+    });
+    logInfo(`\nTotal Unhealthy Accounts: ${unhealthyPositions.length}`);
+    logInfo(`Threshold: ${(Number(forcedRebalanceThresholdBP) / 100).toFixed(2)}%`);
+});
+healthRead
+    .command('calculate-rebalance-need')
+    .description('calculate total ETH needed to rebalance all unhealthy positions')
+    .argument('<address>', 'stv-steth-pool address', stringToAddress)
+    .option('--from-block <number>', 'from block number', stringToNumber)
+    .option('--batch-size <number>', 'max blocks per RPC call (default: 30000)', stringToNumber)
+    .option('--verbose', 'show verbose output', false)
+    .action(async (address, options) => {
+    const poolContract = await getStvStethPoolContract(address);
+    const stethContract = await getStethContract();
+    logInfo('Calculating rebalance requirements...\n');
+    // Get pool info
+    const [name, symbol, totalExceedingMintedSteth, vaultAddress] = await Promise.all([
+        callReadMethodSilent(poolContract, 'name'),
+        callReadMethodSilent(poolContract, 'symbol'),
+        callReadMethodSilent(poolContract, 'totalExceedingMintedSteth'),
+        callReadMethodSilent(poolContract, 'VAULT'),
+    ]);
+    logInfo(`Pool: ${name} (${symbol}) at ${address}\n`);
+    // Calculate balances from indexed events
+    const balances = await calculateBalancesFromEvents({
+        poolAddress: address,
+        fromBlock: options.fromBlock,
+        batchSize: options.batchSize,
+    });
+    const rebalanceRequirements = [];
+    let totalStethRequired = 0n;
+    for (const [account, balance] of balances) {
+        try {
+            // Skip accounts with no position
+            if (balance.stvBalance === 0n && balance.debtShares === 0n) {
+                continue;
+            }
+            const isHealthy = await callReadMethodSilent(poolContract, 'isHealthyOf', [account]);
+            if (!isHealthy) {
+                // Call previewForceRebalance
+                const [stethShares, stvToBurn, isUndercollateralized] = await callReadMethodSilent(poolContract, 'previewForceRebalance', [account]);
+                if (stvToBurn > 0n) {
+                    // Convert stETH shares to ETH
+                    const stethInEth = await callReadMethodSilent(stethContract, 'getPooledEthBySharesRoundUp', [stethShares]);
+                    rebalanceRequirements.push({
+                        account,
+                        stvToBurn,
+                        stethShares,
+                        stethInEth,
+                        isUndercollateralized,
+                    });
+                    totalStethRequired += stethInEth;
+                }
+            }
+        }
+        catch (error) {
+            logInfo(`Error processing account ${account}: ${error}`);
+        }
+    }
+    // Get vault balance
+    const publicClient = await getPublicClient();
+    const vaultEthBalance = await publicClient.getBalance({
+        address: vaultAddress,
+    });
+    // Calculate adjusted requirement after exceeding stETH
+    // "Exceeding minted stETH" is already available in the pool and can be used
+    // for rebalancing WITHOUT providing additional ETH.
+    // So we subtract it from total required to get the REAL ETH need.
+    const adjustedRequirement = totalStethRequired > totalExceedingMintedSteth
+        ? totalStethRequired - totalExceedingMintedSteth
+        : 0n;
+    // Calculate ETH shortfall: how much MORE ETH is needed beyond vault balance
+    const ethShortfall = adjustedRequirement > vaultEthBalance
+        ? adjustedRequirement - vaultEthBalance
+        : 0n;
+    // Output summary
+    logInfo('═'.repeat(70));
+    logInfo('REBALANCE REQUIREMENTS REPORT');
+    logInfo('═'.repeat(70) + '\n');
+    logTable({
+        data: [
+            ['Pool', address],
+            ['Pool Name', `${name} (${symbol})`],
+            ['', ''],
+            ['📊 Unhealthy Accounts', rebalanceRequirements.length.toString()],
+            ['', ''],
+            ['═══ REBALANCE NEEDS ═══', ''],
+            [
+                '1️⃣  Total stETH Required (raw)',
+                `${formatEther(totalStethRequired)} ETH`,
+            ],
+            [
+                '2️⃣  Exceeding Minted stETH (available)',
+                totalExceedingMintedSteth > 0n
+                    ? `${formatEther(totalExceedingMintedSteth)} ETH ✅`
+                    : `${formatEther(totalExceedingMintedSteth)} ETH`,
+            ],
+            [
+                '3️⃣  After Exceeding Adjustment',
+                adjustedRequirement > 0n
+                    ? `${formatEther(adjustedRequirement)} ETH (real need)`
+                    : `${formatEther(adjustedRequirement)} ETH ✅ (covered by exceeding)`,
+            ],
+            ['', ''],
+            ['═══ VAULT RESOURCES ═══', ''],
+            ['💰 Vault ETH Balance', `${formatEther(vaultEthBalance)} ETH`],
+            [
+                '🎯 ETH Shortfall',
+                ethShortfall > 0n
+                    ? `⚠️  ${formatEther(ethShortfall)} ETH (NEED MORE)`
+                    : `✅ ${formatEther(ethShortfall)} ETH (SUFFICIENT)`,
+            ],
+        ],
+    });
+    if (options.verbose && rebalanceRequirements.length > 0) {
+        logInfo('\n' + '─'.repeat(70));
+        logInfo('DETAILED BREAKDOWN BY ACCOUNT');
+        logInfo('─'.repeat(70) + '\n');
+        const detailedData = rebalanceRequirements.map((r) => [
+            r.account,
+            formatUnits(r.stvToBurn, 27),
+            formatEther(r.stethShares),
+            formatEther(r.stethInEth),
+            r.isUndercollateralized ? '⚠️  Yes' : 'No',
+        ]);
+        logTable({
+            params: {
+                head: [
+                    'Account',
+                    'STV to Burn',
+                    'stETH Shares',
+                    'stETH (ETH)',
+                    'Undercollateralized',
+                ],
+            },
+            data: detailedData,
+        });
+    }
+    // Action items
+    logInfo('\n' + '═'.repeat(70));
+    logInfo('ACTION ITEMS');
+    logInfo('═'.repeat(70) + '\n');
+    if (rebalanceRequirements.length === 0) {
+        logInfo('✅ No rebalance needed - all positions are healthy!\n');
+    }
+    else {
+        // Explain the rebalance strategy
+        if (totalExceedingMintedSteth > 0n) {
+            logInfo(`1. 🔄 Can rebalance using exceeding stETH: ${formatEther(totalExceedingMintedSteth)} ETH`);
+            logInfo(`   This stETH is already in the pool and doesn't require external ETH`);
+        }
+        else {
+            logInfo(`1. 🔄 No exceeding stETH available - will need to provide ETH externally`);
+        }
+        if (ethShortfall > 0n) {
+            logInfo(`\n2. ⚠️  Need to provide ${formatEther(ethShortfall)} ETH from external source`);
+            logInfo(`   Command: yarn start dw stv-steth w rebalance-unassigned-liability-with-ether \\`);
+            logInfo(`            ${address} ${formatEther(ethShortfall)}`);
+        }
+        else if (adjustedRequirement > 0n) {
+            logInfo(`\n2. ✅ Vault has sufficient ETH balance (${formatEther(vaultEthBalance)} ETH available)`);
+        }
+        else {
+            logInfo('\n2. ✅ Exceeding stETH fully covers all rebalance needs - no ETH required!');
+        }
+        logInfo(`\n3. 🎯 Execute rebalances for each account:`);
+        logInfo(`   Command: yarn start dw uc h force-rebalance ${address} <account-address>`);
+        const undercollateralizedCount = rebalanceRequirements.filter((r) => r.isUndercollateralized).length;
+        if (undercollateralizedCount > 0) {
+            logInfo(`\n⚠️  CRITICAL: ${undercollateralizedCount} of ${rebalanceRequirements.length} accounts are UNDERCOLLATERALIZED!`);
+            logInfo('   These positions have debt > collateral and will cause LOSSES.');
+            logInfo('   Requires: LOSS_SOCIALIZER_ROLE to execute');
+            logInfo(`   Command: yarn start dw uc h force-rebalance-and-socialize-loss ${address} <account-address>`);
+        }
+        logInfo('');
+    }
+});
+//# sourceMappingURL=read.js.map

package/dist/programs/defi-wrapper/use-cases/health/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../../programs/defi-wrapper/use-cases/health/read.ts"],"names":[],"mappings":"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"}

package/dist/programs/defi-wrapper/use-cases/health/utils.d.ts

@@ -0,0 +1,56 @@
+import { Address } from 'viem';
+/**
+ * Replicates the contract's _isThresholdBreached logic
+ * @param assets - STV assets value in ETH (from previewRedeem)
+ * @param stethShares - debt in stETH shares
+ * @param debtInEth - debt in ETH (from getPooledEthBySharesRoundUp)
+ * @param forcedRebalanceThresholdBP - threshold in basis points
+ * @returns true if threshold is breached (position is unhealthy)
+ */
+export declare const isThresholdBreached: ({ assets, stethShares, debtInEth, forcedRebalanceThresholdBP, verbose, }: {
+    assets: bigint;
+    stethShares: bigint;
+    debtInEth: bigint;
+    forcedRebalanceThresholdBP: bigint;
+    verbose?: boolean;
+}) => boolean;
+/**
+ * Calculate the "effective LTV ratio" for display purposes
+ * This shows how close the position is to the threshold
+ * Returns basis points (10000 = 100%)
+ */
+export declare const calculateEffectiveLTV: ({ assets, debtInEth, }: {
+    assets: bigint;
+    debtInEth: bigint;
+}) => number;
+/**
+ * Calculate how much the position exceeds the threshold
+ * Returns basis points of how much over threshold (negative if healthy)
+ */
+export declare const calculateThresholdExcess: ({ assets, stethShares, debtInEth, forcedRebalanceThresholdBP, verbose, }: {
+    assets: bigint;
+    stethShares: bigint;
+    debtInEth: bigint;
+    forcedRebalanceThresholdBP: bigint;
+    verbose?: boolean;
+}) => number;
+export declare const indexAccountsFromEvents: ({ poolAddress, fromBlock, toBlock, batchSize, }: {
+    poolAddress: Address;
+    fromBlock?: number;
+    toBlock?: number;
+    batchSize?: number;
+}) => Promise<Set<Address>>;
+/**
+ * Calculate account balances from indexed events
+ */
+export declare const calculateBalancesFromEvents: ({ poolAddress, fromBlock, toBlock, batchSize, }: {
+    poolAddress: Address;
+    fromBlock?: number;
+    toBlock?: number;
+    batchSize?: number;
+}) => Promise<Map<Address, {
+    stvBalance: bigint;
+    debtShares: bigint;
+}>>;
+export declare const grantLossSocializerRole: (address: Address, currentAccount: Address) => Promise<void>;
+export declare const setMaxLossSocializationBP: (address: Address) => Promise<void>;