@wireio/stake 2.3.0 → 2.4.0

package/lib/stake.js

@@ -88,6 +88,51 @@ var instructions$7 = [
 		args: [
 		]
 	},
+	{
+		name: "admin_force_unbond_role",
+		discriminator: [
+			80,
+			107,
+			27,
+			49,
+			126,
+			25,
+			31,
+			238
+		],
+		accounts: [
+			{
+				name: "admin",
+				signer: true
+			},
+			{
+				name: "global_config"
+			},
+			{
+				name: "global_state"
+			},
+			{
+				name: "user",
+				docs: [
+					"The user whose role bond is being force-unbonded"
+				]
+			},
+			{
+				name: "outpost_account",
+				writable: true
+			}
+		],
+		args: [
+			{
+				name: "role",
+				type: {
+					defined: {
+						name: "Role"
+					}
+				}
+			}
+		]
+	},
 	{
 		name: "aggregate_stake_metrics",
 		docs: [
@@ -862,6 +907,72 @@ var instructions$7 = [
 			}
 		]
 	},
+	{
+		name: "deposit_to_reserve",
+		discriminator: [
+			8,
+			79,
+			123,
+			129,
+			146,
+			140,
+			178,
+			128
+		],
+		accounts: [
+			{
+				name: "admin",
+				signer: true
+			},
+			{
+				name: "global_config"
+			},
+			{
+				name: "depositor",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "reserve_pool",
+				writable: true
+			},
+			{
+				name: "vault"
+			},
+			{
+				name: "ephemeral_stake",
+				writable: true
+			},
+			{
+				name: "controller_state"
+			},
+			{
+				name: "stake_program"
+			},
+			{
+				name: "system_program"
+			},
+			{
+				name: "clock"
+			},
+			{
+				name: "stake_history"
+			},
+			{
+				name: "rent"
+			}
+		],
+		args: [
+			{
+				name: "amount",
+				type: "u64"
+			},
+			{
+				name: "seed",
+				type: "u32"
+			}
+		]
+	},
 	{
 		name: "desynd",
 		discriminator: [
@@ -938,6 +1049,10 @@ var instructions$7 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -980,6 +1095,44 @@ var instructions$7 = [
 		],
 		returns: "u16"
 	},
+	{
+		name: "has_role",
+		discriminator: [
+			218,
+			136,
+			44,
+			87,
+			142,
+			247,
+			141,
+			195
+		],
+		accounts: [
+			{
+				name: "user",
+				docs: [
+					"User whose role status is being checked."
+				]
+			},
+			{
+				name: "outpost_account"
+			},
+			{
+				name: "global_state"
+			}
+		],
+		args: [
+			{
+				name: "role",
+				type: {
+					defined: {
+						name: "Role"
+					}
+				}
+			}
+		],
+		returns: "bool"
+	},
 	{
 		name: "init_bucket",
 		docs: [
@@ -1331,6 +1484,52 @@ var instructions$7 = [
 		args: [
 		]
 	},
+	{
+		name: "initialize_pretoken_purchase_history",
+		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: "global_config"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
+			{
+				name: "pool_authority"
+			},
+			{
+				name: "global_state",
+				writable: true
+			},
+			{
+				name: "pool_pretoken_record",
+				writable: true
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
+	},
 	{
 		name: "initialize_processing_state",
 		docs: [
@@ -2212,6 +2411,10 @@ var instructions$7 = [
 			},
 			{
 				name: "system_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -2306,6 +2509,10 @@ var instructions$7 = [
 			},
 			{
 				name: "chainlink_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -2401,7 +2608,7 @@ var instructions$7 = [
 		name: "refresh_stake_metrics_post_sync",
 		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: [
@@ -2445,24 +2652,51 @@ var instructions$7 = [
 		]
 	},
 	{
-		name: "register_user",
+		name: "refund",
 		discriminator: [
 			2,
-			241,
-			150,
-			223,
-			99,
-			214,
-			116,
-			97
+			96,
+			183,
+			251,
+			63,
+			208,
+			46,
+			46
 		],
 		accounts: [
+			{
+				name: "associated_token_program"
+			},
 			{
 				name: "user",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "global_state",
 				writable: true
 			},
 			{
-				name: "user_ata",
+				name: "outpost_account",
+				writable: true
+			},
+			{
+				name: "distribution_state",
+				writable: true
+			},
+			{
+				name: "pool_authority"
+			},
+			{
+				name: "liqsol_pool_ata",
+				writable: true
+			},
+			{
+				name: "refund_liqsol_ata",
+				writable: true
+			},
+			{
+				name: "liqsol_pool_user_record",
 				writable: true
 			},
 			{
@@ -2470,13 +2704,118 @@ var instructions$7 = [
 				writable: true
 			},
 			{
-				name: "payer",
-				docs: [
-					"Payer for the user record PDA creation (always the user)"
-				],
+				name: "extra_account_meta_list"
+			},
+			{
+				name: "liqsol_core_program"
+			},
+			{
+				name: "transfer_hook_program"
+			},
+			{
+				name: "liqsol_mint"
+			},
+			{
+				name: "token_program"
+			},
+			{
+				name: "bucket_authority"
+			},
+			{
+				name: "bucket_token_account",
+				writable: true
+			},
+			{
+				name: "bucket_user_record",
+				writable: true
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "register_system_pda",
+		discriminator: [
+			110,
+			93,
+			36,
+			156,
+			179,
+			69,
+			54,
+			210
+		],
+		accounts: [
+			{
+				name: "admin",
 				writable: true,
 				signer: true
 			},
+			{
+				name: "global_config"
+			},
+			{
+				name: "pda_owner",
+				docs: [
+					"The PDA whose user record we're creating — must be system-owned (no program data)."
+				]
+			},
+			{
+				name: "pda_ata"
+			},
+			{
+				name: "user_record",
+				writable: true
+			},
+			{
+				name: "distribution_state",
+				writable: true
+			},
+			{
+				name: "bucket_authority"
+			},
+			{
+				name: "bucket_token_account",
+				docs: [
+					"The bucket's associated token account holding liqSOL (for index sync)"
+				],
+				writable: true
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "register_user",
+		discriminator: [
+			2,
+			241,
+			150,
+			223,
+			99,
+			214,
+			116,
+			97
+		],
+		accounts: [
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "user_ata"
+			},
+			{
+				name: "user_record",
+				writable: true
+			},
 			{
 				name: "distribution_state",
 				writable: true
@@ -2642,7 +2981,8 @@ var instructions$7 = [
 				name: "bucket_token_account",
 				docs: [
 					"The bucket's token account holding liqSOL (for sync_index balance)"
-				]
+				],
+				writable: true
 			},
 			{
 				name: "reserve_pool",
@@ -2991,7 +3331,8 @@ var instructions$7 = [
 				name: "global_config"
 			},
 			{
-				name: "global_state"
+				name: "global_state",
+				writable: true
 			},
 			{
 				name: "user",
@@ -3084,7 +3425,7 @@ var instructions$7 = [
 		name: "sync_main_stake_accounts",
 		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: [
@@ -3252,6 +3593,10 @@ var instructions$7 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -3654,6 +3999,19 @@ var accounts$5 = [
 			150
 		]
 	},
+	{
+		name: "PretokenPurchaseHistory",
+		discriminator: [
+			33,
+			71,
+			113,
+			206,
+			33,
+			180,
+			236,
+			131
+		]
+	},
 	{
 		name: "PriceHistory",
 		discriminator: [
@@ -4166,12 +4524,24 @@ var types$9 = [
 					],
 					type: "u16"
 				},
+				{
+					name: "aggregate_mode_tag",
+					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
 						]
 					}
 				}
@@ -4404,7 +4774,9 @@ var types$9 = [
 				{
 					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"
 				},
@@ -4720,9 +5092,10 @@ var types$9 = [
 					type: "u64"
 				},
 				{
-					name: "last_pool_liqsol_balance",
+					name: "expected_pool_balance",
 					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"
 				},
@@ -4935,6 +5308,9 @@ var types$9 = [
 				},
 				{
 					name: "last_active_infos_synced_epoch",
+					docs: [
+						"DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+					],
 					type: "u16"
 				},
 				{
@@ -4949,6 +5325,9 @@ var types$9 = [
 				},
 				{
 					name: "last_distribution_slot",
+					docs: [
+						"DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+					],
 					type: {
 						option: "u64"
 					}
@@ -5113,6 +5492,24 @@ var types$9 = [
 				{
 					name: "bump",
 					type: "u8"
+				},
+				{
+					name: "accumulated_pretoken_yield",
+					type: {
+						option: "u64"
+					}
+				},
+				{
+					name: "last_epoch_synd_liqsol",
+					type: {
+						option: "u64"
+					}
+				},
+				{
+					name: "last_synd_epoch",
+					type: {
+						option: "u64"
+					}
 				}
 			]
 		}
@@ -5207,6 +5604,57 @@ var types$9 = [
 			]
 		}
 	},
+	{
+		name: "PretokenPurchaseHistory",
+		serialization: "bytemuck",
+		repr: {
+			kind: "c"
+		},
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "starting_epoch",
+					type: "u64"
+				},
+				{
+					name: "latest_epoch",
+					type: "u64"
+				},
+				{
+					name: "purchased_per_epoch",
+					type: {
+						array: [
+							"u64",
+							100
+						]
+					}
+				},
+				{
+					name: "synd_per_epoch",
+					type: {
+						array: [
+							"u64",
+							100
+						]
+					}
+				},
+				{
+					name: "bump",
+					type: "u8"
+				},
+				{
+					name: "_padding",
+					type: {
+						array: [
+							"u8",
+							7
+						]
+					}
+				}
+			]
+		}
+	},
 	{
 		name: "PretokenPurchased",
 		type: {
@@ -5467,56 +5915,56 @@ var types$9 = [
 				{
 					name: "addition_in_progress",
 					docs: [
-						"Whether validator addition selection is currently in progress (batched processing)"
+						"DEPRECATED — see BatchOrchestrator. Always false."
 					],
 					type: "bool"
 				},
 				{
 					name: "addition_next_rank",
 					docs: [
-						"Next rank to process in leaderboard sorted_indices"
+						"DEPRECATED — see BatchOrchestrator.addition_next_rank. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "addition_target_rank",
 					docs: [
-						"Target rank to process up to (inclusive)"
+						"DEPRECATED — see BatchOrchestrator.addition_target_rank. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "validators_added_this_selection",
 					docs: [
-						"Number of validators added in the current selection cycle"
+						"DEPRECATED — see BatchOrchestrator. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "removal_in_progress",
 					docs: [
-						"Whether validator removal selection is currently in progress (batched processing)"
+						"DEPRECATED — see BatchOrchestrator. Always false."
 					],
 					type: "bool"
 				},
 				{
 					name: "removal_next_index",
 					docs: [
-						"Next index in active list to check for removal"
+						"DEPRECATED — see BatchOrchestrator.removal_next_index. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "removal_active_list_snapshot",
 					docs: [
-						"Snapshot of active list count at start of removal (frozen)"
+						"DEPRECATED — see BatchOrchestrator. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "validators_removed_this_selection",
 					docs: [
-						"Number of validators removed in the current selection cycle"
+						"DEPRECATED — see BatchOrchestrator. Always 0."
 					],
 					type: "u16"
 				}
@@ -6372,6 +6820,41 @@ var instructions$6 = [
 				}
 			}
 		]
+	},
+	{
+		name: "update_liqsol_metadata_permissionless",
+		discriminator: [
+			21,
+			255,
+			26,
+			184,
+			136,
+			110,
+			214,
+			33
+		],
+		accounts: [
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "mint_authority"
+			},
+			{
+				name: "mint",
+				writable: true
+			},
+			{
+				name: "token_program"
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
 	}
 ];
 var errors$6 = [
@@ -7129,6 +7612,41 @@ var instructions$4 = [
 				type: "u64"
 			}
 		]
+	},
+	{
+		name: "update_extra_account_meta_list",
+		discriminator: [
+			44,
+			125,
+			141,
+			226,
+			97,
+			179,
+			166,
+			96
+		],
+		accounts: [
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "extra_account_meta_list",
+				writable: true
+			},
+			{
+				name: "mint"
+			},
+			{
+				name: "system_program"
+			},
+			{
+				name: "liqsol_core"
+			}
+		],
+		args: [
+		]
 	}
 ];
 var accounts$3 = [
@@ -7299,6 +7817,51 @@ var instructions$3 = [
 		args: [
 		]
 	},
+	{
+		name: "admin_force_unbond_role",
+		discriminator: [
+			80,
+			107,
+			27,
+			49,
+			126,
+			25,
+			31,
+			238
+		],
+		accounts: [
+			{
+				name: "admin",
+				signer: true
+			},
+			{
+				name: "global_config"
+			},
+			{
+				name: "global_state"
+			},
+			{
+				name: "user",
+				docs: [
+					"The user whose role bond is being force-unbonded"
+				]
+			},
+			{
+				name: "outpost_account",
+				writable: true
+			}
+		],
+		args: [
+			{
+				name: "role",
+				type: {
+					defined: {
+						name: "Role"
+					}
+				}
+			}
+		]
+	},
 	{
 		name: "aggregate_stake_metrics",
 		docs: [
@@ -8073,6 +8636,72 @@ var instructions$3 = [
 			}
 		]
 	},
+	{
+		name: "deposit_to_reserve",
+		discriminator: [
+			8,
+			79,
+			123,
+			129,
+			146,
+			140,
+			178,
+			128
+		],
+		accounts: [
+			{
+				name: "admin",
+				signer: true
+			},
+			{
+				name: "global_config"
+			},
+			{
+				name: "depositor",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "reserve_pool",
+				writable: true
+			},
+			{
+				name: "vault"
+			},
+			{
+				name: "ephemeral_stake",
+				writable: true
+			},
+			{
+				name: "controller_state"
+			},
+			{
+				name: "stake_program"
+			},
+			{
+				name: "system_program"
+			},
+			{
+				name: "clock"
+			},
+			{
+				name: "stake_history"
+			},
+			{
+				name: "rent"
+			}
+		],
+		args: [
+			{
+				name: "amount",
+				type: "u64"
+			},
+			{
+				name: "seed",
+				type: "u32"
+			}
+		]
+	},
 	{
 		name: "desynd",
 		discriminator: [
@@ -8149,6 +8778,10 @@ var instructions$3 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -8191,6 +8824,44 @@ var instructions$3 = [
 		],
 		returns: "u16"
 	},
+	{
+		name: "has_role",
+		discriminator: [
+			218,
+			136,
+			44,
+			87,
+			142,
+			247,
+			141,
+			195
+		],
+		accounts: [
+			{
+				name: "user",
+				docs: [
+					"User whose role status is being checked."
+				]
+			},
+			{
+				name: "outpost_account"
+			},
+			{
+				name: "global_state"
+			}
+		],
+		args: [
+			{
+				name: "role",
+				type: {
+					defined: {
+						name: "Role"
+					}
+				}
+			}
+		],
+		returns: "bool"
+	},
 	{
 		name: "init_bucket",
 		docs: [
@@ -8542,6 +9213,52 @@ var instructions$3 = [
 		args: [
 		]
 	},
+	{
+		name: "initialize_pretoken_purchase_history",
+		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: "global_config"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
+			{
+				name: "pool_authority"
+			},
+			{
+				name: "global_state",
+				writable: true
+			},
+			{
+				name: "pool_pretoken_record",
+				writable: true
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
+	},
 	{
 		name: "initialize_processing_state",
 		docs: [
@@ -9423,6 +10140,10 @@ var instructions$3 = [
 			},
 			{
 				name: "system_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -9517,6 +10238,10 @@ var instructions$3 = [
 			},
 			{
 				name: "chainlink_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -9612,7 +10337,7 @@ var instructions$3 = [
 		name: "refresh_stake_metrics_post_sync",
 		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: [
@@ -9656,24 +10381,51 @@ var instructions$3 = [
 		]
 	},
 	{
-		name: "register_user",
+		name: "refund",
 		discriminator: [
 			2,
-			241,
-			150,
-			223,
-			99,
-			214,
-			116,
-			97
+			96,
+			183,
+			251,
+			63,
+			208,
+			46,
+			46
 		],
 		accounts: [
+			{
+				name: "associated_token_program"
+			},
 			{
 				name: "user",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "global_state",
 				writable: true
 			},
 			{
-				name: "user_ata",
+				name: "outpost_account",
+				writable: true
+			},
+			{
+				name: "distribution_state",
+				writable: true
+			},
+			{
+				name: "pool_authority"
+			},
+			{
+				name: "liqsol_pool_ata",
+				writable: true
+			},
+			{
+				name: "refund_liqsol_ata",
+				writable: true
+			},
+			{
+				name: "liqsol_pool_user_record",
 				writable: true
 			},
 			{
@@ -9681,13 +10433,118 @@ var instructions$3 = [
 				writable: true
 			},
 			{
-				name: "payer",
+				name: "extra_account_meta_list"
+			},
+			{
+				name: "liqsol_core_program"
+			},
+			{
+				name: "transfer_hook_program"
+			},
+			{
+				name: "liqsol_mint"
+			},
+			{
+				name: "token_program"
+			},
+			{
+				name: "bucket_authority"
+			},
+			{
+				name: "bucket_token_account",
+				writable: true
+			},
+			{
+				name: "bucket_user_record",
+				writable: true
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "register_system_pda",
+		discriminator: [
+			110,
+			93,
+			36,
+			156,
+			179,
+			69,
+			54,
+			210
+		],
+		accounts: [
+			{
+				name: "admin",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "global_config"
+			},
+			{
+				name: "pda_owner",
+				docs: [
+					"The PDA whose user record we're creating — must be system-owned (no program data)."
+				]
+			},
+			{
+				name: "pda_ata"
+			},
+			{
+				name: "user_record",
+				writable: true
+			},
+			{
+				name: "distribution_state",
+				writable: true
+			},
+			{
+				name: "bucket_authority"
+			},
+			{
+				name: "bucket_token_account",
 				docs: [
-					"Payer for the user record PDA creation (always the user)"
+					"The bucket's associated token account holding liqSOL (for index sync)"
 				],
+				writable: true
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "register_user",
+		discriminator: [
+			2,
+			241,
+			150,
+			223,
+			99,
+			214,
+			116,
+			97
+		],
+		accounts: [
+			{
+				name: "payer",
 				writable: true,
 				signer: true
 			},
+			{
+				name: "user_ata"
+			},
+			{
+				name: "user_record",
+				writable: true
+			},
 			{
 				name: "distribution_state",
 				writable: true
@@ -9853,7 +10710,8 @@ var instructions$3 = [
 				name: "bucket_token_account",
 				docs: [
 					"The bucket's token account holding liqSOL (for sync_index balance)"
-				]
+				],
+				writable: true
 			},
 			{
 				name: "reserve_pool",
@@ -10202,7 +11060,8 @@ var instructions$3 = [
 				name: "global_config"
 			},
 			{
-				name: "global_state"
+				name: "global_state",
+				writable: true
 			},
 			{
 				name: "user",
@@ -10295,7 +11154,7 @@ var instructions$3 = [
 		name: "sync_main_stake_accounts",
 		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: [
@@ -10463,6 +11322,10 @@ var instructions$3 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -10865,6 +11728,19 @@ var accounts$2 = [
 			150
 		]
 	},
+	{
+		name: "PretokenPurchaseHistory",
+		discriminator: [
+			33,
+			71,
+			113,
+			206,
+			33,
+			180,
+			236,
+			131
+		]
+	},
 	{
 		name: "PriceHistory",
 		discriminator: [
@@ -11377,12 +12253,24 @@ var types$5 = [
 					],
 					type: "u16"
 				},
+				{
+					name: "aggregate_mode_tag",
+					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
 						]
 					}
 				}
@@ -11615,7 +12503,9 @@ var types$5 = [
 				{
 					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"
 				},
@@ -11931,9 +12821,10 @@ var types$5 = [
 					type: "u64"
 				},
 				{
-					name: "last_pool_liqsol_balance",
+					name: "expected_pool_balance",
 					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"
 				},
@@ -12146,6 +13037,9 @@ var types$5 = [
 				},
 				{
 					name: "last_active_infos_synced_epoch",
+					docs: [
+						"DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+					],
 					type: "u16"
 				},
 				{
@@ -12160,6 +13054,9 @@ var types$5 = [
 				},
 				{
 					name: "last_distribution_slot",
+					docs: [
+						"DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+					],
 					type: {
 						option: "u64"
 					}
@@ -12324,6 +13221,24 @@ var types$5 = [
 				{
 					name: "bump",
 					type: "u8"
+				},
+				{
+					name: "accumulated_pretoken_yield",
+					type: {
+						option: "u64"
+					}
+				},
+				{
+					name: "last_epoch_synd_liqsol",
+					type: {
+						option: "u64"
+					}
+				},
+				{
+					name: "last_synd_epoch",
+					type: {
+						option: "u64"
+					}
 				}
 			]
 		}
@@ -12418,6 +13333,57 @@ var types$5 = [
 			]
 		}
 	},
+	{
+		name: "PretokenPurchaseHistory",
+		serialization: "bytemuck",
+		repr: {
+			kind: "c"
+		},
+		type: {
+			kind: "struct",
+			fields: [
+				{
+					name: "starting_epoch",
+					type: "u64"
+				},
+				{
+					name: "latest_epoch",
+					type: "u64"
+				},
+				{
+					name: "purchased_per_epoch",
+					type: {
+						array: [
+							"u64",
+							100
+						]
+					}
+				},
+				{
+					name: "synd_per_epoch",
+					type: {
+						array: [
+							"u64",
+							100
+						]
+					}
+				},
+				{
+					name: "bump",
+					type: "u8"
+				},
+				{
+					name: "_padding",
+					type: {
+						array: [
+							"u8",
+							7
+						]
+					}
+				}
+			]
+		}
+	},
 	{
 		name: "PretokenPurchased",
 		type: {
@@ -12678,56 +13644,56 @@ var types$5 = [
 				{
 					name: "addition_in_progress",
 					docs: [
-						"Whether validator addition selection is currently in progress (batched processing)"
+						"DEPRECATED — see BatchOrchestrator. Always false."
 					],
 					type: "bool"
 				},
 				{
 					name: "addition_next_rank",
 					docs: [
-						"Next rank to process in leaderboard sorted_indices"
+						"DEPRECATED — see BatchOrchestrator.addition_next_rank. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "addition_target_rank",
 					docs: [
-						"Target rank to process up to (inclusive)"
+						"DEPRECATED — see BatchOrchestrator.addition_target_rank. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "validators_added_this_selection",
 					docs: [
-						"Number of validators added in the current selection cycle"
+						"DEPRECATED — see BatchOrchestrator. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "removal_in_progress",
 					docs: [
-						"Whether validator removal selection is currently in progress (batched processing)"
+						"DEPRECATED — see BatchOrchestrator. Always false."
 					],
 					type: "bool"
 				},
 				{
 					name: "removal_next_index",
 					docs: [
-						"Next index in active list to check for removal"
+						"DEPRECATED — see BatchOrchestrator.removal_next_index. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "removal_active_list_snapshot",
 					docs: [
-						"Snapshot of active list count at start of removal (frozen)"
+						"DEPRECATED — see BatchOrchestrator. Always 0."
 					],
 					type: "u16"
 				},
 				{
 					name: "validators_removed_this_selection",
 					docs: [
-						"Number of validators removed in the current selection cycle"
+						"DEPRECATED — see BatchOrchestrator. Always 0."
 					],
 					type: "u16"
 				}
@@ -13583,6 +14549,41 @@ var instructions$2 = [
 				}
 			}
 		]
+	},
+	{
+		name: "update_liqsol_metadata_permissionless",
+		discriminator: [
+			21,
+			255,
+			26,
+			184,
+			136,
+			110,
+			214,
+			33
+		],
+		accounts: [
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "mint_authority"
+			},
+			{
+				name: "mint",
+				writable: true
+			},
+			{
+				name: "token_program"
+			},
+			{
+				name: "system_program"
+			}
+		],
+		args: [
+		]
 	}
 ];
 var errors$2 = [
@@ -14340,6 +15341,41 @@ var instructions = [
 				type: "u64"
 			}
 		]
+	},
+	{
+		name: "update_extra_account_meta_list",
+		discriminator: [
+			44,
+			125,
+			141,
+			226,
+			97,
+			179,
+			166,
+			96
+		],
+		accounts: [
+			{
+				name: "payer",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "extra_account_meta_list",
+				writable: true
+			},
+			{
+				name: "mint"
+			},
+			{
+				name: "system_program"
+			},
+			{
+				name: "liqsol_core"
+			}
+		],
+		args: [
+		]
 	}
 ];
 var accounts = [
@@ -14525,7 +15561,8 @@ const PDA_SEEDS = {
   WITHDRAW_MINT_AUTHORITY: "mint_authority",
   MINT_METADATA: "mint_metadata",
   LIQ_RECEIPT_DATA: "liq_receipt_data",
-  WITHDRAW_MINT: "mint"
+  WITHDRAW_MINT: "mint",
+  PRETOKEN_PURCHASE_HISTORY: "pretoken_purchase_history"
 };
 const deriveEphemeralStakeAddress = (user, seed) => __async$h(null, null, function* () {
   const seedStr = `ephemeral_${seed}`;
@@ -14731,6 +15768,7 @@ function buildOutpostAccounts(connection, user, pgs) {
     const liqsolPoolUserRecord = pgs.deriveUserRecordPda(liqsolPoolAta);
     const userUserRecord = pgs.deriveUserRecordPda(userAta);
     const extraAccountMetaList = pgs.deriveExtraAccountMetaListPda(liqsolMint);
+    const pretokenPurchaseHistory = pgs.derivePretokenPurchaseHistoryPda();
     let chainLinkFeed = CHAINLINK_FEED;
     let chainLinkProgram = CHAINLINK_PROGRAM;
     try {
@@ -14760,7 +15798,8 @@ function buildOutpostAccounts(connection, user, pgs) {
       trancheState,
       chainLinkFeed,
       chainLinkProgram,
-      extraAccountMetaList
+      extraAccountMetaList,
+      pretokenPurchaseHistory
     };
   });
 }
@@ -15168,6 +16207,7 @@ var __async$e = (__this, __arguments, generator) => {
     step((generator = generator.apply(__this, __arguments)).next());
   });
 };
+const INDEX_SCALE_BN = new anchor.BN("1000000000000");
 class DistributionClient {
   constructor(provider, pgs) {
     this.provider = provider;
@@ -15177,6 +16217,16 @@ class DistributionClient {
   get connection() {
     return this.provider.connection;
   }
+  getTokenBalance(ata) {
+    return __async$e(this, null, function* () {
+      try {
+        const bal = yield this.connection.getTokenAccountBalance(ata);
+        return new anchor.BN(bal.value.amount);
+      } catch (e) {
+        return new anchor.BN(0);
+      }
+    });
+  }
   getDistributionState() {
     return __async$e(this, null, function* () {
       const pda = this.pgs.deriveDistributionStatePda();
@@ -15256,6 +16306,85 @@ class DistributionClient {
       return { shares: userShares, totalShares, ratio };
     });
   }
+  getClaimableLiqsol(user) {
+    return __async$e(this, null, function* () {
+      const liqsolMint = this.pgs.deriveLiqsolMintPda();
+      const bucketAuthority = this.pgs.deriveBucketAuthorityPda();
+      const userAta = splToken.getAssociatedTokenAddressSync(
+        liqsolMint,
+        user,
+        true,
+        splToken.TOKEN_2022_PROGRAM_ID
+      );
+      const bucketTokenAccount = splToken.getAssociatedTokenAddressSync(
+        liqsolMint,
+        bucketAuthority,
+        true,
+        splToken.TOKEN_2022_PROGRAM_ID
+      );
+      const [distributionState, userRecord, actualBalance, bucketBalance] = yield Promise.all([
+        this.getDistributionState(),
+        this.getUserRecord(user),
+        this.getTokenBalance(userAta),
+        this.getTokenBalance(bucketTokenAccount)
+      ]);
+      if (!distributionState || !userRecord) {
+        return new anchor.BN(0);
+      }
+      let syncedIndex = new anchor.BN(distributionState.currentIndex.toString());
+      const totalShares = new anchor.BN(distributionState.totalShares.toString());
+      const lastBucketBalance = new anchor.BN(distributionState.lastBucketBalance.toString());
+      if (totalShares.gt(new anchor.BN(0)) && bucketBalance.gt(lastBucketBalance)) {
+        const delta = bucketBalance.sub(lastBucketBalance);
+        const indexDelta = delta.mul(INDEX_SCALE_BN).div(totalShares);
+        if (indexDelta.gt(new anchor.BN(0))) {
+          syncedIndex = syncedIndex.add(indexDelta);
+        }
+      }
+      const shares = new anchor.BN(userRecord.shares.toString());
+      const entitled = shares.mul(syncedIndex).div(INDEX_SCALE_BN);
+      if (entitled.lte(actualBalance)) {
+        return new anchor.BN(0);
+      }
+      return entitled.sub(actualBalance);
+    });
+  }
+  buildClaimRewardsIx(user) {
+    return __async$e(this, null, function* () {
+      const liqsolMint = this.pgs.deriveLiqsolMintPda();
+      const distributionState = this.pgs.deriveDistributionStatePda();
+      const bucketAuthority = this.pgs.deriveBucketAuthorityPda();
+      const userAta = splToken.getAssociatedTokenAddressSync(
+        liqsolMint,
+        user,
+        true,
+        splToken.TOKEN_2022_PROGRAM_ID
+      );
+      const bucketTokenAccount = splToken.getAssociatedTokenAddressSync(
+        liqsolMint,
+        bucketAuthority,
+        true,
+        splToken.TOKEN_2022_PROGRAM_ID
+      );
+      const userRecord = this.pgs.deriveUserRecordPda(userAta);
+      const bucketUserRecord = this.pgs.deriveUserRecordPda(bucketTokenAccount);
+      const extraAccountMetaList = this.pgs.deriveExtraAccountMetaListPda(liqsolMint);
+      return this.program.methods.claimRewards().accounts({
+        user,
+        userAta,
+        userRecord,
+        bucketUserRecord,
+        distributionState,
+        extraAccountMetaList,
+        liqsolCoreProgram: this.pgs.PROGRAM_IDS.LIQSOL_CORE,
+        transferHookProgram: this.pgs.PROGRAM_IDS.TRANSFER_HOOK,
+        liqsolMint,
+        bucketAuthority,
+        bucketTokenAccount,
+        tokenProgram: splToken.TOKEN_2022_PROGRAM_ID
+      }).instruction();
+    });
+  }
   getAverageScaledPayRate(windowSize = 5) {
     return __async$e(this, null, function* () {
       var _a, _b, _c, _d, _e;
@@ -15509,7 +16638,8 @@ class OutpostClient {
         outpostAccount: a.outpostAccount,
         tokenProgram: splToken.TOKEN_2022_PROGRAM_ID,
         associatedTokenProgram: splToken.ASSOCIATED_TOKEN_PROGRAM_ID,
-        systemProgram: web3_js.SystemProgram.programId
+        systemProgram: web3_js.SystemProgram.programId,
+        pretokenPurchaseHistory: a.pretokenPurchaseHistory
       }).instruction();
     });
   }
@@ -15539,7 +16669,8 @@ class OutpostClient {
         outpostAccount: a.outpostAccount,
         tokenProgram: splToken.TOKEN_2022_PROGRAM_ID,
         systemProgram: web3_js.SystemProgram.programId,
-        associatedTokenProgram: splToken.ASSOCIATED_TOKEN_PROGRAM_ID
+        associatedTokenProgram: splToken.ASSOCIATED_TOKEN_PROGRAM_ID,
+        pretokenPurchaseHistory: a.pretokenPurchaseHistory
       }).instruction();
     });
   }
@@ -15671,7 +16802,8 @@ class TokenClient {
         chainlinkProgram: (_b = a.chainLinkProgram) != null ? _b : CHAINLINK_PROGRAM,
         tokenProgram: splToken.TOKEN_2022_PROGRAM_ID,
         associatedTokenProgram: splToken.ASSOCIATED_TOKEN_PROGRAM_ID,
-        systemProgram: web3_js.SystemProgram.programId
+        systemProgram: web3_js.SystemProgram.programId,
+        pretokenPurchaseHistory: a.pretokenPurchaseHistory
       }).instruction();
     });
   }
@@ -15916,6 +17048,12 @@ class SolanaProgramService {
       this.ids.LIQSOL_CORE
     )[0];
   }
+  derivePretokenPurchaseHistoryPda() {
+    return web3_js.PublicKey.findProgramAddressSync(
+      [Buffer.from(PDA_SEEDS.PRETOKEN_PURCHASE_HISTORY)],
+      this.ids.LIQSOL_CORE
+    )[0];
+  }
   deriveWithdrawNftMintPda(receiptId) {
     const receiptIdBytes = Buffer.alloc(8);
     const asBigInt = typeof receiptId === "bigint" ? receiptId : BigInt(receiptId.toString());
@@ -16188,6 +17326,20 @@ const _SolanaStakingClient = class _SolanaStakingClient {
       }
     });
   }
+  claimLiqsolRewards() {
+    return __async$9(this, null, function* () {
+      var _a;
+      this.ensureUser();
+      const owner = (_a = this.squadsVaultPDA) != null ? _a : this.anchor.wallet.publicKey;
+      try {
+        const ix = yield this.distributionClient.buildClaimRewardsIx(owner);
+        return !!this.squadsX ? yield this.sendSquadsIxs(ix) : yield this.buildAndSendIx(ix);
+      } catch (err) {
+        console.log(`Failed to claim liqSOL rewards on Solana: ${err}`);
+        throw err;
+      }
+    });
+  }
   stake(amountLamports) {
     return __async$9(this, null, function* () {
       this.ensureUser();
@@ -16245,10 +17397,11 @@ const _SolanaStakingClient = class _SolanaStakingClient {
           splToken.TOKEN_2022_PROGRAM_ID,
           splToken.ASSOCIATED_TOKEN_PROGRAM_ID
         );
-        const [nativeLamports, actualBalResp, snapshot] = yield Promise.all([
+        const [nativeLamports, actualBalResp, snapshot, claimableLamports] = yield Promise.all([
           this.connection.getBalance(user, "confirmed"),
           this.connection.getTokenAccountBalance(userLiqsolAta, "confirmed").catch(() => null),
-          this.outpostClient.fetchWireState(user).catch(() => null)
+          this.outpostClient.fetchWireState(user).catch(() => null),
+          this.distributionClient.getClaimableLiqsol(user).catch(() => new anchor.BN(0))
         ]);
         const LIQSOL_DECIMALS = 9;
         const actualAmountStr = (_b = (_a = actualBalResp == null ? void 0 : actualBalResp.value) == null ? void 0 : _a.amount) != null ? _b : "0";
@@ -16285,6 +17438,12 @@ const _SolanaStakingClient = class _SolanaStakingClient {
             decimals: LIQSOL_DECIMALS,
             ata: userLiqsolAta
           },
+          claimable: {
+            amount: BigInt(claimableLamports.toString()),
+            symbol: "LiqSOL",
+            decimals: LIQSOL_DECIMALS,
+            ata: userLiqsolAta
+          },
           staked: {
             amount: stakedLiqsol,
             symbol: "LiqSOL",
@@ -42132,6 +43291,10 @@ class EthereumStakingClient {
   get network() {
     return this.config.network;
   }
+  get address() {
+    var _a;
+    return (_a = this.signer) == null ? void 0 : _a.getAddress();
+  }
   deposit(amount) {
     return __async(this, null, function* () {
       this.ensureUser();
@@ -42143,7 +43306,7 @@ class EthereumStakingClient {
   withdraw(amount) {
     return __async(this, null, function* () {
       this.ensureUser();
-      const address = yield this.signer.getAddress();
+      const address = yield this.address;
       const amountWei = ethers.BigNumber.from(amount);
       const result = yield this.convertClient.performWithdraw(address, amountWei);
       return result.txHash;
@@ -42152,7 +43315,7 @@ class EthereumStakingClient {
   getPendingWithdraws() {
     return __async(this, null, function* () {
       this.ensureUser();
-      const address = yield this.signer.getAddress();
+      const address = yield this.address;
       return yield this.receiptClient.fetchWithdrawReceipts(address);
     });
   }
@@ -42167,7 +43330,7 @@ class EthereumStakingClient {
   stake(amount) {
     return __async(this, null, function* () {
       this.ensureUser();
-      const walletAddress = yield this.signer.getAddress();
+      const walletAddress = yield this.address;
       const amountWei = ethers.BigNumber.from(amount);
       const result = yield this.stakeClient.performStake(amountWei, walletAddress);
       return result.txHash;
@@ -42189,7 +43352,7 @@ class EthereumStakingClient {
   buy(amount) {
     return __async(this, null, function* () {
       this.ensureUser();
-      const buyer = yield this.signer.getAddress();
+      const buyer = yield this.address;
       let result = yield this.pretokenClient.purchasePretokensWithLiqETH(amount, buyer);
       return result && result.txHash ? result.txHash : "Error - no resulting txHash";
     });
@@ -42206,7 +43369,7 @@ class EthereumStakingClient {
       var _a, _b, _c, _d, _e, _f, _g, _h, _i;
       try {
         if (!this.signer) return Promise.resolve(null);
-        const walletAddress = yield this.signer.getAddress();
+        const walletAddress = yield this.address;
         const nativeBalance = yield this.provider.getBalance(walletAddress);
         const nativeDecimals = (_c = (_b = (_a = this.network) == null ? void 0 : _a.nativeCurrency) == null ? void 0 : _b.decimals) != null ? _c : 18;
         const nativeSymbol = (_f = (_e = (_d = this.network) == null ? void 0 : _d.nativeCurrency) == null ? void 0 : _e.symbol) != null ? _f : "ETH";
@@ -42286,14 +43449,14 @@ class EthereumStakingClient {
   fetchPrelaunchReceipts(address) {
     return __async(this, null, function* () {
       this.ensureUser();
-      if (address === void 0) address = yield this.signer.getAddress();
+      if (address === void 0) address = yield this.address;
       return yield this.receiptClient.stakeReceipts(address);
     });
   }
   getOPPMessages(address) {
     return __async(this, null, function* () {
       this.ensureUser();
-      if (!address) address = yield this.signer.getAddress();
+      if (!address) address = yield this.address;
       return yield this.oppClient.getMessages(address);
     });
   }
@@ -42381,7 +43544,7 @@ class EthereumStakingClient {
     return __async(this, null, function* () {
       var _a, _b, _c, _d, _e;
       this.ensureUser();
-      const walletAddress = yield this.signer.getAddress();
+      const walletAddress = yield this.address;
       const baseGas = yield this.provider.estimateGas({
         from: walletAddress,
         to: walletAddress,