oil_api/state/
well.rs

1use serde::{Deserialize, Serialize};
2use steel::*;
3
4use crate::state::well_pda;
5
6use super::{OilAccount, Auction};
7
8/// Well account (one per well)
9/// PDA: [WELL, well_id]
10/// Tracks current auction state for a well
11#[repr(C)]
12#[derive(Clone, Copy, Debug, PartialEq, Pod, Zeroable, Serialize, Deserialize)]
13pub struct Well {
14    /// Well ID (0-3) - which well this is for
15    pub well_id: u64,
16    
17    /// Current epoch ID (increments each auction: 0, 1, 2, 3, etc.)
18    /// Starts at 0, increments when bid happens
19    pub epoch_id: u64,
20    
21    /// Current bidder/owner (Pubkey::default() if unowned)
22    pub current_bidder: Pubkey,
23    
24    /// Initial price for current epoch (in lamports)
25    /// Doubles from current price when bid happens
26    pub init_price: u64,
27    
28    /// Mining per second (MPS) - current mining rate (OIL per second, in atomic units)
29    /// This is the base rate adjusted for halvings
30    pub mps: u64,
31    
32    /// Epoch start time (timestamp when current epoch started)
33    pub epoch_start_time: u64,
34    
35    /// Accumulated OIL mined by current owner (not yet claimed)
36    pub accumulated_oil: u64,
37    
38    /// Last time accumulated_oil was updated
39    pub last_update_time: u64,
40    
41    /// Number of halvings that have occurred (for rate calculation)
42    pub halving_count: u64,
43    
44    /// Total OIL ever mined from this well (lifetime)
45    pub lifetime_oil_mined: u64,
46    
47    /// Total OIL mined by current operator (doesn't reset when claimed, only when ownership changes)
48    /// Repurposed from buffer_a
49    pub operator_total_oil_mined: u64,
50    
51    /// Buffer field (for future use) - previously is_pool_owned
52    pub buffer_c: u64,
53    
54    /// Buffer field (for future use)
55    pub buffer_d: u64,
56    
57    /// Buffer field (for future use)
58    pub buffer_e: u64,
59}
60
61impl Well {
62    pub fn pda(well_id: u64) -> (Pubkey, u8) {
63        well_pda(well_id)
64    }
65
66    /// Calculate current price for this epoch (Dutch auction - price decreases over time)
67    pub fn current_price(&self, auction: &Auction, clock: &Clock) -> u64 {
68        // If well has no owner (never been bid on), show starting price
69        use solana_program::pubkey::Pubkey;
70        if self.current_bidder == Pubkey::default() {
71            return self.init_price; // Return starting price for unowned wells
72        }
73        
74        let elapsed = clock.unix_timestamp.saturating_sub(self.epoch_start_time as i64);
75        let duration = auction.auction_duration_seconds as i64;
76        
77        if elapsed >= duration {
78            return 0; // Auction expired, free to claim
79        }
80        
81        // Linear decay: price = init_price * (1 - elapsed / duration)
82        // Applies to both solo-owned and pool-owned wells
83        let remaining = duration - elapsed;
84        (self.init_price as u128 * remaining as u128 / duration as u128) as u64
85    }
86
87    /// Update accumulated OIL for this epoch state
88    pub fn update_accumulated_oil(&mut self, clock: &Clock) {
89        // Skip if no owner
90        use solana_program::pubkey::Pubkey;
91        if self.current_bidder == Pubkey::default() {
92            return;
93        }
94        
95        let last_update = self.last_update_time as i64;
96        let elapsed = clock.unix_timestamp.saturating_sub(last_update);
97        if elapsed <= 0 {
98            return;
99        }
100        
101        // Calculate OIL mined: rate * time
102        let oil_mined = self.mps
103            .checked_mul(elapsed as u64)
104            .unwrap_or(0);
105        
106        self.accumulated_oil = self.accumulated_oil
107            .checked_add(oil_mined)
108            .unwrap_or(u64::MAX);
109        
110        self.lifetime_oil_mined = self.lifetime_oil_mined
111            .checked_add(oil_mined)
112            .unwrap_or(u64::MAX);
113        
114        // Track total mined by current operator (persists even after claiming)
115        self.operator_total_oil_mined = self.operator_total_oil_mined
116            .checked_add(oil_mined)
117            .unwrap_or(u64::MAX);
118        
119        self.last_update_time = clock.unix_timestamp as u64;
120    }
121
122    /// Check and apply halving if needed, updating mining rate
123    /// Time-based halving: halvings occur every 28 days (halving_period_seconds)
124    /// Uses 50% reduction (multiply by 0.5) per halving, matching Macaron's model
125    pub fn check_and_apply_halving(&mut self, auction: &mut Auction, clock: &Clock) {
126        // Check if we should apply halvings based on current time
127        let current_time = clock.unix_timestamp as u64;
128        let halvings_to_apply = auction.should_apply_halving(current_time);
129        
130        if halvings_to_apply > 0 {
131            // Apply halvings: 50% reduction (multiply by 0.5) per halving
132            // Formula: new_rate = old_rate * 0.5 = old_rate / 2
133            for _ in 0..halvings_to_apply {
134                self.mps = self.mps / 2; // 50% reduction (multiply by 0.5)
135                self.halving_count += 1;
136            }
137            
138            // Update auction last_halving_time to current time
139            // This ensures we don't apply the same halving multiple times
140            auction.last_halving_time = current_time;
141        }
142    }
143}
144
145account!(OilAccount, Well);
146
oil_api/state/well.rs

oil_api/state/
well.rs
