@lidofinance/lsv-cli 1.0.0-alpha.5 → 1.0.0-alpha.51

package/dist/utils/arguments.js

@@ -0,0 +1,70 @@
+import { program } from 'commander';
+import { isAddress, parseEther } from 'viem';
+import { toHex } from './proof/merkle-utils.js';
+const toCamelCase = (str) => str.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+export const stringToBigIntArray = (value) => {
+    return value.split(',').map(BigInt);
+};
+export const stringToBigIntArrayWei = (value) => {
+    return value.split(',').map(etherToWei);
+};
+export const stringToHexArray = (value) => {
+    return value.split(',').map(toHex);
+};
+export const jsonToPermit = (value) => {
+    return JSON.parse(value);
+};
+export const jsonToRoleAssignment = (value) => {
+    return JSON.parse(value);
+};
+export const stringToBigInt = (value) => {
+    return BigInt(value);
+};
+export const etherToWei = (value) => {
+    return parseEther(value, 'wei');
+};
+export const stringToNumber = (value) => {
+    if (isNaN(Number(value)) || Number(value) < 0) {
+        program.error('value must be a positive number', { exitCode: 1 });
+    }
+    return parseInt(value);
+};
+export const parseTiers = (value) => {
+    return JSON.parse(value);
+};
+export const parseTier = (value) => {
+    return JSON.parse(value);
+};
+export const parseDepositArray = (str) => {
+    const trimmed = str.trim();
+    if (!trimmed) {
+        return [];
+    }
+    const parsed = JSON.parse(trimmed, (key, value) => {
+        if (key === '')
+            return value; // root array
+        if (key === 'amount')
+            return BigInt(value) * BigInt(10 ** 9); // to wei
+        if (typeof value === 'string') {
+            return toHex(value);
+        }
+        return value;
+    });
+    // Convert keys to camelCase
+    const camelCased = parsed.map((obj) => {
+        const newObj = {};
+        for (const key in obj) {
+            const camelKey = toCamelCase(key);
+            newObj[camelKey] = obj[key];
+        }
+        return newObj;
+    });
+    return camelCased;
+};
+export const stringToAddress = (value) => {
+    if (!isAddress(value)) {
+        program.error('Address value must be a valid address', { exitCode: 1 });
+    }
+    return value;
+};
+//# sourceMappingURL=arguments.js.map

package/dist/utils/arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.js","sourceRoot":"","sources":["../../utils/arguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAW,SAAS,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEtD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CAC1C,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAE,EAAE;IACnD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAE,EAAE;IACtD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,EAAE;IAChD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAW,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAE,EAAE;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAqB,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE;IAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE;IAC1C,OAAO,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE;IAC9C,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAW,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAS,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAa,EAAE;IAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAChD,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC,CAAC,aAAa;QAC3C,IAAI,GAAG,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,MAAM,UAAU,GAAc,MAAM,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE;QACpD,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAAW,EAAE;IACxD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/utils/bls.d.ts

@@ -0,0 +1,21 @@
+import { type Hex } from 'viem';
+type DepositStruct = {
+    pubkey: Hex;
+    signature: Hex;
+    amount: bigint;
+    depositDataRoot: Hex;
+};
+export declare const computeDepositDomainByForkVersion: (forkVersion: string) => Uint8Array<ArrayBufferLike>;
+export declare const computeDepositDomain: () => Uint8Array<ArrayBufferLike>;
+export declare const isValidBLSDeposit: (deposit: DepositStruct, withdrawalCredentials: Hex) => boolean;
+export declare const expandBLSSignature: (signature: Hex, pubkey: Hex) => {
+    pubkey: `0x${string}`;
+    pubkeyY_a: `0x${string}`;
+    pubkeyY_b: `0x${string}`;
+    signature: `0x${string}`;
+    sigY_c0_a: `0x${string}`;
+    sigY_c0_b: `0x${string}`;
+    sigY_c1_a: `0x${string}`;
+    sigY_c1_b: `0x${string}`;
+};
+export {};

package/dist/utils/bls.js

@@ -0,0 +1,101 @@
+import { pad, bytesToHex } from 'viem';
+import { mainnet, sepolia, hoodi } from 'viem/chains';
+import { fromHexString, ByteVectorType, ContainerType, UintNumberType, } from '@chainsafe/ssz';
+import { PublicKey, Signature, verify } from '@chainsafe/blst';
+import { toHex } from './proof/merkle-utils.js';
+import { getChain } from '../configs/index.js';
+const FORK_VERSION_BY_CHAIN = {
+    [sepolia.id]: '0x90000069', // https://github.com/eth-clients/sepolia
+    [hoodi.id]: '0x10000910', // https://github.com/eth-clients/hoodi
+    [mainnet.id]: '0x00000000', // https://github.com/eth-clients/mainnet
+};
+export const computeDepositDomainByForkVersion = (forkVersion) => {
+    const ZERO_HASH = Buffer.alloc(32, 0);
+    const DOMAIN_DEPOSIT = Uint8Array.from([3, 0, 0, 0]);
+    const forkVersionUint8Array = fromHexString(forkVersion);
+    const Root = new ByteVectorType(32);
+    const Bytes4 = new ByteVectorType(4);
+    const Version = Bytes4;
+    const ForkData = new ContainerType({
+        currentVersion: Version,
+        genesisValidatorsRoot: Root,
+    }, { typeName: 'ForkData', jsonCase: 'eth2' });
+    const computeDomain = (domainType, forkVersion, genesisValidatorRoot) => {
+        const forkDataRoot = computeForkDataRoot(forkVersion, genesisValidatorRoot);
+        const domain = new Uint8Array(32);
+        domain.set(domainType, 0);
+        domain.set(forkDataRoot.slice(0, 28), 4);
+        return domain;
+    };
+    const computeForkDataRoot = (currentVersion, genesisValidatorsRoot) => {
+        return ForkData.hashTreeRoot({ currentVersion, genesisValidatorsRoot });
+    };
+    return computeDomain(DOMAIN_DEPOSIT, forkVersionUint8Array, ZERO_HASH);
+};
+export const computeDepositDomain = () => {
+    const forkByChain = FORK_VERSION_BY_CHAIN[getChain().id];
+    if (!forkByChain) {
+        throw new Error(`Fork version not found for chain ${getChain().id}`);
+    }
+    return computeDepositDomainByForkVersion(forkByChain);
+};
+const computeDepositMessageRoot = (pubkey, withdrawalCredentials, amount) => {
+    const Bytes48 = new ByteVectorType(48);
+    const Bytes32 = new ByteVectorType(32);
+    const UintNum64 = new UintNumberType(8);
+    const Root = new ByteVectorType(32);
+    const Domain = Bytes32;
+    const BLSPubkey = Bytes48;
+    const DepositMessage = new ContainerType({ pubkey: BLSPubkey, withdrawalCredentials: Bytes32, amount: UintNum64 }, { typeName: 'DepositMessage', jsonCase: 'eth2' });
+    const SigningData = new ContainerType({
+        objectRoot: Root,
+        domain: Domain,
+    }, { typeName: 'SigningData', jsonCase: 'eth2' });
+    const depositMessage = {
+        pubkey: BLSPubkey.fromJson(toHex(pubkey)),
+        withdrawalCredentials: Bytes32.fromJson(toHex(withdrawalCredentials)),
+        amount: UintNum64.fromJson(amount / 1000000000n),
+    };
+    const domain = computeDepositDomain();
+    return SigningData.hashTreeRoot({
+        objectRoot: DepositMessage.hashTreeRoot(depositMessage),
+        domain,
+    });
+};
+export const isValidBLSDeposit = (deposit, withdrawalCredentials) => {
+    const signningRoot = computeDepositMessageRoot(deposit.pubkey, withdrawalCredentials, deposit.amount);
+    const isBLSValid = verify(signningRoot, PublicKey.fromHex(deposit.pubkey), Signature.fromHex(deposit.signature), true, true);
+    return isBLSValid;
+};
+export const expandBLSSignature = (signature, pubkey) => {
+    const pubkeyY = PublicKey.fromHex(pubkey).toBytes(false).slice(48);
+    // pad Y.a to 32 bytes to match Fp struct
+    const pubkeyY_a = bytesToHex(pad(pubkeyY.slice(0, 16), { dir: 'left', size: 32 }));
+    const pubkeyY_b = bytesToHex(pad(pubkeyY.slice(16), { dir: 'left', size: 32 }));
+    const signatureY = Signature.fromHex(signature).toBytes(false).slice(96);
+    // first Fp of Y coordinate is last 48 bytes of signature
+    const sigY_c0 = signatureY.slice(48);
+    const sigY_c0_a = bytesToHex(pad(sigY_c0.slice(0, 16), {
+        dir: 'left',
+        size: 32,
+    }));
+    const sigY_c0_b = bytesToHex(pad(sigY_c0.slice(16), { dir: 'left', size: 32 }));
+    // second Fp is 48 bytes before first one
+    const sigY_c1 = signatureY.slice(0, 48);
+    const sigY_c1_a = bytesToHex(pad(sigY_c1.slice(0, 16), {
+        dir: 'left',
+        size: 32,
+    }));
+    const sigY_c1_b = bytesToHex(pad(sigY_c1.slice(16), { dir: 'left', size: 32 }));
+    return {
+        pubkey,
+        pubkeyY_a,
+        pubkeyY_b,
+        signature,
+        sigY_c0_a,
+        sigY_c0_b,
+        sigY_c1_a,
+        sigY_c1_b,
+    };
+};
+//# sourceMappingURL=bls.js.map

package/dist/utils/bls.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,18 @@
+export declare const cache: {
+    getShareRate(blockNumber: number): Promise<bigint | null>;
+    setShareRate(blockNumber: number, value: bigint): Promise<void>;
+    getRebaseReward(vaultAddress: string, cacheKey: string): Promise<bigint | null>;
+    setRebaseReward(vaultAddress: string, cacheKey: string, value: bigint): Promise<void>;
+    getNodeOperatorFeeBP(vaultAddress: string, blockNumber: number): Promise<bigint | null>;
+    setNodeOperatorFeeBP(vaultAddress: string, blockNumber: number, value: bigint): Promise<void>;
+};
+export declare const getShareRateFromCache: (blockNumber: number) => Promise<bigint>;
+type GetRebaseRewardFromCacheArgs = {
+    vaultAddress: string;
+    blockNumberPrev: number;
+    blockNumberCurr: number;
+    liabilitySharesPrev: bigint;
+    liabilitySharesCurr: bigint;
+};
+export declare const getRebaseRewardFromCache: (args: GetRebaseRewardFromCacheArgs) => Promise<bigint>;
+export {};

package/dist/utils/cache.js

@@ -0,0 +1,109 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { calculateShareRate, calculateRebaseReward } from './index.js';
+const getShareRateCacheFile = () => path.resolve('ipfs-cache', `share-rate-cache-global.json`);
+const getRebaseRewardCacheFile = (vaultAddress) => path.resolve('ipfs-cache', `rebase-rewards-cache-${vaultAddress}.json`);
+const getNodeOperatorFeeBPCacheFile = (vaultAddress) => path.resolve('ipfs-cache', `node-operator-fee-bp-cache-${vaultAddress}.json`);
+export const cache = {
+    async getShareRate(blockNumber) {
+        try {
+            const data = JSON.parse(await fs.readFile(getShareRateCacheFile(), 'utf-8'));
+            if (data[blockNumber] !== undefined)
+                return BigInt(data[blockNumber]);
+        }
+        catch {
+            /* ignore */
+        }
+        return null;
+    },
+    async setShareRate(blockNumber, value) {
+        let data = {};
+        try {
+            data = JSON.parse(await fs.readFile(getShareRateCacheFile(), 'utf-8'));
+        }
+        catch {
+            /* ignore */
+        }
+        data[blockNumber] = value.toString();
+        await fs.mkdir(path.dirname(getShareRateCacheFile()), {
+            recursive: true,
+        });
+        await fs.writeFile(getShareRateCacheFile(), JSON.stringify(data), 'utf-8');
+    },
+    async getRebaseReward(vaultAddress, cacheKey) {
+        try {
+            const data = JSON.parse(await fs.readFile(getRebaseRewardCacheFile(vaultAddress), 'utf-8'));
+            if (data[cacheKey] !== undefined)
+                return BigInt(data[cacheKey]);
+        }
+        catch {
+            /* ignore */
+        }
+        return null;
+    },
+    async setRebaseReward(vaultAddress, cacheKey, value) {
+        let data = {};
+        try {
+            data = JSON.parse(await fs.readFile(getRebaseRewardCacheFile(vaultAddress), 'utf-8'));
+        }
+        catch {
+            /* ignore */
+        }
+        data[cacheKey] = value.toString();
+        await fs.mkdir(path.dirname(getRebaseRewardCacheFile(vaultAddress)), {
+            recursive: true,
+        });
+        await fs.writeFile(getRebaseRewardCacheFile(vaultAddress), JSON.stringify(data), 'utf-8');
+    },
+    async getNodeOperatorFeeBP(vaultAddress, blockNumber) {
+        try {
+            const data = JSON.parse(await fs.readFile(getNodeOperatorFeeBPCacheFile(vaultAddress), 'utf-8'));
+            if (data[blockNumber] !== undefined)
+                return BigInt(data[blockNumber]);
+        }
+        catch {
+            /* ignore */
+        }
+        return null;
+    },
+    async setNodeOperatorFeeBP(vaultAddress, blockNumber, value) {
+        let data = {};
+        try {
+            data = JSON.parse(await fs.readFile(getNodeOperatorFeeBPCacheFile(vaultAddress), 'utf-8'));
+        }
+        catch {
+            /* ignore */
+        }
+        data[blockNumber] = value.toString();
+        await fs.mkdir(path.dirname(getNodeOperatorFeeBPCacheFile(vaultAddress)), {
+            recursive: true,
+        });
+        await fs.writeFile(getNodeOperatorFeeBPCacheFile(vaultAddress), JSON.stringify(data), 'utf-8');
+    },
+};
+export const getShareRateFromCache = async (blockNumber) => {
+    const cached = await cache.getShareRate(blockNumber);
+    if (cached !== null)
+        return cached;
+    const shareRate = await calculateShareRate(blockNumber);
+    await cache.setShareRate(blockNumber, shareRate);
+    return shareRate;
+};
+export const getRebaseRewardFromCache = async (args) => {
+    const { vaultAddress, blockNumberPrev, blockNumberCurr, liabilitySharesPrev, liabilitySharesCurr, } = args;
+    const cacheKey = `${blockNumberPrev}_${blockNumberCurr}`;
+    const cached = await cache.getRebaseReward(vaultAddress, cacheKey);
+    if (cached !== null)
+        return cached;
+    const shareRatePrev = await getShareRateFromCache(blockNumberPrev);
+    const shareRateCurr = await getShareRateFromCache(blockNumberCurr);
+    const reward = calculateRebaseReward({
+        shareRatePrev,
+        shareRateCurr,
+        sharesPrev: liabilitySharesPrev,
+        sharesCurr: liabilitySharesCurr,
+    });
+    await cache.setRebaseReward(vaultAddress, cacheKey, reward);
+    return reward;
+};
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/calculate-overview-v2.d.ts

@@ -0,0 +1,28 @@
+type OverviewArgs = {
+    totalValue: bigint;
+    reserveRatioBP: number;
+    liabilitySharesInStethWei: bigint;
+    liabilitySharesInWei: bigint;
+    forceRebalanceThresholdBP: number;
+    withdrawableEther: bigint;
+    balance: bigint;
+    locked: bigint;
+    nodeOperatorUnclaimedFee: bigint;
+    totalMintingCapacityStethWei: bigint;
+    totalMintingCapacitySharesInWei: bigint;
+};
+export declare const calculateOverviewV2: (args: OverviewArgs) => {
+    healthRatio: number;
+    isHealthy: boolean;
+    AvailableToWithdrawal: bigint;
+    idleCapital: bigint;
+    totalLocked: bigint;
+    collateral: bigint;
+    PendingUnlock: bigint;
+    utilizationRatio: number;
+    reserved: bigint;
+    totalMintingCapacityStethWei: bigint;
+    remainingMintingCapacitySteth: bigint;
+    remainingMintingCapacityShares: bigint;
+};
+export {};

package/dist/utils/calculate-overview-v2.js

@@ -0,0 +1,57 @@
+import { parseEther } from 'viem';
+import { calculateHealth } from './health/calculate-health.js';
+const BASIS_POINTS_DENOMINATOR = 10000n;
+const DECIMALS = 18n;
+const SCALING_FACTOR = 10n ** DECIMALS;
+const bigIntMax = (...args) => args.reduce((a, b) => (a > b ? a : b));
+const bigIntMin = (...args) => args.reduce((a, b) => (a < b ? a : b));
+export const calculateOverviewV2 = (args) => {
+    const { totalValue, reserveRatioBP, liabilitySharesInStethWei, liabilitySharesInWei, forceRebalanceThresholdBP, withdrawableEther, balance, locked, nodeOperatorUnclaimedFee, totalMintingCapacityStethWei, totalMintingCapacitySharesInWei, } = args;
+    const { healthRatio, isHealthy } = calculateHealth({
+        totalValue,
+        liabilitySharesInStethWei,
+        forceRebalanceThresholdBP,
+    });
+    const AvailableToWithdrawal = withdrawableEther;
+    const idleCapital = balance;
+    const UnsettledLidoFees = 0n;
+    // TODO: add Lido Unclaimed Fees
+    const totalLocked = locked + nodeOperatorUnclaimedFee + UnsettledLidoFees;
+    const RR = (BigInt(reserveRatioBP) * SCALING_FACTOR) / BASIS_POINTS_DENOMINATOR; // RR with SCALING_FACTOR
+    const oneMinusRR = SCALING_FACTOR - RR; // (1 - RR) with SCALING_FACTOR
+    const liabilityDivOneMinusRR = oneMinusRR === 0n
+        ? 0n
+        : (liabilitySharesInStethWei * SCALING_FACTOR) / oneMinusRR;
+    const collateral = bigIntMax(parseEther('1'), liabilityDivOneMinusRR);
+    const PendingUnlock = liabilityDivOneMinusRR <= parseEther('1')
+        ? bigIntMax(locked - parseEther('1'), 0n)
+        : bigIntMax(locked - liabilityDivOneMinusRR, 0n);
+    const remainingMintingCapacityShares = totalMintingCapacitySharesInWei - liabilitySharesInWei;
+    const remainingMintingCapacitySteth = totalMintingCapacityStethWei - liabilitySharesInStethWei;
+    const reservedByFormula = oneMinusRR === 0n
+        ? 0n
+        : (liabilitySharesInStethWei * SCALING_FACTOR) / oneMinusRR -
+            liabilitySharesInStethWei;
+    const reserved = bigIntMin(totalValue - liabilitySharesInStethWei, reservedByFormula);
+    // Prevent division by 0
+    const utilizationRatio = totalMintingCapacityStethWei === 0n
+        ? 0
+        : Number(((liabilitySharesInStethWei * SCALING_FACTOR) /
+            totalMintingCapacityStethWei) *
+            100n) / Number(SCALING_FACTOR);
+    return {
+        healthRatio,
+        isHealthy,
+        AvailableToWithdrawal,
+        idleCapital,
+        totalLocked,
+        collateral,
+        PendingUnlock,
+        utilizationRatio,
+        reserved,
+        totalMintingCapacityStethWei,
+        remainingMintingCapacitySteth,
+        remainingMintingCapacityShares,
+    };
+};
+//# sourceMappingURL=calculate-overview-v2.js.map

package/dist/utils/calculate-overview-v2.js.map

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

package/dist/utils/calculate-overview.d.ts

@@ -0,0 +1,29 @@
+type OverviewArgs = {
+    totalValue: bigint;
+    reserveRatioBP: number;
+    liabilitySharesInStethWei: bigint;
+    forceRebalanceThresholdBP: number;
+    withdrawableEther: bigint;
+    balance: bigint;
+    locked: bigint;
+    nodeOperatorUnclaimedFee: bigint;
+    totalMintingCapacityStethWei: bigint;
+};
+export declare const BASIS_POINTS_DENOMINATOR = 10000n;
+export declare const formatBP: (bp: number | bigint) => string;
+export declare const formatRatio: (r: number) => string;
+export declare const calculateOverview: (args: OverviewArgs) => {
+    healthRatio: number;
+    isHealthy: boolean;
+    AvailableToWithdrawal: bigint;
+    idleCapital: bigint;
+    totalLocked: bigint;
+    collateral: bigint;
+    PendingUnlock: bigint;
+    utilizationRatio: number;
+    totalReservable: bigint;
+    reserved: bigint;
+    totalMintingCapacityStethWei: bigint;
+    remainingMintingCapacity: bigint;
+};
+export {};

package/dist/utils/calculate-overview.js

@@ -0,0 +1,59 @@
+import { parseEther } from 'viem';
+import { calculateHealth } from './health/calculate-health.js';
+export const BASIS_POINTS_DENOMINATOR = 10000n;
+const DECIMALS = 18n;
+const SCALING_FACTOR = 10n ** DECIMALS;
+const bigIntMax = (...args) => args.reduce((a, b) => (a > b ? a : b));
+const bigIntMin = (...args) => args.reduce((a, b) => (a < b ? a : b));
+// Percent helper (basis points → percentage)
+export const formatBP = (bp) => `${((Number(bp) / Number(BASIS_POINTS_DENOMINATOR)) * 100).toFixed(2)}%`;
+export const formatRatio = (r) => isFinite(r) ? `${r.toFixed(4)}%` : '∞';
+export const calculateOverview = (args) => {
+    const { totalValue, reserveRatioBP, liabilitySharesInStethWei, forceRebalanceThresholdBP, withdrawableEther, balance, locked, nodeOperatorUnclaimedFee, totalMintingCapacityStethWei, } = args;
+    const { healthRatio, isHealthy } = calculateHealth({
+        totalValue,
+        liabilitySharesInStethWei,
+        forceRebalanceThresholdBP,
+    });
+    const AvailableToWithdrawal = withdrawableEther;
+    const idleCapital = balance;
+    // TODO: add Lido Unclaimed Fees
+    const totalLocked = locked + nodeOperatorUnclaimedFee;
+    // ---------- Computed values ---------- //
+    const totalReservable = (totalValue * BigInt(reserveRatioBP)) / BASIS_POINTS_DENOMINATOR;
+    // Prevent division by 0
+    const utilizationRatio = totalMintingCapacityStethWei === 0n
+        ? 0
+        : Number(((liabilitySharesInStethWei * SCALING_FACTOR) /
+            totalMintingCapacityStethWei) *
+            100n) / Number(SCALING_FACTOR);
+    const reservedRaw = totalMintingCapacityStethWei === 0n
+        ? 0n
+        : (liabilitySharesInStethWei * totalReservable * SCALING_FACTOR) /
+            totalMintingCapacityStethWei;
+    const reserved = bigIntMax(bigIntMax(reservedRaw / SCALING_FACTOR, totalValue - liabilitySharesInStethWei), 0n);
+    const collateral = bigIntMin(bigIntMax(liabilitySharesInStethWei + reserved, parseEther('1')), totalValue);
+    const PendingUnlock = locked - nodeOperatorUnclaimedFee - liabilitySharesInStethWei - reserved <
+        parseEther('1')
+        ? 0n
+        : locked -
+            nodeOperatorUnclaimedFee -
+            liabilitySharesInStethWei -
+            reserved;
+    const remainingMintingCapacity = totalMintingCapacityStethWei - liabilitySharesInStethWei;
+    return {
+        healthRatio,
+        isHealthy,
+        AvailableToWithdrawal,
+        idleCapital,
+        totalLocked,
+        collateral,
+        PendingUnlock,
+        utilizationRatio,
+        totalReservable,
+        reserved,
+        totalMintingCapacityStethWei,
+        remainingMintingCapacity,
+    };
+};
+//# sourceMappingURL=calculate-overview.js.map

package/dist/utils/calculate-overview.js.map

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

package/dist/utils/charts/blessed/charts-apr.d.ts

@@ -0,0 +1,98 @@
+import { Address } from 'viem';
+type FetchAprChartsDataArgs = {
+    cid: string;
+    dashboard: Address;
+    limit?: number;
+    cacheUse?: boolean;
+};
+export declare const fetchAprChartsData: ({ cid, dashboard, limit, cacheUse, }: FetchAprChartsDataArgs) => Promise<{
+    grossStakingAPRChart: {
+        range: {
+            min: number;
+            max: number;
+            minY: number;
+            maxY: number;
+        };
+        dataset: {
+            title: string;
+            label: string;
+            x: string[];
+            y: number[];
+            style: {
+                line: string;
+            };
+        };
+    };
+    netStakingAPRChart: {
+        range: {
+            min: number;
+            max: number;
+            minY: number;
+            maxY: number;
+        };
+        dataset: {
+            title: string;
+            label: string;
+            x: string[];
+            y: number[];
+            style: {
+                line: string;
+            };
+        };
+    };
+    efficiencyChart: {
+        range: {
+            min: number;
+            max: number;
+            minY: number;
+            maxY: number;
+        };
+        dataset: {
+            title: string;
+            label: string;
+            x: string[];
+            y: number[];
+            style: {
+                line: string;
+            };
+        };
+    };
+    bottomLineChart: {
+        range: {
+            min: number;
+            max: number;
+            minY: number;
+            maxY: number;
+        };
+        dataset: {
+            title: string;
+            label: string;
+            x: string[];
+            y: number[];
+            style: {
+                line: string;
+            };
+            yLabel: string;
+        };
+    };
+    lidoAPRChart: {
+        range: {
+            min: number;
+            max: number;
+            minY: number;
+            maxY: number;
+        };
+        dataset: {
+            title: string;
+            label: string;
+            x: string[];
+            y: number[];
+            style: {
+                line: string;
+            };
+            yLabel: string;
+        };
+    };
+}>;
+export declare const renderAprCharts: ({ grossStakingAPRChart, netStakingAPRChart, efficiencyChart, bottomLineChart, lidoAPRChart, }: any) => void;
+export {};