@wireio/stake 2.3.1 → 2.4.1

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,50 +2652,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
 			},
 			{
@@ -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 = [
@@ -7300,10 +7818,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,
@@ -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: [
@@ -9584,72 +10309,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: [
@@ -9669,25 +10534,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
@@ -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(poolAuthority);
     let chainLinkFeed = CHAINLINK_FEED;
     let chainLinkProgram = CHAINLINK_PROGRAM;
     try {
@@ -14760,7 +15798,8 @@ function buildOutpostAccounts(connection, user, pgs) {
       trancheState,
       chainLinkFeed,
       chainLinkProgram,
-      extraAccountMetaList
+      extraAccountMetaList,
+      pretokenPurchaseHistory
     };
   });
 }
@@ -15599,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();
     });
   }
@@ -15629,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();
     });
   }
@@ -15761,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();
     });
   }
@@ -16006,6 +17048,12 @@ class SolanaProgramService {
       this.ids.LIQSOL_CORE
     )[0];
   }
+  derivePretokenPurchaseHistoryPda(poolAuthority) {
+    return web3_js.PublicKey.findProgramAddressSync(
+      [Buffer.from(PDA_SEEDS.PRETOKEN_PURCHASE_HISTORY), poolAuthority.toBuffer()],
+      this.ids.LIQSOL_CORE
+    )[0];
+  }
   deriveWithdrawNftMintPda(receiptId) {
     const receiptIdBytes = Buffer.alloc(8);
     const asBigInt = typeof receiptId === "bigint" ? receiptId : BigInt(receiptId.toString());