@wireio/stake 0.4.3 → 0.5.1

package/src/networks/ethereum/contract.ts

@@ -3,12 +3,16 @@
  *
  * Provides a unified service for interacting with Ethereum smart contracts using ethers.js.
  */
+
+// LiqETH Artifacts
 import AccountingArtifact from '../../assets/ethereum/ABI/liqEth/accounting.sol/Accounting.json';
 import DepositManagerArtifact from '../../assets/ethereum/ABI/liqEth/DepositManager.sol/DepositManager.json';
 import LiqEthArtifact from '../../assets/ethereum/ABI/liqEth/liqEth.sol/LiqEthToken.json';
 import StakingModuleArtifact from '../../assets/ethereum/ABI/liqEth/stakingModule.sol/StakingModule.json';
 import WithdrawalQueueArtifact from '../../assets/ethereum/ABI/liqEth/withdrawalQueue.sol/WithdrawalQueue.json';
 import WithdrawalVaultArtifact from '../../assets/ethereum/ABI/liqEth/withdrawalVault.sol/WithdrawalVault.json';
+import BeaconStateArtifact from '../../assets/ethereum/ABI/liqEth/BeaconState.sol/BeaconState.json';
+import YieldOracleArtifact from '../../assets/ethereum/ABI/liqEth/Yield.sol/YieldOracle.json';
 
 // Outpost Artifacts
 import DepositorArtifact from '../../assets/ethereum/ABI/outpost/Depositor.sol/Depositor.json';
@@ -22,7 +26,15 @@ import PretokenArtifact from '../../assets/ethereum/ABI/outpost/Pretoken.sol/Pre
 import AggregatorArtifact from '../../assets/ethereum/ABI/outpost/Aggregator.sol/Aggregator.json';
 import EthUsdPriceConsumerArtifact from '../../assets/ethereum/ABI/outpost/EthUsdPriceConsumer.sol/EthUsdPriceConsumer.json';
 import PoolArtifact from '../../assets/ethereum/ABI/outpost/Pool.sol/Pool.json';
+import OutpostManagerAuthorityArtifact from '../../assets/ethereum/ABI/outpost/OutpostManagerAuthority.sol/OutpostManagerAuthority.json';
+
+// Common Artifacts
+import IodataArtifact from '../../assets/ethereum/ABI/common/iodata.sol/iodata.json';
+import Base58Artifact from '../../assets/ethereum/ABI/common/Base58.sol/Base58.json';
+import sysio_merkleArtifact from '../../assets/ethereum/ABI/common/sysio_merkle.sol/sysio_merkle.json';
+import sysio_writeArtifact from '../../assets/ethereum/ABI/common/sysio_write.sol/sysio_write.json';
 
+// ERC Token Artifacts
 import ERC20Artifact from '../../assets/ethereum/ABI/token/ERC20Token.sol/ERC20Token.json';
 import ERC721Artifact from '../../assets/ethereum/ABI/token/ERC721Token.sol/ERC721Token.json';
 import ERC1155Artifact from '../../assets/ethereum/ABI/token/ERC1155Token.sol/ERC1155Token.json';
@@ -43,25 +55,33 @@ export const ERC1155Abi = ERC1155Artifact.abi;
 // Make sure ContractName in ./types includes all of these keys.
 export const ADDRESSES: AddressBook = {
     // LiqETH contracts
-    Accounting: "0xd333A03a44D5d602A98c1B7bcd7ED1f042DD0dEd",
-    DepositManager: "0x601eaA31e8d33D8725786f1733f4cE6cCEf740D4",
-    LiqEth: "0x08252e1Dcbaa86A2887927b02536CD3E67a802c8", // AKA LiqEthToken
-    StakingModule: "0x7Aac2fCfc83d7F2f15eA53a10C1677CA377AFcF4",
-    WithdrawalQueue: "0x951E413FC81a2CE133078ABE8B88677F5296abE7",
-    WithdrawalVault: "0x0D2bf834DD560839e986d42D06DeE268A17c2d13",
+    LiqEthAuthority: "0x9686E04F30Fa93496B7d7fE0FBc2e4e0aD52891E",
+    BeaconState: "0x207b249d7a83F6E9FCa04a1CD9b484D4f4f9aD2D",
+    WithdrawalQueue: "0x9a575c7Acce9e616cD07A0BDb2D28866027b75Ae",
+    LiqEthToken: "0x5f7192fa756304b255F6F9C1123426Db6A1Db748",
+    Accounting: "0xBAbAd5219f022B29282b904ceEaeBB7ab1b069fC",
+    DepositManager: "0x2e1986508472805c1649e4BBB424879B89720741",
+    WithdrawalVault: "0xC82FAf3Fed135B70A7E797864F504819a98E96c4",
+    StakingModule: "0xdd24EffAa4B42f3273E2b44995639119c08daBea",
+    YieldOracle: "0x56A27E1d10d4aEc7402dC26693fb7c0Eb66eF802",
 
     //Outpost contracts
-    Depositor: "0x69Aa53Ef02F124dB421AeDda509d6912341299Cc",
-    ReceiptNFT: "0x13588fF41E2f47D047874162B1eD15AaF6818f5a",
-    OutpostManager: "0x187f4fEDBCAD2f3150120B743b5d568F11dD3452",
-    BAR: "0x27d4646abF638A13934c94f8bA9AC1Bda39F5dbb",
-    OPP: "0x79CA2DE915C294593edc16b32CBA8B7866159205",
-    OPPCommon: "0x8392ea945Cd8C03F5241d4964D20BB5A9c320c71",
-    OPPInbound: "0xfDA9A2C7e395a9722d9fa506f5d67aba823298dd",
-    Pretoken: "0xcf6A1209A7A391cc576174204386F4e5462323dC",
-    EthUsdPriceConsumer: "0x1Ef180FF49313fCB8B5c0470268295d0d24CDE69",
-    Aggregator: "0xFCfc3ddd4CBd9Ad3b3af3A374B8bdA1b66eE6FFF",
-    Pool: "0x29DEf0fA009e02d108d9505018EAe0168F233e03",
+    OutpostManagerAuthority: "0xAEcd2aa6EeFa4Aa7Cb9368728aA89Ca59Aa9ea59",
+    iodata: "0x2c2ab53F6Bc146bd31B459E832Ce0B9Da78712d8",
+    Base58: "0x9F188Ec124c9ad9bF6D195650d8360Fd052F585A",
+    sysio_merkle: "0x6eDA3C4c34421Cd667800C17fe33E48f5698e004",
+    ReceiptNFT: "0xd083051d9bb8353875abCecAB50C6e4FB5e527a8",
+    MockAggregator: "0xFCfc3ddd4CBd9Ad3b3af3A374B8bdA1b66eE6FFF",
+    Pool: "0xee5F11aC9b104c18d2423f266c5E737fC95ebA92",
+    OutpostManager: "0xB1B6ba7FA156652849069aC7ADB281283D235B9f",
+    sysio_write: "0xEfA608136d372349C09a7aA57665C09Fb4a620Ca",
+    EthUsdPriceConsumer: "0x6337A23b61f98b1526faF2848385Abe9cB4cFF21",
+    BAR: "0x9264eAA449da94caF70Fc18522021a94C8DF32Fb",
+    OPPCommon: "0x86A8cA16ce521De3EBdd1C541fAf188795b59FD0",
+    OPP: "0x79e8395Bb5131FB285aCEE5329BB43E66f50F88C",
+    Pretoken: "0x62f98AF2f9C3EF4eF2fA7bc0245BD5a9315E7541",
+    OPPInbound: "0xC85f57Ff069711e0b3472De3963bd2fC2FEfF3e2",
+    Depositor: "0xb0BACAb6f13dd96281300be13a6346461b2f35F3"
 };
 
 export type Contracts<T extends string = ContractName> = Record<T, ContractConfig>;
@@ -76,76 +96,109 @@ export type ContractConfig = {
 // -----------------------------------------------------------------------------
 
 export const CONTRACTS: Contracts<ContractName> = {
+    // LiqETH Contracts
+    LiqEthAuthority: {
+        address: ADDRESSES.LiqEthAuthority,
+        abi: LiqEthArtifact.abi as JsonFragment[],
+    },
+    BeaconState: {
+        address: ADDRESSES.BeaconState,
+        abi: BeaconStateArtifact.abi as JsonFragment[]
+    },
+    WithdrawalQueue: {
+        address: ADDRESSES.WithdrawalQueue,
+        abi: WithdrawalQueueArtifact.abi as JsonFragment[],
+    },
+    LiqEthToken: {
+        address: ADDRESSES.LiqEthToken,
+        abi: LiqEthArtifact.abi as JsonFragment[],
+    },
     Accounting: {
         address: ADDRESSES.Accounting,
         abi: AccountingArtifact.abi as JsonFragment[],
     },
-    LiqEth: {
-        address: ADDRESSES.LiqEth,
-        abi: LiqEthArtifact.abi as JsonFragment[],
-    },
     DepositManager: {
         address: ADDRESSES.DepositManager,
         abi: DepositManagerArtifact.abi as JsonFragment[],
     },
+    WithdrawalVault: {
+        address: ADDRESSES.WithdrawalVault,
+        abi: WithdrawalVaultArtifact.abi as JsonFragment[],
+    },
     StakingModule: {
         address: ADDRESSES.StakingModule,
         abi: StakingModuleArtifact.abi as JsonFragment[],
     },
-    WithdrawalQueue: {
-        address: ADDRESSES.WithdrawalQueue,
-        abi: WithdrawalQueueArtifact.abi as JsonFragment[],
-    },
-    WithdrawalVault: {
-        address: ADDRESSES.WithdrawalVault,
-        abi: WithdrawalVaultArtifact.abi as JsonFragment[],
+    YieldOracle: {
+        address: ADDRESSES.YieldOracle,
+        abi: YieldOracleArtifact.abi as JsonFragment[],
     },
 
     // Outpost Contracts
-    Depositor: {
-        address: ADDRESSES.Depositor,
-        abi: DepositorArtifact.abi as JsonFragment[],
+    OutpostManagerAuthority: {
+        address: ADDRESSES.OutpostManagerAuthority,
+        abi: OutpostManagerAuthorityArtifact.abi as JsonFragment[],
+    },
+    iodata: {
+        address: ADDRESSES.iodata,
+        abi: IodataArtifact.abi as JsonFragment[],
+    },
+    Base58: {
+        address: ADDRESSES.Base58,
+        abi: Base58Artifact.abi as JsonFragment[],
+    },
+    sysio_merkle: {
+        address: ADDRESSES.sysio_merkle,
+        abi: sysio_merkleArtifact.abi as JsonFragment[],
     },
     ReceiptNFT: {
         address: ADDRESSES.ReceiptNFT,
         abi: ReceiptNFTArtifact.abi as JsonFragment[],
     },
+    MockAggregator: {
+        address: ADDRESSES.MockAggregator,
+        abi: AggregatorArtifact.abi as JsonFragment[],
+    },
+    Pool: {
+        address: ADDRESSES.Pool,
+        abi: PoolArtifact.abi as JsonFragment[],
+    },
     OutpostManager: {
         address: ADDRESSES.OutpostManager,
         abi: OutpostManagerArtifact.abi as JsonFragment[],
     },
+    sysio_write: {
+        address: ADDRESSES.sysio_write,
+        abi: sysio_writeArtifact.abi as JsonFragment[],
+    },
+    EthUsdPriceConsumer: {
+        address: ADDRESSES.EthUsdPriceConsumer,
+        abi: EthUsdPriceConsumerArtifact.abi as JsonFragment[],
+    },
     BAR: {
         address: ADDRESSES.BAR,
         abi: BARArtifact.abi as JsonFragment[],
     },
-    OPP: {
-        address: ADDRESSES.OPP,
-        abi: OPPArtifact.abi as JsonFragment[],
-    },
     OPPCommon: {
         address: ADDRESSES.OPPCommon,
         abi: OPPCommonArtifact.abi as JsonFragment[],
     },
-    OPPInbound: {
-        address: ADDRESSES.OPPInbound,
-        abi: OPPInboundArtifact.abi as JsonFragment[],
+    OPP: {
+        address: ADDRESSES.OPP,
+        abi: OPPArtifact.abi as JsonFragment[],
     },
     Pretoken: {
         address: ADDRESSES.Pretoken,
         abi: PretokenArtifact.abi as JsonFragment[],
     },
-    Aggregator: {
-        address: ADDRESSES.Aggregator,
-        abi: AggregatorArtifact.abi as JsonFragment[],
+    OPPInbound: {
+        address: ADDRESSES.OPPInbound,
+        abi: OPPInboundArtifact.abi as JsonFragment[],
     },
-    EthUsdPriceConsumer: {
-        address: ADDRESSES.EthUsdPriceConsumer,
-        abi: EthUsdPriceConsumerArtifact.abi as JsonFragment[],
+    Depositor: {
+        address: ADDRESSES.Depositor,
+        abi: DepositorArtifact.abi as JsonFragment[],
     },
-    Pool: {
-        address: ADDRESSES.Pool,
-        abi: PoolArtifact.abi as JsonFragment[],
-    }
 };
 
 export interface ContractOptions {
@@ -228,17 +281,17 @@ export class EthereumContractService {
             ERC721Artifact,
             ERC1155Artifact,
 
-            // liqETH suite
-            AccountingArtifact,
-            DepositManagerArtifact,
-            LiqEthArtifact,
-            // LiqEthBurnArtifact,
-            // LiqEthMintArtifact,
-            // RewardsERC20Artifact,
-            StakingModuleArtifact,
-            // ValidatorBalanceArtifact,
-            WithdrawalQueueArtifact,
-            WithdrawalVaultArtifact,
+            // // liqETH suite
+            // AccountingArtifact,
+            // DepositManagerArtifact,
+            // LiqEthArtifact,
+            // // LiqEthBurnArtifact,
+            // // LiqEthMintArtifact,
+            // // RewardsERC20Artifact,
+            // StakingModuleArtifact,
+            // // ValidatorBalanceArtifact,
+            // WithdrawalQueueArtifact,
+            // WithdrawalVaultArtifact,
             // YieldArtifact,
         ];
 

package/src/networks/ethereum/ethereum.ts

@@ -16,6 +16,8 @@ import { PretokenClient } from './clients/pretoken.client';
 import { OPPClient } from './clients/opp.client';
 import { ReceiptClient } from './clients/receipt.client';
 
+export const INITIAL_TRANCHE_SUPPLY = 35000;
+
 export class EthereumStakingClient implements IStakingClient {
     private readonly provider: ethers.providers.Web3Provider | ethers.providers.JsonRpcProvider;
     public readonly pubKey?: WirePubKey;
@@ -154,8 +156,8 @@ export class EthereumStakingClient implements IStakingClient {
      * actual  = liqETH token balance (ERC-20)
      * tracked = liqETH tracked balance (protocol/accounting view)
      */
-    async getPortfolio(): Promise<Portfolio> {
-        this.ensureUser();
+    async getPortfolio(): Promise<Portfolio | null> {
+        if (!this.signer) return Promise.resolve(null);
 
         const walletAddress = await this.signer!.getAddress();
 
@@ -165,7 +167,7 @@ export class EthereumStakingClient implements IStakingClient {
         const nativeSymbol = this.network?.nativeCurrency?.symbol ?? 'ETH';
 
         // 2) liqETH ERC-20 balance (actual)
-        const liqBalance: ethers.BigNumber = await this.contract.LiqEth.balanceOf(walletAddress);
+        const liqBalance: ethers.BigNumber = await this.contract.LiqEthToken.balanceOf(walletAddress);
         const liqSymbol = 'Liq' + (this.network?.nativeCurrency?.symbol ?? 'ETH');
 
         // 3) staked liqEth ERC-20 balance (calculate from receipts)
@@ -199,7 +201,7 @@ export class EthereumStakingClient implements IStakingClient {
             currentIndex = BigInt(indexBn.toString());
             totalShares = BigInt(totalSharesBn.toString());
             userShares = BigInt(userSharesBn.toString());
-        } catch {}
+        } catch { }
 
         // sharesToTokens(userShares, currentIndex) = userShares * currentIndex / indexScale
         let estimatedClaim = BigInt(0);
@@ -287,10 +289,18 @@ export class EthereumStakingClient implements IStakingClient {
     // READ-ONLY Public Methods
     // ---------------------------------------------------------------------
 
-    // Estimated total APY for staking yeild
+    // Protocol-wide ETH staking APY in percent, e.g. 3.0 => "3.00%"
     async getSystemAPY(): Promise<number> {
+        // NOTE: despite the name, this value is effectively *annual* BPS on-chain.
+        // e.g. 300 => 3% APY
         const annualBpsBn = await this.contract.DepositManager.dailyRateBPS();
-        return annualBpsBn.toNumber() / 10000; // 0.04 for 4%
+        const annualBps = annualBpsBn.toNumber(); // e.g. 300 for 3%
+
+        // Convert basis points (1/100 of 1%) to percent:
+        // 10,000 bps = 100% ⇒ 100 bps = 1% ⇒ divide by 100.
+        const apyPercent = annualBps / 100;
+
+        return apyPercent; // 3 => "3.00%"
     }
 
     // Protocol fee charged for deposit from Native to LIQ
@@ -304,7 +314,7 @@ export class EthereumStakingClient implements IStakingClient {
     }
 
     async getEthStats(): Promise<any> {
-        let withdrawDelay = await this.contract.DepositManager.withdrawDelay();
+        let withdrawDelay = await this.contract.WithdrawalQueue.withdrawDelay();
         let minDeposit = await this.contract.DepositManager.minDeposit();
         let rewardCooldown = await this.contract.DepositManager.rewardCooldown();
 
@@ -332,55 +342,133 @@ export class EthereumStakingClient implements IStakingClient {
         } = options ?? {};
 
 
-        const blockNumber = await this.provider.getBlockNumber();
-        const blockTag = { blockTag: blockNumber };
-
-        // Fetch all required contract data
-        const [totalSharesBn, indexBn, trancheNumberBn, trancheSupplyBn, tranchePriceWadBn, totalSupplyBn, supplyGrowthBps, priceGrowthBps, minPriceUsd, maxPriceUsd] = await Promise.all([
-            this.contract.Depositor.totalShares(blockTag),
-            this.contract.Depositor.index(blockTag),
-            this.contract.Pretoken.trancheNumber(blockTag),
-            this.contract.Pretoken.trancheSupply(blockTag),
-            this.contract.Pretoken.tranchePriceUsd(blockTag),
-            this.contract.Pretoken.totalSupply(blockTag),
-            this.contract.Pretoken.supplyGrowthBps(blockTag),
-            this.contract.Pretoken.priceGrowthBps(blockTag),
-            this.contract.EthUsdPriceConsumer.MIN_PRICE(),
-            this.contract.EthUsdPriceConsumer.MAX_PRICE(),
-        ]);
-
-
-        const totalTrancheSupply = BigInt(totalSupplyBn.toString()) / BigInt(1e10);
-        const currentTrancheSupply = BigInt(trancheSupplyBn.toString()) / BigInt(1e10);
-
-
-        // fetch price and timestamp from aggregator
-        const [roundId, answer, startedAt, updatedAt, answeredInRound] = await this.contract.Aggregator.latestRoundData();
-        let ethPriceUsd: bigint = BigInt(answer.toString());
-        let nativePriceTimestamp: number = Number(updatedAt);
-
-        // ! Placeholder from hoodi deployment - don't think this can be fetched dynamically
-        const initialTrancheSupply = BigInt(60000) * BigInt(1e8);
-
-        return buildEthereumTrancheSnapshot({
-            chainID,
-            totalSharesBn,
-            indexBn,
-            trancheNumberBn,
-            currentTrancheSupply,
-            tranchePriceWadBn,
-            totalTrancheSupply,
-            initialTrancheSupply,
-            supplyGrowthBps,
-            priceGrowthBps,
-            minPriceUsd,
-            maxPriceUsd,
-
-            ethPriceUsd,
-            nativePriceTimestamp,
-            ladderWindowBefore: windowBefore,
-            ladderWindowAfter: windowAfter,
+        try {
+
+            const blockNumber = await this.provider.getBlockNumber();
+            const blockTag = { blockTag: blockNumber };
+
+
+            // Fetch all required contract data
+            const [totalSharesBn, indexBn, trancheNumberBn, trancheSupplyBn, tranchePriceWadBn, totalSupplyBn, supplyGrowthBps, priceGrowthCents, minPriceUsd, maxPriceUsd] = await Promise.all([
+                this.contract.Depositor.totalShares(blockTag),
+                this.contract.Depositor.index(blockTag),
+                this.contract.Pretoken.trancheNumber(blockTag),
+                this.contract.Pretoken.trancheSupply(blockTag),
+                this.contract.Pretoken.tranchePriceUsd(blockTag),
+                this.contract.Pretoken.totalSupply(blockTag),
+                this.contract.Pretoken.supplyGrowthBps(blockTag),
+                this.contract.Pretoken.priceIncrementUsd(blockTag),
+                this.contract.EthUsdPriceConsumer.MIN_PRICE(),
+                this.contract.EthUsdPriceConsumer.MAX_PRICE(),
+            ]);
+
+
+            const totalTrancheSupply = BigInt(totalSupplyBn.toString()) / BigInt(1e10);
+            const currentTrancheSupply = BigInt(trancheSupplyBn.toString()) / BigInt(1e10);
+
+
+            // fetch price and timestamp from aggregator
+            const [roundId, answer, startedAt, updatedAt, answeredInRound] = await this.contract.MockAggregator.latestRoundData();
+            let ethPriceUsd: bigint = BigInt(answer.toString());
+            let nativePriceTimestamp: number = Number(updatedAt);
+
+            const initialTrancheSupply = BigInt(INITIAL_TRANCHE_SUPPLY) * BigInt(1e8);
+
+            return buildEthereumTrancheSnapshot({
+                chainID,
+                totalSharesBn,
+                indexBn,
+                trancheNumberBn,
+                currentTrancheSupply,
+                tranchePriceWadBn,
+                totalTrancheSupply,
+                initialTrancheSupply,
+                supplyGrowthBps,
+                priceGrowthCents,
+                minPriceUsd,
+                maxPriceUsd,
+
+                ethPriceUsd,
+                nativePriceTimestamp,
+                ladderWindowBefore: windowBefore,
+                ladderWindowAfter: windowAfter,
+            });
+        }
+        catch (err: any) {
+            console.log(err);
+
+            throw new Error(`Error fetching Ethereum tranche snapshot: ${err?.message || err}`);
+        }
+    }
+
+    /**
+     * Estimate a conservative native ETH buffer (in wei) to leave in the wallet
+     * so the user can pay gas for the current deposit and at least one more tx.
+     *
+     * Typical usage in UI:
+     *   const buffer = await client.estimateGasBuffer();
+     *   const maxSpendable = balanceWei > buffer ? balanceWei - buffer : 0n;
+     *
+     * @param options.txCount         How many transactions to cover (default 2: deposit + 1 more)
+     * @param options.safetyMultiplier Additional safety multiplier on top of txCount (default 1.5x)
+     * @param options.minBufferWei    Optional override minimum buffer (defaults ~0.002 ETH)
+     */
+    async estimateGasBuffer(options?: {
+        txCount?: number;
+        safetyMultiplier?: number;
+        minBufferWei?: bigint;
+    }): Promise<bigint> {
+        this.ensureUser();
+
+        const walletAddress = await this.signer!.getAddress();
+
+        // 1) Estimate a baseline gas usage using a simple self-transfer.
+        //    This is cheap and doesn't depend on your contract ABI at all.
+        const baseGas = await this.provider.estimateGas({
+            from: walletAddress,
+            to: walletAddress,
+            value: ethers.constants.Zero,
         });
+
+        // 2) Fetch current gas price / max fee per gas.
+        const feeData = await this.provider.getFeeData();
+        let gasPrice =
+            feeData.maxFeePerGas ??
+            feeData.gasPrice ??
+            ethers.utils.parseUnits('20', 'gwei'); // conservative fallback
+
+        // 3) How many txs do we want to cover?
+        //    Default: 2 (deposit + one extra action such as stake or small follow-up).
+        const txCount = options?.txCount ?? 2;
+
+        // We also assume that contract interactions are more expensive than a simple transfer.
+        // Use a multiplier (e.g., 5x) on baseGas to approximate a more complex tx.
+        const COMPLEX_TX_MULTIPLIER = 5; // tuning knob
+        const totalGasUnits = baseGas
+            .mul(COMPLEX_TX_MULTIPLIER)
+            .mul(txCount);
+
+        const baseCost = totalGasUnits.mul(gasPrice);
+
+        // 4) Safety multiplier on top of that (e.g. 1.5x).
+        const safetyMultiplier = options?.safetyMultiplier ?? 1.5;
+        const safetyScaled = Math.round(safetyMultiplier * 100); // e.g. 150
+
+        const bufferedCost = baseCost
+            .mul(safetyScaled)
+            .div(100); // apply safety factor
+
+        let bufferWei = bufferedCost.toBigInt();
+
+        // 5) Enforce a minimum floor (e.g. ~0.002 ETH).
+        const defaultMinBufferWei = BigInt(2_000_000_000_000_000); // 0.002 ETH
+        const minBufferWei = options?.minBufferWei ?? defaultMinBufferWei;
+
+        if (bufferWei < minBufferWei) {
+            bufferWei = minBufferWei;
+        }
+
+        return bufferWei;
     }
 
     // ---------------------------------------------------------------------
@@ -389,7 +477,7 @@ export class EthereumStakingClient implements IStakingClient {
 
     // ! This is a temporary measure for Hoodi testnet because there is no aggregator deployed
     private async updateMockAggregatorPrice() {
-        const aggregator = this.contract.Aggregator;
+        const aggregator = this.contract.MockAggregator;
 
         // read latest round & compute age
         const [roundId, answer, startedAt, updatedAt, answeredInRound] = await aggregator.latestRoundData();

package/src/networks/ethereum/types.ts

@@ -2,25 +2,34 @@ import { BigNumber, ethers } from 'ethers';
 import { BalanceView } from '../../types';
 
 export const CONTRACT_NAMES = [
-    'Accounting',
-    'DepositManager',
-    'LiqEth',
-    'StakingModule',
-    'WithdrawalQueue',
-    'WithdrawalVault',
+    // LiqETH contracts
+    "LiqEthAuthority",
+    "BeaconState",
+    "WithdrawalQueue",
+    "LiqEthToken",
+    "Accounting",
+    "DepositManager",
+    "WithdrawalVault",
+    "StakingModule",
+    "YieldOracle",
 
     //Outpost contracts
-    'Depositor',
-    'ReceiptNFT',
-    'OutpostManager',
-    'BAR',
-    'OPP',
-    'OPPCommon',
-    'OPPInbound',
-    'Pretoken',
-    'Aggregator',
-    'EthUsdPriceConsumer',
-    'Pool',
+    "OutpostManagerAuthority",
+    "iodata",
+    "Base58",
+    "sysio_merkle",
+    "ReceiptNFT",
+    "MockAggregator",
+    "Pool",
+    "OutpostManager",
+    "sysio_write",
+    "EthUsdPriceConsumer",
+    "BAR",
+    "OPPCommon",
+    "OPP",
+    "Pretoken",
+    "OPPInbound",
+    "Depositor",
 
 ] as const;
 

package/src/networks/ethereum/utils.ts

@@ -157,7 +157,7 @@ export function buildEthereumTrancheLadder(options: {
     currentTrancheSupply: bigint;
     currentPriceUsd: bigint;
     supplyGrowthBps: number;
-    priceGrowthBps: number;
+    priceGrowthCents: number;
     windowBefore?: number;
     windowAfter?: number;
 }): TrancheLadderItem[] {
@@ -167,7 +167,7 @@ export function buildEthereumTrancheLadder(options: {
         currentTrancheSupply,
         currentPriceUsd,
         supplyGrowthBps,
-        priceGrowthBps,
+        priceGrowthCents,
         windowBefore = 5,
         windowAfter = 5,
     } = options;
@@ -190,7 +190,7 @@ export function buildEthereumTrancheLadder(options: {
         const prevCap = capacity.get(id - 1)!;
         const prevPrice = price.get(id - 1)!;
         capacity.set(id, growOnce(prevCap, supplyGrowthBps));
-        price.set(id, growOnce(prevPrice, priceGrowthBps));
+        price.set(id, growOnce(prevPrice, priceGrowthCents));
     }
 
     // Backward (past tranches)
@@ -198,7 +198,7 @@ export function buildEthereumTrancheLadder(options: {
         const nextCap = capacity.get(id + 1)!;
         const nextPrice = price.get(id + 1)!;
         capacity.set(id, shrinkOnce(nextCap, supplyGrowthBps));
-        price.set(id, shrinkOnce(nextPrice, priceGrowthBps));
+        price.set(id, shrinkOnce(nextPrice, priceGrowthCents));
     }
 
     const ladder: TrancheLadderItem[] = [];
@@ -240,7 +240,7 @@ export async function buildEthereumTrancheSnapshot(options: {
     totalTrancheSupply;
     initialTrancheSupply;
     supplyGrowthBps;
-    priceGrowthBps;
+    priceGrowthCents;
     minPriceUsd;
     maxPriceUsd;
 
@@ -264,7 +264,7 @@ export async function buildEthereumTrancheSnapshot(options: {
         totalTrancheSupply,
         initialTrancheSupply,
         supplyGrowthBps,
-        priceGrowthBps,
+        priceGrowthCents,
         minPriceUsd, 
         maxPriceUsd,
     } = options;
@@ -284,7 +284,7 @@ export async function buildEthereumTrancheSnapshot(options: {
         currentTrancheSupply,
         currentPriceUsd,
         supplyGrowthBps,
-        priceGrowthBps,
+        priceGrowthCents,
         windowBefore: ladderWindowBefore,
         windowAfter: ladderWindowAfter,
     });
@@ -297,7 +297,7 @@ export async function buildEthereumTrancheSnapshot(options: {
         currentTranche,
         currentPriceUsd,
         supplyGrowthBps,
-        priceGrowthBps,
+        priceGrowthCents,
         currentTrancheSupply,
         initialTrancheSupply,
         totalPretokensSold: totalTrancheSupply,