@wireio/stake 0.5.0 → 0.5.2

package/lib/stake.d.ts

@@ -23,7 +23,7 @@ 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
@@ -43,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.
@@ -184,9 +192,8 @@ interface TrancheSnapshot {
     currentTranche: number;
     /** Current tranche price in USD (1e8 scale) */
     currentPriceUsd: bigint;
-    /** Tranche curve config (per-chain) */
     supplyGrowthBps: number;
-    priceIncrementUsd: number;
+    priceGrowthCents: number;
     totalPretokensSold: bigint;
     /** Current tranche supply state (1e8 scale) */
     currentTrancheSupply: bigint;
@@ -337,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;
@@ -412,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
@@ -435,6 +443,23 @@ 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;
 }
 
@@ -771,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 */
@@ -798,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) */
@@ -1023,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) */
@@ -1037,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) */
@@ -1219,7 +1240,7 @@ 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;
@@ -1241,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_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 };
+  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 {
@@ -1331,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>;
 }
 
 /**
@@ -1964,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;
                 }
@@ -2007,6 +2023,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                 },
@@ -2049,6 +2068,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -2708,14 +2730,17 @@ type LiqsolCore = {
                     "name": "globalConfig";
                     "writable": true;
                 },
-                {
-                    "name": "controllerState";
-                },
                 {
                     "name": "payer";
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "program";
+                },
+                {
+                    "name": "programData";
+                },
                 {
                     "name": "systemProgram";
                 }
@@ -3199,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;
                 },
                 {
@@ -4235,6 +4253,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4276,6 +4297,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -4308,6 +4332,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -4322,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": [
@@ -4378,6 +4461,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4407,6 +4493,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4444,6 +4533,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4473,6 +4565,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                     "writable": true;
@@ -4555,6 +4650,9 @@ type LiqsolCore = {
                     "name": "admin";
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "globalState";
                 },
@@ -4610,6 +4708,9 @@ type LiqsolCore = {
         },
         {
             "name": "syncLeaderboardScoresBatch";
+            "docs": [
+                "region: Validator Leaderboard Syncing"
+            ];
             "discriminator": [
                 52,
                 11,
@@ -4872,13 +4973,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -4915,13 +5010,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -4958,13 +5047,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -5001,13 +5084,7 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "controllerState";
-                },
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority must match StakeControllerState.authority"
-                    ];
+                    "name": "admin";
                     "signer": true;
                 }
             ];
@@ -5044,6 +5121,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -5062,7 +5142,7 @@ type LiqsolCore = {
                     "type": "u16";
                 },
                 {
-                    "name": "priceGrowthBps";
+                    "name": "priceGrowthCents";
                     "type": "u16";
                 }
             ];
@@ -5085,6 +5165,9 @@ type LiqsolCore = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "globalConfig";
+                },
                 {
                     "name": "trancheState";
                     "writable": true;
@@ -5549,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": [
@@ -6046,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": {
@@ -6069,6 +6041,23 @@ type LiqsolCore = {
                             ];
                         };
                     },
+                    {
+                        "name": "admin";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "cranky";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "reservedPubkey";
+                        "type": {
+                            "array": [
+                                "pubkey",
+                                1
+                            ];
+                        };
+                    },
                     {
                         "name": "minUserDeposit";
                         "docs": [
@@ -6255,10 +6244,6 @@ type LiqsolCore = {
             "type": {
                 "kind": "struct";
                 "fields": [
-                    {
-                        "name": "admin";
-                        "type": "pubkey";
-                    },
                     {
                         "name": "deployedAt";
                         "type": "i64";
@@ -7219,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";
@@ -7254,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";
                     },
@@ -7868,7 +7846,7 @@ declare function buildSolanaTrancheLadder(options: {
     currentTrancheSupply: bigint;
     currentPriceUsd: bigint;
     supplyGrowthBps: number;
-    priceGrowthBps: number;
+    priceGrowthCents: number;
     windowBefore?: number;
     windowAfter?: number;
 }): TrancheLadderItem[];
@@ -7992,6 +7970,7 @@ interface ScheduleConfig {
     early?: number;
     late?: number;
 }
+declare function ceilDiv(n: BN, d: BN): BN;
 
 /**
  * OutpostClient
@@ -8121,17 +8100,954 @@ declare class TokenClient {
 }
 
 /**
- * Solana implementation of IStakingClient.
- *
- * Responsibilities:
- *  - liqSOL deposit (SOL -> liqSOL)
- *  - withdraw requests (liqSOL -> NFT receipt / encumbered SOL)
- *  - Pretoken (WIRE) buys via liqSOL
- *  - Unified portfolio + tranche snapshot + balance correction (later)
+ * Program IDL in camelCase format in order to be used in JS/TS.
  *
- * This composes lower-level clients; it does not know about UI.
+ * Note that this is only a type helper and is not the actual IDL. The original
+ * IDL can be found at `target/idl/liqsol_token.json`.
  */
-declare class SolanaStakingClient implements IStakingClient {
+type LiqsolToken = {
+    "address": "5MRFSLCkXPEzfR6gkcZCVttq9g83mMUHyTZ85Z3TSpvU";
+    "metadata": {
+        "name": "liqsolToken";
+        "version": "0.1.0";
+        "spec": "0.1.0";
+        "description": "Liquidity Staking Token Program";
+    };
+    "instructions": [
+        {
+            "name": "createMintAccount";
+            "discriminator": [
+                76,
+                184,
+                50,
+                62,
+                162,
+                141,
+                47,
+                103
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "mintAuthority";
+                },
+                {
+                    "name": "receiver";
+                },
+                {
+                    "name": "mint";
+                    "docs": [
+                        "The mint PDA - deterministic address for liqSOL token"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "mintTokenAccount";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                },
+                {
+                    "name": "associatedTokenProgram";
+                },
+                {
+                    "name": "tokenProgram";
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "createMintAccountArgs";
+                        };
+                    };
+                }
+            ];
+        },
+        {
+            "name": "mintForAuthorizedProgram";
+            "discriminator": [
+                116,
+                208,
+                64,
+                189,
+                2,
+                60,
+                50,
+                41
+            ];
+            "accounts": [
+                {
+                    "name": "mint";
+                    "writable": true;
+                },
+                {
+                    "name": "recipientTokenAccount";
+                    "writable": true;
+                },
+                {
+                    "name": "programAuthority";
+                    "docs": [
+                        "The calling program's authority PDA that proves authorization to mint"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "mintAuthority";
+                },
+                {
+                    "name": "instructions";
+                },
+                {
+                    "name": "tokenProgram";
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "mintTokenArgs";
+                        };
+                    };
+                }
+            ];
+        }
+    ];
+    "errors": [
+        {
+            "code": 6000;
+            "name": "invalidMintAuthority";
+            "msg": "Invalid mint authority";
+        },
+        {
+            "code": 6001;
+            "name": "unauthorizedProgram";
+            "msg": "Unauthorized program attempting to mint";
+        },
+        {
+            "code": 6002;
+            "name": "cannotDetermineCallingProgram";
+            "msg": "Cannot determine calling program";
+        },
+        {
+            "code": 6003;
+            "name": "directCallNotAllowed";
+            "msg": "Direct calls not allowed, must be called via CPI";
+        },
+        {
+            "code": 6004;
+            "name": "invalidProgramId";
+            "msg": "Invalid program ID";
+        },
+        {
+            "code": 6005;
+            "name": "unauthorizedAuthority";
+            "msg": "Unauthorized authority PDA";
+        }
+    ];
+    "types": [
+        {
+            "name": "createMintAccountArgs";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "name";
+                        "type": "string";
+                    },
+                    {
+                        "name": "symbol";
+                        "type": "string";
+                    },
+                    {
+                        "name": "uri";
+                        "type": "string";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "mintTokenArgs";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    }
+                ];
+            };
+        }
+    ];
+};
+
+/**
+ * Program IDL in camelCase format in order to be used in JS/TS.
+ *
+ * Note that this is only a type helper and is not the actual IDL. The original
+ * IDL can be found at `target/idl/validator_leaderboard.json`.
+ */
+type ValidatorLeaderboard = {
+    "address": "5v7mWL1735qp2Th9B5WNf7spGynR5ZaxwyCYoQw13DP2";
+    "metadata": {
+        "name": "validatorLeaderboard";
+        "version": "0.1.0";
+        "spec": "0.1.0";
+        "description": "Created with Anchor";
+    };
+    "instructions": [
+        {
+            "name": "initializeLeaderboard";
+            "discriminator": [
+                47,
+                23,
+                34,
+                39,
+                46,
+                108,
+                91,
+                176
+            ];
+            "accounts": [
+                {
+                    "name": "authority";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "reallocLeaderboard";
+            "discriminator": [
+                2,
+                70,
+                106,
+                94,
+                81,
+                225,
+                113,
+                152
+            ];
+            "accounts": [
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "testClearLeaderboard";
+            "discriminator": [
+                118,
+                207,
+                26,
+                205,
+                180,
+                7,
+                75,
+                244
+            ];
+            "accounts": [
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                },
+                {
+                    "name": "authority";
+                    "signer": true;
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "testForceRegisterValidator";
+            "discriminator": [
+                136,
+                156,
+                132,
+                32,
+                96,
+                240,
+                7,
+                115
+            ];
+            "accounts": [
+                {
+                    "name": "registrant";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "voteAccount";
+                },
+                {
+                    "name": "validatorRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                },
+                {
+                    "name": "clock";
+                }
+            ];
+            "args": [
+                {
+                    "name": "vpp";
+                    "type": "u8";
+                }
+            ];
+        },
+        {
+            "name": "testForceUpdateVpp";
+            "discriminator": [
+                67,
+                51,
+                28,
+                174,
+                200,
+                214,
+                203,
+                162
+            ];
+            "accounts": [
+                {
+                    "name": "registrant";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "voteAccount";
+                },
+                {
+                    "name": "validatorRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "vpp";
+                    "type": "u8";
+                }
+            ];
+        },
+        {
+            "name": "testSeedRandomValidators";
+            "discriminator": [
+                48,
+                155,
+                181,
+                112,
+                163,
+                242,
+                43,
+                146
+            ];
+            "accounts": [
+                {
+                    "name": "registrant";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "count";
+                    "type": "u16";
+                },
+                {
+                    "name": "seed";
+                    "type": "u64";
+                },
+                {
+                    "name": "minVpp";
+                    "type": "u8";
+                },
+                {
+                    "name": "maxVpp";
+                    "type": "u8";
+                }
+            ];
+        },
+        {
+            "name": "updateCommission";
+            "discriminator": [
+                2,
+                202,
+                72,
+                156,
+                19,
+                253,
+                91,
+                174
+            ];
+            "accounts": [
+                {
+                    "name": "registrant";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "voteAccount";
+                },
+                {
+                    "name": "validatorRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "updateMevCommission";
+            "discriminator": [
+                107,
+                65,
+                238,
+                108,
+                183,
+                47,
+                236,
+                203
+            ];
+            "accounts": [
+                {
+                    "name": "signer";
+                    "signer": true;
+                },
+                {
+                    "name": "validatorRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "tipDistributionAccount";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "updateValidator";
+            "discriminator": [
+                105,
+                192,
+                4,
+                98,
+                236,
+                115,
+                108,
+                192
+            ];
+            "accounts": [
+                {
+                    "name": "registrant";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "voteAccount";
+                },
+                {
+                    "name": "validatorRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "leaderboardState";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [
+                {
+                    "name": "vpp";
+                    "type": "u8";
+                },
+                {
+                    "name": "proposedRank";
+                    "type": "u16";
+                }
+            ];
+        }
+    ];
+    "accounts": [
+        {
+            "name": "leaderboardState";
+            "discriminator": [
+                211,
+                181,
+                29,
+                120,
+                189,
+                4,
+                106,
+                111
+            ];
+        },
+        {
+            "name": "validatorRecord";
+            "discriminator": [
+                105,
+                248,
+                112,
+                34,
+                71,
+                224,
+                21,
+                71
+            ];
+        }
+    ];
+    "errors": [
+        {
+            "code": 6000;
+            "name": "missingPreviousValidator";
+            "msg": "Missing previous validator account";
+        },
+        {
+            "code": 6001;
+            "name": "missingNextValidator";
+            "msg": "Missing next validator account";
+        },
+        {
+            "code": 6002;
+            "name": "invalidVppScore";
+            "msg": "Invalid VPP score provided.";
+        },
+        {
+            "code": 6003;
+            "name": "invalidInsertPosition";
+            "msg": "Invalid insertion position.";
+        },
+        {
+            "code": 6004;
+            "name": "invalidCurrentPrev";
+            "msg": "Invalid current previous validator.";
+        },
+        {
+            "code": 6005;
+            "name": "invalidCurrentNext";
+            "msg": "Invalid current next validator.";
+        },
+        {
+            "code": 6006;
+            "name": "invalidHeadValidator";
+            "msg": "Head validator cannot have a previous validator";
+        },
+        {
+            "code": 6007;
+            "name": "invalidTailValidator";
+            "msg": "Tail validator cannot have a next validator";
+        },
+        {
+            "code": 6008;
+            "name": "validatorNotInLeaderboard";
+            "msg": "Cannot remove validator that is not in the leaderboard";
+        },
+        {
+            "code": 6009;
+            "name": "validatorAlreadyExists";
+            "msg": "Validator already exists in the leaderboard";
+        },
+        {
+            "code": 6010;
+            "name": "overflow";
+            "msg": "Arithmetic overflow";
+        },
+        {
+            "code": 6011;
+            "name": "invalidVoteAccount";
+            "msg": "Invalid vote account - must be owned by vote program";
+        },
+        {
+            "code": 6012;
+            "name": "vppVerificationFailed";
+            "msg": "VPP verification failed";
+        },
+        {
+            "code": 6013;
+            "name": "vppUnchanged";
+            "msg": "VPP score unchanged - update not needed";
+        },
+        {
+            "code": 6014;
+            "name": "invalidAccountCount";
+            "msg": "Invalid account count for top 10 verification";
+        },
+        {
+            "code": 6015;
+            "name": "invalidVppOrdering";
+            "msg": "Validators not in correct VPP order";
+        },
+        {
+            "code": 6016;
+            "name": "brokenLinkage";
+            "msg": "Broken linked list continuity";
+        },
+        {
+            "code": 6017;
+            "name": "commissionNotUpdated";
+            "msg": "Commission must be updated for current epoch before updating validator";
+        },
+        {
+            "code": 6018;
+            "name": "mevCommissionNotUpdated";
+            "msg": "MEV commission must be updated for current epoch before updating validator";
+        },
+        {
+            "code": 6019;
+            "name": "invalidCurrentNeighbor";
+            "msg": "Current neighbor account doesn't match validator's stored links";
+        },
+        {
+            "code": 6020;
+            "name": "nonAdjacentInsertionPosition";
+            "msg": "Insertion position accounts are not actually adjacent in leaderboard";
+        },
+        {
+            "code": 6021;
+            "name": "staleAccountReference";
+            "msg": "Account reference is outdated due to concurrent update";
+        },
+        {
+            "code": 6022;
+            "name": "invalidStakeAmount";
+            "msg": "Invalid stake amount - exceeds maximum allowed";
+        },
+        {
+            "code": 6023;
+            "name": "invalidTipDistributionAccount";
+            "msg": "Invalid Tip Distribution Account provided";
+        },
+        {
+            "code": 6024;
+            "name": "invalidRankPosition";
+            "msg": "Proposed rank position violates sorted ordering";
+        },
+        {
+            "code": 6025;
+            "name": "leaderboardFull";
+            "msg": "Leaderboard is full - cannot add more validators";
+        },
+        {
+            "code": 6026;
+            "name": "validatorNotInRankings";
+            "msg": "Validator not found in rankings";
+        },
+        {
+            "code": 6027;
+            "name": "arithmeticOverflow";
+            "msg": "Arithmetic overflow";
+        }
+    ];
+    "types": [
+        {
+            "name": "leaderboardState";
+            "docs": [
+                "Central leaderboard state using parallel arrays for efficient ranking and CPI access",
+                "Stores VPP scores and sorted rankings for up to 1024 validators",
+                "Uses zero-copy for efficient access from other programs via CPI"
+            ];
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "scores";
+                        "docs": [
+                            "VPP scores indexed by registry_index (0-100 range)",
+                            "registry_index is assigned on first validator registration and never changes"
+                        ];
+                        "type": {
+                            "array": [
+                                "u8",
+                                1024
+                            ];
+                        };
+                    },
+                    {
+                        "name": "sortedIndices";
+                        "docs": [
+                            "Validator indices sorted by VPP score descending",
+                            "sorted_indices[0] = registry_index of highest VPP validator",
+                            "sorted_indices[1] = registry_index of 2nd highest VPP validator, etc."
+                        ];
+                        "type": {
+                            "array": [
+                                "u16",
+                                1024
+                            ];
+                        };
+                    },
+                    {
+                        "name": "voteAccounts";
+                        "docs": [
+                            "Vote account pubkeys indexed by registry_index",
+                            "Allows CPI callers to get vote accounts for top N validators"
+                        ];
+                        "type": {
+                            "array": [
+                                {
+                                    "defined": {
+                                        "name": "pubkeyBytes";
+                                    };
+                                },
+                                1024
+                            ];
+                        };
+                    },
+                    {
+                        "name": "numValidators";
+                        "docs": [
+                            "Number of active validators currently in the leaderboard"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "PDA bump seed"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "padding";
+                        "docs": [
+                            "Reserved space for future upgrades"
+                        ];
+                        "type": {
+                            "array": [
+                                "u8",
+                                5
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "pubkeyBytes";
+            "docs": [
+                "Fixed-size representation of a `Pubkey` that satisfies Anchor's zero-copy rules.",
+                "Stores the raw 32-byte array and offers helpers to convert to/from `Pubkey`."
+            ];
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "transparent";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "bytes";
+                        "type": {
+                            "array": [
+                                "u8",
+                                32
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "validatorRecord";
+            "docs": [
+                "Per-validator record account storing commission data and metadata"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "voteAccount";
+                        "docs": [
+                            "The validator's vote account pubkey"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "registryIndex";
+                        "docs": [
+                            "Immutable index into LeaderboardState arrays",
+                            "Assigned on first registration, never changes"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "creditsObserved";
+                        "docs": [
+                            "Current cumulative credits from vote account"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "commissionHistory";
+                        "docs": [
+                            "Circular buffer of past 10 commission values (0-100)",
+                            "Used to penalize validators who increase commission"
+                        ];
+                        "type": {
+                            "array": [
+                                "u8",
+                                10
+                            ];
+                        };
+                    },
+                    {
+                        "name": "commissionIndex";
+                        "docs": [
+                            "Current index in commission_history circular buffer (0-9)"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "lastCommissionUpdate";
+                        "docs": [
+                            "Last epoch when commission was updated"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "epoch";
+                        "docs": [
+                            "Last epoch this validator was updated"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "slot";
+                        "docs": [
+                            "Last slot this validator was updated"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "wireOperator";
+                        "docs": [
+                            "Whether this validator is a Wire operator (5% bonus)"
+                        ];
+                        "type": "bool";
+                    },
+                    {
+                        "name": "mevCommission";
+                        "docs": [
+                            "Current MEV commission in basis points"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "mevCommissionHistory";
+                        "docs": [
+                            "Circular buffer of past 10 MEV commission values"
+                        ];
+                        "type": {
+                            "array": [
+                                "u16",
+                                10
+                            ];
+                        };
+                    },
+                    {
+                        "name": "mevCommissionIndex";
+                        "docs": [
+                            "Current index in mev_commission_history circular buffer (0-9)"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "lastMevCommissionUpdate";
+                        "docs": [
+                            "Last epoch when MEV commission was updated"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "bump";
+                        "docs": [
+                            "PDA bump seed"
+                        ];
+                        "type": "u8";
+                    }
+                ];
+            };
+        }
+    ];
+};
+
+type Entry<IDL> = {
+    idl: IDL & {
+        address: string;
+    };
+    address: string;
+};
+declare const PROGRAMS: {
+    readonly liqsolCore: Entry<LiqsolCore>;
+    readonly liqsolToken: Entry<LiqsolToken>;
+    readonly validatorLeaderboard: Entry<ValidatorLeaderboard>;
+};
+type SolanaProgramName = keyof typeof PROGRAMS;
+declare class SolanaProgramService {
+    private provider;
+    constructor(provider: AnchorProvider);
+    getProgram<K extends SolanaProgramName>(name: K): Program<(typeof PROGRAMS)[K]['idl']>;
+    listProgramNames(): SolanaProgramName[];
+}
+
+declare const SCALE: any;
+/**
+ * Solana implementation of IStakingClient.
+ *
+ * Responsibilities:
+ *  - liqSOL deposit (SOL -> liqSOL)
+ *  - withdraw requests (liqSOL -> NFT receipt / encumbered SOL)
+ *  - Pretoken (WIRE) buys via liqSOL
+ *  - Unified portfolio + tranche snapshot + balance correction (later)
+ *
+ * This composes lower-level clients; it does not know about UI.
+ */
+declare class SolanaStakingClient implements IStakingClient {
     private config;
     pubKey?: PublicKey;
     connection: Connection;
@@ -8141,6 +9057,7 @@ declare class SolanaStakingClient implements IStakingClient {
     leaderboardClient: LeaderboardClient;
     outpostClient: OutpostClient;
     tokenClient: TokenClient;
+    program: SolanaProgramService;
     get solPubKey(): PublicKey$1;
     get network(): ExternalNetwork;
     constructor(config: StakerConfig);
@@ -8190,7 +9107,28 @@ declare class SolanaStakingClient implements IStakingClient {
      * Used by balance-correction flows and debugging.
      */
     getUserRecord(): Promise<DistributionUserRecord | null>;
+    /**
+     * Returns the system APY (percent) for Solana,
+     * using compound interest per epoch and a
+     * cluster-derived epochs-per-year.
+     */
     getSystemAPY(): Promise<number>;
+    /**
+     * Reads the liqsol_core stakeMetrics account and returns the
+     * Solana per-epoch system rate as a **decimal** (not BPS),
+     * de-scaled using PAY_RATE_SCALE_FACTOR (1e12).
+     */
+    private getEpochRateDecimalFromProgram;
+    private epochsPerYearCache?;
+    private static readonly EPOCHS_PER_YEAR_TTL_MS;
+    /**
+     * Derive "epochs per year" from the live Solana cluster.
+     *
+     * Uses:
+     *  - getRecentPerformanceSamples() to estimate slots/second
+     *  - getEpochInfo() to read slotsInEpoch
+     */
+    private getEpochsPerYearFromCluster;
     /**
      * Estimate the protocol deposit fee in lamports for a given SOL amount,
      * based on recent pay rates and globalConfig.depositFeeMultiplier.
@@ -8217,6 +9155,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.
@@ -8245,7 +9203,6 @@ declare class SolanaStakingClient implements IStakingClient {
      * Ensures we have a Wire pubKey and an Anchor wallet pubKey, and that they match.
      */
     ensureUser(): void;
-    private ceilDiv;
 }
 
 /**
@@ -8399,5 +9356,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 };