Struct Referral 

#[repr(C)]
pub struct Referral {
    pub authority: Pubkey,
    pub total_referred: u64,
    pub total_sol_earned: u64,
    pub total_oil_earned: u64,
    pub pending_sol: u64,
    pub pending_oil: u64,
}

Referral account tracks a referrer’s stats and pending rewards.

Anyone can create a Referral account to become a referrer. When a new miner signs up with their referral link, 0.5% of that miner’s claimed rewards from each mode (block-based and auction-based) are credited to the referrer’s pending balance, totaling 1% across both modes.

Fields

authority: Pubkey

The authority (wallet) of this referrer.

total_referred: u64

Total number of miners referred by this referrer.

total_sol_earned: u64

Total SOL earned from referrals (lifetime, for stats).

total_oil_earned: u64

Total OIL earned from referrals (lifetime, for stats).

pending_sol: u64

Pending SOL rewards to claim.

pending_oil: u64

Pending OIL rewards to claim.

Implementations

impl Referral

pub fn claim_sol(&mut self) -> u64

Claims pending SOL rewards. Returns the amount of SOL that can be claimed and resets pending_sol to 0.

pub fn claim_oil(&mut self) -> u64

Claims pending OIL rewards. Returns the amount of OIL that can be claimed and resets pending_oil to 0.

pub fn credit_sol_referral(&mut self, total_amount: u64) -> u64

Calculates and credits SOL referral bonus (0.5% of total amount). Returns the referral amount that should be transferred to this referral account.

This function handles:

• Calculating 0.5% referral bonus
• Crediting pending_sol
• Updating total_sol_earned

pub fn credit_oil_referral(&mut self, total_amount: u64) -> u64

Calculates and credits OIL referral bonus (0.5% of total amount). Returns the referral amount that should be transferred to this referral account.

This function handles:

• Calculating 0.5% referral bonus
• Crediting pending_oil
• Updating total_oil_earned

pub fn process_new_miner_referral<'a>( referral_info_opt: Option<&AccountInfo<'a>>, referrer: Pubkey, authority: Pubkey, ) -> Result<(), ProgramError>

Validates and increments referral count for a new miner.

This function:

• Validates the referrer is not default and not self-referral
• Validates the referral account exists and matches the referrer
• Increments the referral’s total_referred count

Returns Ok(()) if referral was processed, or Err if validation fails. If referrer is invalid (default or self), returns Ok(()) without processing.

impl Referral

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

Trait Implementations

impl AccountValidation for Referral

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 Referral

fn clone(&self) -> Referral

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Referral

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Referral

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Discriminator for Referral

fn discriminator() -> u8

impl PartialEq for Referral

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

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 Referral

fn zeroed() -> Self

Calls zeroed.

impl Copy for Referral

impl Pod for Referral

impl StructuralPartialEq for Referral