@wireio/stake 2.3.1 → 2.4.0

package/lib/stake.m.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,50 +2631,182 @@ 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: "user_record",
+				name: "distribution_state",
 				writable: true
 			},
 			{
-				name: "payer",
-				docs: [
-					"Payer for the user record PDA creation (always the user)"
-				],
-				writable: true,
-				signer: true
+				name: "pool_authority"
 			},
 			{
-				name: "distribution_state",
+				name: "liqsol_pool_ata",
+				writable: true
+			},
+			{
+				name: "refund_liqsol_ata",
+				writable: true
+			},
+			{
+				name: "liqsol_pool_user_record",
+				writable: true
+			},
+			{
+				name: "user_record",
 				writable: true
 			},
+			{
+				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",
-				docs: [
-					"The bucket's associated token account holding liqSOL (for index sync)"
-				],
+				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
+			},
+			{
+				name: "bucket_authority"
+			},
+			{
+				name: "bucket_token_account",
+				docs: [
+					"The bucket's associated token account holding liqSOL (for index sync)"
+				],
 				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 = [
@@ -7279,10 +7797,55 @@ var instructions$3 = [
 		]
 	},
 	{
-		name: "aggregate_stake_metrics",
-		docs: [
-			"V2: Aggregate stake metrics across all validators using PDA architecture"
-		],
+		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: [
+			"V2: Aggregate stake metrics across all validators using PDA architecture"
+		],
 		discriminator: [
 			13,
 			245,
@@ -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: [
@@ -9563,72 +10288,212 @@ var instructions$3 = [
 				signer: true
 			},
 			{
-				name: "stake_metrics",
+				name: "stake_metrics",
+				writable: true
+			},
+			{
+				name: "epoch_state",
+				writable: true
+			},
+			{
+				name: "processing_state",
+				writable: true
+			},
+			{
+				name: "active_list"
+			},
+			{
+				name: "global_config",
+				docs: [
+					"Global config for late epoch slot gate"
+				]
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "refresh_stake_metrics_post_sync",
+		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: "stake_metrics",
+				writable: true
+			},
+			{
+				name: "epoch_state",
+				writable: true
+			},
+			{
+				name: "processing_state",
+				writable: true
+			},
+			{
+				name: "active_list"
+			},
+			{
+				name: "global_config",
+				docs: [
+					"Global config for late epoch slot gate"
+				]
+			}
+		],
+		args: [
+		]
+	},
+	{
+		name: "refund",
+		discriminator: [
+			2,
+			96,
+			183,
+			251,
+			63,
+			208,
+			46,
+			46
+		],
+		accounts: [
+			{
+				name: "associated_token_program"
+			},
+			{
+				name: "user",
+				writable: true,
+				signer: true
+			},
+			{
+				name: "global_state",
+				writable: true
+			},
+			{
+				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
+			},
+			{
+				name: "user_record",
 				writable: true
 			},
 			{
-				name: "epoch_state",
-				writable: true
+				name: "extra_account_meta_list"
 			},
 			{
-				name: "processing_state",
+				name: "liqsol_core_program"
+			},
+			{
+				name: "transfer_hook_program"
+			},
+			{
+				name: "liqsol_mint"
+			},
+			{
+				name: "token_program"
+			},
+			{
+				name: "bucket_authority"
+			},
+			{
+				name: "bucket_token_account",
 				writable: true
 			},
 			{
-				name: "active_list"
+				name: "bucket_user_record",
+				writable: true
 			},
 			{
-				name: "global_config",
-				docs: [
-					"Global config for late epoch slot gate"
-				]
+				name: "system_program"
 			}
 		],
 		args: [
 		]
 	},
 	{
-		name: "refresh_stake_metrics_post_sync",
-		docs: [
-			"V2: Refresh stake metrics after removal selection + PDA setup",
-			"Requires ActiveInfosSynced + ValidatorPdaSetup as prerequisites",
-			"Tracks completion in last_post_sync_stake_metrics_refresh_epoch"
-		],
+		name: "register_system_pda",
 		discriminator: [
-			177,
-			250,
-			32,
-			155,
-			196,
-			199,
-			199,
-			249
+			110,
+			93,
+			36,
+			156,
+			179,
+			69,
+			54,
+			210
 		],
 		accounts: [
 			{
 				name: "admin",
+				writable: true,
 				signer: true
 			},
 			{
-				name: "stake_metrics",
-				writable: true
+				name: "global_config"
 			},
 			{
-				name: "epoch_state",
+				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: "processing_state",
+				name: "distribution_state",
 				writable: true
 			},
 			{
-				name: "active_list"
+				name: "bucket_authority"
 			},
 			{
-				name: "global_config",
+				name: "bucket_token_account",
 				docs: [
-					"Global config for late epoch slot gate"
-				]
+					"The bucket's associated token account holding liqSOL (for index sync)"
+				],
+				writable: true
+			},
+			{
+				name: "system_program"
 			}
 		],
 		args: [
@@ -9648,25 +10513,17 @@ var instructions$3 = [
 		],
 		accounts: [
 			{
-				name: "user",
-				writable: true
+				name: "payer",
+				writable: true,
+				signer: true
 			},
 			{
-				name: "user_ata",
-				writable: true
+				name: "user_ata"
 			},
 			{
 				name: "user_record",
 				writable: true
 			},
-			{
-				name: "payer",
-				docs: [
-					"Payer for the user record PDA creation (always the user)"
-				],
-				writable: true,
-				signer: 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) {
@@ -15397,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) {
@@ -15425,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) {
@@ -15524,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() {
@@ -15725,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());