Struct Auction 

#[repr(C)]
pub struct Auction {
    pub halving_period_seconds: u64,
    pub last_halving_time: u64,
    pub base_mining_rates: [u64; 4],
    pub min_pool_contribution: u64,
    pub auction_duration_seconds: u64,
    pub starting_prices: [u64; 4],
    pub buffer_a: Numeric,
    pub total_auction_oil_minted: u64,
    pub halving_count: u64,
    pub buffer_d: u64,
}

Singleton auction configuration account

Fields

halving_period_seconds: u64

[REPURPOSED] Total OIL minted from auction-based mining (in atomic units) Used for supply-based halving: halvings occur at 1M, 2.5M, 5M, 10M, etc. OIL Originally: halving_period_seconds (no longer used for time-based halving)

last_halving_time: u64

[REPURPOSED] Number of halvings that have been applied (starts at 0) Each halving reduces rates by 25% (multiply by 0.75) Originally: last_halving_time (no longer used for time-based halving)

base_mining_rates: [u64; 4]

Base mining rates per well (OIL per second, in atomic units) Macaron’s rates: totaling 4.0 OIL/s

• Well 0 (Seep): 0.4 OIL/s = 40,000,000,000 atomic units/s
• Well 1 (Flow): 0.8 OIL/s = 80,000,000,000 atomic units/s
• Well 2 (Gusher): 1.2 OIL/s = 120,000,000,000 atomic units/s
• Well 3 (Blowout): 1.6 OIL/s = 160,000,000,000 atomic units/s Total: 4.0 OIL/s (matches Macaron’s rates) Creates meaningful trade-offs: higher rates = higher competition & prices

min_pool_contribution: u64

Minimum contribution to join auction pool (0.01 SOL = 10,000,000 lamports)

auction_duration_seconds: u64

Auction duration in seconds (1 hour = 3600)

starting_prices: [u64; 4]

Starting prices per well (in lamports) Scaled to match mining rate differentiation for strategic choices:

• Well 0 (Seep): 0.1 SOL = 100,000,000 lamports (lowest price, accessible)
• Well 1 (Flow): 0.2 SOL = 200,000,000 lamports (2x Well 0)
• Well 2 (Gusher): 0.3 SOL = 300,000,000 lamports (3x Well 0)
• Well 3 (Blowout): 0.4 SOL = 400,000,000 lamports (4x Well 0)

buffer_a: Numeric

Buffer field (for future use)

total_auction_oil_minted: u64

Total OIL minted from auction-based mining (in atomic units) Used for supply-based halving: halvings occur at 1M, 2.5M, 5M, 10M, etc. OIL Repurposed from buffer_b - maintains account layout compatibility

halving_count: u64

Number of halvings that have been applied (starts at 0) Each halving reduces rates by 25% (multiply by 0.75) Repurposed from buffer_c - maintains account layout compatibility

buffer_d: u64

Buffer field (for future use)

Implementations

impl Auction

pub fn pda() -> (Pubkey, u8)

pub fn next_halving_threshold(&self) -> u64

Get the next halving threshold based on current halving count Halving thresholds: 1M, 2.5M, 5M, 10M, 20M, 40M, etc. (exponential) All thresholds are in atomic units (multiply OIL amounts by ONE_OIL) Formula: threshold = (1_000_000 * ONE_OIL) * multiplier for first 3, then doubles

pub fn should_apply_halving(&self) -> u64

Check if halving should be applied based on total OIL minted Returns number of halvings to apply (can be > 1 if multiple thresholds crossed)

impl Auction

pub fn to_bytes(&self) -> &[u8]

Trait Implementations

impl AccountValidation for Auction

fn assert<F>(&self, condition: F) -> Result<&Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_err<F>( &self, condition: F, err: ProgramError, ) -> Result<&Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_msg<F>(&self, condition: F, msg: &str) -> Result<&Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_mut<F>(&mut self, condition: F) -> Result<&mut Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_mut_err<F>( &mut self, condition: F, err: ProgramError, ) -> Result<&mut Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_mut_msg<F>( &mut self, condition: F, msg: &str, ) -> Result<&mut Self, ProgramError>

where F: Fn(&Self) -> bool,

impl Clone for Auction

fn clone(&self) -> Auction

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Auction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Auction

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Discriminator for Auction

fn discriminator() -> u8

impl PartialEq for Auction

fn eq(&self, other: &Auction) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Auction

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Zeroable for Auction

fn zeroed() -> Self

Calls zeroed.

impl Copy for Auction

impl Pod for Auction

impl StructuralPartialEq for Auction