@wireio/stake 2.3.0 → 2.4.0

package/lib/stake.d.ts

@@ -41,6 +41,8 @@ interface IStakingClient {
     buy(amount: bigint): Promise<string>;
     /** Claim a withdrawal receipt (burn NFT + receive ETH/SOL) via claim_withdraw. */
     claimWithdraw(tokenId: bigint): Promise<string>;
+    /** Solana only: claim accrued liqSOL distribution rewards. */
+    claimLiqsolRewards?(): Promise<string>;
     /** Enumerate withdrawal receipt NFTs held by the user (queued/ready/claimed). */
     getPendingWithdraws(): Promise<WithdrawReceipt$1[]>;
     /** Fetch the complete user portfolio */
@@ -91,6 +93,11 @@ interface Portfolio {
     native: BalanceView;
     /** Liquid staking token balance (LiqETH, LiqSOL, etc.). */
     liq: BalanceView;
+    /**
+     * Solana-only liqSOL rewards currently claimable from the distribution bucket.
+     * Not populated on Ethereum.
+     */
+    claimable?: BalanceView;
     /**
      * Outpost-staked balance:
      *  - On Solana: liqSOL staked via `synd` (stakedLiqsol, in lamports).
@@ -445,6 +452,7 @@ declare class EthereumStakingClient implements IStakingClient {
         MockAggregator: ethers.Contract;
     };
     get network(): _wireio_core.ExternalNetwork;
+    get address(): Promise<string> | undefined;
     constructor(config: StakerConfig);
     /**
      * Deposit native ETH into the liqETH protocol via DepositManager.
@@ -931,10 +939,10 @@ type GlobalState = {
      */
     currentIndex: BN;
     /**
-     * Last observed liqSOL pool balance
-     * used for computing incremental yield.
+     * Replaced legacy `lastPoolLiqsolBalance`
+     * with expected balance based on total shares and current index.
      */
-    lastPoolLiqsolBalance: BN;
+    expectedPoolBalance: BN;
     /**
      * Accumulated liqSOL yield available to the protocol
      * (used for `purchaseFromYield`-style flows).
@@ -1425,6 +1433,7 @@ declare const PDA_SEEDS: {
     readonly MINT_METADATA: "mint_metadata";
     readonly LIQ_RECEIPT_DATA: "liq_receipt_data";
     readonly WITHDRAW_MINT: "mint";
+    readonly PRETOKEN_PURCHASE_HISTORY: "pretoken_purchase_history";
 };
 /**
  * Ephemeral stake account address seed helper
@@ -1517,6 +1526,51 @@ type LiqsolCore$1 = {
             ];
             "args": [];
         },
+        {
+            "name": "adminForceUnbondRole";
+            "discriminator": [
+                80,
+                107,
+                27,
+                49,
+                126,
+                25,
+                31,
+                238
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "globalState";
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose role bond is being force-unbonded"
+                    ];
+                },
+                {
+                    "name": "outpostAccount";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "role";
+                    "type": {
+                        "defined": {
+                            "name": "role";
+                        };
+                    };
+                }
+            ];
+        },
         {
             "name": "aggregateStakeMetrics";
             "docs": [
@@ -2282,6 +2336,72 @@ type LiqsolCore$1 = {
                 }
             ];
         },
+        {
+            "name": "depositToReserve";
+            "discriminator": [
+                8,
+                79,
+                123,
+                129,
+                146,
+                140,
+                178,
+                128
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "depositor";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "reservePool";
+                    "writable": true;
+                },
+                {
+                    "name": "vault";
+                },
+                {
+                    "name": "ephemeralStake";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "stakeProgram";
+                },
+                {
+                    "name": "systemProgram";
+                },
+                {
+                    "name": "clock";
+                },
+                {
+                    "name": "stakeHistory";
+                },
+                {
+                    "name": "rent";
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                },
+                {
+                    "name": "seed";
+                    "type": "u32";
+                }
+            ];
+        },
         {
             "name": "desynd";
             "discriminator": [
@@ -2358,6 +2478,10 @@ type LiqsolCore$1 = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -2399,6 +2523,44 @@ type LiqsolCore$1 = {
             "args": [];
             "returns": "u16";
         },
+        {
+            "name": "hasRole";
+            "discriminator": [
+                218,
+                136,
+                44,
+                87,
+                142,
+                247,
+                141,
+                195
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "docs": [
+                        "User whose role status is being checked."
+                    ];
+                },
+                {
+                    "name": "outpostAccount";
+                },
+                {
+                    "name": "globalState";
+                }
+            ];
+            "args": [
+                {
+                    "name": "role";
+                    "type": {
+                        "defined": {
+                            "name": "role";
+                        };
+                    };
+                }
+            ];
+            "returns": "bool";
+        },
         {
             "name": "initBucket";
             "docs": [
@@ -2740,6 +2902,51 @@ type LiqsolCore$1 = {
             ];
             "args": [];
         },
+        {
+            "name": "initializePretokenPurchaseHistory";
+            "docs": [
+                "Admin-only: initialize PretokenPurchaseHistory PDA for a pool"
+            ];
+            "discriminator": [
+                140,
+                166,
+                196,
+                128,
+                189,
+                240,
+                159,
+                1
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
+                {
+                    "name": "poolAuthority";
+                },
+                {
+                    "name": "globalState";
+                    "writable": true;
+                },
+                {
+                    "name": "poolPretokenRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "initializeProcessingState";
             "docs": [
@@ -3610,6 +3817,10 @@ type LiqsolCore$1 = {
                 },
                 {
                     "name": "systemProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [
@@ -3704,6 +3915,10 @@ type LiqsolCore$1 = {
                 },
                 {
                     "name": "chainlinkProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [];
@@ -3796,7 +4011,7 @@ type LiqsolCore$1 = {
             "name": "refreshStakeMetricsPostSync";
             "docs": [
                 "V2: Refresh stake metrics after removal selection + PDA setup",
-                "Requires ActiveInfosSynced + ValidatorPdaSetup as prerequisites",
+                "Requires ValidatorAdditionSelection + ValidatorPdaSetup as prerequisites",
                 "Tracks completion in last_post_sync_stake_metrics_refresh_epoch"
             ];
             "discriminator": [
@@ -3839,92 +4054,222 @@ type LiqsolCore$1 = {
             "args": [];
         },
         {
-            "name": "registerUser";
+            "name": "refund";
             "discriminator": [
                 2,
-                241,
-                150,
-                223,
-                99,
-                214,
-                116,
-                97
+                96,
+                183,
+                251,
+                63,
+                208,
+                46,
+                46
             ];
             "accounts": [
                 {
-                    "name": "user";
-                    "writable": true;
+                    "name": "associatedTokenProgram";
                 },
                 {
-                    "name": "userAta";
+                    "name": "user";
                     "writable": true;
+                    "signer": true;
                 },
                 {
-                    "name": "userRecord";
+                    "name": "globalState";
                     "writable": true;
                 },
                 {
-                    "name": "payer";
-                    "docs": [
-                        "Payer for the user record PDA creation (always the user)"
-                    ];
+                    "name": "outpostAccount";
                     "writable": true;
-                    "signer": true;
                 },
                 {
                     "name": "distributionState";
                     "writable": true;
                 },
                 {
-                    "name": "bucketAuthority";
+                    "name": "poolAuthority";
                 },
                 {
-                    "name": "bucketTokenAccount";
-                    "docs": [
-                        "The bucket's associated token account holding liqSOL (for index sync)"
-                    ];
+                    "name": "liqsolPoolAta";
                     "writable": true;
                 },
                 {
-                    "name": "systemProgram";
-                }
-            ];
-            "args": [];
-        },
-        {
-            "name": "removeLowPerformersBatch";
-            "docs": [
-                "Process batch of validators for removal (below exit threshold)"
-            ];
-            "discriminator": [
-                91,
-                142,
-                166,
-                98,
-                245,
-                245,
-                159,
-                44
-            ];
-            "accounts": [
-                {
-                    "name": "activeList";
+                    "name": "refundLiqsolAta";
                     "writable": true;
                 },
                 {
-                    "name": "graveyardList";
+                    "name": "liqsolPoolUserRecord";
                     "writable": true;
                 },
                 {
-                    "name": "maintenanceLedger";
+                    "name": "userRecord";
                     "writable": true;
                 },
                 {
-                    "name": "processingState";
-                    "writable": true;
+                    "name": "extraAccountMetaList";
                 },
                 {
-                    "name": "allocationState";
+                    "name": "liqsolCoreProgram";
+                },
+                {
+                    "name": "transferHookProgram";
+                },
+                {
+                    "name": "liqsolMint";
+                },
+                {
+                    "name": "tokenProgram";
+                },
+                {
+                    "name": "bucketAuthority";
+                },
+                {
+                    "name": "bucketTokenAccount";
+                    "writable": true;
+                },
+                {
+                    "name": "bucketUserRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "registerSystemPda";
+            "discriminator": [
+                110,
+                93,
+                36,
+                156,
+                179,
+                69,
+                54,
+                210
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "pdaOwner";
+                    "docs": [
+                        "The PDA whose user record we're creating — must be system-owned (no program data)."
+                    ];
+                },
+                {
+                    "name": "pdaAta";
+                },
+                {
+                    "name": "userRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "distributionState";
+                    "writable": true;
+                },
+                {
+                    "name": "bucketAuthority";
+                },
+                {
+                    "name": "bucketTokenAccount";
+                    "docs": [
+                        "The bucket's associated token account holding liqSOL (for index sync)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "registerUser";
+            "discriminator": [
+                2,
+                241,
+                150,
+                223,
+                99,
+                214,
+                116,
+                97
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "userAta";
+                },
+                {
+                    "name": "userRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "distributionState";
+                    "writable": true;
+                },
+                {
+                    "name": "bucketAuthority";
+                },
+                {
+                    "name": "bucketTokenAccount";
+                    "docs": [
+                        "The bucket's associated token account holding liqSOL (for index sync)"
+                    ];
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "removeLowPerformersBatch";
+            "docs": [
+                "Process batch of validators for removal (below exit threshold)"
+            ];
+            "discriminator": [
+                91,
+                142,
+                166,
+                98,
+                245,
+                245,
+                159,
+                44
+            ];
+            "accounts": [
+                {
+                    "name": "activeList";
+                    "writable": true;
+                },
+                {
+                    "name": "graveyardList";
+                    "writable": true;
+                },
+                {
+                    "name": "maintenanceLedger";
+                    "writable": true;
+                },
+                {
+                    "name": "processingState";
+                    "writable": true;
+                },
+                {
+                    "name": "allocationState";
                 },
                 {
                     "name": "globalConfig";
@@ -4035,6 +4380,7 @@ type LiqsolCore$1 = {
                     "docs": [
                         "The bucket's token account holding liqSOL (for sync_index balance)"
                     ];
+                    "writable": true;
                 },
                 {
                     "name": "reservePool";
@@ -4381,6 +4727,7 @@ type LiqsolCore$1 = {
                 },
                 {
                     "name": "globalState";
+                    "writable": true;
                 },
                 {
                     "name": "user";
@@ -4470,7 +4817,7 @@ type LiqsolCore$1 = {
             "name": "syncMainStakeAccounts";
             "docs": [
                 "V2: Sync main stake accounts using PDA architecture (batched)",
-                "Processes up to 10 validators per transaction via remaining_accounts",
+                "Processes validators in batches via remaining_accounts (batch size is enforced client-side)",
                 "Note: Only syncs primary delegated stakes, not transient stakes"
             ];
             "discriminator": [
@@ -4636,6 +4983,10 @@ type LiqsolCore$1 = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -5038,6 +5389,19 @@ type LiqsolCore$1 = {
                 150
             ];
         },
+        {
+            "name": "pretokenPurchaseHistory";
+            "discriminator": [
+                33,
+                71,
+                113,
+                206,
+                33,
+                180,
+                236,
+                131
+            ];
+        },
         {
             "name": "priceHistory";
             "discriminator": [
@@ -5550,12 +5914,24 @@ type LiqsolCore$1 = {
                         ];
                         "type": "u16";
                     },
+                    {
+                        "name": "aggregateModeTag";
+                        "docs": [
+                            "Tracks which aggregation mode currently owns the shared temp fields.",
+                            "0 = idle,",
+                            "1 = Normal,",
+                            "2 = PostSync,",
+                            "3 = PostLateEpoch.",
+                            "Prevents cross-mode state contamination when modes share the same vars."
+                        ];
+                        "type": "u8";
+                    },
                     {
                         "name": "reserved";
                         "type": {
                             "array": [
                                 "u8",
-                                32
+                                31
                             ];
                         };
                     }
@@ -5788,7 +6164,9 @@ type LiqsolCore$1 = {
                     {
                         "name": "authority";
                         "docs": [
-                            "Authority that can update serviceable_epoch"
+                            "DEPRECATED: Originally intended as authority for serviceable_epoch updates,",
+                            "but serviceable_epoch is updated by merge_deactivated_stakes gated via GlobalConfig.cranky.",
+                            "Retained to preserve account layout."
                         ];
                         "type": "pubkey";
                     },
@@ -6104,9 +6482,10 @@ type LiqsolCore$1 = {
                         "type": "u64";
                     },
                     {
-                        "name": "lastPoolLiqsolBalance";
+                        "name": "expectedPoolBalance";
                         "docs": [
-                            "Last observed liqSOL pool balance (for yield calculation)"
+                            "Expected liqSOL pool balance (tracked by protocol operations, not read from on-chain balance).",
+                            "Any discrepancy vs actual on-chain balance is treated as unsolicited donations, not yield."
                         ];
                         "type": "u64";
                     },
@@ -6319,6 +6698,9 @@ type LiqsolCore$1 = {
                     },
                     {
                         "name": "lastActiveInfosSyncedEpoch";
+                        "docs": [
+                            "DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+                        ];
                         "type": "u16";
                     },
                     {
@@ -6333,6 +6715,9 @@ type LiqsolCore$1 = {
                     },
                     {
                         "name": "lastDistributionSlot";
+                        "docs": [
+                            "DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+                        ];
                         "type": {
                             "option": "u64";
                         };
@@ -6497,6 +6882,24 @@ type LiqsolCore$1 = {
                     {
                         "name": "bump";
                         "type": "u8";
+                    },
+                    {
+                        "name": "accumulatedPretokenYield";
+                        "type": {
+                            "option": "u64";
+                        };
+                    },
+                    {
+                        "name": "lastEpochSyndLiqsol";
+                        "type": {
+                            "option": "u64";
+                        };
+                    },
+                    {
+                        "name": "lastSyndEpoch";
+                        "type": {
+                            "option": "u64";
+                        };
                     }
                 ];
             };
@@ -6591,6 +6994,57 @@ type LiqsolCore$1 = {
                 ];
             };
         },
+        {
+            "name": "pretokenPurchaseHistory";
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "startingEpoch";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "latestEpoch";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "purchasedPerEpoch";
+                        "type": {
+                            "array": [
+                                "u64",
+                                100
+                            ];
+                        };
+                    },
+                    {
+                        "name": "syndPerEpoch";
+                        "type": {
+                            "array": [
+                                "u64",
+                                100
+                            ];
+                        };
+                    },
+                    {
+                        "name": "bump";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "padding";
+                        "type": {
+                            "array": [
+                                "u8",
+                                7
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
         {
             "name": "pretokenPurchased";
             "type": {
@@ -6851,56 +7305,56 @@ type LiqsolCore$1 = {
                     {
                         "name": "additionInProgress";
                         "docs": [
-                            "Whether validator addition selection is currently in progress (batched processing)"
+                            "DEPRECATED — see BatchOrchestrator. Always false."
                         ];
                         "type": "bool";
                     },
                     {
                         "name": "additionNextRank";
                         "docs": [
-                            "Next rank to process in leaderboard sorted_indices"
+                            "DEPRECATED — see BatchOrchestrator.addition_next_rank. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "additionTargetRank";
                         "docs": [
-                            "Target rank to process up to (inclusive)"
+                            "DEPRECATED — see BatchOrchestrator.addition_target_rank. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "validatorsAddedThisSelection";
                         "docs": [
-                            "Number of validators added in the current selection cycle"
+                            "DEPRECATED — see BatchOrchestrator. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "removalInProgress";
                         "docs": [
-                            "Whether validator removal selection is currently in progress (batched processing)"
+                            "DEPRECATED — see BatchOrchestrator. Always false."
                         ];
                         "type": "bool";
                     },
                     {
                         "name": "removalNextIndex";
                         "docs": [
-                            "Next index in active list to check for removal"
+                            "DEPRECATED — see BatchOrchestrator.removal_next_index. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "removalActiveListSnapshot";
                         "docs": [
-                            "Snapshot of active list count at start of removal (frozen)"
+                            "DEPRECATED — see BatchOrchestrator. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "validatorsRemovedThisSelection";
                         "docs": [
-                            "Number of validators removed in the current selection cycle"
+                            "DEPRECATED — see BatchOrchestrator. Always 0."
                         ];
                         "type": "u16";
                     }
@@ -7755,22 +8209,56 @@ type LiqsolToken$1 = {
                     };
                 }
             ];
-        }
-    ];
-    "errors": [
-        {
-            "code": 6000;
-            "name": "invalidMintAuthority";
-            "msg": "Invalid mint authority";
-        },
-        {
-            "code": 6001;
-            "name": "unauthorizedProgram";
-            "msg": "Unauthorized program attempting to mint";
         },
         {
-            "code": 6002;
-            "name": "cannotDetermineCallingProgram";
+            "name": "updateLiqsolMetadataPermissionless";
+            "discriminator": [
+                21,
+                255,
+                26,
+                184,
+                136,
+                110,
+                214,
+                33
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "mintAuthority";
+                },
+                {
+                    "name": "mint";
+                    "writable": true;
+                },
+                {
+                    "name": "tokenProgram";
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        }
+    ];
+    "errors": [
+        {
+            "code": 6000;
+            "name": "invalidMintAuthority";
+            "msg": "Invalid mint authority";
+        },
+        {
+            "code": 6001;
+            "name": "unauthorizedProgram";
+            "msg": "Unauthorized program attempting to mint";
+        },
+        {
+            "code": 6002;
+            "name": "cannotDetermineCallingProgram";
             "msg": "Cannot determine calling program";
         },
         {
@@ -8473,6 +8961,51 @@ type LiqsolCore = {
             ];
             "args": [];
         },
+        {
+            "name": "adminForceUnbondRole";
+            "discriminator": [
+                80,
+                107,
+                27,
+                49,
+                126,
+                25,
+                31,
+                238
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "globalState";
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose role bond is being force-unbonded"
+                    ];
+                },
+                {
+                    "name": "outpostAccount";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "role";
+                    "type": {
+                        "defined": {
+                            "name": "role";
+                        };
+                    };
+                }
+            ];
+        },
         {
             "name": "aggregateStakeMetrics";
             "docs": [
@@ -9238,6 +9771,72 @@ type LiqsolCore = {
                 }
             ];
         },
+        {
+            "name": "depositToReserve";
+            "discriminator": [
+                8,
+                79,
+                123,
+                129,
+                146,
+                140,
+                178,
+                128
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "depositor";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "reservePool";
+                    "writable": true;
+                },
+                {
+                    "name": "vault";
+                },
+                {
+                    "name": "ephemeralStake";
+                    "writable": true;
+                },
+                {
+                    "name": "controllerState";
+                },
+                {
+                    "name": "stakeProgram";
+                },
+                {
+                    "name": "systemProgram";
+                },
+                {
+                    "name": "clock";
+                },
+                {
+                    "name": "stakeHistory";
+                },
+                {
+                    "name": "rent";
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                },
+                {
+                    "name": "seed";
+                    "type": "u32";
+                }
+            ];
+        },
         {
             "name": "desynd";
             "discriminator": [
@@ -9314,6 +9913,10 @@ type LiqsolCore = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -9355,6 +9958,44 @@ type LiqsolCore = {
             "args": [];
             "returns": "u16";
         },
+        {
+            "name": "hasRole";
+            "discriminator": [
+                218,
+                136,
+                44,
+                87,
+                142,
+                247,
+                141,
+                195
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "docs": [
+                        "User whose role status is being checked."
+                    ];
+                },
+                {
+                    "name": "outpostAccount";
+                },
+                {
+                    "name": "globalState";
+                }
+            ];
+            "args": [
+                {
+                    "name": "role";
+                    "type": {
+                        "defined": {
+                            "name": "role";
+                        };
+                    };
+                }
+            ];
+            "returns": "bool";
+        },
         {
             "name": "initBucket";
             "docs": [
@@ -9696,6 +10337,51 @@ type LiqsolCore = {
             ];
             "args": [];
         },
+        {
+            "name": "initializePretokenPurchaseHistory";
+            "docs": [
+                "Admin-only: initialize PretokenPurchaseHistory PDA for a pool"
+            ];
+            "discriminator": [
+                140,
+                166,
+                196,
+                128,
+                189,
+                240,
+                159,
+                1
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "globalConfig";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
+                {
+                    "name": "poolAuthority";
+                },
+                {
+                    "name": "globalState";
+                    "writable": true;
+                },
+                {
+                    "name": "poolPretokenRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
         {
             "name": "initializeProcessingState";
             "docs": [
@@ -10566,6 +11252,10 @@ type LiqsolCore = {
                 },
                 {
                     "name": "systemProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [
@@ -10660,6 +11350,10 @@ type LiqsolCore = {
                 },
                 {
                     "name": "chainlinkProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [];
@@ -10678,118 +11372,256 @@ type LiqsolCore = {
             ];
             "accounts": [
                 {
-                    "name": "payer";
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "trancheState";
+                },
+                {
+                    "name": "priceHistory";
+                    "writable": true;
+                },
+                {
+                    "name": "chainlinkProgram";
+                },
+                {
+                    "name": "chainlinkFeed";
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "refreshStakeMetricsPostLateEpoch";
+            "docs": [
+                "Refresh stake metrics after all late-epoch operations (ProcessStakeOrders, ProcessUnstakeOrders)",
+                "Requires Distribution + UnstakeOrder as prerequisites",
+                "Tracks completion in last_post_late_epoch_stake_metrics_refresh_epoch"
+            ];
+            "discriminator": [
+                11,
+                226,
+                87,
+                114,
+                47,
+                159,
+                99,
+                157
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "stakeMetrics";
+                    "writable": true;
+                },
+                {
+                    "name": "epochState";
+                    "writable": true;
+                },
+                {
+                    "name": "processingState";
+                    "writable": true;
+                },
+                {
+                    "name": "activeList";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "refreshStakeMetricsPostSync";
+            "docs": [
+                "V2: Refresh stake metrics after removal selection + PDA setup",
+                "Requires ValidatorAdditionSelection + ValidatorPdaSetup as prerequisites",
+                "Tracks completion in last_post_sync_stake_metrics_refresh_epoch"
+            ];
+            "discriminator": [
+                177,
+                250,
+                32,
+                155,
+                196,
+                199,
+                199,
+                249
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "stakeMetrics";
+                    "writable": true;
+                },
+                {
+                    "name": "epochState";
+                    "writable": true;
+                },
+                {
+                    "name": "processingState";
+                    "writable": true;
+                },
+                {
+                    "name": "activeList";
+                },
+                {
+                    "name": "globalConfig";
+                    "docs": [
+                        "Global config for late epoch slot gate"
+                    ];
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "refund";
+            "discriminator": [
+                2,
+                96,
+                183,
+                251,
+                63,
+                208,
+                46,
+                46
+            ];
+            "accounts": [
+                {
+                    "name": "associatedTokenProgram";
+                },
+                {
+                    "name": "user";
                     "writable": true;
                     "signer": true;
                 },
                 {
-                    "name": "trancheState";
+                    "name": "globalState";
+                    "writable": true;
                 },
                 {
-                    "name": "priceHistory";
+                    "name": "outpostAccount";
                     "writable": true;
                 },
                 {
-                    "name": "chainlinkProgram";
+                    "name": "distributionState";
+                    "writable": true;
                 },
                 {
-                    "name": "chainlinkFeed";
+                    "name": "poolAuthority";
                 },
                 {
-                    "name": "systemProgram";
-                }
-            ];
-            "args": [];
-        },
-        {
-            "name": "refreshStakeMetricsPostLateEpoch";
-            "docs": [
-                "Refresh stake metrics after all late-epoch operations (ProcessStakeOrders, ProcessUnstakeOrders)",
-                "Requires Distribution + UnstakeOrder as prerequisites",
-                "Tracks completion in last_post_late_epoch_stake_metrics_refresh_epoch"
-            ];
-            "discriminator": [
-                11,
-                226,
-                87,
-                114,
-                47,
-                159,
-                99,
-                157
-            ];
-            "accounts": [
+                    "name": "liqsolPoolAta";
+                    "writable": true;
+                },
                 {
-                    "name": "admin";
+                    "name": "refundLiqsolAta";
                     "writable": true;
-                    "signer": true;
                 },
                 {
-                    "name": "stakeMetrics";
+                    "name": "liqsolPoolUserRecord";
                     "writable": true;
                 },
                 {
-                    "name": "epochState";
+                    "name": "userRecord";
                     "writable": true;
                 },
                 {
-                    "name": "processingState";
+                    "name": "extraAccountMetaList";
+                },
+                {
+                    "name": "liqsolCoreProgram";
+                },
+                {
+                    "name": "transferHookProgram";
+                },
+                {
+                    "name": "liqsolMint";
+                },
+                {
+                    "name": "tokenProgram";
+                },
+                {
+                    "name": "bucketAuthority";
+                },
+                {
+                    "name": "bucketTokenAccount";
                     "writable": true;
                 },
                 {
-                    "name": "activeList";
+                    "name": "bucketUserRecord";
+                    "writable": true;
                 },
                 {
-                    "name": "globalConfig";
-                    "docs": [
-                        "Global config for late epoch slot gate"
-                    ];
+                    "name": "systemProgram";
                 }
             ];
             "args": [];
         },
         {
-            "name": "refreshStakeMetricsPostSync";
-            "docs": [
-                "V2: Refresh stake metrics after removal selection + PDA setup",
-                "Requires ActiveInfosSynced + ValidatorPdaSetup as prerequisites",
-                "Tracks completion in last_post_sync_stake_metrics_refresh_epoch"
-            ];
+            "name": "registerSystemPda";
             "discriminator": [
-                177,
-                250,
-                32,
-                155,
-                196,
-                199,
-                199,
-                249
+                110,
+                93,
+                36,
+                156,
+                179,
+                69,
+                54,
+                210
             ];
             "accounts": [
                 {
                     "name": "admin";
+                    "writable": true;
                     "signer": true;
                 },
                 {
-                    "name": "stakeMetrics";
-                    "writable": true;
+                    "name": "globalConfig";
                 },
                 {
-                    "name": "epochState";
+                    "name": "pdaOwner";
+                    "docs": [
+                        "The PDA whose user record we're creating — must be system-owned (no program data)."
+                    ];
+                },
+                {
+                    "name": "pdaAta";
+                },
+                {
+                    "name": "userRecord";
                     "writable": true;
                 },
                 {
-                    "name": "processingState";
+                    "name": "distributionState";
                     "writable": true;
                 },
                 {
-                    "name": "activeList";
+                    "name": "bucketAuthority";
                 },
                 {
-                    "name": "globalConfig";
+                    "name": "bucketTokenAccount";
                     "docs": [
-                        "Global config for late epoch slot gate"
+                        "The bucket's associated token account holding liqSOL (for index sync)"
                     ];
+                    "writable": true;
+                },
+                {
+                    "name": "systemProgram";
                 }
             ];
             "args": [];
@@ -10808,25 +11640,17 @@ type LiqsolCore = {
             ];
             "accounts": [
                 {
-                    "name": "user";
+                    "name": "payer";
                     "writable": true;
+                    "signer": true;
                 },
                 {
                     "name": "userAta";
-                    "writable": true;
                 },
                 {
                     "name": "userRecord";
                     "writable": true;
                 },
-                {
-                    "name": "payer";
-                    "docs": [
-                        "Payer for the user record PDA creation (always the user)"
-                    ];
-                    "writable": true;
-                    "signer": true;
-                },
                 {
                     "name": "distributionState";
                     "writable": true;
@@ -10991,6 +11815,7 @@ type LiqsolCore = {
                     "docs": [
                         "The bucket's token account holding liqSOL (for sync_index balance)"
                     ];
+                    "writable": true;
                 },
                 {
                     "name": "reservePool";
@@ -11337,6 +12162,7 @@ type LiqsolCore = {
                 },
                 {
                     "name": "globalState";
+                    "writable": true;
                 },
                 {
                     "name": "user";
@@ -11426,7 +12252,7 @@ type LiqsolCore = {
             "name": "syncMainStakeAccounts";
             "docs": [
                 "V2: Sync main stake accounts using PDA architecture (batched)",
-                "Processes up to 10 validators per transaction via remaining_accounts",
+                "Processes validators in batches via remaining_accounts (batch size is enforced client-side)",
                 "Note: Only syncs primary delegated stakes, not transient stakes"
             ];
             "discriminator": [
@@ -11592,6 +12418,10 @@ type LiqsolCore = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -11994,6 +12824,19 @@ type LiqsolCore = {
                 150
             ];
         },
+        {
+            "name": "pretokenPurchaseHistory";
+            "discriminator": [
+                33,
+                71,
+                113,
+                206,
+                33,
+                180,
+                236,
+                131
+            ];
+        },
         {
             "name": "priceHistory";
             "discriminator": [
@@ -12506,12 +13349,24 @@ type LiqsolCore = {
                         ];
                         "type": "u16";
                     },
+                    {
+                        "name": "aggregateModeTag";
+                        "docs": [
+                            "Tracks which aggregation mode currently owns the shared temp fields.",
+                            "0 = idle,",
+                            "1 = Normal,",
+                            "2 = PostSync,",
+                            "3 = PostLateEpoch.",
+                            "Prevents cross-mode state contamination when modes share the same vars."
+                        ];
+                        "type": "u8";
+                    },
                     {
                         "name": "reserved";
                         "type": {
                             "array": [
                                 "u8",
-                                32
+                                31
                             ];
                         };
                     }
@@ -12744,7 +13599,9 @@ type LiqsolCore = {
                     {
                         "name": "authority";
                         "docs": [
-                            "Authority that can update serviceable_epoch"
+                            "DEPRECATED: Originally intended as authority for serviceable_epoch updates,",
+                            "but serviceable_epoch is updated by merge_deactivated_stakes gated via GlobalConfig.cranky.",
+                            "Retained to preserve account layout."
                         ];
                         "type": "pubkey";
                     },
@@ -13060,9 +13917,10 @@ type LiqsolCore = {
                         "type": "u64";
                     },
                     {
-                        "name": "lastPoolLiqsolBalance";
+                        "name": "expectedPoolBalance";
                         "docs": [
-                            "Last observed liqSOL pool balance (for yield calculation)"
+                            "Expected liqSOL pool balance (tracked by protocol operations, not read from on-chain balance).",
+                            "Any discrepancy vs actual on-chain balance is treated as unsolicited donations, not yield."
                         ];
                         "type": "u64";
                     },
@@ -13275,6 +14133,9 @@ type LiqsolCore = {
                     },
                     {
                         "name": "lastActiveInfosSyncedEpoch";
+                        "docs": [
+                            "DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+                        ];
                         "type": "u16";
                     },
                     {
@@ -13289,6 +14150,9 @@ type LiqsolCore = {
                     },
                     {
                         "name": "lastDistributionSlot";
+                        "docs": [
+                            "DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+                        ];
                         "type": {
                             "option": "u64";
                         };
@@ -13453,6 +14317,24 @@ type LiqsolCore = {
                     {
                         "name": "bump";
                         "type": "u8";
+                    },
+                    {
+                        "name": "accumulatedPretokenYield";
+                        "type": {
+                            "option": "u64";
+                        };
+                    },
+                    {
+                        "name": "lastEpochSyndLiqsol";
+                        "type": {
+                            "option": "u64";
+                        };
+                    },
+                    {
+                        "name": "lastSyndEpoch";
+                        "type": {
+                            "option": "u64";
+                        };
                     }
                 ];
             };
@@ -13547,6 +14429,57 @@ type LiqsolCore = {
                 ];
             };
         },
+        {
+            "name": "pretokenPurchaseHistory";
+            "serialization": "bytemuck";
+            "repr": {
+                "kind": "c";
+            };
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "startingEpoch";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "latestEpoch";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "purchasedPerEpoch";
+                        "type": {
+                            "array": [
+                                "u64",
+                                100
+                            ];
+                        };
+                    },
+                    {
+                        "name": "syndPerEpoch";
+                        "type": {
+                            "array": [
+                                "u64",
+                                100
+                            ];
+                        };
+                    },
+                    {
+                        "name": "bump";
+                        "type": "u8";
+                    },
+                    {
+                        "name": "padding";
+                        "type": {
+                            "array": [
+                                "u8",
+                                7
+                            ];
+                        };
+                    }
+                ];
+            };
+        },
         {
             "name": "pretokenPurchased";
             "type": {
@@ -13807,56 +14740,56 @@ type LiqsolCore = {
                     {
                         "name": "additionInProgress";
                         "docs": [
-                            "Whether validator addition selection is currently in progress (batched processing)"
+                            "DEPRECATED — see BatchOrchestrator. Always false."
                         ];
                         "type": "bool";
                     },
                     {
                         "name": "additionNextRank";
                         "docs": [
-                            "Next rank to process in leaderboard sorted_indices"
+                            "DEPRECATED — see BatchOrchestrator.addition_next_rank. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "additionTargetRank";
                         "docs": [
-                            "Target rank to process up to (inclusive)"
+                            "DEPRECATED — see BatchOrchestrator.addition_target_rank. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "validatorsAddedThisSelection";
                         "docs": [
-                            "Number of validators added in the current selection cycle"
+                            "DEPRECATED — see BatchOrchestrator. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "removalInProgress";
                         "docs": [
-                            "Whether validator removal selection is currently in progress (batched processing)"
+                            "DEPRECATED — see BatchOrchestrator. Always false."
                         ];
                         "type": "bool";
                     },
                     {
                         "name": "removalNextIndex";
                         "docs": [
-                            "Next index in active list to check for removal"
+                            "DEPRECATED — see BatchOrchestrator.removal_next_index. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "removalActiveListSnapshot";
                         "docs": [
-                            "Snapshot of active list count at start of removal (frozen)"
+                            "DEPRECATED — see BatchOrchestrator. Always 0."
                         ];
                         "type": "u16";
                     },
                     {
                         "name": "validatorsRemovedThisSelection";
                         "docs": [
-                            "Number of validators removed in the current selection cycle"
+                            "DEPRECATED — see BatchOrchestrator. Always 0."
                         ];
                         "type": "u16";
                     }
@@ -14711,6 +15644,40 @@ type LiqsolToken = {
                     };
                 }
             ];
+        },
+        {
+            "name": "updateLiqsolMetadataPermissionless";
+            "discriminator": [
+                21,
+                255,
+                26,
+                184,
+                136,
+                110,
+                214,
+                33
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "mintAuthority";
+                },
+                {
+                    "name": "mint";
+                    "writable": true;
+                },
+                {
+                    "name": "tokenProgram";
+                },
+                {
+                    "name": "systemProgram";
+                }
+            ];
+            "args": [];
         }
     ];
     "errors": [
@@ -15409,6 +16376,7 @@ declare class SolanaProgramService {
     deriveMaintenanceLedgerPda(): PublicKey$1;
     deriveWithdrawMintAuthorityPda(): PublicKey$1;
     deriveWithdrawMintMetadataPda(): PublicKey$1;
+    derivePretokenPurchaseHistoryPda(): PublicKey$1;
     /**
      * NFT mint for withdrawal receipt, derived from nextReceiptId.
      */
@@ -15494,6 +16462,7 @@ declare class DistributionClient {
     private program;
     constructor(provider: AnchorProvider, pgs: SolanaProgramService);
     get connection(): _solana_web3_js.Connection;
+    private getTokenBalance;
     /**
      * Fetch the global distribution state account.
      *
@@ -15536,6 +16505,19 @@ declare class DistributionClient {
         totalShares: BN;
         ratio: number;
     }>;
+    /**
+     * Compute claimable liqSOL for a wallet:
+     * claimable = max(0, entitled - actual)
+     * entitled = floor(shares * syncedIndex / 1e12)
+     *
+     * `syncedIndex` mirrors on-chain `sync_index` behavior by incorporating any
+     * unsynced bucket delta (bucket_balance - last_bucket_balance).
+     */
+    getClaimableLiqsol(user: PublicKey$1): Promise<BN>;
+    /**
+     * Build claim_rewards instruction for a wallet.
+     */
+    buildClaimRewardsIx(user: PublicKey$1): Promise<TransactionInstruction>;
     /**
      * Compute an average scaled pay rate over the most recent `windowSize`
      * valid entries in the pay-rate history circular buffer.
@@ -15639,6 +16621,7 @@ interface OutpostAccounts {
     chainLinkFeed: PublicKey$1;
     chainLinkProgram: PublicKey$1;
     extraAccountMetaList: PublicKey$1;
+    pretokenPurchaseHistory: PublicKey$1;
 }
 declare function buildOutpostAccounts(connection: Connection, user: PublicKey$1, pgs: SolanaProgramService): Promise<OutpostAccounts>;
 type EpochSnapshot = {
@@ -15857,6 +16840,10 @@ declare class SolanaStakingClient implements IStakingClient {
      * Claim a withdrawal receipt (burn NFT + receive SOL) via claim_withdraw.
      */
     claimWithdraw(tokenId: bigint): Promise<string>;
+    /**
+     * Claim accrued liqSOL distribution rewards (liqsol_core::claim_rewards).
+     */
+    claimLiqsolRewards(): Promise<string>;
     /**
      * Stake liqSOL into Outpost (liqSOL → pool) via liqsol_core::synd.
      */