@wireio/stake 2.3.0 → 2.4.0

package/lib/stake.browser.js

@@ -67,6 +67,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: [
@@ -841,6 +886,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: [
@@ -917,6 +1028,10 @@ var instructions$7 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -959,6 +1074,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: [
@@ -1310,6 +1463,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: [
@@ -2191,6 +2390,10 @@ var instructions$7 = [
 			},
 			{
 				name: "system_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -2285,6 +2488,10 @@ var instructions$7 = [
 			},
 			{
 				name: "chainlink_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -2380,7 +2587,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: [
@@ -2424,24 +2631,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
 			},
 			{
@@ -2449,13 +2683,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
@@ -2621,7 +2960,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",
@@ -2970,7 +3310,8 @@ var instructions$7 = [
 				name: "global_config"
 			},
 			{
-				name: "global_state"
+				name: "global_state",
+				writable: true
 			},
 			{
 				name: "user",
@@ -3063,7 +3404,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: [
@@ -3231,6 +3572,10 @@ var instructions$7 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -3633,6 +3978,19 @@ var accounts$5 = [
 			150
 		]
 	},
+	{
+		name: "PretokenPurchaseHistory",
+		discriminator: [
+			33,
+			71,
+			113,
+			206,
+			33,
+			180,
+			236,
+			131
+		]
+	},
 	{
 		name: "PriceHistory",
 		discriminator: [
@@ -4145,12 +4503,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
 						]
 					}
 				}
@@ -4383,7 +4753,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"
 				},
@@ -4699,9 +5071,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"
 				},
@@ -4914,6 +5287,9 @@ var types$9 = [
 				},
 				{
 					name: "last_active_infos_synced_epoch",
+					docs: [
+						"DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+					],
 					type: "u16"
 				},
 				{
@@ -4928,6 +5304,9 @@ var types$9 = [
 				},
 				{
 					name: "last_distribution_slot",
+					docs: [
+						"DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+					],
 					type: {
 						option: "u64"
 					}
@@ -5092,6 +5471,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"
+					}
 				}
 			]
 		}
@@ -5186,6 +5583,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: {
@@ -5446,56 +5894,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"
 				}
@@ -6351,6 +6799,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 = [
@@ -7108,6 +7591,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 = [
@@ -7278,6 +7796,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: [
@@ -8052,6 +8615,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: [
@@ -8128,6 +8757,10 @@ var instructions$3 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -8170,6 +8803,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: [
@@ -8521,6 +9192,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: [
@@ -9402,6 +10119,10 @@ var instructions$3 = [
 			},
 			{
 				name: "system_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -9496,6 +10217,10 @@ var instructions$3 = [
 			},
 			{
 				name: "chainlink_program"
+			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
 			}
 		],
 		args: [
@@ -9591,7 +10316,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: [
@@ -9635,24 +10360,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
 			},
 			{
@@ -9660,13 +10412,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: [
-					"Payer for the user record PDA creation (always the user)"
+					"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
@@ -9832,7 +10689,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",
@@ -10181,7 +11039,8 @@ var instructions$3 = [
 				name: "global_config"
 			},
 			{
-				name: "global_state"
+				name: "global_state",
+				writable: true
 			},
 			{
 				name: "user",
@@ -10274,7 +11133,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: [
@@ -10442,6 +11301,10 @@ var instructions$3 = [
 				],
 				writable: true
 			},
+			{
+				name: "pretoken_purchase_history",
+				writable: true
+			},
 			{
 				name: "token_program"
 			},
@@ -10844,6 +11707,19 @@ var accounts$2 = [
 			150
 		]
 	},
+	{
+		name: "PretokenPurchaseHistory",
+		discriminator: [
+			33,
+			71,
+			113,
+			206,
+			33,
+			180,
+			236,
+			131
+		]
+	},
 	{
 		name: "PriceHistory",
 		discriminator: [
@@ -11356,12 +12232,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
 						]
 					}
 				}
@@ -11594,7 +12482,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"
 				},
@@ -11910,9 +12800,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"
 				},
@@ -12125,6 +13016,9 @@ var types$5 = [
 				},
 				{
 					name: "last_active_infos_synced_epoch",
+					docs: [
+						"DEPRECATED: ActiveInfosSynced removed in WIN-134. Retained to preserve account layout."
+					],
 					type: "u16"
 				},
 				{
@@ -12139,6 +13033,9 @@ var types$5 = [
 				},
 				{
 					name: "last_distribution_slot",
+					docs: [
+						"DEPRECATED: Distribution slot tracking removed in PR113. Retained to preserve account layout."
+					],
 					type: {
 						option: "u64"
 					}
@@ -12303,6 +13200,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"
+					}
 				}
 			]
 		}
@@ -12397,6 +13312,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: {
@@ -12657,56 +13623,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"
 				}
@@ -13562,6 +14528,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 = [
@@ -14319,6 +15320,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 = [
@@ -14484,7 +15520,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 = async (user, seed) => {
   const seedStr = `ephemeral_${seed}`;
@@ -14669,6 +15706,7 @@ async 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 {
@@ -14698,7 +15736,8 @@ async function buildOutpostAccounts(connection, user, pgs) {
     trancheState,
     chainLinkFeed,
     chainLinkProgram,
-    extraAccountMetaList
+    extraAccountMetaList,
+    pretokenPurchaseHistory
   };
 }
 async function getEpochSnapshot(connection) {
@@ -15040,6 +16079,7 @@ let ConvertClient$1 = class ConvertClient {
   }
 };
 
+const INDEX_SCALE_BN = new BN("1000000000000");
 class DistributionClient {
   constructor(provider, pgs) {
     this.provider = provider;
@@ -15049,6 +16089,14 @@ class DistributionClient {
   get connection() {
     return this.provider.connection;
   }
+  async getTokenBalance(ata) {
+    try {
+      const bal = await this.connection.getTokenAccountBalance(ata);
+      return new BN(bal.value.amount);
+    } catch {
+      return new BN(0);
+    }
+  }
   async getDistributionState() {
     const pda = this.pgs.deriveDistributionStatePda();
     try {
@@ -15116,6 +16164,81 @@ class DistributionClient {
     }
     return { shares: userShares, totalShares, ratio };
   }
+  async getClaimableLiqsol(user) {
+    const liqsolMint = this.pgs.deriveLiqsolMintPda();
+    const bucketAuthority = this.pgs.deriveBucketAuthorityPda();
+    const userAta = getAssociatedTokenAddressSync(
+      liqsolMint,
+      user,
+      true,
+      TOKEN_2022_PROGRAM_ID
+    );
+    const bucketTokenAccount = getAssociatedTokenAddressSync(
+      liqsolMint,
+      bucketAuthority,
+      true,
+      TOKEN_2022_PROGRAM_ID
+    );
+    const [distributionState, userRecord, actualBalance, bucketBalance] = await Promise.all([
+      this.getDistributionState(),
+      this.getUserRecord(user),
+      this.getTokenBalance(userAta),
+      this.getTokenBalance(bucketTokenAccount)
+    ]);
+    if (!distributionState || !userRecord) {
+      return new BN(0);
+    }
+    let syncedIndex = new BN(distributionState.currentIndex.toString());
+    const totalShares = new BN(distributionState.totalShares.toString());
+    const lastBucketBalance = new BN(distributionState.lastBucketBalance.toString());
+    if (totalShares.gt(new BN(0)) && bucketBalance.gt(lastBucketBalance)) {
+      const delta = bucketBalance.sub(lastBucketBalance);
+      const indexDelta = delta.mul(INDEX_SCALE_BN).div(totalShares);
+      if (indexDelta.gt(new BN(0))) {
+        syncedIndex = syncedIndex.add(indexDelta);
+      }
+    }
+    const shares = new BN(userRecord.shares.toString());
+    const entitled = shares.mul(syncedIndex).div(INDEX_SCALE_BN);
+    if (entitled.lte(actualBalance)) {
+      return new BN(0);
+    }
+    return entitled.sub(actualBalance);
+  }
+  async buildClaimRewardsIx(user) {
+    const liqsolMint = this.pgs.deriveLiqsolMintPda();
+    const distributionState = this.pgs.deriveDistributionStatePda();
+    const bucketAuthority = this.pgs.deriveBucketAuthorityPda();
+    const userAta = getAssociatedTokenAddressSync(
+      liqsolMint,
+      user,
+      true,
+      TOKEN_2022_PROGRAM_ID
+    );
+    const bucketTokenAccount = getAssociatedTokenAddressSync(
+      liqsolMint,
+      bucketAuthority,
+      true,
+      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: TOKEN_2022_PROGRAM_ID
+    }).instruction();
+  }
   async getAverageScaledPayRate(windowSize = 5) {
     const history = await this.getPayRateHistory();
     if (!history) {
@@ -15313,7 +16436,8 @@ class OutpostClient {
       outpostAccount: a.outpostAccount,
       tokenProgram: TOKEN_2022_PROGRAM_ID,
       associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
-      systemProgram: SystemProgram.programId
+      systemProgram: SystemProgram.programId,
+      pretokenPurchaseHistory: a.pretokenPurchaseHistory
     }).instruction();
   }
   async buildUnstakeIx(amountLamports, user) {
@@ -15341,7 +16465,8 @@ class OutpostClient {
       outpostAccount: a.outpostAccount,
       tokenProgram: TOKEN_2022_PROGRAM_ID,
       systemProgram: SystemProgram.programId,
-      associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID
+      associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
+      pretokenPurchaseHistory: a.pretokenPurchaseHistory
     }).instruction();
   }
   previewPretokens(params) {
@@ -15440,7 +16565,8 @@ class TokenClient {
       chainlinkProgram: a.chainLinkProgram ?? CHAINLINK_PROGRAM,
       tokenProgram: TOKEN_2022_PROGRAM_ID,
       associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
-      systemProgram: SystemProgram.programId
+      systemProgram: SystemProgram.programId,
+      pretokenPurchaseHistory: a.pretokenPurchaseHistory
     }).instruction();
   }
   async getSolPriceUsdSafe() {
@@ -15641,6 +16767,12 @@ class SolanaProgramService {
       this.ids.LIQSOL_CORE
     )[0];
   }
+  derivePretokenPurchaseHistoryPda() {
+    return 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());
@@ -15872,6 +17004,17 @@ const _SolanaStakingClient = class _SolanaStakingClient {
       throw err;
     }
   }
+  async claimLiqsolRewards() {
+    this.ensureUser();
+    const owner = this.squadsVaultPDA ?? this.anchor.wallet.publicKey;
+    try {
+      const ix = await this.distributionClient.buildClaimRewardsIx(owner);
+      return !!this.squadsX ? await this.sendSquadsIxs(ix) : await this.buildAndSendIx(ix);
+    } catch (err) {
+      console.log(`Failed to claim liqSOL rewards on Solana: ${err}`);
+      throw err;
+    }
+  }
   async stake(amountLamports) {
     this.ensureUser();
     if (!amountLamports || amountLamports <= BigInt(0))
@@ -15921,10 +17064,11 @@ const _SolanaStakingClient = class _SolanaStakingClient {
         TOKEN_2022_PROGRAM_ID,
         ASSOCIATED_TOKEN_PROGRAM_ID
       );
-      const [nativeLamports, actualBalResp, snapshot] = await Promise.all([
+      const [nativeLamports, actualBalResp, snapshot, claimableLamports] = await 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 BN(0))
       ]);
       const LIQSOL_DECIMALS = 9;
       const actualAmountStr = actualBalResp?.value?.amount ?? "0";
@@ -15961,6 +17105,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",
@@ -41534,6 +42684,9 @@ class EthereumStakingClient {
   get network() {
     return this.config.network;
   }
+  get address() {
+    return this.signer?.getAddress();
+  }
   async deposit(amount) {
     this.ensureUser();
     const amountWei = BigNumber.isBigNumber(amount) ? amount : BigNumber.from(amount);
@@ -41542,14 +42695,14 @@ class EthereumStakingClient {
   }
   async withdraw(amount) {
     this.ensureUser();
-    const address = await this.signer.getAddress();
+    const address = await this.address;
     const amountWei = BigNumber.from(amount);
     const result = await this.convertClient.performWithdraw(address, amountWei);
     return result.txHash;
   }
   async getPendingWithdraws() {
     this.ensureUser();
-    const address = await this.signer.getAddress();
+    const address = await this.address;
     return await this.receiptClient.fetchWithdrawReceipts(address);
   }
   async claimWithdraw(tokenId) {
@@ -41560,7 +42713,7 @@ class EthereumStakingClient {
   }
   async stake(amount) {
     this.ensureUser();
-    const walletAddress = await this.signer.getAddress();
+    const walletAddress = await this.address;
     const amountWei = BigNumber.from(amount);
     const result = await this.stakeClient.performStake(amountWei, walletAddress);
     return result.txHash;
@@ -41576,7 +42729,7 @@ class EthereumStakingClient {
   }
   async buy(amount) {
     this.ensureUser();
-    const buyer = await this.signer.getAddress();
+    const buyer = await this.address;
     let result = await this.pretokenClient.purchasePretokensWithLiqETH(amount, buyer);
     return result && result.txHash ? result.txHash : "Error - no resulting txHash";
   }
@@ -41588,7 +42741,7 @@ class EthereumStakingClient {
   async getPortfolio() {
     try {
       if (!this.signer) return Promise.resolve(null);
-      const walletAddress = await this.signer.getAddress();
+      const walletAddress = await this.address;
       const nativeBalance = await this.provider.getBalance(walletAddress);
       const nativeDecimals = this.network?.nativeCurrency?.decimals ?? 18;
       const nativeSymbol = this.network?.nativeCurrency?.symbol ?? "ETH";
@@ -41666,12 +42819,12 @@ class EthereumStakingClient {
   }
   async fetchPrelaunchReceipts(address) {
     this.ensureUser();
-    if (address === void 0) address = await this.signer.getAddress();
+    if (address === void 0) address = await this.address;
     return await this.receiptClient.stakeReceipts(address);
   }
   async getOPPMessages(address) {
     this.ensureUser();
-    if (!address) address = await this.signer.getAddress();
+    if (!address) address = await this.address;
     return await this.oppClient.getMessages(address);
   }
   ensureUser() {
@@ -41746,7 +42899,7 @@ class EthereumStakingClient {
   }
   async getDepositBuffer(options) {
     this.ensureUser();
-    const walletAddress = await this.signer.getAddress();
+    const walletAddress = await this.address;
     const baseGas = await this.provider.estimateGas({
       from: walletAddress,
       to: walletAddress,