Skip to main content

oil_api/
sdk.rs

1use solana_program::pubkey::Pubkey;
2use spl_associated_token_account::get_associated_token_address;
3use steel::*;
4
5use crate::{
6    consts::{AUCTION, BOARD, MINT_ADDRESS, SOL_MINT, TREASURY_ADDRESS},
7    instruction::{self, *},
8    state::*,
9};
10
11pub fn log(signer: Pubkey, msg: &[u8]) -> Instruction {
12    let mut data = Log {}.to_bytes();
13    data.extend_from_slice(msg);
14    Instruction {
15        program_id: crate::ID,
16        accounts: vec![AccountMeta::new(signer, true)],
17        data: data,
18    }
19}
20
21pub fn program_log(accounts: &[AccountInfo], msg: &[u8]) -> Result<(), ProgramError> {
22    // Derive Board PDA to use as signer for log instruction
23    let (board_address, _) = board_pda();
24    invoke_signed(&log(board_address, msg), accounts, &crate::ID, &[BOARD])
25}
26
27/// Log event for auction-based instructions (uses Auction PDA instead of Board)
28pub fn auction_program_log(accounts: &[AccountInfo], msg: &[u8]) -> Result<(), ProgramError> {
29    // Derive Auction PDA to use as signer for log instruction
30    let (auction_address, _) = auction_pda();
31    invoke_signed(&log(auction_address, msg), accounts, &crate::ID, &[AUCTION])
32}
33
34// let [signer_info, board_info, config_info, mint_info, treasury_info, treasury_tokens_info, system_program, token_program, associated_token_program] = accounts else {
35
36// pub fn initialize(
37//     signer: Pubkey,
38//     barrel_authority: Pubkey,
39//     fee_collector: Pubkey,
40//     swap_program: Pubkey,
41//     var_address: Pubkey,
42//     admin_fee: u64,
43// ) -> Instruction {
44//     let board_address = board_pda().0;
45//     let config_address = config_pda().0;
46//     let mint_address = MINT_ADDRESS;
47//     let treasury_address = TREASURY_ADDRESS;
48//     let treasury_tokens_address = treasury_tokens_address();
49//     Instruction {
50//         program_id: crate::ID,
51//         accounts: vec![
52//             AccountMeta::new(signer, true),
53//             AccountMeta::new(board_address, false),
54//             AccountMeta::new(config_address, false),
55//             AccountMeta::new(mint_address, false),
56//             AccountMeta::new(treasury_address, false),
57//             AccountMeta::new(treasury_tokens_address, false),
58//             AccountMeta::new_readonly(system_program::ID, false),
59//             AccountMeta::new_readonly(spl_token::ID, false),
60//             AccountMeta::new_readonly(spl_associated_token_account::ID, false),
61//         ],
62//         data: Initialize {
63//             barrel_authority: barrel_authority.to_bytes(),
64//             fee_collector: fee_collector.to_bytes(),
65//             swap_program: swap_program.to_bytes(),
66//             var_address: var_address.to_bytes(),
67//             admin_fee: admin_fee.to_le_bytes(),
68//         }
69//         .to_bytes(),
70//     }
71// }
72
73// let [signer_info, automation_info, executor_info, miner_info, system_program] = accounts else {
74
75/// Set up automation for a miner. If the miner doesn't exist yet, pass a referrer to set it.
76/// If a referrer is provided and the miner is new, the referral account must be included.
77pub fn automate(
78    signer: Pubkey,
79    authority: Pubkey,
80    amount: u64,
81    deposit: u64,
82    executor: Pubkey,
83    fee: u64,
84    mask: u64,
85    strategy: u8,
86    reload: bool,
87    referrer: Option<Pubkey>,
88    pooled: bool,
89    is_new_miner: bool,
90) -> Instruction {
91    let automation_address = automation_pda(authority).0;
92    let miner_address = miner_pda(authority).0;
93    let config_address = config_pda().0;
94    let referrer_pk = referrer.unwrap_or(Pubkey::default());
95    
96    let mut accounts = vec![
97            AccountMeta::new(signer, true), // 0: signer (payer)
98            AccountMeta::new(authority, false), // 1: authority (user's wallet)
99            AccountMeta::new(automation_address, false), // 2: automation
100            AccountMeta::new(executor, false), // 3: executor
101            AccountMeta::new(miner_address, false), // 4: miner
102            AccountMeta::new_readonly(system_program::ID, false), // 5: system_program
103            AccountMeta::new_readonly(crate::ID, false), // 6: oil_program
104            AccountMeta::new_readonly(config_address, false), // 7: config
105    ];
106    
107    // Token accounts (user_wrapped_sol, automation_wrapped_sol, token_program, program_signer (optional), payer (optional), mint, ata_program)
108    // These are added by the client, not here in the SDK
109    
110    // Add referral account if referrer is provided and miner is new (for incrementing total_referred)
111    if is_new_miner && referrer.is_some() && referrer_pk != Pubkey::default() {
112        let referral_address = referral_pda(referrer_pk).0;
113        accounts.push(AccountMeta::new(referral_address, false));
114    }
115    
116    Instruction {
117        program_id: crate::ID,
118        accounts,
119        data: Automate {
120            amount: amount.to_le_bytes(),
121            deposit: deposit.to_le_bytes(),
122            fee: fee.to_le_bytes(),
123            mask: mask.to_le_bytes(),
124            strategy: strategy as u8,
125            reload: (reload as u64).to_le_bytes(),
126            referrer: referrer_pk.to_bytes(),
127            pooled: pooled as u8,
128        }
129        .to_bytes(),
130    }
131}
132
133/// Claim SOL rewards with single-tier referral system.
134/// 
135/// If the miner has a referrer, 1.0% of the claim goes to the referrer.
136/// 
137/// Account structure:
138/// - Base: signer, miner, system_program
139/// - If miner has referrer (required): [miner_referrer, referral_referrer]
140pub fn claim_sol(
141    signer: Pubkey,
142    referrer_miner: Option<Pubkey>, // Referrer's miner PDA (if miner has referrer)
143    referrer_referral: Option<Pubkey>, // Referrer's referral PDA (if miner has referrer)
144) -> Instruction {
145    let miner_address = miner_pda(signer).0;
146    
147    let mut accounts = vec![
148        AccountMeta::new(signer, true),
149        AccountMeta::new(miner_address, false),
150        AccountMeta::new_readonly(system_program::ID, false),
151    ];
152    
153    // Add referrer accounts if provided (required if miner has referrer)
154    if let (Some(miner_pubkey), Some(referral_pubkey)) = (referrer_miner, referrer_referral) {
155        accounts.push(AccountMeta::new(miner_pubkey, false));
156        accounts.push(AccountMeta::new(referral_pubkey, false));
157    }
158    
159    Instruction {
160        program_id: crate::ID,
161        accounts,
162        data: ClaimSOL {}.to_bytes(),
163    }
164}
165
166// let [signer_info, miner_info, mint_info, recipient_info, treasury_info, treasury_tokens_info, system_program, token_program, associated_token_program] =
167
168/// Claim OIL rewards with single-tier referral system.
169/// 
170/// If the miner has a referrer, 1.0% of the claim goes to the referrer.
171/// 
172/// Account structure:
173/// - Base: signer, miner, mint, recipient, treasury, treasury_tokens, system_program, token_program, associated_token_program
174/// - If miner has referrer (required): [miner_referrer, referral_referrer, referral_referrer_oil_ata]
175pub fn claim_oil(
176    signer: Pubkey,
177    referrer_miner: Option<Pubkey>, // Referrer's miner PDA (if miner has referrer)
178    referrer_referral: Option<Pubkey>, // Referrer's referral PDA (if miner has referrer)
179    referrer_referral_oil_ata: Option<Pubkey>, // Referrer's referral OIL ATA (if miner has referrer)
180) -> Instruction {
181    let miner_address = miner_pda(signer).0;
182    let treasury_address = treasury_pda().0;
183    let treasury_tokens_address = get_associated_token_address(&treasury_address, &MINT_ADDRESS);
184    let recipient_address = get_associated_token_address(&signer, &MINT_ADDRESS);
185    
186    let mut accounts = vec![
187        AccountMeta::new(signer, true),
188        AccountMeta::new(miner_address, false),
189        AccountMeta::new(MINT_ADDRESS, false),
190        AccountMeta::new(recipient_address, false),
191        AccountMeta::new(treasury_address, false),
192        AccountMeta::new(treasury_tokens_address, false),
193        AccountMeta::new_readonly(system_program::ID, false),
194        AccountMeta::new_readonly(spl_token::ID, false),
195        AccountMeta::new_readonly(spl_associated_token_account::ID, false),
196    ];
197    
198    // Add referrer accounts if provided (required if miner has referrer)
199    if let (Some(miner_pubkey), Some(referral_pubkey), Some(oil_ata_pubkey)) = 
200        (referrer_miner, referrer_referral, referrer_referral_oil_ata) {
201        accounts.push(AccountMeta::new(miner_pubkey, false));
202        accounts.push(AccountMeta::new(referral_pubkey, false));
203        accounts.push(AccountMeta::new(oil_ata_pubkey, false));
204    }
205    
206    Instruction {
207        program_id: crate::ID,
208        accounts,
209        data: ClaimOIL {}.to_bytes(),
210    }
211}
212
213
214pub fn close(signer: Pubkey, round_id: u64, rent_payer: Pubkey) -> Instruction {
215    let board_address = board_pda().0;
216    let round_address = round_pda(round_id).0;
217    let treasury_address = TREASURY_ADDRESS;
218    Instruction {
219        program_id: crate::ID,
220        accounts: vec![
221            AccountMeta::new(signer, true),
222            AccountMeta::new(board_address, false),
223            AccountMeta::new(rent_payer, false),
224            AccountMeta::new(round_address, false),
225            AccountMeta::new(treasury_address, false),
226            AccountMeta::new_readonly(system_program::ID, false),
227        ],
228        data: Close {}.to_bytes(),
229    }
230}
231
232/// Deploy SOL to prospect on squares (for FOGO sessions or regular wallets with wrapped SOL).
233/// 
234/// This function includes wrapped SOL ATAs and is used for:
235/// - FOGO sessions (signer != authority, with wrapped SOL transfers)
236/// - Regular wallets using wrapped SOL
237/// 
238/// For automations (bot-executed deploys using native SOL from automation account balance),
239/// use `deploy_auto` instead.
240/// 
241/// Pass a referrer pubkey for new miners to set up referral.
242/// Set `pooled` to true to join the mining pool (rewards shared proportionally).
243pub fn deploy(
244    signer: Pubkey,
245    authority: Pubkey,
246    amount: u64,
247    round_id: u64,
248    squares: [bool; 25],
249    referrer: Option<Pubkey>,
250    pooled: bool,
251) -> Instruction {
252    let automation_address = automation_pda(authority).0;
253    let board_address = board_pda().0;
254    let config_address = config_pda().0;
255    let miner_address = miner_pda(authority).0;
256    let round_address = round_pda(round_id).0;
257    let entropy_var_address = entropy_rng_api::state::var_pda(board_address, 0).0;
258
259    // Convert array of 25 booleans into a 32-bit mask where each bit represents whether
260    // that square index is selected (1) or not (0)
261    let mut mask: u32 = 0;
262    for (i, &square) in squares.iter().enumerate() {
263        if square {
264            mask |= 1 << i;
265        }
266    }
267    
268    // Get referrer bytes (default to zero pubkey if no referrer).
269    let referrer_pubkey = referrer.unwrap_or(Pubkey::default());
270    let referrer_bytes = referrer_pubkey.to_bytes();
271
272    // Derive wrapped SOL ATAs
273    let user_wrapped_sol_ata = get_associated_token_address(&authority, &SOL_MINT);
274    let round_wrapped_sol_ata = get_associated_token_address(&round_address, &SOL_MINT);
275
276    // Build accounts list - must match program structure:
277    // Oil accounts: base (9) + token (5) + optional referral (1) = 14-15
278    // Entropy accounts: var + program = 2 (always exactly 2)
279    let mut accounts = vec![
280        // Base accounts (9)
281        AccountMeta::new(signer, true), // 0: signer
282        AccountMeta::new(authority, false), // 1: authority
283        AccountMeta::new(automation_address, false), // 2: automation
284        AccountMeta::new(board_address, false), // 3: board
285        AccountMeta::new_readonly(config_address, false), // 4: config
286        AccountMeta::new(miner_address, false), // 5: miner
287        AccountMeta::new(round_address, false), // 6: round
288        AccountMeta::new_readonly(system_program::ID, false), // 7: system_program
289        AccountMeta::new_readonly(crate::ID, false), // 8: oil_program
290        // Token accounts (5)
291        AccountMeta::new(user_wrapped_sol_ata, false), // 9: user_wrapped_sol
292        AccountMeta::new(round_wrapped_sol_ata, false), // 10: round_wrapped_sol
293        AccountMeta::new_readonly(spl_token::ID, false), // 11: token_program
294        AccountMeta::new_readonly(SOL_MINT, false), // 12: mint (SOL_MINT)
295        AccountMeta::new_readonly(spl_associated_token_account::ID, false), // 13: associated_token_program
296    ];
297    
298    // Add referral account if referrer is provided (in oil_accounts)
299    if referrer_pubkey != Pubkey::default() {
300        let referral_address = referral_pda(referrer_pubkey).0;
301        accounts.push(AccountMeta::new(referral_address, false)); // referral (optional, in oil_accounts)
302    }
303    
304    // Entropy accounts (always exactly 2, come after all oil_accounts)
305    accounts.push(AccountMeta::new(entropy_var_address, false)); // entropy_var
306    accounts.push(AccountMeta::new_readonly(entropy_rng_api::ID, false)); // entropy_program
307
308    Instruction {
309        program_id: crate::ID,
310        accounts,
311        data: Deploy {
312            amount: amount.to_le_bytes(),
313            squares: mask.to_le_bytes(),
314            referrer: referrer_bytes,
315            pooled: if pooled { 1 } else { 0 },
316        }
317        .to_bytes(),
318    }
319}
320
321/// Deploy instruction for automations (omits wrapped token accounts since automation uses native SOL).
322/// 
323/// This function is used when:
324/// - Bot executor (signer) != user authority (automation pattern)
325/// - Automation account has native SOL balance to deploy
326/// - No wrapped SOL ATAs needed (uses native SOL directly)
327/// 
328/// Account structure: base (9) + token programs only (3) + optional referral (1) + optional whitelist (1) + entropy (2) = 12-16 accounts
329/// 
330/// For FOGO sessions or regular wallets with wrapped SOL, use `deploy` instead.
331pub fn deploy_auto(
332    signer: Pubkey,
333    authority: Pubkey,
334    amount: u64,
335    round_id: u64,
336    squares: [bool; 25],
337    referrer: Option<Pubkey>,
338    pooled: bool,
339) -> Instruction {
340    let automation_address = automation_pda(authority).0;
341    let board_address = board_pda().0;
342    let config_address = config_pda().0;
343    let miner_address = miner_pda(authority).0;
344    let round_address = round_pda(round_id).0;
345    let entropy_var_address = entropy_rng_api::state::var_pda(board_address, 0).0;
346
347    // Convert array of 25 booleans into a 32-bit mask where each bit represents whether
348    // that square index is selected (1) or not (0)
349    let mut mask: u32 = 0;
350    for (i, &square) in squares.iter().enumerate() {
351        if square {
352            mask |= 1 << i;
353        }
354    }
355    
356    // Get referrer bytes (default to zero pubkey if no referrer).
357    let referrer_pubkey = referrer.unwrap_or(Pubkey::default());
358    let referrer_bytes = referrer_pubkey.to_bytes();
359
360    // Build accounts list - for automation, omit wrapped token ATAs:
361    // Base (9) + token programs only (3) + optional referral (1) = 12-13
362    // Entropy accounts: var + program = 2 (always exactly 2)
363    // Note: Program allows 12 accounts even when signer != authority (automation pattern)
364    let mut accounts = vec![
365        // Base accounts (9)
366        AccountMeta::new(signer, true), // 0: signer
367        AccountMeta::new(authority, false), // 1: authority
368        AccountMeta::new(automation_address, false), // 2: automation
369        AccountMeta::new(board_address, false), // 3: board
370        AccountMeta::new_readonly(config_address, false), // 4: config
371        AccountMeta::new(miner_address, false), // 5: miner
372        AccountMeta::new(round_address, false), // 6: round
373        AccountMeta::new_readonly(system_program::ID, false), // 7: system_program
374        AccountMeta::new_readonly(crate::ID, false), // 8: oil_program
375        // Token programs only (3) - no ATAs for automation
376        AccountMeta::new_readonly(spl_token::ID, false), // 9: token_program
377        AccountMeta::new_readonly(SOL_MINT, false), // 10: mint (SOL_MINT)
378        AccountMeta::new_readonly(spl_associated_token_account::ID, false), // 11: associated_token_program
379    ];
380    
381    // Add referral account if referrer is provided (in oil_accounts)
382    if referrer_pubkey != Pubkey::default() {
383        let referral_address = referral_pda(referrer_pubkey).0;
384        accounts.push(AccountMeta::new(referral_address, false)); // referral (optional, in oil_accounts)
385    }
386    
387    // Entropy accounts (always exactly 2, come after all oil_accounts)
388    accounts.push(AccountMeta::new(entropy_var_address, false)); // entropy_var
389    accounts.push(AccountMeta::new_readonly(entropy_rng_api::ID, false)); // entropy_program
390
391    Instruction {
392        program_id: crate::ID,
393        accounts,
394        data: Deploy {
395            amount: amount.to_le_bytes(),
396            squares: mask.to_le_bytes(),
397            referrer: referrer_bytes,
398            pooled: if pooled { 1 } else { 0 },
399        }
400        .to_bytes(),
401    }
402}
403
404// let [pool, user_source_token, user_destination_token, a_vault, b_vault, a_token_vault, b_token_vault, a_vault_lp_mint, b_vault_lp_mint, a_vault_lp, b_vault_lp, protocol_token_fee, user_key, vault_program, token_program] =
405
406pub fn wrap(signer: Pubkey, use_liquidity: bool, amount: u64) -> Instruction {
407    let config_address = config_pda().0;
408    let treasury_address = TREASURY_ADDRESS;
409    let treasury_sol_address = get_associated_token_address(&treasury_address, &SOL_MINT);
410    let data = Wrap {
411        use_liquidity: if use_liquidity { 1 } else { 0 },
412        amount: amount.to_le_bytes(),
413    }
414    .to_bytes();
415    Instruction {
416        program_id: crate::ID,
417        accounts: vec![
418            AccountMeta::new(signer, true),
419            AccountMeta::new_readonly(config_address, false),
420            AccountMeta::new(treasury_address, false),
421            AccountMeta::new(treasury_sol_address, false),
422            AccountMeta::new_readonly(solana_program::system_program::ID, false),
423        ],
424        data,
425    }
426}
427
428pub fn buyback(signer: Pubkey, swap_accounts: &[AccountMeta], swap_data: &[u8]) -> Instruction {
429    let board_address = board_pda().0;
430    let mint_address = MINT_ADDRESS;
431    let treasury_address = TREASURY_ADDRESS;
432    let treasury_oil_address = get_associated_token_address(&treasury_address, &MINT_ADDRESS);
433    let treasury_sol_address = get_associated_token_address(&treasury_address, &SOL_MINT);
434    let mut accounts = vec![
435        AccountMeta::new(signer, true),
436        AccountMeta::new(board_address, false),
437        AccountMeta::new(mint_address, false),
438        AccountMeta::new(treasury_address, false),
439        AccountMeta::new(treasury_oil_address, false),
440        AccountMeta::new(treasury_sol_address, false),
441        AccountMeta::new_readonly(spl_token::ID, false),
442        AccountMeta::new_readonly(crate::ID, false),
443    ];
444    for account in swap_accounts.iter() {
445        let mut acc_clone = account.clone();
446        acc_clone.is_signer = false;
447        accounts.push(acc_clone);
448    }
449    let mut data = Buyback {}.to_bytes();
450    data.extend_from_slice(swap_data);
451    Instruction {
452        program_id: crate::ID,
453        accounts,
454        data,
455    }
456}
457
458pub fn barrel(signer: Pubkey, amount: u64) -> Instruction {
459    let board_address = board_pda().0;
460    let mint_address = MINT_ADDRESS;
461    let treasury_address = TREASURY_ADDRESS;
462    let sender_oil_address = get_associated_token_address(&signer, &MINT_ADDRESS);
463    let treasury_oil_address = get_associated_token_address(&treasury_address, &MINT_ADDRESS);
464    let data = Barrel {
465        amount: amount.to_le_bytes(),
466    }
467    .to_bytes();
468    Instruction {
469        program_id: crate::ID,
470        accounts: vec![
471            AccountMeta::new(signer, true),
472            AccountMeta::new(sender_oil_address, false),
473            AccountMeta::new(board_address, false),
474            AccountMeta::new(mint_address, false),
475            AccountMeta::new(treasury_address, false),
476            AccountMeta::new(treasury_oil_address, false),
477            AccountMeta::new_readonly(spl_token::ID, false),
478            AccountMeta::new_readonly(crate::ID, false),
479        ],
480        data,
481    }
482}
483
484
485// let [signer_info, board_info, config_info, fee_collector_info, mint_info, round_info, round_next_info, top_miner_info, treasury_info, treasury_tokens_info, system_program, token_program, oil_program, slot_hashes_sysvar] =
486
487pub fn reset(
488    signer: Pubkey,
489    fee_collector: Pubkey,
490    round_id: u64,
491    top_miner: Pubkey,
492    var_address: Pubkey,
493) -> Instruction {
494    reset_with_miners(signer, fee_collector, round_id, top_miner, var_address, &[])
495}
496
497pub fn reset_with_miners(
498    signer: Pubkey,
499    fee_collector: Pubkey,
500    round_id: u64,
501    top_miner: Pubkey,
502    var_address: Pubkey,
503    miner_accounts: &[Pubkey],
504) -> Instruction {
505    let board_address = board_pda().0;
506    let config_address = config_pda().0;
507    let mint_address = MINT_ADDRESS;
508    let round_address = round_pda(round_id).0;
509    let round_next_address = round_pda(round_id + 1).0;
510    let top_miner_address = miner_pda(top_miner).0;
511    let treasury_address = TREASURY_ADDRESS;
512    let treasury_tokens_address = treasury_tokens_address();
513    let pool_address = pool_pda().0;
514    let mint_authority_address = oil_mint_api::state::authority_pda().0;
515    let mut reset_instruction = Instruction {
516        program_id: crate::ID,
517        accounts: vec![
518            AccountMeta::new(signer, true),
519            AccountMeta::new(board_address, false),
520            AccountMeta::new(config_address, false),
521            AccountMeta::new(fee_collector, false),
522            AccountMeta::new(mint_address, false),
523            AccountMeta::new(round_address, false),
524            AccountMeta::new(round_next_address, false),
525            AccountMeta::new(top_miner_address, false),
526            AccountMeta::new(treasury_address, false),
527            AccountMeta::new(pool_address, false),
528            AccountMeta::new(treasury_tokens_address, false),
529            AccountMeta::new_readonly(system_program::ID, false),
530            AccountMeta::new_readonly(spl_token::ID, false),
531            AccountMeta::new_readonly(crate::ID, false),
532            AccountMeta::new_readonly(sysvar::slot_hashes::ID, false),
533            AccountMeta::new_readonly(SOL_MINT, false),
534            // Entropy accounts (these are in "other_accounts" after the split)
535            AccountMeta::new(var_address, false),
536            AccountMeta::new_readonly(entropy_rng_api::ID, false),
537            // Mint accounts.
538            AccountMeta::new(mint_authority_address, false),
539            AccountMeta::new_readonly(oil_mint_api::ID, false),
540        ],
541        data: Reset {}.to_bytes(),
542    };
543    
544    // Add miner accounts for seeker rewards (optional)
545    for miner_pubkey in miner_accounts {
546        reset_instruction.accounts.push(AccountMeta::new(
547            miner_pda(*miner_pubkey).0,
548            false,
549        ));
550    }
551    
552    reset_instruction
553}
554    
555// let [signer_info, automation_info, board_info, miner_info, round_info, treasury_info, system_program] =
556
557pub fn checkpoint(signer: Pubkey, authority: Pubkey, round_id: u64) -> Instruction {
558    let miner_address = miner_pda(authority).0;
559    let board_address = board_pda().0;
560    let round_address = round_pda(round_id).0;
561    let treasury_address = TREASURY_ADDRESS;
562    Instruction {
563        program_id: crate::ID,
564        accounts: vec![
565            AccountMeta::new(signer, true), // payer (session payer or regular wallet, receives bot fee)
566            AccountMeta::new(authority, false), // authority (user's wallet, for PDA derivation - must be writable when combined with deploy)
567            AccountMeta::new(board_address, false),
568            AccountMeta::new(miner_address, false),
569            AccountMeta::new(round_address, false),
570            AccountMeta::new(treasury_address, false),
571            AccountMeta::new_readonly(system_program::ID, false),
572        ],
573        data: Checkpoint {}.to_bytes(),
574    }
575}
576
577pub fn set_admin(signer: Pubkey, admin: Pubkey) -> Instruction {
578    let config_address = config_pda().0;
579    Instruction {
580        program_id: crate::ID,
581        accounts: vec![
582            AccountMeta::new(signer, true),
583            AccountMeta::new(config_address, false),
584            AccountMeta::new_readonly(system_program::ID, false),
585        ],
586        data: SetAdmin {
587            admin: admin.to_bytes(),
588        }
589        .to_bytes(),
590    }
591}
592
593pub fn set_admin_fee(signer: Pubkey, admin_fee: u64) -> Instruction {
594    let config_address = config_pda().0;
595    Instruction {
596        program_id: crate::ID,
597        accounts: vec![
598            AccountMeta::new(signer, true),
599            AccountMeta::new(config_address, false),
600            AccountMeta::new_readonly(system_program::ID, false),
601        ],
602        data: SetAdminFee {
603            admin_fee: admin_fee.to_le_bytes(),
604        }
605        .to_bytes(),
606    }
607}
608
609pub fn set_fee_collector(signer: Pubkey, fee_collector: Pubkey) -> Instruction {
610    let config_address = config_pda().0;
611    Instruction {
612        program_id: crate::ID,
613        accounts: vec![
614            AccountMeta::new(signer, true),
615            AccountMeta::new(config_address, false),
616            AccountMeta::new_readonly(system_program::ID, false),
617        ],
618        data: SetFeeCollector {
619            fee_collector: fee_collector.to_bytes(),
620        }
621        .to_bytes(),
622    }
623}
624
625/// Sets the TGE (Token Generation Event) timestamp.
626/// If current time < tge_timestamp, pre-mine is active.
627/// Set to 0 to disable pre-mine.
628/// Admin-only instruction.
629pub fn set_tge_timestamp(signer: Pubkey, tge_timestamp: i64) -> Instruction {
630    let config_address = config_pda().0;
631    Instruction {
632        program_id: crate::ID,
633        accounts: vec![
634            AccountMeta::new(signer, true),
635            AccountMeta::new(config_address, false),
636            AccountMeta::new_readonly(system_program::ID, false),
637        ],
638        data: SetTgeTimestamp {
639            tge_timestamp: tge_timestamp.to_le_bytes(),
640        }
641        .to_bytes(),
642    }
643}
644
645pub fn set_auction(
646    signer: Pubkey,
647    halving_period_seconds: u64,
648    last_halving_time: u64,
649    base_mining_rates: [u64; 4],
650    auction_duration_seconds: u64,
651    starting_prices: [u64; 4],
652    _well_id: u64, // Kept for backwards compatibility, but not used (always updates auction only)
653) -> Instruction {
654    let config_address = config_pda().0;
655    let auction_address = auction_pda().0;
656    
657    Instruction {
658        program_id: crate::ID,
659        accounts: vec![
660            AccountMeta::new(signer, true),
661            AccountMeta::new_readonly(config_address, false),
662            AccountMeta::new(auction_address, false),
663        ],
664        data: SetAuction {
665            halving_period_seconds: halving_period_seconds.to_le_bytes(),
666            last_halving_time: last_halving_time.to_le_bytes(),
667            base_mining_rates: [
668                base_mining_rates[0].to_le_bytes(),
669                base_mining_rates[1].to_le_bytes(),
670                base_mining_rates[2].to_le_bytes(),
671                base_mining_rates[3].to_le_bytes(),
672            ],
673            auction_duration_seconds: auction_duration_seconds.to_le_bytes(),
674            starting_prices: [
675                starting_prices[0].to_le_bytes(),
676                starting_prices[1].to_le_bytes(),
677                starting_prices[2].to_le_bytes(),
678                starting_prices[3].to_le_bytes(),
679            ],
680            well_id: 4u64.to_le_bytes(), // Always use 4 to indicate auction-only update
681        }
682        .to_bytes(),
683    }
684}
685
686// let [signer_info, mint_info, sender_info, stake_info, stake_tokens_info, treasury_info, system_program, token_program, associated_token_program] =
687
688pub fn deposit(signer: Pubkey, authority: Pubkey, amount: u64, lock_duration_days: u64, stake_id: u64) -> Instruction {
689    let mint_address = MINT_ADDRESS;
690    let stake_address = stake_pda_with_id(authority, stake_id).0; // Derive from authority, not signer
691    let stake_tokens_address = get_associated_token_address(&stake_address, &MINT_ADDRESS);
692    let sender_address = get_associated_token_address(&authority, &MINT_ADDRESS); // Authority's ATA
693    let pool_address = pool_pda().0;
694    let pool_tokens_address = pool_tokens_address();
695    let miner_address = miner_pda(authority).0; // Derive from authority
696    Instruction {
697        program_id: crate::ID,
698        accounts: vec![
699            AccountMeta::new(signer, true), // payer (session payer or regular wallet, pays fees)
700            AccountMeta::new(authority, true), // authority (user's wallet, signs token transfer and used for PDA derivation)
701            AccountMeta::new(mint_address, false),
702            AccountMeta::new(sender_address, false),
703            AccountMeta::new(stake_address, false),
704            AccountMeta::new(stake_tokens_address, false),
705            AccountMeta::new(pool_address, false),
706            AccountMeta::new(pool_tokens_address, false),
707            AccountMeta::new(miner_address, false),
708            AccountMeta::new_readonly(system_program::ID, false),
709            AccountMeta::new_readonly(spl_token::ID, false),
710            AccountMeta::new_readonly(spl_associated_token_account::ID, false),
711        ],
712        data: Deposit {
713            amount: amount.to_le_bytes(),
714            lock_duration_days: lock_duration_days.to_le_bytes(),
715            stake_id: stake_id.to_le_bytes(),
716        }
717        .to_bytes(),
718    }
719}
720
721// let [signer_info, mint_info, recipient_info, stake_info, stake_tokens_info, treasury_info, system_program, token_program, associated_token_program] =
722
723pub fn withdraw(signer: Pubkey, authority: Pubkey, amount: u64, stake_id: u64) -> Instruction {
724    let stake_address = stake_pda_with_id(authority, stake_id).0; // Derive from authority, not signer
725    let stake_tokens_address = get_associated_token_address(&stake_address, &MINT_ADDRESS);
726    let mint_address = MINT_ADDRESS;
727    let recipient_address = get_associated_token_address(&authority, &MINT_ADDRESS); // Authority's ATA
728    let pool_address = pool_pda().0;
729    let pool_tokens_address = pool_tokens_address();
730    let miner_address = miner_pda(authority).0; // Derive from authority
731    let treasury_address = treasury_pda().0;
732    let treasury_tokens_address = treasury_tokens_address();
733    Instruction {
734        program_id: crate::ID,
735        accounts: vec![
736            AccountMeta::new(signer, true), // payer (session payer or regular wallet)
737            AccountMeta::new(authority, false), // authority (user's wallet, for PDA derivation)
738            AccountMeta::new(mint_address, false),
739            AccountMeta::new(recipient_address, false),
740            AccountMeta::new(stake_address, false),
741            AccountMeta::new(stake_tokens_address, false),
742            AccountMeta::new(pool_address, false),
743            AccountMeta::new(pool_tokens_address, false),
744            AccountMeta::new(miner_address, false),
745            AccountMeta::new(treasury_address, false), // Treasury account (writable, signed by PDA)
746            AccountMeta::new(treasury_tokens_address, false), // Treasury OIL token account (writable, signed by PDA)
747            AccountMeta::new_readonly(system_program::ID, false),
748            AccountMeta::new_readonly(spl_token::ID, false),
749            AccountMeta::new_readonly(spl_associated_token_account::ID, false),
750        ],
751        data: Withdraw {
752            amount: amount.to_le_bytes(),
753            stake_id: stake_id.to_le_bytes(),
754        }
755        .to_bytes(),
756    }
757}
758
759// let [signer_info, automation_info, miner_info, system_program] = accounts else {
760
761/// Reload SOL from miner account to automation balance with single-tier referral system.
762/// 
763/// If the miner has a referrer, 1.0% of the claim goes to the referrer.
764/// 
765/// Account structure:
766/// - Base: signer, automation, miner, system_program
767/// - If miner has referrer (required): [miner_referrer, referral_referrer]
768pub fn reload_sol(
769    signer: Pubkey,
770    authority: Pubkey,
771    referrer_miner: Option<Pubkey>,
772    referrer_referral: Option<Pubkey>,
773) -> Instruction {
774    let automation_address = automation_pda(authority).0;
775    let miner_address = miner_pda(authority).0;
776    
777    let mut accounts = vec![
778        AccountMeta::new(signer, true),
779        AccountMeta::new(automation_address, false),
780        AccountMeta::new(miner_address, false),
781        AccountMeta::new_readonly(system_program::ID, false),
782    ];
783    
784    // Add referral accounts if provided (required when miner has referrer)
785    if let (Some(miner_ref), Some(referral_ref)) = (referrer_miner, referrer_referral) {
786        accounts.push(AccountMeta::new(miner_ref, false));
787        accounts.push(AccountMeta::new(referral_ref, false));
788    }
789    
790    Instruction {
791        program_id: crate::ID,
792        accounts,
793        data: ReloadSOL {}.to_bytes(),
794    }
795}
796
797// let [signer_info, mint_info, recipient_info, stake_info, treasury_info, treasury_tokens_info, system_program, token_program, associated_token_program] =
798
799/// Claim SOL yield from staking. Stakers earn SOL rewards (2% of round winnings), not OIL.
800pub fn claim_yield(signer: Pubkey, authority: Pubkey, amount: u64, stake_id: u64) -> Instruction {
801    let stake_address = stake_pda_with_id(authority, stake_id).0; // Derive from authority, not signer
802    let pool_address = pool_pda().0;
803    Instruction {
804        program_id: crate::ID,
805        accounts: vec![
806            AccountMeta::new(signer, true), // payer (session payer or regular wallet)
807            AccountMeta::new(authority, true), // authority (user's wallet, receives SOL and used for PDA derivation)
808            AccountMeta::new(stake_address, false),
809            AccountMeta::new(pool_address, false),
810            AccountMeta::new_readonly(system_program::ID, false),
811        ],
812        data: ClaimYield {
813            amount: amount.to_le_bytes(),
814        }
815        .to_bytes(),
816    }
817}
818
819pub fn new_var(
820    signer: Pubkey,
821    provider: Pubkey,
822    id: u64,
823    commit: [u8; 32],
824    samples: u64,
825) -> Instruction {
826    let board_address = board_pda().0;
827    let config_address = config_pda().0;
828    let var_address = entropy_rng_api::state::var_pda(board_address, id).0;
829    Instruction {
830        program_id: crate::ID,
831        accounts: vec![
832            AccountMeta::new(signer, true),
833            AccountMeta::new(board_address, false),
834            AccountMeta::new(config_address, false),
835            AccountMeta::new(provider, false),
836            AccountMeta::new(var_address, false),
837            AccountMeta::new_readonly(system_program::ID, false),
838            AccountMeta::new_readonly(entropy_rng_api::ID, false),
839        ],
840        data: NewVar {
841            id: id.to_le_bytes(),
842            commit: commit,
843            samples: samples.to_le_bytes(),
844        }
845        .to_bytes(),
846    }
847}
848
849pub fn set_swap_program(signer: Pubkey, new_program: Pubkey) -> Instruction {
850    let config_address = config_pda().0;
851    Instruction {
852        program_id: crate::ID,
853        accounts: vec![
854            AccountMeta::new(signer, true),
855            AccountMeta::new(config_address, false),
856            AccountMeta::new_readonly(new_program, false),
857        ],
858        data: SetSwapProgram {}.to_bytes(),
859    }
860}
861
862pub fn set_var_address(signer: Pubkey, new_var_address: Pubkey) -> Instruction {
863    let board_address = board_pda().0;
864    let config_address = config_pda().0;
865    Instruction {
866        program_id: crate::ID,
867        accounts: vec![
868            AccountMeta::new(signer, true),
869            AccountMeta::new(board_address, false),
870            AccountMeta::new(config_address, false),
871            AccountMeta::new(new_var_address, false),
872        ],
873        data: SetVarAddress {}.to_bytes(),
874    }
875}
876
877/// Migrate: Extend Treasury struct with liquidity field.
878/// This migration ensures the Treasury account has the new liquidity field available.
879/// Must be called by the admin.
880/// Accounts: signer, config, treasury, system_program
881pub fn migrate(signer: Pubkey) -> Instruction {
882    let config_address = config_pda().0;
883    let treasury_address = treasury_pda().0;
884    Instruction {
885        program_id: crate::ID,
886        accounts: vec![
887            AccountMeta::new(signer, true),
888            AccountMeta::new(config_address, false),
889            AccountMeta::new(treasury_address, false),
890            AccountMeta::new_readonly(system_program::ID, false),
891        ],
892        data: Migrate {}.to_bytes(),
893    }
894}
895
896/// Create a referral account to become a referrer.
897pub fn create_referral(signer: Pubkey) -> Instruction {
898    let referral_address = referral_pda(signer).0;
899    Instruction {
900        program_id: crate::ID,
901        accounts: vec![
902            AccountMeta::new(signer, true),
903            AccountMeta::new(referral_address, false),
904            AccountMeta::new_readonly(system_program::ID, false),
905        ],
906        data: CreateReferral {}.to_bytes(),
907    }
908}
909
910/// Creates a Whitelist account for a shared access code.
911/// Admin-only instruction.
912/// Accounts: signer (admin), config, whitelist, system_program
913pub fn create_whitelist(
914    signer: Pubkey,
915    code_hash: [u8; 32],
916) -> Instruction {
917    let config_address = config_pda().0;
918    let (whitelist_address, _) = Whitelist::pda(code_hash);
919    Instruction {
920        program_id: crate::ID,
921        accounts: vec![
922            AccountMeta::new(signer, true), // signer (admin)
923            AccountMeta::new_readonly(config_address, false), // config
924            AccountMeta::new(whitelist_address, false), // whitelist
925            AccountMeta::new_readonly(system_program::ID, false), // system_program
926        ],
927        data: CreateWhitelist {
928            code_hash,
929        }
930        .to_bytes(),
931    }
932}
933
934/// Claim pending referral rewards (both SOL and OIL).
935/// 
936/// Account structure (for Fogo sessions):
937/// - Base: signer (payer), authority (user's wallet), referral, referral_tokens, mint, recipient, system_program, token_program, associated_token_program
938pub fn claim_referral(signer: Pubkey, authority: Pubkey) -> Instruction {
939    let referral_address = referral_pda(authority).0;
940    let referral_oil_address = get_associated_token_address(&referral_address, &MINT_ADDRESS);
941    let recipient_oil_address = get_associated_token_address(&authority, &MINT_ADDRESS);
942    Instruction {
943        program_id: crate::ID,
944        accounts: vec![
945            AccountMeta::new(signer, true), // 0: signer (payer)
946            AccountMeta::new(authority, false), // 1: authority (user's wallet, receives SOL)
947            AccountMeta::new(referral_address, false), // 2: referral
948            AccountMeta::new(referral_oil_address, false), // 3: referral_tokens (Referral account's OIL ATA)
949            AccountMeta::new(MINT_ADDRESS, false), // 4: mint
950            AccountMeta::new(recipient_oil_address, false), // 5: recipient (Recipient's OIL ATA - authority's wallet)
951            AccountMeta::new_readonly(system_program::ID, false), // 6: system_program
952            AccountMeta::new_readonly(spl_token::ID, false), // 7: token_program
953            AccountMeta::new_readonly(spl_associated_token_account::ID, false), // 8: associated_token_program
954        ],
955        data: ClaimReferral {}.to_bytes(),
956    }
957}
958
959/// Direct solo bid on an auction well (seize ownership).
960/// The bid amount is calculated on-chain as current_price + 1 lamport.
961/// User must have enough SOL in their wallet to cover the bid.
962/// 
963/// Account structure:
964/// - Base: signer, authority, program_signer (optional), payer (optional), well, auction, treasury, treasury_tokens, mint, mint_authority, mint_program, staking_pool, fee_collector, config, token_program, system_program, oil_program
965/// - If previous owner exists (optional): [previous_owner_miner, previous_owner]
966/// - If referrer is provided (optional): [referral]
967pub fn place_bid(
968    signer: Pubkey,
969    authority: Pubkey,
970    square_id: u64,
971    fee_collector: Pubkey,
972    previous_owner_miner: Option<Pubkey>, // Previous owner's miner PDA (if previous owner exists)
973    previous_owner: Option<Pubkey>, // Previous owner pubkey (if previous owner exists)
974    referrer: Option<Pubkey>, // Optional referrer pubkey for new miners
975) -> Instruction {
976    let well_address = well_pda(square_id).0;
977    let auction_address = auction_pda().0;
978    let treasury_address = treasury_pda().0;
979    let treasury_tokens_address = get_associated_token_address(&treasury_address, &MINT_ADDRESS);
980    let staking_pool_address = pool_pda().0;
981    let config_address = config_pda().0;
982    let mint_authority_address = oil_mint_api::state::authority_pda().0;
983    let bidder_miner_address = miner_pda(authority).0;
984    
985    let mut accounts = vec![
986        AccountMeta::new(signer, true), // 0: signer
987        AccountMeta::new(authority, false), // 1: authority
988    ];
989    
990    // Add program_signer and payer for Fogo sessions (these are added by the client, not here)
991    // For now, we'll add placeholders or the client will add them
992    
993    accounts.extend_from_slice(&[
994        AccountMeta::new(well_address, false), // well
995        AccountMeta::new(auction_address, false), // Must be writable for auction_program_log CPI
996        AccountMeta::new(treasury_address, false),
997        AccountMeta::new(treasury_tokens_address, false),
998        AccountMeta::new(MINT_ADDRESS, false),
999        AccountMeta::new(mint_authority_address, false),
1000        AccountMeta::new_readonly(oil_mint_api::ID, false),
1001        AccountMeta::new(staking_pool_address, false),
1002        AccountMeta::new(fee_collector, false),
1003        AccountMeta::new_readonly(config_address, false),
1004        AccountMeta::new_readonly(spl_token::ID, false),
1005        AccountMeta::new_readonly(system_program::ID, false),
1006        AccountMeta::new_readonly(crate::ID, false), // oil_program
1007        AccountMeta::new(bidder_miner_address, false), // bidder_miner
1008    ]);
1009    
1010    // Add previous owner accounts if provided
1011    if let (Some(miner_pubkey), Some(owner_pubkey)) = (previous_owner_miner, previous_owner) {
1012        accounts.push(AccountMeta::new(miner_pubkey, false)); // previous_owner_miner
1013        accounts.push(AccountMeta::new(owner_pubkey, false)); // previous_owner
1014    }
1015    
1016    // Add referral account if referrer is provided
1017    if let Some(referrer_pubkey) = referrer {
1018        let referral_address = referral_pda(referrer_pubkey).0;
1019        accounts.push(AccountMeta::new(referral_address, false)); // referral
1020    }
1021    
1022    // Note: Wrapped token accounts are added by the client:
1023    // - user_wrapped_sol (source)
1024    // - treasury_wrapped_sol (temp ATA for all wrapped SOL - will be closed to get native SOL)
1025    // - token_program, native_mint, ata_program
1026    // The program distributes native SOL from treasury to pool and fee_collector after closing the temp ATA.
1027    
1028    Instruction {
1029        program_id: crate::ID,
1030        accounts,
1031        data: instruction::PlaceBid {
1032            square_id: square_id.to_le_bytes(),
1033            referrer: referrer.unwrap_or(Pubkey::default()).to_bytes(),
1034        }
1035        .to_bytes(),
1036    }
1037}
1038
1039/// Claim auction-based OIL rewards
1040/// - OIL rewards: from current ownership and previous ownership (pre-minted)
1041/// 
1042/// Account structure:
1043/// - Base: signer, miner, well accounts (one per well in mask), auction pool accounts (optional, one per well), auction, treasury, treasury_tokens, mint, mint_authority, mint_program, recipient, token_program, associated_token_program, system_program, oil_program
1044/// - Bid accounts (one per well in mask, required for pool contributors): [bid_0, bid_1, bid_2, bid_3] (must include epoch_id in PDA)
1045pub fn claim_auction_oil(
1046    signer: Pubkey,
1047    well_mask: u8, // Bitmask: bit 0 = well 0, bit 1 = well 1, etc.
1048    well_accounts: [Option<Pubkey>; 4], // Well PDAs for wells 0-3 (required for wells in mask)
1049    auction_pool_accounts: Option<[Option<Pubkey>; 4]>, // Auction Pool PDAs for wells 0-3 (optional, for pool contributors)
1050    bid_accounts: Option<[Option<Pubkey>; 4]>, // Bid PDAs for wells 0-3 (required for pool contributors, must include epoch_id in PDA)
1051) -> Instruction {
1052    let miner_address = miner_pda(signer).0;
1053    let auction_address = auction_pda().0;
1054    let treasury_address = treasury_pda().0;
1055    let treasury_tokens_address = get_associated_token_address(&treasury_address, &MINT_ADDRESS);
1056    let recipient_address = get_associated_token_address(&signer, &MINT_ADDRESS);
1057    let mint_authority_address = oil_mint_api::state::authority_pda().0;
1058    
1059    let mut accounts = vec![
1060        AccountMeta::new(signer, true),
1061        AccountMeta::new(miner_address, false),
1062    ];
1063    
1064    // Add well accounts for wells in mask (all 4 required, but only wells in mask are used)
1065    for well_opt in well_accounts.iter() {
1066        if let Some(well_pubkey) = well_opt {
1067            accounts.push(AccountMeta::new(*well_pubkey, false));
1068        } else {
1069            // Use a placeholder account if well is not provided
1070            accounts.push(AccountMeta::new_readonly(system_program::ID, false));
1071        }
1072    }
1073    
1074    // Add auction pool accounts if provided (optional, for pool contributors)
1075    if let Some(auction_pool_pdas) = auction_pool_accounts {
1076        for auction_pool_pda_opt in auction_pool_pdas.iter() {
1077            if let Some(auction_pool_pubkey) = auction_pool_pda_opt {
1078                accounts.push(AccountMeta::new(*auction_pool_pubkey, false));
1079            } else {
1080                // Use a placeholder account if auction pool is not provided
1081                accounts.push(AccountMeta::new_readonly(system_program::ID, false));
1082            }
1083        }
1084    } else {
1085        // Add 4 placeholder accounts if auction_pool_accounts is None
1086        for _ in 0..4 {
1087            accounts.push(AccountMeta::new_readonly(system_program::ID, false));
1088        }
1089    }
1090    
1091    accounts.extend_from_slice(&[
1092        AccountMeta::new(auction_address, false), // Must be writable for auction_program_log CPI
1093        AccountMeta::new(treasury_address, false),
1094        AccountMeta::new(treasury_tokens_address, false),
1095        AccountMeta::new(MINT_ADDRESS, false), // Must be writable for mint_oil CPI
1096        AccountMeta::new(mint_authority_address, false), // Must be writable for mint_oil CPI
1097        AccountMeta::new_readonly(oil_mint_api::ID, false),
1098        AccountMeta::new(recipient_address, false),
1099        AccountMeta::new_readonly(spl_token::ID, false),
1100        AccountMeta::new_readonly(spl_associated_token_account::ID, false),
1101        AccountMeta::new_readonly(system_program::ID, false),
1102        AccountMeta::new_readonly(crate::ID, false), // oil_program
1103    ]);
1104    
1105    // Add bid accounts if provided (for pool contributors)
1106    if let Some(bid_pdas) = bid_accounts {
1107        for bid_pda_opt in bid_pdas.iter() {
1108            if let Some(bid_pubkey) = bid_pda_opt {
1109                accounts.push(AccountMeta::new(*bid_pubkey, false));
1110            }
1111        }
1112    }
1113    
1114    Instruction {
1115        program_id: crate::ID,
1116        accounts,
1117        data: ClaimAuctionOIL {
1118            well_mask,
1119        }
1120        .to_bytes(),
1121    }
1122}
1123
1124/// Claim auction-based SOL rewards
1125/// - SOL rewards: from being outbid and refunds from abandoned pools
1126/// 
1127/// Account structure:
1128/// - Base: signer, miner, well accounts (one per well 0-3, for checking abandoned pools), auction pool accounts (optional, one per well), auction, treasury, system_program, oil_program
1129/// - Bid accounts (one per well, required for refunds): [bid_0, bid_1, bid_2, bid_3] (must include epoch_id in PDA)
1130pub fn claim_auction_sol(
1131    signer: Pubkey,
1132    well_accounts: [Option<Pubkey>; 4], // Well PDAs for wells 0-3 (for checking abandoned pools)
1133    auction_pool_accounts: Option<[Option<Pubkey>; 4]>, // Auction Pool PDAs for wells 0-3 (optional, for refunds)
1134    bid_accounts: Option<[Option<Pubkey>; 4]>, // Bid PDAs for wells 0-3 (required for refunds, must include epoch_id in PDA)
1135) -> Instruction {
1136    let miner_address = miner_pda(signer).0;
1137    let (auction_address, _) = auction_pda();
1138    let treasury_address = treasury_pda().0;
1139    
1140    let mut accounts = vec![
1141        AccountMeta::new(signer, true),
1142        AccountMeta::new(miner_address, false),
1143    ];
1144    
1145    // Add well accounts (all 4 wells for checking abandoned pools)
1146    for well_opt in well_accounts.iter() {
1147        if let Some(well_pubkey) = well_opt {
1148            accounts.push(AccountMeta::new(*well_pubkey, false));
1149        } else {
1150            // Use a placeholder account if well is not provided
1151            accounts.push(AccountMeta::new_readonly(system_program::ID, false));
1152        }
1153    }
1154    
1155    // Add auction pool accounts if provided (optional, for refunds)
1156    if let Some(auction_pool_pdas) = auction_pool_accounts {
1157        for auction_pool_pda_opt in auction_pool_pdas.iter() {
1158            if let Some(auction_pool_pubkey) = auction_pool_pda_opt {
1159                accounts.push(AccountMeta::new(*auction_pool_pubkey, false));
1160            } else {
1161                // Use a placeholder account if auction pool is not provided
1162                accounts.push(AccountMeta::new_readonly(system_program::ID, false));
1163            }
1164        }
1165    } else {
1166        // Add 4 placeholder accounts if auction_pool_accounts is None
1167        for _ in 0..4 {
1168            accounts.push(AccountMeta::new_readonly(system_program::ID, false));
1169        }
1170    }
1171    
1172    accounts.extend_from_slice(&[
1173        AccountMeta::new(auction_address, false), // Must be writable for auction_program_log CPI
1174        AccountMeta::new(treasury_address, false),
1175        AccountMeta::new_readonly(system_program::ID, false),
1176        AccountMeta::new_readonly(crate::ID, false), // oil_program
1177    ]);
1178    
1179    // Add bid accounts if provided (for refunds)
1180    if let Some(bid_pdas) = bid_accounts {
1181        for bid_pda_opt in bid_pdas.iter() {
1182            if let Some(bid_pubkey) = bid_pda_opt {
1183                accounts.push(AccountMeta::new(*bid_pubkey, false));
1184            }
1185        }
1186    }
1187    
1188    Instruction {
1189        program_id: crate::ID,
1190        accounts,
1191        data: ClaimAuctionSOL {
1192            _reserved: 0,
1193        }
1194        .to_bytes(),
1195    }
1196}
1197
1198pub fn claim_seeker(signer: Pubkey, mint: Pubkey) -> Instruction {
1199    let seeker_address = seeker_pda(mint).0;
1200    let token_account_address = get_associated_token_address(&signer, &mint);
1201    Instruction {
1202        program_id: crate::ID,
1203        accounts: vec![
1204            AccountMeta::new(signer, true),
1205            AccountMeta::new_readonly(mint, false),
1206            AccountMeta::new(seeker_address, false),
1207            AccountMeta::new(token_account_address, false),
1208            AccountMeta::new_readonly(system_program::ID, false),
1209        ],
1210        data: ClaimSeeker {}.to_bytes(),
1211    }
1212}