@wireio/stake 2.3.1 → 2.4.1

package/lib/stake.d.ts

@@ -939,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).
@@ -1433,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
@@ -1525,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": [
@@ -2290,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": [
@@ -2366,6 +2478,10 @@ type LiqsolCore$1 = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -2407,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": [
@@ -2748,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": [
@@ -3618,6 +3817,10 @@ type LiqsolCore$1 = {
                 },
                 {
                     "name": "systemProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [
@@ -3712,6 +3915,10 @@ type LiqsolCore$1 = {
                 },
                 {
                     "name": "chainlinkProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [];
@@ -3804,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": [
@@ -3847,95 +4054,225 @@ 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": "globalConfig";
+                    "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";
                     "docs": [
                         "Global config for late epoch slot gate"
                     ];
@@ -4043,6 +4380,7 @@ type LiqsolCore$1 = {
                     "docs": [
                         "The bucket's token account holding liqSOL (for sync_index balance)"
                     ];
+                    "writable": true;
                 },
                 {
                     "name": "reservePool";
@@ -4389,6 +4727,7 @@ type LiqsolCore$1 = {
                 },
                 {
                     "name": "globalState";
+                    "writable": true;
                 },
                 {
                     "name": "user";
@@ -4478,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": [
@@ -4644,6 +4983,10 @@ type LiqsolCore$1 = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -5046,6 +5389,19 @@ type LiqsolCore$1 = {
                 150
             ];
         },
+        {
+            "name": "pretokenPurchaseHistory";
+            "discriminator": [
+                33,
+                71,
+                113,
+                206,
+                33,
+                180,
+                236,
+                131
+            ];
+        },
         {
             "name": "priceHistory";
             "discriminator": [
@@ -5558,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
                             ];
                         };
                     }
@@ -5796,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";
                     },
@@ -6112,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";
                     },
@@ -6327,6 +6698,9 @@ type LiqsolCore$1 = {
                     },
                     {
                         "name": "lastActiveInfosSyncedEpoch";
+                        "docs": [
+                            "DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+                        ];
                         "type": "u16";
                     },
                     {
@@ -6341,6 +6715,9 @@ type LiqsolCore$1 = {
                     },
                     {
                         "name": "lastDistributionSlot";
+                        "docs": [
+                            "DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+                        ];
                         "type": {
                             "option": "u64";
                         };
@@ -6505,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";
+                        };
                     }
                 ];
             };
@@ -6599,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": {
@@ -6859,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";
                     }
@@ -7763,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";
         },
         {
@@ -8481,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": [
@@ -9246,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": [
@@ -9322,6 +9913,10 @@ type LiqsolCore = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -9363,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": [
@@ -9704,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": [
@@ -10574,6 +11252,10 @@ type LiqsolCore = {
                 },
                 {
                     "name": "systemProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
                 }
             ];
             "args": [
@@ -10637,7 +11319,225 @@ type LiqsolCore = {
                     "writable": true;
                 },
                 {
-                    "name": "liqsolPoolUserRecord";
+                    "name": "liqsolPoolUserRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "extraAccountMetaList";
+                },
+                {
+                    "name": "liqsolCoreProgram";
+                },
+                {
+                    "name": "transferHookProgram";
+                },
+                {
+                    "name": "tokenProgram";
+                },
+                {
+                    "name": "systemProgram";
+                },
+                {
+                    "name": "trancheState";
+                    "writable": true;
+                },
+                {
+                    "name": "poolPretokenRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "chainlinkFeed";
+                },
+                {
+                    "name": "chainlinkProgram";
+                },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "recordPrice";
+            "discriminator": [
+                210,
+                113,
+                46,
+                101,
+                107,
+                218,
+                83,
+                51
+            ];
+            "accounts": [
+                {
+                    "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": "globalState";
+                    "writable": true;
+                },
+                {
+                    "name": "outpostAccount";
+                    "writable": true;
+                },
+                {
+                    "name": "distributionState";
+                    "writable": true;
+                },
+                {
+                    "name": "poolAuthority";
+                },
+                {
+                    "name": "liqsolPoolAta";
+                    "writable": true;
+                },
+                {
+                    "name": "refundLiqsolAta";
+                    "writable": true;
+                },
+                {
+                    "name": "liqsolPoolUserRecord";
+                    "writable": true;
+                },
+                {
+                    "name": "userRecord";
                     "writable": true;
                 },
                 {
@@ -10650,59 +11550,22 @@ type LiqsolCore = {
                     "name": "transferHookProgram";
                 },
                 {
-                    "name": "tokenProgram";
-                },
-                {
-                    "name": "systemProgram";
-                },
-                {
-                    "name": "trancheState";
-                    "writable": true;
+                    "name": "liqsolMint";
                 },
                 {
-                    "name": "poolPretokenRecord";
-                    "writable": true;
+                    "name": "tokenProgram";
                 },
                 {
-                    "name": "chainlinkFeed";
+                    "name": "bucketAuthority";
                 },
                 {
-                    "name": "chainlinkProgram";
-                }
-            ];
-            "args": [];
-        },
-        {
-            "name": "recordPrice";
-            "discriminator": [
-                210,
-                113,
-                46,
-                101,
-                107,
-                218,
-                83,
-                51
-            ];
-            "accounts": [
-                {
-                    "name": "payer";
+                    "name": "bucketTokenAccount";
                     "writable": true;
-                    "signer": true;
-                },
-                {
-                    "name": "trancheState";
                 },
                 {
-                    "name": "priceHistory";
+                    "name": "bucketUserRecord";
                     "writable": true;
                 },
-                {
-                    "name": "chainlinkProgram";
-                },
-                {
-                    "name": "chainlinkFeed";
-                },
                 {
                     "name": "systemProgram";
                 }
@@ -10710,21 +11573,16 @@ type LiqsolCore = {
             "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"
-            ];
+            "name": "registerSystemPda";
             "discriminator": [
-                11,
-                226,
-                87,
-                114,
-                47,
-                159,
-                99,
-                157
+                110,
+                93,
+                36,
+                156,
+                179,
+                69,
+                54,
+                210
             ];
             "accounts": [
                 {
@@ -10733,71 +11591,37 @@ type LiqsolCore = {
                     "signer": true;
                 },
                 {
-                    "name": "stakeMetrics";
-                    "writable": true;
-                },
-                {
-                    "name": "epochState";
-                    "writable": true;
-                },
-                {
-                    "name": "processingState";
-                    "writable": true;
-                },
-                {
-                    "name": "activeList";
+                    "name": "globalConfig";
                 },
                 {
-                    "name": "globalConfig";
+                    "name": "pdaOwner";
                     "docs": [
-                        "Global config for late epoch slot gate"
+                        "The PDA whose user record we're creating — must be system-owned (no program data)."
                     ];
-                }
-            ];
-            "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"
-            ];
-            "discriminator": [
-                177,
-                250,
-                32,
-                155,
-                196,
-                199,
-                199,
-                249
-            ];
-            "accounts": [
-                {
-                    "name": "admin";
-                    "signer": true;
                 },
                 {
-                    "name": "stakeMetrics";
-                    "writable": true;
+                    "name": "pdaAta";
                 },
                 {
-                    "name": "epochState";
+                    "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": [];
@@ -10816,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;
@@ -10999,6 +11815,7 @@ type LiqsolCore = {
                     "docs": [
                         "The bucket's token account holding liqSOL (for sync_index balance)"
                     ];
+                    "writable": true;
                 },
                 {
                     "name": "reservePool";
@@ -11345,6 +12162,7 @@ type LiqsolCore = {
                 },
                 {
                     "name": "globalState";
+                    "writable": true;
                 },
                 {
                     "name": "user";
@@ -11434,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": [
@@ -11600,6 +12418,10 @@ type LiqsolCore = {
                     ];
                     "writable": true;
                 },
+                {
+                    "name": "pretokenPurchaseHistory";
+                    "writable": true;
+                },
                 {
                     "name": "tokenProgram";
                 },
@@ -12002,6 +12824,19 @@ type LiqsolCore = {
                 150
             ];
         },
+        {
+            "name": "pretokenPurchaseHistory";
+            "discriminator": [
+                33,
+                71,
+                113,
+                206,
+                33,
+                180,
+                236,
+                131
+            ];
+        },
         {
             "name": "priceHistory";
             "discriminator": [
@@ -12514,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
                             ];
                         };
                     }
@@ -12752,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";
                     },
@@ -13068,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";
                     },
@@ -13283,6 +14133,9 @@ type LiqsolCore = {
                     },
                     {
                         "name": "lastActiveInfosSyncedEpoch";
+                        "docs": [
+                            "DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+                        ];
                         "type": "u16";
                     },
                     {
@@ -13297,6 +14150,9 @@ type LiqsolCore = {
                     },
                     {
                         "name": "lastDistributionSlot";
+                        "docs": [
+                            "DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+                        ];
                         "type": {
                             "option": "u64";
                         };
@@ -13461,6 +14317,24 @@ type LiqsolCore = {
                     {
                         "name": "bump";
                         "type": "u8";
+                    },
+                    {
+                        "name": "accumulatedPretokenYield";
+                        "type": {
+                            "option": "u64";
+                        };
+                    },
+                    {
+                        "name": "lastEpochSyndLiqsol";
+                        "type": {
+                            "option": "u64";
+                        };
+                    },
+                    {
+                        "name": "lastSyndEpoch";
+                        "type": {
+                            "option": "u64";
+                        };
                     }
                 ];
             };
@@ -13555,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": {
@@ -13815,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";
                     }
@@ -14719,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": [
@@ -15417,6 +16376,7 @@ declare class SolanaProgramService {
     deriveMaintenanceLedgerPda(): PublicKey$1;
     deriveWithdrawMintAuthorityPda(): PublicKey$1;
     deriveWithdrawMintMetadataPda(): PublicKey$1;
+    derivePretokenPurchaseHistoryPda(poolAuthority: PublicKey$1): PublicKey$1;
     /**
      * NFT mint for withdrawal receipt, derived from nextReceiptId.
      */
@@ -15661,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 = {