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 buffer_b: u64,
    pub buffer_c: u64,
    pub buffer_d: u64,
}

Singleton auction configuration account

Fields

halving_period_seconds: u64

Halving period in seconds (28 days = 2,419,200 seconds) Halvings occur every 28 days, reducing mining rates by 50%

last_halving_time: u64

Timestamp of the last halving event (Unix timestamp in seconds) Used to calculate when the next halving should occur

base_mining_rates: [u64; 4]

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

• Well 0 (Seep): 0.5 OIL/s = 50,000,000,000 atomic units/s
• Well 1 (Flow): 1.0 OIL/s = 100,000,000,000 atomic units/s
• Well 2 (Gusher): 1.5 OIL/s = 150,000,000,000 atomic units/s
• Well 3 (Blowout): 2.0 OIL/s = 200,000,000,000 atomic units/s Total: 5.0 OIL/s (25% higher than Macaron’s 4.0 OIL/s) 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)

buffer_b: u64

Buffer field (for future use)

buffer_c: u64

Buffer field (for future use)

buffer_d: u64

Buffer field (for future use)

Implementations

impl Auction

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

pub fn next_halving_time(&self) -> u64

Get the timestamp when the next halving should occur Halvings occur every halving_period_seconds (28 days)

pub fn should_apply_halving(&self, current_time: u64) -> u64

Check if halving should be applied based on current time Returns number of halvings to apply (can be > 1 if multiple periods passed) Each halving reduces rates by 50% (multiply by 0.5)

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