@wireio/stake 0.4.1 → 0.4.3

package/lib/stake.d.ts

@@ -10,7 +10,7 @@ import { BN, AnchorProvider, Program } from '@coral-xyz/anchor';
 
 type StakerConfig = {
     network: ExternalNetwork;
-    provider: BaseSignerWalletAdapter | ethers.providers.Web3Provider;
+    provider?: BaseSignerWalletAdapter | ethers.providers.Web3Provider;
     pubKey?: PublicKey;
 };
 interface IStakingClient {
@@ -24,6 +24,8 @@ interface IStakingClient {
     buy(amount: bigint): Promise<string>;
     /** Fetch the complete user portfolio */
     getPortfolio(): Promise<Portfolio>;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amount: bigint): Promise<bigint>;
     /**
      * Program-level prelaunch WIRE/tranche snapshot for this chain.
      *
@@ -36,6 +38,8 @@ interface IStakingClient {
         windowBefore?: number;
         windowAfter?: number;
     }): Promise<TrancheSnapshot | null>;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amount: bigint): Promise<bigint>;
 }
 /**
  * Cross-chain portfolio view for a single account/wallet.
@@ -98,9 +102,9 @@ interface BalanceView {
     ata?: PublicKey$1;
 }
 /**
- * SOL / Outpost yield view.
+ * Outpost yield view.
  *
- * All amounts are integers in base units (lamports for liqSOL).
+ * All amounts are integers in base units (lamports for liqSOL, wei for liqETH).
  *
  * Math matches capital-staking:
  *   INDEX_SCALE      = 1e12
@@ -123,19 +127,19 @@ interface YieldView {
     /** User’s staked shares in the Outpost pool. */
     userShares: bigint;
     /**
-     * Total liqSOL (lamports) the user could claim right now if they fully
+     * Total liq (wei/lamports) the user could claim right now if they fully
      * unwound their stake:
-     *   estimatedClaimLiqsol = userShares * currentIndex / indexScale
+     *   estimatedClaim = userShares * currentIndex / indexScale
      */
-    estimatedClaimLiqsol: bigint;
+    estimatedClaim?: bigint;
     /**
-     * Portion of estimatedClaimLiqsol that is “yield” above principal:
-     *   estimatedYieldLiqsol = max(0, estimatedClaimLiqsol - stakedLiqsol)
+     * Portion of estimatedClaim that is “yield” above principal:
+     *   estimatedYield = max(0, estimatedClaim - staked)
      *
-     * NOTE: stakedLiqsol principal itself is surfaced separately as
+     * NOTE: staked principal itself is surfaced separately as
      *       Portfolio.staked.amount.
      */
-    estimatedYieldLiqsol: bigint;
+    estimatedYield?: bigint;
 }
 interface TrancheLadderItem {
     /** On-chain tranche id, 0-based (0,1,2,...) */
@@ -330,9 +334,9 @@ declare namespace types$1 {
 
 declare class EthereumStakingClient implements IStakingClient {
     private config;
-    readonly pubKey?: PublicKey;
     private readonly provider;
-    private readonly signer;
+    readonly pubKey?: PublicKey;
+    private readonly signer?;
     private readonly contractService;
     private convertClient;
     private pretokenClient;
@@ -388,15 +392,6 @@ declare class EthereumStakingClient implements IStakingClient {
      */
     unstakePrelaunch(tokenId: bigint, recipient: string): Promise<string>;
     buy(amount: bigint): Promise<string>;
-    getOPPMessages(address?: string): Promise<OPPAssertion[]>;
-    getOPPStatus(): Promise<any>;
-    /**
-     * ETH Prelaunch function to list the Stake ReceiptNFTs owned by a specific user
-     * @param address address to query the receipts for
-     * @returns array of receipts
-     */
-    fetchPrelaunchReceipts(address?: string): Promise<preLaunchReceipt[]>;
-    getEthStats(): Promise<any>;
     /**
      * Resolve the user's ETH + liqETH balances.
      *
@@ -405,8 +400,22 @@ declare class EthereumStakingClient implements IStakingClient {
      * tracked = liqETH tracked balance (protocol/accounting view)
      */
     getPortfolio(): Promise<Portfolio>;
+    /**
+     * ETH Prelaunch function to list the Stake ReceiptNFTs owned by a specific user
+     * @param address address to query the receipts for
+     * @returns array of receipts
+     */
+    fetchPrelaunchReceipts(address?: string): Promise<preLaunchReceipt[]>;
+    getOPPMessages(address?: string): Promise<OPPAssertion[]>;
+    private ensureUser;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amountWei: bigint): Promise<bigint>;
+    getOPPStatus(): Promise<any>;
+    getEthStats(): Promise<any>;
     /**
      * Program-level prelaunch WIRE / tranche snapshot for Ethereum
+     *
+     * SUPPORTS READ-ONLY ACcESS
      */
     getTrancheSnapshot(options?: {
         chainID?: ChainID;
@@ -1223,7 +1232,7 @@ declare class LeaderboardClient {
  * IDL can be found at `target/idl/liqsol_core.json`.
  */
 type LiqsolCore = {
-    "address": "2qSsCXBYUSwF7zrzTT9jFpRpCmWoDpEyHr9exfCMq56P";
+    "address": "5nBtmutQLrRKBUxNfHJPDjiW5u8id6QM9Hhjg1D1g1XH";
     "metadata": {
         "name": "liqsolCore";
         "version": "0.1.0";
@@ -1237,7 +1246,8 @@ type LiqsolCore = {
                 "Accumulate unstake requests to be processed in next allocation cycle",
                 "Multiple requests can be accumulated before calculating allocations",
                 "Returns the target epoch when this unstake request will be processed",
-                "We should not be able to"
+                "We should not be able to call this without development feature enabled",
+                ""
             ];
             "discriminator": [
                 24,
@@ -1274,6 +1284,12 @@ type LiqsolCore = {
                         "Maintenance ledger - to determine target processing epoch"
                     ];
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for min_unstake_request setting"
+                    ];
+                },
                 {
                     "name": "clock";
                 }
@@ -1325,6 +1341,12 @@ type LiqsolCore = {
                     "name": "processingState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for threshold parameters"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -1400,44 +1422,6 @@ type LiqsolCore = {
                 }
             ];
         },
-        {
-            "name": "advanceServiceability";
-            "docs": [
-                "Advance the max servicable receipt ID"
-            ];
-            "discriminator": [
-                139,
-                89,
-                79,
-                2,
-                90,
-                211,
-                173,
-                240
-            ];
-            "accounts": [
-                {
-                    "name": "authority";
-                    "docs": [
-                        "Authority that can update serviceable epoch"
-                    ];
-                    "signer": true;
-                },
-                {
-                    "name": "global";
-                    "writable": true;
-                },
-                {
-                    "name": "runtimeProgram";
-                }
-            ];
-            "args": [
-                {
-                    "name": "resolvedEpoch";
-                    "type": "u64";
-                }
-            ];
-        },
         {
             "name": "aggregateStakeMetrics";
             "docs": [
@@ -1598,6 +1582,12 @@ type LiqsolCore = {
                         "Maintenance ledger - to track last unstake allocation epoch"
                     ];
                     "writable": true;
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
                 }
             ];
             "args": [];
@@ -1661,6 +1651,12 @@ type LiqsolCore = {
                     "docs": [
                         "Global withdraw operator state - to read total_encumbered_funds"
                     ];
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for rebalancing thresholds"
+                    ];
                 }
             ];
             "args": [];
@@ -1783,6 +1779,12 @@ type LiqsolCore = {
                 {
                     "name": "stakeHistory";
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for claim_withdrawals_enabled check"
+                    ];
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -1834,6 +1836,12 @@ type LiqsolCore = {
                         "Stake controller state - used to verify authority"
                     ];
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for cooldown_epochs"
+                    ];
+                },
                 {
                     "name": "clock";
                 },
@@ -2169,6 +2177,12 @@ type LiqsolCore = {
                     "name": "controllerState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for deposit settings"
+                    ];
+                },
                 {
                     "name": "payoutState";
                     "writable": true;
@@ -2305,47 +2319,6 @@ type LiqsolCore = {
                 }
             ];
         },
-        {
-            "name": "forceValidatorUnstake";
-            "docs": [
-                "A function you can call to directly influence the amount to unstake from a particular validator",
-                "Tbh this is a bypass of the system and should not be called unless you know what you are doing"
-            ];
-            "discriminator": [
-                7,
-                208,
-                146,
-                241,
-                10,
-                219,
-                109,
-                30
-            ];
-            "accounts": [
-                {
-                    "name": "admin";
-                    "writable": true;
-                    "signer": true;
-                },
-                {
-                    "name": "validatorInfo";
-                    "docs": [
-                        "Validator info account to update"
-                    ];
-                    "writable": true;
-                }
-            ];
-            "args": [
-                {
-                    "name": "voteAccount";
-                    "type": "pubkey";
-                },
-                {
-                    "name": "amount";
-                    "type": "u64";
-                }
-            ];
-        },
         {
             "name": "getMinMaxResolvedEpochDeactivations";
             "docs": [
@@ -2584,6 +2557,37 @@ type LiqsolCore = {
             ];
             "args": [];
         },
+        {
+            "name": "initializeGlobalConfig";
+            "discriminator": [
+                113,
+                216,
+                122,
+                131,
+                225,
+                209,
+                22,
+                55
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "initializeGraveyardList";
             "docs": [
@@ -3104,6 +3108,10 @@ type LiqsolCore = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "withdrawGlobal";
+                    "writable": true;
+                },
                 {
                     "name": "stakeProgram";
                 },
@@ -3168,6 +3176,12 @@ type LiqsolCore = {
                     "name": "processingState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "clock";
                 },
@@ -3241,6 +3255,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "instructions";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for process_pay_cycle_enabled check"
+                    ];
                 }
             ];
             "args": [];
@@ -3312,6 +3332,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "rent";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for process_stake_orders_enabled check"
+                    ];
                 }
             ];
             "args": [];
@@ -3420,6 +3446,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "stakeProgram";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for process_unstake_orders_enabled check"
+                    ];
                 }
             ];
             "args": [];
@@ -3694,6 +3726,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "activeList";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
                 }
             ];
             "args": [];
@@ -3734,6 +3772,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "activeList";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
                 }
             ];
             "args": [];
@@ -3826,6 +3870,12 @@ type LiqsolCore = {
                 {
                     "name": "allocationState";
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -3956,6 +4006,12 @@ type LiqsolCore = {
                         "Maintenance ledger - for accumulate_unstake_request"
                     ];
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for min_unstake_request setting"
+                    ];
+                },
                 {
                     "name": "clock";
                 },
@@ -4333,6 +4389,12 @@ type LiqsolCore = {
                     "name": "allocationState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "systemProgram";
                     "docs": [
@@ -4399,6 +4461,12 @@ type LiqsolCore = {
                     "name": "maintenanceLedger";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -4407,37 +4475,32 @@ type LiqsolCore = {
             "args": [];
         },
         {
-            "name": "syncDistributionIndex";
+            "name": "syncLeaderboardScoresBatch";
             "discriminator": [
-                82,
-                159,
-                232,
-                125,
-                12,
-                29,
-                9,
-                226
+                52,
+                11,
+                210,
+                173,
+                90,
+                5,
+                48,
+                50
             ];
             "accounts": [
                 {
-                    "name": "authority";
-                    "docs": [
-                        "Admin or crank that triggers the index sync"
-                    ];
-                    "signer": true;
+                    "name": "leaderboardState";
                 },
                 {
-                    "name": "distributionState";
+                    "name": "processingState";
                     "writable": true;
                 },
                 {
-                    "name": "bucketAuthority";
-                    "docs": [
-                        "The bucket's associated token account holding liqSOL"
-                    ];
+                    "name": "maintenanceLedger";
+                    "writable": true;
                 },
                 {
-                    "name": "bucketTokenAccount";
+                    "name": "authority";
+                    "signer": true;
                 }
             ];
             "args": [];
@@ -4523,6 +4586,12 @@ type LiqsolCore = {
                     "name": "maintenanceLedger";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for min_vpp_entry and min_vpp_exit"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -4652,39 +4721,211 @@ type LiqsolCore = {
             "args": [];
         },
         {
-            "name": "updateGrowthParameters";
+            "name": "updateConfigBool";
             "discriminator": [
-                172,
-                187,
-                237,
-                233,
-                250,
-                160,
-                115,
-                239
+                79,
+                36,
+                65,
+                239,
+                188,
+                35,
+                13,
+                160
             ];
             "accounts": [
                 {
-                    "name": "admin";
-                    "writable": true;
-                    "signer": true;
-                },
-                {
-                    "name": "trancheState";
+                    "name": "globalConfig";
                     "writable": true;
                 },
                 {
-                    "name": "priceHistory";
-                    "writable": true;
+                    "name": "controllerState";
                 },
                 {
-                    "name": "systemProgram";
+                    "name": "authority";
+                    "docs": [
+                        "Authority must match StakeControllerState.authority"
+                    ];
+                    "signer": true;
                 }
             ];
             "args": [
                 {
-                    "name": "supplyGrowthBps";
-                    "type": "u16";
+                    "name": "key";
+                    "type": {
+                        "defined": {
+                            "name": "configKeyBool";
+                        };
+                    };
+                },
+                {
+                    "name": "value";
+                    "type": "bool";
+                }
+            ];
+        },
+        {
+            "name": "updateConfigU16";
+            "discriminator": [
+                149,
+                9,
+                244,
+                25,
+                46,
+                136,
+                59,
+                173
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "authority";
+                    "docs": [
+                        "Authority must match StakeControllerState.authority"
+                    ];
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "key";
+                    "type": {
+                        "defined": {
+                            "name": "configKeyU16";
+                        };
+                    };
+                },
+                {
+                    "name": "value";
+                    "type": "u16";
+                }
+            ];
+        },
+        {
+            "name": "updateConfigU64";
+            "discriminator": [
+                120,
+                43,
+                124,
+                106,
+                97,
+                80,
+                208,
+                123
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "authority";
+                    "docs": [
+                        "Authority must match StakeControllerState.authority"
+                    ];
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "key";
+                    "type": {
+                        "defined": {
+                            "name": "configKeyU64";
+                        };
+                    };
+                },
+                {
+                    "name": "value";
+                    "type": "u64";
+                }
+            ];
+        },
+        {
+            "name": "updateConfigU8";
+            "discriminator": [
+                17,
+                160,
+                31,
+                134,
+                222,
+                250,
+                229,
+                253
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "authority";
+                    "docs": [
+                        "Authority must match StakeControllerState.authority"
+                    ];
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "key";
+                    "type": {
+                        "defined": {
+                            "name": "configKeyU8";
+                        };
+                    };
+                },
+                {
+                    "name": "value";
+                    "type": "u8";
+                }
+            ];
+        },
+        {
+            "name": "updateGrowthParameters";
+            "discriminator": [
+                172,
+                187,
+                237,
+                233,
+                250,
+                160,
+                115,
+                239
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "trancheState";
+                    "writable": true;
+                },
+                {
+                    "name": "priceHistory";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [
+                {
+                    "name": "supplyGrowthBps";
+                    "type": "u16";
                 },
                 {
                     "name": "priceGrowthBps";
@@ -4725,11 +4966,11 @@ type LiqsolCore = {
             "args": [
                 {
                     "name": "minPriceUsd";
-                    "type": "i128";
+                    "type": "u64";
                 },
                 {
                     "name": "maxPriceUsd";
-                    "type": "i128";
+                    "type": "u64";
                 },
                 {
                     "name": "maxStalenessSeconds";
@@ -4778,6 +5019,19 @@ type LiqsolCore = {
                 127
             ];
         },
+        {
+            "name": "globalConfig";
+            "discriminator": [
+                149,
+                8,
+                156,
+                202,
+                160,
+                252,
+                176,
+                217
+            ];
+        },
         {
             "name": "globalState";
             "discriminator": [
@@ -5339,6 +5593,13 @@ type LiqsolCore = {
                         ];
                         "type": "u16";
                     },
+                    {
+                        "name": "leaderboardScoresNextIndex";
+                        "docs": [
+                            "Next leaderboard registry index to process for score sync"
+                        ];
+                        "type": "u16";
+                    },
                     {
                         "name": "removalNextIndex";
                         "docs": [
@@ -5386,6 +5647,130 @@ type LiqsolCore = {
                 ];
             };
         },
+        {
+            "name": "configKeyBool";
+            "docs": [
+                "Keys for bool config values (feature flags) - stored as bits in a u16",
+                "Bit positions: 0=Deposits, 1=Withdrawals, 2=ClaimWithdrawals, 3=ProcessStake,",
+                "4=ProcessUnstake, 5=ProcessPayCycle, 6=Rebalancing, 7-15=Reserved"
+            ];
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "depositsEnabled";
+                    },
+                    {
+                        "name": "withdrawalsEnabled";
+                    },
+                    {
+                        "name": "claimWithdrawalsEnabled";
+                    },
+                    {
+                        "name": "processStakeOrdersEnabled";
+                    },
+                    {
+                        "name": "processUnstakeOrdersEnabled";
+                    },
+                    {
+                        "name": "processPayCycleEnabled";
+                    },
+                    {
+                        "name": "rebalancingEnabled";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "configKeyU16";
+            "docs": [
+                "Keys for u16 config values (small counts, thresholds, ranks)"
+            ];
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "cooldownEpochs";
+                    },
+                    {
+                        "name": "depositFeeEpochsMultiplier";
+                    },
+                    {
+                        "name": "minVppEntry";
+                    },
+                    {
+                        "name": "minVppExit";
+                    },
+                    {
+                        "name": "tinyNetworkThreshold";
+                    },
+                    {
+                        "name": "smallNetworkThreshold";
+                    },
+                    {
+                        "name": "mediumNetworkThreshold";
+                    },
+                    {
+                        "name": "largeNetworkEntryRank";
+                    },
+                    {
+                        "name": "largeNetworkExitRank";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "configKeyU64";
+            "docs": [
+                "Keys for u64 config values (large amounts, rates)"
+            ];
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "minUserDeposit";
+                    },
+                    {
+                        "name": "minUnstakeRequest";
+                    },
+                    {
+                        "name": "minRebalanceStakeDelta";
+                    },
+                    {
+                        "name": "minRebalanceUnstakeDelta";
+                    },
+                    {
+                        "name": "transientThreshold";
+                    },
+                    {
+                        "name": "minLateEpochSlotGate";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "configKeyU8";
+            "docs": [
+                "Keys for u8 config values (percentages 0-100)"
+            ];
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "smallNetworkEntryPercent";
+                    },
+                    {
+                        "name": "smallNetworkExitPercent";
+                    },
+                    {
+                        "name": "mediumNetworkEntryPercent";
+                    },
+                    {
+                        "name": "mediumNetworkExitPercent";
+                    }
+                ];
+            };
+        },
         {
             "name": "distributionState";
             "type": {
@@ -5524,6 +5909,213 @@ type LiqsolCore = {
                 ];
             };
         },
+        {
+            "name": "globalConfig";
+            "docs": [
+                "Zero-copy global config PDA",
+                "Authority is taken from StakeControllerState, not stored here"
+            ];
+            "serialization": "bytemuckunsafe";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "bump";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "padding";
+                        "type": {
+                            "array": [
+                                "u8",
+                                7
+                            ];
+                        };
+                    },
+                    {
+                        "name": "minUserDeposit";
+                        "docs": [
+                            "Minimum SOL amount a user can deposit"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "minUnstakeRequest";
+                        "docs": [
+                            "Minimum SOL amount for an unstake/withdrawal request"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "minRebalanceStakeDelta";
+                        "docs": [
+                            "Minimum stake delta to trigger a stake rebalance order"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "minRebalanceUnstakeDelta";
+                        "docs": [
+                            "Minimum unstake delta to trigger an unstake rebalance order"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "transientThreshold";
+                        "docs": [
+                            "Minimum transient stake to include in effective stake calculations"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "minLateEpochSlotGate";
+                        "docs": [
+                            "Minimum slots that must have elapsed in the epoch before late epoch operations can execute"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "reservedU64";
+                        "type": {
+                            "array": [
+                                "u64",
+                                2
+                            ];
+                        };
+                    },
+                    {
+                        "name": "cooldownEpochs";
+                        "docs": [
+                            "Epochs a validator must wait in the graveyard before it is booted. This begins after the last recorded state change"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "depositFeeMultiplier";
+                        "docs": [
+                            "Multiplier for deposit fee calculation, this would be average \"pay rate x number of epochs we expect the stake to warm up\""
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "minVppEntry";
+                        "docs": [
+                            "Minimum VPP score required to enter the active validator set, this is a fall back for when the val set is really small"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "minVppExit";
+                        "docs": [
+                            "VPP score threshold below which a validator is removed from active set, again a fall back"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "tinyNetworkThreshold";
+                        "docs": [
+                            "Max validators for \"tiny\" network band (uses fixed VPP thresholds) as above"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "smallNetworkThreshold";
+                        "docs": [
+                            "Max validators for \"small\" network band (uses percentile-based selection)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "mediumNetworkThreshold";
+                        "docs": [
+                            "Max validators for \"medium\" network band (uses percentile-based selection)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "largeNetworkEntryRank";
+                        "docs": [
+                            "Fixed rank threshold to enter active set in large networks (0-indexed)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "largeNetworkExitRank";
+                        "docs": [
+                            "Fixed rank threshold to exit active set in large networks (0-indexed)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "reservedU16";
+                        "type": {
+                            "array": [
+                                "u16",
+                                3
+                            ];
+                        };
+                    },
+                    {
+                        "name": "smallNetworkEntryPercent";
+                        "docs": [
+                            "Percentile rank required to enter active set in small networks"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "smallNetworkExitPercent";
+                        "docs": [
+                            "Percentile rank below which validators exit in small networks"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "mediumNetworkEntryPercent";
+                        "docs": [
+                            "Percentile rank required to enter active set in medium networks"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "mediumNetworkExitPercent";
+                        "docs": [
+                            "Percentile rank below which validators exit in medium networks"
+                        ];
+                        "type": "u8";
+                    },
+                    {
+                        "name": "reservedU8";
+                        "type": {
+                            "array": [
+                                "u8",
+                                2
+                            ];
+                        };
+                    },
+                    {
+                        "name": "featureFlags";
+                        "docs": [
+                            "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"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "reservedFlags";
+                        "type": {
+                            "array": [
+                                "u16",
+                                1
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
         {
             "name": "globalState";
             "type": {
@@ -5790,6 +6382,10 @@ type LiqsolCore = {
                         "name": "lastValidatorScoreSyncEpoch";
                         "type": "u16";
                     },
+                    {
+                        "name": "lastLeaderboardScoresSyncEpoch";
+                        "type": "u16";
+                    },
                     {
                         "name": "lastActiveInfosSyncedEpoch";
                         "type": "u16";
@@ -6079,7 +6675,7 @@ type LiqsolCore = {
                     },
                     {
                         "name": "pretokensPurchased";
-                        "type": "i128";
+                        "type": "u64";
                     }
                 ];
             };
@@ -6107,7 +6703,7 @@ type LiqsolCore = {
                         ];
                         "type": {
                             "array": [
-                                "i128",
+                                "u64",
                                 10
                             ];
                         };
@@ -6283,6 +6879,30 @@ type LiqsolCore = {
                         ];
                         "type": "u64";
                     },
+                    {
+                        "name": "isSmallDistributionMode";
+                        "docs": [
+                            "Whether we're in small distribution mode (not enough for VPP-based distribution)",
+                            "In this mode, we distribute evenly to first N validators instead of using VPP ratios"
+                        ];
+                        "type": "bool";
+                    },
+                    {
+                        "name": "validatorsToFundThisRebalance";
+                        "docs": [
+                            "Number of validators to fund in small distribution mode",
+                            "Calculated as floor(total_to_distribute / MIN_STAKE_DELEGATION)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "amountPerValidatorThisRebalance";
+                        "docs": [
+                            "Amount each validator gets in small distribution mode",
+                            "Calculated as total_to_distribute / validators_to_fund"
+                        ];
+                        "type": "u64";
+                    },
                     {
                         "name": "selectionEntryThresholdVpp";
                         "docs": [
@@ -6459,8 +7079,7 @@ type LiqsolCore = {
         {
             "name": "trancheState";
             "docs": [
-                "All i128 values use 8-decimal precision (SCALE = 1e8 = 100,000,000)",
-                "This matches Chainlink SOL/USD's native format, avoiding conversion overhead",
+                "All u64 values use 8-decimal precision (SCALE = 1e8 = 100,000,000)",
                 "Example: $193.32 is stored as 19332000000"
             ];
             "type": {
@@ -6479,19 +7098,19 @@ type LiqsolCore = {
                     },
                     {
                         "name": "currentTrancheSupply";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "currentTranchePriceUsd";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "totalPretokensSold";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "initialTrancheSupply";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "supplyGrowthBps";
@@ -6512,14 +7131,14 @@ type LiqsolCore = {
                         "docs": [
                             "Minimum valid SOL/USD price for validation (8-dec)"
                         ];
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "maxPriceUsd";
                         "docs": [
                             "Maximum valid SOL/USD price for validation (8-dec)"
                         ];
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "maxStalenessSeconds";
@@ -6564,7 +7183,7 @@ type LiqsolCore = {
                     },
                     {
                         "name": "totalPretokensPurchased";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "lastTrancheNumber";
@@ -6572,7 +7191,7 @@ type LiqsolCore = {
                     },
                     {
                         "name": "lastTranchePriceUsd";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "bump";
@@ -7432,6 +8051,13 @@ declare class SolanaStakingClient implements IStakingClient {
      *  - extras: useful internal addresses and raw state for debugging/UX
      */
     getPortfolio(): Promise<Portfolio>;
+    /**
+     * Convenience helper to fetch the distribution userRecord for the current user.
+     * Used by balance-correction flows and debugging.
+     */
+    getUserRecord(): Promise<DistributionUserRecord | null>;
+    getSystemAPY(): Promise<number>;
+    getDepositFee(amount: bigint): Promise<bigint>;
     /**
      * Unified, chain-agnostic tranche snapshot for Solana.
      *
@@ -7447,11 +8073,6 @@ declare class SolanaStakingClient implements IStakingClient {
         windowBefore?: number;
         windowAfter?: number;
     }): Promise<TrancheSnapshot>;
-    /**
-     * Convenience helper to fetch the distribution userRecord for the current user.
-     * Used by balance-correction flows and debugging.
-     */
-    getUserRecord(): Promise<DistributionUserRecord | null>;
     /**
      * Send a signed transaction over HTTP RPC and wait for confirmation.
      * Throws if the transaction fails.
@@ -7479,7 +8100,7 @@ declare class SolanaStakingClient implements IStakingClient {
      * Guard for all write operations (deposit/withdraw/stake/unstake/buy).
      * Ensures we have a Wire pubKey and an Anchor wallet pubKey, and that they match.
      */
-    ensureWriteAccess(): void;
+    ensureUser(): void;
 }
 
 /**
@@ -7507,6 +8128,7 @@ declare const TRANSFER_HOOK: PublicKey$1;
  * ---------------------------------------------------------------------------
  */
 declare const PDA_SEEDS: {
+    readonly GLOBAL_CONFIG: "global_config";
     readonly DEPOSIT_AUTHORITY: "deposit_authority";
     readonly VAULT: "vault";
     readonly RESERVE_POOL: "reserve_pool";
@@ -7540,6 +8162,7 @@ declare const PDA_SEEDS: {
     readonly LIQ_RECEIPT_DATA: "liq_receipt_data";
     readonly WITHDRAW_MINT: "mint";
 };
+declare const deriveGlobalConfigPda: () => PublicKey$1;
 /**
  * ---------------------------------------------------------------------------
  *  CORE / DISTRIBUTION / DEPOSIT PDAS
@@ -7631,5 +8254,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, 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, 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 type { BalanceView, ContractConfig, ContractOptions, Contracts, EpochSnapshot, IStakingClient, OPPAssertion, OutpostAccounts, Portfolio, PurchaseQuote, ScheduleConfig, StakerConfig, TrancheLadderItem, TrancheSnapshot, YieldView };