@wireio/stake 0.4.2 → 0.5.0

package/lib/stake.d.ts

@@ -25,6 +25,11 @@ interface IStakingClient {
     /** Fetch the complete user portfolio */
     getPortfolio(): Promise<Portfolio>;
     getSystemAPY(): Promise<number>;
+    /**
+     * Protocol fee charged for deposit from Native to LIQ
+     * in Solana: amount in lamports
+     * in Ethereum: amount in wei
+     */
     getDepositFee(amount: bigint): Promise<bigint>;
     /**
      * Program-level prelaunch WIRE/tranche snapshot for this chain.
@@ -38,6 +43,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.
@@ -100,9 +107,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
@@ -125,19 +132,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,...) */
@@ -179,7 +186,7 @@ interface TrancheSnapshot {
     currentPriceUsd: bigint;
     /** Tranche curve config (per-chain) */
     supplyGrowthBps: number;
-    priceGrowthBps: number;
+    priceIncrementUsd: number;
     totalPretokensSold: bigint;
     /** Current tranche supply state (1e8 scale) */
     currentTrancheSupply: bigint;
@@ -246,7 +253,7 @@ declare class Staker {
     setChain(chainID: ChainID): boolean;
 }
 
-declare const CONTRACT_NAMES: readonly ["Accounting", "DepositManager", "LiqEth", "StakingModule", "WithdrawalQueue", "WithdrawalVault", "Depositor", "ReceiptNFT", "OutpostManager", "BAR", "OPP", "OPPCommon", "OPPInbound", "Pretoken", "Aggregator", "EthUsdPriceConsumer", "Pool"];
+declare const CONTRACT_NAMES: readonly ["LiqEthAuthority", "BeaconState", "WithdrawalQueue", "LiqEthToken", "Accounting", "DepositManager", "WithdrawalVault", "StakingModule", "YieldOracle", "OutpostManagerAuthority", "iodata", "Base58", "sysio_merkle", "ReceiptNFT", "MockAggregator", "Pool", "OutpostManager", "sysio_write", "EthUsdPriceConsumer", "BAR", "OPPCommon", "OPP", "Pretoken", "OPPInbound", "Depositor"];
 type ContractName = typeof CONTRACT_NAMES[number];
 type AddressBook = Record<ContractName, string>;
 interface Result {
@@ -342,23 +349,31 @@ declare class EthereumStakingClient implements IStakingClient {
     private oppClient;
     private receiptClient;
     get contract(): {
+        LiqEthAuthority: ethers.Contract;
+        BeaconState: ethers.Contract;
+        WithdrawalQueue: ethers.Contract;
+        LiqEthToken: ethers.Contract;
         Accounting: ethers.Contract;
         DepositManager: ethers.Contract;
-        LiqEth: ethers.Contract;
-        StakingModule: ethers.Contract;
-        WithdrawalQueue: ethers.Contract;
         WithdrawalVault: ethers.Contract;
-        Depositor: ethers.Contract;
+        StakingModule: ethers.Contract;
+        YieldOracle: ethers.Contract;
+        OutpostManagerAuthority: ethers.Contract;
+        iodata: ethers.Contract;
+        Base58: ethers.Contract;
+        sysio_merkle: ethers.Contract;
         ReceiptNFT: ethers.Contract;
+        MockAggregator: ethers.Contract;
+        Pool: ethers.Contract;
         OutpostManager: ethers.Contract;
+        sysio_write: ethers.Contract;
+        EthUsdPriceConsumer: ethers.Contract;
         BAR: ethers.Contract;
-        OPP: ethers.Contract;
         OPPCommon: ethers.Contract;
-        OPPInbound: ethers.Contract;
+        OPP: ethers.Contract;
         Pretoken: ethers.Contract;
-        Aggregator: ethers.Contract;
-        EthUsdPriceConsumer: ethers.Contract;
-        Pool: ethers.Contract;
+        OPPInbound: ethers.Contract;
+        Depositor: ethers.Contract;
     };
     get network(): _wireio_core.ExternalNetwork;
     constructor(config: StakerConfig);
@@ -407,7 +422,7 @@ declare class EthereumStakingClient implements IStakingClient {
     getOPPMessages(address?: string): Promise<OPPAssertion[]>;
     private ensureUser;
     getSystemAPY(): Promise<number>;
-    getDepositFee(amount: bigint): Promise<bigint>;
+    getDepositFee(amountWei: bigint): Promise<bigint>;
     getOPPStatus(): Promise<any>;
     getEthStats(): Promise<any>;
     /**
@@ -423,6 +438,12 @@ declare class EthereumStakingClient implements IStakingClient {
     private updateMockAggregatorPrice;
 }
 
+/**
+ * @module EthereumContractService
+ *
+ * Provides a unified service for interacting with Ethereum smart contracts using ethers.js.
+ */
+
 declare const ERC20Abi: ({
     inputs: {
         internalType: string;
@@ -823,6 +844,108 @@ type GlobalState = {
     /** PDA bump */
     bump: number;
 };
+/**
+ * IDL: `globalConfig`
+ *
+ * Zero-copy global config PDA.
+ * Authority is taken from StakeControllerState, not stored here.
+ */
+type GlobalConfig = {
+    /** PDA bump */
+    bump: number;
+    /** 7-byte padding (unused) */
+    padding: number[];
+    /** Minimum SOL amount a user can deposit (lamports, u64) */
+    minUserDeposit: BN;
+    /** Minimum SOL amount for an unstake/withdrawal request (lamports, u64) */
+    minUnstakeRequest: BN;
+    /** Minimum stake delta to trigger a stake rebalance order (lamports, u64) */
+    minRebalanceStakeDelta: BN;
+    /** Minimum unstake delta to trigger an unstake rebalance order (lamports, u64) */
+    minRebalanceUnstakeDelta: BN;
+    /** Minimum transient stake to include in effective stake calculations (lamports, u64) */
+    transientThreshold: BN;
+    /**
+     * Minimum slots that must have elapsed in the epoch before late epoch operations can execute (u64)
+     */
+    minLateEpochSlotGate: BN;
+    /** Reserved u64[2] */
+    reservedU64: BN[];
+    /**
+     * Epochs a validator must wait in the graveyard before it is booted.
+     * This begins after the last recorded state change (u16)
+     */
+    cooldownEpochs: number;
+    /**
+     * Multiplier for deposit fee calculation (u16).
+     * Typically: avg_pay_rate * expected_warmup_epochs
+     */
+    depositFeeMultiplier: number;
+    /**
+     * Minimum VPP score required to enter the active validator set,
+     * fallback when the validator set is very small (u16)
+     */
+    minVppEntry: number;
+    /**
+     * VPP score threshold below which a validator is removed from active set,
+     * fallback threshold (u16)
+     */
+    minVppExit: number;
+    /**
+     * Max validators for "tiny" network band (uses fixed VPP thresholds) (u16)
+     */
+    tinyNetworkThreshold: number;
+    /**
+     * Max validators for "small" network band (uses percentile-based selection) (u16)
+     */
+    smallNetworkThreshold: number;
+    /**
+     * Max validators for "medium" network band (uses percentile-based selection) (u16)
+     */
+    mediumNetworkThreshold: number;
+    /**
+     * Fixed rank threshold to enter active set in large networks (0-indexed, u16)
+     */
+    largeNetworkEntryRank: number;
+    /**
+     * Fixed rank threshold to exit active set in large networks (0-indexed, u16)
+     */
+    largeNetworkExitRank: number;
+    /** Reserved u16[3] */
+    reservedU16: number[];
+    /**
+     * Percentile rank required to enter active set in small networks (u8)
+     */
+    smallNetworkEntryPercent: number;
+    /**
+     * Percentile rank below which validators exit in small networks (u8)
+     */
+    smallNetworkExitPercent: number;
+    /**
+     * Percentile rank required to enter active set in medium networks (u8)
+     */
+    mediumNetworkEntryPercent: number;
+    /**
+     * Percentile rank below which validators exit in medium networks (u8)
+     */
+    mediumNetworkExitPercent: number;
+    /** Reserved u8[2] */
+    reservedU8: number[];
+    /**
+     * Feature flags (u16 bitfield):
+     *  Bit 0: DepositsEnabled
+     *  Bit 1: WithdrawalsEnabled
+     *  Bit 2: ClaimWithdrawalsEnabled
+     *  Bit 3: ProcessStakeOrdersEnabled
+     *  Bit 4: ProcessUnstakeOrdersEnabled
+     *  Bit 5: ProcessPayCycleEnabled
+     *  Bit 6: RebalancingEnabled
+     *  Bits 7–15: Reserved
+     */
+    featureFlags: number;
+    /** Reserved flags (u16[1]) */
+    reservedFlags: number[];
+};
 /**
  * ============================================================
  *  Outpost / Pretoken Accounts
@@ -1097,6 +1220,7 @@ type ValidatorRecord = {
 type types_DistributionState = DistributionState;
 type types_DistributionUserRecord = DistributionUserRecord;
 type types_Global = Global;
+type types_GlobalConfig = GlobalConfig;
 type types_GlobalState = GlobalState;
 type types_LeaderboardState = LeaderboardState;
 type types_OutpostAccount = OutpostAccount;
@@ -1117,7 +1241,7 @@ type types_WalletLike = WalletLike;
 type types_WireReceipt = WireReceipt;
 type types_WireState = WireState;
 declare namespace types {
-  export type { types_DistributionState as DistributionState, types_DistributionUserRecord as DistributionUserRecord, types_Global as Global, types_GlobalState as GlobalState, types_LeaderboardState as LeaderboardState, types_OutpostAccount as OutpostAccount, types_OutpostWireStateSnapshot as OutpostWireStateSnapshot, types_ParsedAccountInfo as ParsedAccountInfo, types_PayRateEntry as PayRateEntry, types_PayRateHistory as PayRateHistory, types_PriceHistory as PriceHistory, types_Role as Role, types_SharesPreview as SharesPreview, types_SolanaTransaction as SolanaTransaction, types_TrancheState as TrancheState, types_UserPretokenRecord as UserPretokenRecord, types_ValidatorRecord as ValidatorRecord, types_ValidatorReputation as ValidatorReputation, types_ValidatorState as ValidatorState, types_WalletLike as WalletLike, types_WireReceipt as WireReceipt, types_WireState as WireState };
+  export type { types_DistributionState as DistributionState, types_DistributionUserRecord as DistributionUserRecord, types_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 };
 }
 
 declare class DepositClient {
@@ -1171,6 +1295,18 @@ declare class DistributionClient {
      * IDL account name: "distributionState"
      */
     getDistributionState(): Promise<DistributionState | null>;
+    /**
+     * Fetch the global payRateHistory account (circular buffer of scaled pay rates).
+     *
+     * IDL account name: "payRateHistory"
+     */
+    getPayRateHistory(): Promise<PayRateHistory | null>;
+    /**
+     * Fetch the globalConfig account (contains depositFeeMultiplier, etc).
+     *
+     * IDL account name: "globalConfig"
+     */
+    getGlobalConfig(): Promise<GlobalConfig | null>;
     /**
      * Fetch a user's distribution userRecord (or null if missing).
      *
@@ -1230,7 +1366,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";
@@ -1244,7 +1380,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,
@@ -1281,6 +1418,12 @@ type LiqsolCore = {
                         "Maintenance ledger - to determine target processing epoch"
                     ];
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for min_unstake_request setting"
+                    ];
+                },
                 {
                     "name": "clock";
                 }
@@ -1332,6 +1475,12 @@ type LiqsolCore = {
                     "name": "processingState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for threshold parameters"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -1407,44 +1556,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": [
@@ -1605,6 +1716,12 @@ type LiqsolCore = {
                         "Maintenance ledger - to track last unstake allocation epoch"
                     ];
                     "writable": true;
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
                 }
             ];
             "args": [];
@@ -1668,6 +1785,12 @@ type LiqsolCore = {
                     "docs": [
                         "Global withdraw operator state - to read total_encumbered_funds"
                     ];
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for rebalancing thresholds"
+                    ];
                 }
             ];
             "args": [];
@@ -1790,6 +1913,12 @@ type LiqsolCore = {
                 {
                     "name": "stakeHistory";
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for claim_withdrawals_enabled check"
+                    ];
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -1841,6 +1970,12 @@ type LiqsolCore = {
                         "Stake controller state - used to verify authority"
                     ];
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for cooldown_epochs"
+                    ];
+                },
                 {
                     "name": "clock";
                 },
@@ -2176,6 +2311,12 @@ type LiqsolCore = {
                     "name": "controllerState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for deposit settings"
+                    ];
+                },
                 {
                     "name": "payoutState";
                     "writable": true;
@@ -2312,47 +2453,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": [
@@ -2591,6 +2691,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": [
@@ -3111,6 +3242,10 @@ type LiqsolCore = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "withdrawGlobal";
+                    "writable": true;
+                },
                 {
                     "name": "stakeProgram";
                 },
@@ -3175,6 +3310,12 @@ type LiqsolCore = {
                     "name": "processingState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "clock";
                 },
@@ -3248,6 +3389,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "instructions";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for process_pay_cycle_enabled check"
+                    ];
                 }
             ];
             "args": [];
@@ -3319,6 +3466,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "rent";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for process_stake_orders_enabled check"
+                    ];
                 }
             ];
             "args": [];
@@ -3427,6 +3580,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "stakeProgram";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for process_unstake_orders_enabled check"
+                    ];
                 }
             ];
             "args": [];
@@ -3701,6 +3860,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "activeList";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
                 }
             ];
             "args": [];
@@ -3741,6 +3906,12 @@ type LiqsolCore = {
                 },
                 {
                     "name": "activeList";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
                 }
             ];
             "args": [];
@@ -3833,6 +4004,12 @@ type LiqsolCore = {
                 {
                     "name": "allocationState";
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -3963,6 +4140,12 @@ type LiqsolCore = {
                         "Maintenance ledger - for accumulate_unstake_request"
                     ];
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for min_unstake_request setting"
+                    ];
+                },
                 {
                     "name": "clock";
                 },
@@ -4340,6 +4523,12 @@ type LiqsolCore = {
                     "name": "allocationState";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "systemProgram";
                     "docs": [
@@ -4406,6 +4595,12 @@ type LiqsolCore = {
                     "name": "maintenanceLedger";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -4414,37 +4609,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": [];
@@ -4530,6 +4720,12 @@ type LiqsolCore = {
                     "name": "maintenanceLedger";
                     "writable": true;
                 },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for min_vpp_entry and min_vpp_exit"
+                    ];
+                },
                 {
                     "name": "authority";
                     "signer": true;
@@ -4658,6 +4854,178 @@ type LiqsolCore = {
             ];
             "args": [];
         },
+        {
+            "name": "updateConfigBool";
+            "discriminator": [
+                79,
+                36,
+                65,
+                239,
+                188,
+                35,
+                13,
+                160
+            ];
+            "accounts": [
+                {
+                    "name": "globalConfig";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "authority";
+                    "docs": [
+                        "Authority must match StakeControllerState.authority"
+                    ];
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "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": [
@@ -4732,11 +5100,11 @@ type LiqsolCore = {
             "args": [
                 {
                     "name": "minPriceUsd";
-                    "type": "i128";
+                    "type": "u64";
                 },
                 {
                     "name": "maxPriceUsd";
-                    "type": "i128";
+                    "type": "u64";
                 },
                 {
                     "name": "maxStalenessSeconds";
@@ -4785,6 +5153,19 @@ type LiqsolCore = {
                 127
             ];
         },
+        {
+            "name": "globalConfig";
+            "discriminator": [
+                149,
+                8,
+                156,
+                202,
+                160,
+                252,
+                176,
+                217
+            ];
+        },
         {
             "name": "globalState";
             "discriminator": [
@@ -5346,6 +5727,13 @@ type LiqsolCore = {
                         ];
                         "type": "u16";
                     },
+                    {
+                        "name": "leaderboardScoresNextIndex";
+                        "docs": [
+                            "Next leaderboard registry index to process for score sync"
+                        ];
+                        "type": "u16";
+                    },
                     {
                         "name": "removalNextIndex";
                         "docs": [
@@ -5393,6 +5781,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": {
@@ -5531,6 +6043,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": {
@@ -5797,6 +6516,10 @@ type LiqsolCore = {
                         "name": "lastValidatorScoreSyncEpoch";
                         "type": "u16";
                     },
+                    {
+                        "name": "lastLeaderboardScoresSyncEpoch";
+                        "type": "u16";
+                    },
                     {
                         "name": "lastActiveInfosSyncedEpoch";
                         "type": "u16";
@@ -6086,7 +6809,7 @@ type LiqsolCore = {
                     },
                     {
                         "name": "pretokensPurchased";
-                        "type": "i128";
+                        "type": "u64";
                     }
                 ];
             };
@@ -6114,7 +6837,7 @@ type LiqsolCore = {
                         ];
                         "type": {
                             "array": [
-                                "i128",
+                                "u64",
                                 10
                             ];
                         };
@@ -6290,6 +7013,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": [
@@ -6466,8 +7213,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": {
@@ -6486,19 +7232,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";
@@ -6519,14 +7265,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";
@@ -6571,7 +7317,7 @@ type LiqsolCore = {
                     },
                     {
                         "name": "totalPretokensPurchased";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "lastTrancheNumber";
@@ -6579,7 +7325,7 @@ type LiqsolCore = {
                     },
                     {
                         "name": "lastTranchePriceUsd";
-                        "type": "i128";
+                        "type": "u64";
                     },
                     {
                         "name": "bump";
@@ -7445,7 +8191,17 @@ declare class SolanaStakingClient implements IStakingClient {
      */
     getUserRecord(): Promise<DistributionUserRecord | null>;
     getSystemAPY(): Promise<number>;
-    getDepositFee(amount: bigint): Promise<bigint>;
+    /**
+     * Estimate the protocol deposit fee in lamports for a given SOL amount,
+     * based on recent pay rates and globalConfig.depositFeeMultiplier.
+     *
+     * - amountLamports: deposit notional in lamports
+     * - windowSize: how many recent payRate entries to average (default 5)
+     *
+     * Returns 0n if payRateHistory or globalConfig is missing, or if
+     * there are no valid pay-rate entries yet.
+     */
+    getDepositFee(amountLamports: bigint, windowSize?: number): Promise<bigint>;
     /**
      * Unified, chain-agnostic tranche snapshot for Solana.
      *
@@ -7489,6 +8245,7 @@ declare class SolanaStakingClient implements IStakingClient {
      * Ensures we have a Wire pubKey and an Anchor wallet pubKey, and that they match.
      */
     ensureUser(): void;
+    private ceilDiv;
 }
 
 /**
@@ -7516,6 +8273,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";
@@ -7549,6 +8307,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
@@ -7640,5 +8399,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 };