@wireio/stake 0.4.3 → 0.5.1

package/lib/stake.d.ts

@@ -23,8 +23,13 @@ interface IStakingClient {
     unstake(amount: bigint): Promise<string>;
     buy(amount: bigint): Promise<string>;
     /** Fetch the complete user portfolio */
-    getPortfolio(): Promise<Portfolio>;
+    getPortfolio(): Promise<Portfolio | null>;
     getSystemAPY(): Promise<number>;
+    /**
+     * Protocol fee charged for deposit from Native to LIQ
+     * in Solana: amount in lamports
+     * in Ethereum: amount in wei
+     */
     getDepositFee(amount: bigint): Promise<bigint>;
     /**
      * Program-level prelaunch WIRE/tranche snapshot for this chain.
@@ -38,8 +43,16 @@ interface IStakingClient {
         windowBefore?: number;
         windowAfter?: number;
     }): Promise<TrancheSnapshot | null>;
-    getSystemAPY(): Promise<number>;
-    getDepositFee(amount: bigint): Promise<bigint>;
+    /**
+     * Estimate a conservative ETH(wei) / SOL(lamports) buffer to leave in the wallet
+     * so the user can pay fees for the current deposit and at least one
+     * more transaction, plus a bit extra for future interactions.
+    */
+    estimateGasBuffer(options?: {
+        txCount?: number;
+        safetyMultiplier?: number;
+        minBuffer?: bigint;
+    }): Promise<bigint>;
 }
 /**
  * Cross-chain portfolio view for a single account/wallet.
@@ -179,9 +192,8 @@ interface TrancheSnapshot {
     currentTranche: number;
     /** Current tranche price in USD (1e8 scale) */
     currentPriceUsd: bigint;
-    /** Tranche curve config (per-chain) */
     supplyGrowthBps: number;
-    priceGrowthBps: number;
+    priceGrowthCents: number;
     totalPretokensSold: bigint;
     /** Current tranche supply state (1e8 scale) */
     currentTrancheSupply: bigint;
@@ -248,7 +260,7 @@ declare class Staker {
     setChain(chainID: ChainID): boolean;
 }
 
-declare const CONTRACT_NAMES: readonly ["Accounting", "DepositManager", "LiqEth", "StakingModule", "WithdrawalQueue", "WithdrawalVault", "Depositor", "ReceiptNFT", "OutpostManager", "BAR", "OPP", "OPPCommon", "OPPInbound", "Pretoken", "Aggregator", "EthUsdPriceConsumer", "Pool"];
+declare const CONTRACT_NAMES: readonly ["LiqEthAuthority", "BeaconState", "WithdrawalQueue", "LiqEthToken", "Accounting", "DepositManager", "WithdrawalVault", "StakingModule", "YieldOracle", "OutpostManagerAuthority", "iodata", "Base58", "sysio_merkle", "ReceiptNFT", "MockAggregator", "Pool", "OutpostManager", "sysio_write", "EthUsdPriceConsumer", "BAR", "OPPCommon", "OPP", "Pretoken", "OPPInbound", "Depositor"];
 type ContractName = typeof CONTRACT_NAMES[number];
 type AddressBook = Record<ContractName, string>;
 interface Result {
@@ -332,6 +344,7 @@ declare namespace types$1 {
   export type { types$1_AddressBook as AddressBook, types$1_ContractName as ContractName, types$1_DepositEvent as DepositEvent, types$1_DepositResult as DepositResult, types$1_SharesBurnedEvent as SharesBurnedEvent, types$1_StakedEvent as StakedEvent, types$1_StakedResult as StakedResult, types$1_WithdrawRequestedEvent as WithdrawRequestedEvent, types$1_WithdrawResult as WithdrawResult, types$1_WithdrawnStakeEvent as WithdrawnStakeEvent, types$1_WithdrawnStakeResult as WithdrawnStakeResult, types$1_preLaunchReceipt as preLaunchReceipt };
 }
 
+declare const INITIAL_TRANCHE_SUPPLY = 35000;
 declare class EthereumStakingClient implements IStakingClient {
     private config;
     private readonly provider;
@@ -344,23 +357,31 @@ declare class EthereumStakingClient implements IStakingClient {
     private oppClient;
     private receiptClient;
     get contract(): {
+        LiqEthAuthority: ethers.Contract;
+        BeaconState: ethers.Contract;
+        WithdrawalQueue: ethers.Contract;
+        LiqEthToken: ethers.Contract;
         Accounting: ethers.Contract;
         DepositManager: ethers.Contract;
-        LiqEth: ethers.Contract;
-        StakingModule: ethers.Contract;
-        WithdrawalQueue: ethers.Contract;
         WithdrawalVault: ethers.Contract;
-        Depositor: ethers.Contract;
+        StakingModule: ethers.Contract;
+        YieldOracle: ethers.Contract;
+        OutpostManagerAuthority: ethers.Contract;
+        iodata: ethers.Contract;
+        Base58: ethers.Contract;
+        sysio_merkle: ethers.Contract;
         ReceiptNFT: ethers.Contract;
+        MockAggregator: ethers.Contract;
+        Pool: ethers.Contract;
         OutpostManager: ethers.Contract;
+        sysio_write: ethers.Contract;
+        EthUsdPriceConsumer: ethers.Contract;
         BAR: ethers.Contract;
-        OPP: ethers.Contract;
         OPPCommon: ethers.Contract;
-        OPPInbound: ethers.Contract;
+        OPP: ethers.Contract;
         Pretoken: ethers.Contract;
-        Aggregator: ethers.Contract;
-        EthUsdPriceConsumer: ethers.Contract;
-        Pool: ethers.Contract;
+        OPPInbound: ethers.Contract;
+        Depositor: ethers.Contract;
     };
     get network(): _wireio_core.ExternalNetwork;
     constructor(config: StakerConfig);
@@ -399,7 +420,7 @@ declare class EthereumStakingClient implements IStakingClient {
      * actual  = liqETH token balance (ERC-20)
      * tracked = liqETH tracked balance (protocol/accounting view)
      */
-    getPortfolio(): Promise<Portfolio>;
+    getPortfolio(): Promise<Portfolio | null>;
     /**
      * ETH Prelaunch function to list the Stake ReceiptNFTs owned by a specific user
      * @param address address to query the receipts for
@@ -422,9 +443,32 @@ declare class EthereumStakingClient implements IStakingClient {
         windowBefore?: number;
         windowAfter?: number;
     }): Promise<TrancheSnapshot>;
+    /**
+     * 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)
+     */
+    estimateGasBuffer(options?: {
+        txCount?: number;
+        safetyMultiplier?: number;
+        minBufferWei?: bigint;
+    }): Promise<bigint>;
     private updateMockAggregatorPrice;
 }
 
+/**
+ * @module EthereumContractService
+ *
+ * Provides a unified service for interacting with Ethereum smart contracts using ethers.js.
+ */
+
 declare const ERC20Abi: ({
     inputs: {
         internalType: string;
@@ -752,7 +796,7 @@ interface SharesPreview {
  * - NFT withdrawal receipts
  * - Encumbered funds for pending withdrawals
  */
-type Global = {
+type GlobalAccount = {
     /** PDA bump */
     bump: number;
     /** Authority that can update serviceable epochs / receipts */
@@ -779,8 +823,6 @@ type Global = {
  * - `wireState` lifecycle (preLaunch/postLaunch/refund)
  */
 type GlobalState = {
-    /** Admin authority for pretokens/outpost config */
-    admin: PublicKey$1;
     /** Deployment timestamp (Unix, seconds) */
     deployedAt: BN;
     /** Delay before refunds are permitted (seconds) */
@@ -825,6 +867,108 @@ type GlobalState = {
     /** PDA bump */
     bump: number;
 };
+/**
+ * IDL: `globalConfig`
+ *
+ * Zero-copy global config PDA.
+ * Authority is taken from StakeControllerState, not stored here.
+ */
+type GlobalConfig = {
+    /** PDA bump */
+    bump: number;
+    /** 7-byte padding (unused) */
+    padding: number[];
+    /** Minimum SOL amount a user can deposit (lamports, u64) */
+    minUserDeposit: BN;
+    /** Minimum SOL amount for an unstake/withdrawal request (lamports, u64) */
+    minUnstakeRequest: BN;
+    /** Minimum stake delta to trigger a stake rebalance order (lamports, u64) */
+    minRebalanceStakeDelta: BN;
+    /** Minimum unstake delta to trigger an unstake rebalance order (lamports, u64) */
+    minRebalanceUnstakeDelta: BN;
+    /** Minimum transient stake to include in effective stake calculations (lamports, u64) */
+    transientThreshold: BN;
+    /**
+     * Minimum slots that must have elapsed in the epoch before late epoch operations can execute (u64)
+     */
+    minLateEpochSlotGate: BN;
+    /** Reserved u64[2] */
+    reservedU64: BN[];
+    /**
+     * Epochs a validator must wait in the graveyard before it is booted.
+     * This begins after the last recorded state change (u16)
+     */
+    cooldownEpochs: number;
+    /**
+     * Multiplier for deposit fee calculation (u16).
+     * Typically: avg_pay_rate * expected_warmup_epochs
+     */
+    depositFeeMultiplier: number;
+    /**
+     * Minimum VPP score required to enter the active validator set,
+     * fallback when the validator set is very small (u16)
+     */
+    minVppEntry: number;
+    /**
+     * VPP score threshold below which a validator is removed from active set,
+     * fallback threshold (u16)
+     */
+    minVppExit: number;
+    /**
+     * Max validators for "tiny" network band (uses fixed VPP thresholds) (u16)
+     */
+    tinyNetworkThreshold: number;
+    /**
+     * Max validators for "small" network band (uses percentile-based selection) (u16)
+     */
+    smallNetworkThreshold: number;
+    /**
+     * Max validators for "medium" network band (uses percentile-based selection) (u16)
+     */
+    mediumNetworkThreshold: number;
+    /**
+     * Fixed rank threshold to enter active set in large networks (0-indexed, u16)
+     */
+    largeNetworkEntryRank: number;
+    /**
+     * Fixed rank threshold to exit active set in large networks (0-indexed, u16)
+     */
+    largeNetworkExitRank: number;
+    /** Reserved u16[3] */
+    reservedU16: number[];
+    /**
+     * Percentile rank required to enter active set in small networks (u8)
+     */
+    smallNetworkEntryPercent: number;
+    /**
+     * Percentile rank below which validators exit in small networks (u8)
+     */
+    smallNetworkExitPercent: number;
+    /**
+     * Percentile rank required to enter active set in medium networks (u8)
+     */
+    mediumNetworkEntryPercent: number;
+    /**
+     * Percentile rank below which validators exit in medium networks (u8)
+     */
+    mediumNetworkExitPercent: number;
+    /** Reserved u8[2] */
+    reservedU8: number[];
+    /**
+     * Feature flags (u16 bitfield):
+     *  Bit 0: DepositsEnabled
+     *  Bit 1: WithdrawalsEnabled
+     *  Bit 2: ClaimWithdrawalsEnabled
+     *  Bit 3: ProcessStakeOrdersEnabled
+     *  Bit 4: ProcessUnstakeOrdersEnabled
+     *  Bit 5: ProcessPayCycleEnabled
+     *  Bit 6: RebalancingEnabled
+     *  Bits 7–15: Reserved
+     */
+    featureFlags: number;
+    /** Reserved flags (u16[1]) */
+    reservedFlags: number[];
+};
 /**
  * ============================================================
  *  Outpost / Pretoken Accounts
@@ -902,8 +1046,6 @@ type UserPretokenRecord = {
  * All price/supply fields use 8-decimal precision (SCALE = 1e8).
  */
 type TrancheState = {
-    /** Admin authority for tranche parameters */
-    admin: PublicKey$1;
     /** Current tranche number */
     currentTrancheNumber: BN;
     /** Remaining supply in the current tranche (8-decimal i128) */
@@ -916,8 +1058,8 @@ type TrancheState = {
     initialTrancheSupply: BN;
     /** Supply growth in basis points per tranche */
     supplyGrowthBps: number;
-    /** Price growth in basis points per tranche */
-    priceGrowthBps: number;
+    /** Price growth in cents per tranche (0.01 USD units) */
+    priceGrowthCents: number;
     /** Minimum valid SOL/USD price for Chainlink validation (8-decimal i128) */
     minPriceUsd: BN;
     /** Maximum valid SOL/USD price for Chainlink validation (8-decimal i128) */
@@ -1098,7 +1240,8 @@ type ValidatorRecord = {
 
 type types_DistributionState = DistributionState;
 type types_DistributionUserRecord = DistributionUserRecord;
-type types_Global = Global;
+type types_GlobalAccount = GlobalAccount;
+type types_GlobalConfig = GlobalConfig;
 type types_GlobalState = GlobalState;
 type types_LeaderboardState = LeaderboardState;
 type types_OutpostAccount = OutpostAccount;
@@ -1119,7 +1262,7 @@ type types_WalletLike = WalletLike;
 type types_WireReceipt = WireReceipt;
 type types_WireState = WireState;
 declare namespace types {
-  export type { types_DistributionState as DistributionState, types_DistributionUserRecord as DistributionUserRecord, types_Global as Global, types_GlobalState as GlobalState, types_LeaderboardState as LeaderboardState, types_OutpostAccount as OutpostAccount, types_OutpostWireStateSnapshot as OutpostWireStateSnapshot, types_ParsedAccountInfo as ParsedAccountInfo, types_PayRateEntry as PayRateEntry, types_PayRateHistory as PayRateHistory, types_PriceHistory as PriceHistory, types_Role as Role, types_SharesPreview as SharesPreview, types_SolanaTransaction as SolanaTransaction, types_TrancheState as TrancheState, types_UserPretokenRecord as UserPretokenRecord, types_ValidatorRecord as ValidatorRecord, types_ValidatorReputation as ValidatorReputation, types_ValidatorState as ValidatorState, types_WalletLike as WalletLike, types_WireReceipt as WireReceipt, types_WireState as WireState };
+  export type { types_DistributionState as DistributionState, types_DistributionUserRecord as DistributionUserRecord, types_GlobalAccount as GlobalAccount, types_GlobalConfig as GlobalConfig, types_GlobalState as GlobalState, types_LeaderboardState as LeaderboardState, types_OutpostAccount as OutpostAccount, types_OutpostWireStateSnapshot as OutpostWireStateSnapshot, types_ParsedAccountInfo as ParsedAccountInfo, types_PayRateEntry as PayRateEntry, types_PayRateHistory as PayRateHistory, types_PriceHistory as PriceHistory, types_Role as Role, types_SharesPreview as SharesPreview, types_SolanaTransaction as SolanaTransaction, types_TrancheState as TrancheState, types_UserPretokenRecord as UserPretokenRecord, types_ValidatorRecord as ValidatorRecord, types_ValidatorReputation as ValidatorReputation, types_ValidatorState as ValidatorState, types_WalletLike as WalletLike, types_WireReceipt as WireReceipt, types_WireState as WireState };
 }
 
 declare class DepositClient {
@@ -1173,6 +1316,18 @@ declare class DistributionClient {
      * IDL account name: "distributionState"
      */
     getDistributionState(): Promise<DistributionState | null>;
+    /**
+     * Fetch the global payRateHistory account (circular buffer of scaled pay rates).
+     *
+     * IDL account name: "payRateHistory"
+     */
+    getPayRateHistory(): Promise<PayRateHistory | null>;
+    /**
+     * Fetch the globalConfig account (contains depositFeeMultiplier, etc).
+     *
+     * IDL account name: "globalConfig"
+     */
+    getGlobalConfig(): Promise<GlobalConfig | null>;
     /**
      * Fetch a user's distribution userRecord (or null if missing).
      *
@@ -1197,6 +1352,13 @@ declare class DistributionClient {
         totalShares: BN;
         ratio: number;
     }>;
+    /**
+     * Compute an average scaled pay rate over the most recent `windowSize`
+     * valid entries in the pay-rate history circular buffer.
+     *
+     * Returns a BN scaled by 1e12 (same as on-chain).
+     */
+    getAverageScaledPayRate(windowSize?: number): Promise<BN>;
 }
 
 /**
@@ -1830,26 +1992,14 @@ type LiqsolCore = {
                     "name": "processingState";
                     "writable": true;
                 },
-                {
-                    "name": "controllerState";
-                    "docs": [
-                        "Stake controller state - used to verify authority"
-                    ];
-                },
                 {
                     "name": "globalConfig";
-                    "docs": [
-                        "Global config for cooldown_epochs"
-                    ];
                 },
                 {
                     "name": "clock";
                 },
                 {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match the stored authority in controller_state"
-                    ];
+                    "name": "cranky";
                     "writable": true;
                     "signer": true;
                 }
@@ -1873,6 +2023,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                 },
@@ -1915,6 +2068,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -2574,14 +2730,17 @@ type LiqsolCore = {
                     "name": "globalConfig";
                     "writable": true;
                 },
-                {
-                    "name": "controllerState";
-                },
                 {
                     "name": "payer";
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "program";
+                },
+                {
+                    "name": "programData";
+                },
                 {
                     "name": "systemProgram";
                 }
@@ -3065,17 +3224,10 @@ type LiqsolCore = {
             ];
             "accounts": [
                 {
-                    "name": "controllerState";
-                    "docs": [
-                        "Stake controller state - used to verify admin authority"
-                    ];
+                    "name": "globalConfig";
                 },
                 {
-                    "name": "admin";
-                    "docs": [
-                        "Admin must match the stored authority in controller_state"
-                    ];
-                    "writable": true;
+                    "name": "cranky";
                     "signer": true;
                 },
                 {
@@ -4101,6 +4253,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4142,6 +4297,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -4174,6 +4332,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -4188,6 +4349,62 @@ type LiqsolCore = {
             ];
             "args": [];
         },
+        {
+            "name": "setAdmin";
+            "discriminator": [
+                251,
+                163,
+                0,
+                52,
+                91,
+                194,
+                187,
+                92
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "newAuthority";
+                    "signer": true;
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "setCranky";
+            "discriminator": [
+                232,
+                48,
+                178,
+                74,
+                194,
+                60,
+                143,
+                164
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "newAuthority";
+                    "signer": true;
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "setLastStateChangeEpoch";
             "docs": [
@@ -4244,6 +4461,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4273,6 +4493,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4310,6 +4533,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4339,6 +4565,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4421,6 +4650,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                 },
@@ -4476,6 +4708,9 @@ type LiqsolCore = {
         },
         {
             "name": "syncLeaderboardScoresBatch";
+            "docs": [
+                "region: Validator Leaderboard Syncing"
+            ];
             "discriminator": [
                 52,
                 11,
@@ -4738,13 +4973,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -4781,13 +5010,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -4824,13 +5047,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -4867,13 +5084,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -4910,6 +5121,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -4928,7 +5142,7 @@ type LiqsolCore = {
                     "type": "u16";
                 },
                 {
-                    "name": "priceGrowthBps";
+                    "name": "priceGrowthCents";
                     "type": "u16";
                 }
             ];
@@ -4951,6 +5165,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -5415,118 +5632,8 @@ type LiqsolCore = {
     "errors": [
         {
             "code": 6000;
-            "name": "destinationAccountDoesNotExist";
-            "msg": "Destination stake account does not exist";
-        },
-        {
-            "code": 6001;
-            "name": "sourceAccountDoesNotExist";
-            "msg": "Source stake account does not exist";
-        },
-        {
-            "code": 6002;
-            "name": "invalidDestinationOwner";
-            "msg": "Destination account not owned by stake program";
-        },
-        {
-            "code": 6003;
-            "name": "invalidSourceOwner";
-            "msg": "Source account not owned by stake program";
-        },
-        {
-            "code": 6004;
-            "name": "clockBorrowFailed";
-            "msg": "Failed to borrow clock data";
-        },
-        {
-            "code": 6005;
-            "name": "clockDeserializeFailed";
-            "msg": "Failed to deserialize clock";
-        },
-        {
-            "code": 6006;
-            "name": "destinationAnalysisFailed";
-            "msg": "Failed to analyze destination stake account";
-        },
-        {
-            "code": 6007;
-            "name": "sourceAnalysisFailed";
-            "msg": "Failed to analyze source stake account";
-        },
-        {
-            "code": 6008;
-            "name": "destinationStillActivating";
-            "msg": "Destination stake is still activating";
-        },
-        {
-            "code": 6009;
-            "name": "destinationDeactivating";
-            "msg": "Destination stake is deactivating";
-        },
-        {
-            "code": 6010;
-            "name": "sourceStillActivating";
-            "msg": "Source stake is still activating";
-        },
-        {
-            "code": 6011;
-            "name": "sourceDeactivating";
-            "msg": "Source stake is deactivating";
-        },
-        {
-            "code": 6012;
-            "name": "destinationBorrowFailed";
-            "msg": "Failed to borrow destination account data";
-        },
-        {
-            "code": 6013;
-            "name": "destinationParseFailed";
-            "msg": "Failed to parse destination stake state";
-        },
-        {
-            "code": 6014;
-            "name": "sourceBorrowFailed";
-            "msg": "Failed to borrow source account data";
-        },
-        {
-            "code": 6015;
-            "name": "sourceParseFailed";
-            "msg": "Failed to parse source stake state";
-        },
-        {
-            "code": 6016;
-            "name": "differentValidators";
-            "msg": "Stakes are delegated to different validators";
-        },
-        {
-            "code": 6017;
-            "name": "differentStakers";
-            "msg": "Stakes have different staker authorities";
-        },
-        {
-            "code": 6018;
-            "name": "differentWithdrawers";
-            "msg": "Stakes have different withdrawer authorities";
-        },
-        {
-            "code": 6019;
-            "name": "authoritiesNotFound";
-            "msg": "Could not extract authorities from accounts";
-        },
-        {
-            "code": 6020;
-            "name": "mergeInstructionFailed";
-            "msg": "Merge instruction failed";
-        },
-        {
-            "code": 6021;
-            "name": "epochRewardsActive";
-            "msg": "Epoch rewards distribution is active - stake operations blocked";
-        },
-        {
-            "code": 6022;
-            "name": "differentCreditsObserved";
-            "msg": "Stakes have different credits_observed - cannot merge until both earn same rewards";
+            "name": "accountBorrowFailed";
+            "msg": "Util Acc borrow Failed";
         }
     ];
     "types": [
@@ -5912,8 +6019,7 @@ type LiqsolCore = {
         {
             "name": "globalConfig";
             "docs": [
-                "Zero-copy global config PDA",
-                "Authority is taken from StakeControllerState, not stored here"
+                "Zero-copy global config PDA"
             ];
             "serialization": "bytemuckunsafe";
             "repr": {
@@ -5935,6 +6041,23 @@ type LiqsolCore = {
                             ];
                         };
                     },
+                    {
+                        "name": "admin";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "cranky";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "reservedPubkey";
+                        "type": {
+                            "array": [
+                                "pubkey",
+                                1
+                            ];
+                        };
+                    },
                     {
                         "name": "minUserDeposit";
                         "docs": [
@@ -6121,10 +6244,6 @@ type LiqsolCore = {
             "type": {
                 "kind": "struct";
                 "fields": [
-                    {
-                        "name": "admin";
-                        "type": "pubkey";
-                    },
                     {
                         "name": "deployedAt";
                         "type": "i64";
@@ -7085,13 +7204,6 @@ type LiqsolCore = {
             "type": {
                 "kind": "struct";
                 "fields": [
-                    {
-                        "name": "admin";
-                        "docs": [
-                            "Admin authority (can update growth parameters and price bounds)"
-                        ];
-                        "type": "pubkey";
-                    },
                     {
                         "name": "currentTrancheNumber";
                         "type": "u64";
@@ -7120,9 +7232,9 @@ type LiqsolCore = {
                         "type": "u16";
                     },
                     {
-                        "name": "priceGrowthBps";
+                        "name": "priceGrowthCents";
                         "docs": [
-                            "Price growth in basis points (e.g., 200 = 2%, max 10000)"
+                            "Price growth in cents per tranche (0.01 USD units)"
                         ];
                         "type": "u16";
                     },
@@ -7734,7 +7846,7 @@ declare function buildSolanaTrancheLadder(options: {
     currentTrancheSupply: bigint;
     currentPriceUsd: bigint;
     supplyGrowthBps: number;
-    priceGrowthBps: number;
+    priceGrowthCents: number;
     windowBefore?: number;
     windowAfter?: number;
 }): TrancheLadderItem[];
@@ -7858,6 +7970,7 @@ interface ScheduleConfig {
     early?: number;
     late?: number;
 }
+declare function ceilDiv(n: BN, d: BN): BN;
 
 /**
  * OutpostClient
@@ -7986,6 +8099,7 @@ declare class TokenClient {
     getSolPriceUsd(): Promise<bigint>;
 }
 
+declare const SCALE: any;
 /**
  * Solana implementation of IStakingClient.
  *
@@ -8057,7 +8171,17 @@ declare class SolanaStakingClient implements IStakingClient {
      */
     getUserRecord(): Promise<DistributionUserRecord | null>;
     getSystemAPY(): Promise<number>;
-    getDepositFee(amount: bigint): Promise<bigint>;
+    /**
+     * Estimate the protocol deposit fee in lamports for a given SOL amount,
+     * based on recent pay rates and globalConfig.depositFeeMultiplier.
+     *
+     * - amountLamports: deposit notional in lamports
+     * - windowSize: how many recent payRate entries to average (default 5)
+     *
+     * Returns 0n if payRateHistory or globalConfig is missing, or if
+     * there are no valid pay-rate entries yet.
+     */
+    getDepositFee(amountLamports: bigint, windowSize?: number): Promise<bigint>;
     /**
      * Unified, chain-agnostic tranche snapshot for Solana.
      *
@@ -8073,6 +8197,26 @@ declare class SolanaStakingClient implements IStakingClient {
         windowBefore?: number;
         windowAfter?: number;
     }): Promise<TrancheSnapshot>;
+    /**
+     * Estimate a conservative SOL buffer (lamports) to leave in the wallet
+     * so the user can pay fees for the current deposit and at least one
+     * more transaction, plus a bit extra for future interactions.
+     *
+     * Intended usage in UI:
+     *   const bufferLamports = await client.estimateGasBuffer();
+     *   const maxSpendable = balanceLamports > bufferLamports
+     *       ? balanceLamports - bufferLamports
+     *       : 0n;
+     *
+     * @param options.txCount          How many transactions to cover (default 2)
+     * @param options.safetyMultiplier Extra safety multiplier (default 3x)
+     * @param options.minBufferLamports Optional override minimum buffer (default ~0.01 SOL)
+     */
+    estimateGasBuffer(options?: {
+        txCount?: number;
+        safetyMultiplier?: number;
+        minBufferLamports?: bigint;
+    }): Promise<bigint>;
     /**
      * Send a signed transaction over HTTP RPC and wait for confirmation.
      * Throws if the transaction fails.
@@ -8254,5 +8398,5 @@ declare const INDEX_SCALE: bigint;
 declare const lamportsToSol: (lamports: number | bigint) => number;
 declare const solToLamports: (sol: number) => bigint;
 
-export { ADDRESSES, CHAINLINK_FEED, CHAINLINK_PROGRAM, CONTRACTS, DEFAULT_AVERAGE_PAY_RATE, DEFAULT_PAY_RATE_LOOKBACK, DepositClient, DistributionClient, EPHEMERAL_RENT_EXEMPTION, ERC1155Abi, ERC20Abi, ERC721Abi, types$1 as ETH, EthereumContractService, EthereumStakingClient, INDEX_SCALE, LAMPORTS_PER_SOL, LIQSOL_CORE, LIQSOL_TOKEN, LeaderboardClient, OutpostClient, PAY_RATE_SCALE_FACTOR, PDA_SEEDS, PROGRAM_IDS, PurchaseAsset, ReceiptNFTKind, types as SOL, SolanaStakingClient, Staker, TRANSFER_HOOK, TokenClient, VALIDATOR_LEADERBOARD, airdropSol, buildOutpostAccounts, buildSolanaTrancheLadder, buildSolanaTrancheSnapshot, calculateExpectedFee, deriveBarConfigPda, deriveBondLevelPda, deriveBondedActorPda, deriveBucketAuthorityPda, deriveDepositAuthorityPda, deriveDistributionStatePda, deriveEphemeralStakeAddress, deriveExtraAccountMetaListPda, deriveGlobalConfigPda, deriveLeaderboardStatePda, deriveLiqReceiptDataPda, deriveLiqsolMintAuthorityPda, deriveLiqsolMintPda, deriveMaintenanceLedgerPda, deriveOutpostAccountPda, deriveOutpostGlobalStatePda, deriveOutpostPoolAuthorityPda, derivePayRateHistoryPda, derivePayoutStatePda, derivePriceHistoryPda, deriveReservePoolPda, deriveStakeAllocationStatePda, deriveStakeControllerStatePda, deriveStakeControllerVaultPda, deriveStakeMetricsPda, deriveTrancheStatePda, deriveUserPretokenRecordPda, deriveUserRecordPda, deriveValidatorRecordPda, deriveVaultPda, deriveWithdrawGlobalPda, deriveWithdrawMintAuthorityPda, deriveWithdrawMintMetadataPda, deriveWithdrawNftMintPda, generateRandomDepositAmount, generateTestKeypair, getAveragePayRate, getBucketLiqSolBalance, getEpochSnapshot, getErrorMessage, getLiqsolCoreProgram, getPayoutStateRaw, getReservePoolBalance, getStakeControllerStateRaw, getUserLiqSolBalance, getUserRecordRaw, lamportsToSol, msToEpochEnd, previewDepositEffects, scheduledInstruction, sleep, solToLamports, toBigint, tokensToShares, waitForConfirmation, waitUntilSafeToExecuteFunction };
+export { ADDRESSES, CHAINLINK_FEED, CHAINLINK_PROGRAM, CONTRACTS, DEFAULT_AVERAGE_PAY_RATE, DEFAULT_PAY_RATE_LOOKBACK, DepositClient, DistributionClient, EPHEMERAL_RENT_EXEMPTION, ERC1155Abi, ERC20Abi, ERC721Abi, types$1 as ETH, EthereumContractService, EthereumStakingClient, INDEX_SCALE, INITIAL_TRANCHE_SUPPLY, LAMPORTS_PER_SOL, LIQSOL_CORE, LIQSOL_TOKEN, LeaderboardClient, OutpostClient, PAY_RATE_SCALE_FACTOR, PDA_SEEDS, PROGRAM_IDS, PurchaseAsset, ReceiptNFTKind, SCALE, types as SOL, SolanaStakingClient, Staker, TRANSFER_HOOK, TokenClient, VALIDATOR_LEADERBOARD, airdropSol, buildOutpostAccounts, buildSolanaTrancheLadder, buildSolanaTrancheSnapshot, calculateExpectedFee, ceilDiv, deriveBarConfigPda, deriveBondLevelPda, deriveBondedActorPda, deriveBucketAuthorityPda, deriveDepositAuthorityPda, deriveDistributionStatePda, deriveEphemeralStakeAddress, deriveExtraAccountMetaListPda, deriveGlobalConfigPda, deriveLeaderboardStatePda, deriveLiqReceiptDataPda, deriveLiqsolMintAuthorityPda, deriveLiqsolMintPda, deriveMaintenanceLedgerPda, deriveOutpostAccountPda, deriveOutpostGlobalStatePda, deriveOutpostPoolAuthorityPda, derivePayRateHistoryPda, derivePayoutStatePda, derivePriceHistoryPda, deriveReservePoolPda, deriveStakeAllocationStatePda, deriveStakeControllerStatePda, deriveStakeControllerVaultPda, deriveStakeMetricsPda, deriveTrancheStatePda, deriveUserPretokenRecordPda, deriveUserRecordPda, deriveValidatorRecordPda, deriveVaultPda, deriveWithdrawGlobalPda, deriveWithdrawMintAuthorityPda, deriveWithdrawMintMetadataPda, deriveWithdrawNftMintPda, generateRandomDepositAmount, generateTestKeypair, getAveragePayRate, getBucketLiqSolBalance, getEpochSnapshot, getErrorMessage, getLiqsolCoreProgram, getPayoutStateRaw, getReservePoolBalance, getStakeControllerStateRaw, getUserLiqSolBalance, getUserRecordRaw, lamportsToSol, msToEpochEnd, previewDepositEffects, scheduledInstruction, sleep, solToLamports, toBigint, tokensToShares, waitForConfirmation, waitUntilSafeToExecuteFunction };
 export type { BalanceView, ContractConfig, ContractOptions, Contracts, EpochSnapshot, IStakingClient, OPPAssertion, OutpostAccounts, Portfolio, PurchaseQuote, ScheduleConfig, StakerConfig, TrancheLadderItem, TrancheSnapshot, YieldView };