Struct Plot 

#[repr(C)]
pub struct Plot {

    pub authority: Pubkey,
    pub plot_level: u64,
    pub fuel_capacity: u64,
    pub current_fuel: u64,
    pub max_rig_slots: u64,
    pub total_mining_power: u64,
    pub last_claim_block: u64,
    pub last_fuel_update_block: u64,
    pub last_upgrade_timestamp: i64,
    pub total_fuel_requirement: u64,
    pub num_rigs_staked: u64,
    pub last_refinery_rewards_factor: Numeric,
    pub buffer_a: u64,
    pub buffer_b: u64,
    pub buffer_c: u64,
}

Plot account (one per wallet/authority)

Fields

authority: Pubkey

The authority (owner) of this plot account.

plot_level: u64

Plot level (0-9: Basic to Master)

fuel_capacity: u64

Maximum fuel capacity (tank size)

current_fuel: u64

Current fuel remaining in tank

max_rig_slots: u64

Maximum number of rig slots (1-5)

total_mining_power: u64

Total mining power from all staked rigs

last_claim_block: u64

Last block when rewards were claimed

last_fuel_update_block: u64

Last block when fuel was updated (for consumption calculation)

last_upgrade_timestamp: i64

Timestamp of last upgrade (for 24h cooldown)

total_fuel_requirement: u64

Sum of fuel_requirement of all rigs currently placed on this plot (placement constraint)

num_rigs_staked: u64

Number of rigs currently placed on this plot (≤ max_rig_slots)

last_refinery_rewards_factor: Numeric

Refinery rewards factor at this plot’s last claim (for claimable = power * (current - this))

buffer_a: u64

Sum of fuel_consumption_rate of all staked rigs (used for fuel consumption on claim). Stored in buffer_a. buffer_a: total_fuel_consumption_rate

buffer_b: u64

Buffer for future extensions

buffer_c: u64

Buffer for future extensions

Implementations

impl Plot

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

pub fn initialize(&mut self, authority: Pubkey, clock: &Clock)

pub fn can_upgrade(&self, clock: &Clock) -> bool

Check if plot can be upgraded (24h cooldown)

pub fn get_upgrade_cost(&self) -> Option<u64>

Get upgrade cost for the next level (in atomic units, 11 decimals) Returns None if already at max level (9)

pub fn upgrade_cost_for_level(level: u64) -> u64

Get upgrade cost for a specific level (in atomic units, 11 decimals)

pub fn level_stats(level: u64) -> (u64, u64)

Get level stats (slots, fuel_capacity) for a specific level

pub fn upgrade(&mut self, clock: &Clock) -> Option<u64>

Upgrade plot to next level Returns the upgrade cost if successful, None if already at max level

pub fn apply_fuel_consumption(&mut self, clock: &Clock) -> u64

Apply fuel consumption since last_fuel_update_block using buffer_a (total_fuel_consumption_rate). Uses fuel-supported blocks: rewards accrue only for blocks where fuel was available; fuel can deplete mid-interval so we cap at fuel_supported_blocks and consume proportionally. Returns effective mining power for the period (0 if no fuel; else scaled by fuel_supported_blocks/blocks_elapsed).

pub fn update_fuel_consumption( &mut self, staked_rig_consumption_rates: &[u64], clock: &Clock, ) -> u64

Update fuel consumption based on staked rig consumption rates (alternative when rig list available). Uses same fuel-supported-blocks logic as apply_fuel_consumption.

impl Plot

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

Trait Implementations

impl AccountValidation for Plot

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 Plot

fn clone(&self) -> Plot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Plot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Plot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Discriminator for Plot

fn discriminator() -> u8

impl PartialEq for Plot

fn eq(&self, other: &Plot) -> 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 Plot

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 Plot

fn zeroed() -> Self

Calls zeroed.

impl Copy for Plot

impl Pod for Plot

impl StructuralPartialEq for Plot