Struct solana_sdk::rent::Rent

pub struct Rent {
    pub lamports_per_byte_year: u64,
    pub exemption_threshold: f64,
    pub burn_percent: u8,
}

Configuration of network rent.

Fields

lamports_per_byte_year: u64

Rental rate in lamports/byte-year.

exemption_threshold: f64

Amount of time (in years) a balance must include rent for the account to be rent exempt.

burn_percent: u8

The percentage of collected rent that is burned.

Valid values are in the range [0, 100]. The remaining percentage is distributed to validators.

Implementations

impl Rent

pub fn calculate_burn(&self, rent_collected: u64) -> (u64, u64)

Calculate how much rent to burn from the collected rent.

The first value returned is the amount burned. The second is the amount to distribute to validators.

pub fn minimum_balance(&self, data_len: usize) -> u64

Minimum balance due for rent-exemption of a given account data size.

Note: a stripped-down version of this calculation is used in calculate_split_rent_exempt_reserve in the stake program. When this function is updated, eg. when making rent variable, the stake program will need to be refactored.

pub fn is_exempt(&self, balance: u64, data_len: usize) -> bool

Whether a given balance and data length would be exempt.

pub fn due(&self, balance: u64, data_len: usize, years_elapsed: f64) -> RentDue

Rent due on account’s data length with balance.

pub fn due_amount(&self, data_len: usize, years_elapsed: f64) -> u64

Rent due for account that is known to be not exempt.

pub fn free() -> Rent

Creates a Rent that charges no lamports.

This is used for testing.

pub fn with_slots_per_epoch(slots_per_epoch: u64) -> Rent

Creates a Rent that is scaled based on the number of slots in an epoch.

This is used for testing.

Trait Implementations

impl AbiExample for Rent

fn example() -> Rent

impl Clone for Rent

fn clone(&self) -> Rent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Rent

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

Formats the value using the given formatter.

impl Default for Rent

fn default() -> Rent

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Rent

fn deserialize<__D>( __deserializer: __D ) -> Result<Rent, <__D as Deserializer<'de>>::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq<Rent> for Rent

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for Rent

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

Serialize this value into the given Serde serializer.

impl Sysvar for Rent

fn get() -> Result<Rent, ProgramError>

Load the sysvar directly from the runtime.

fn size_of() -> usize

The size in bytes of the sysvar as serialized account data.

fn from_account_info( account_info: &AccountInfo<'_> ) -> Result<Self, ProgramError>

Deserializes the sysvar from its AccountInfo.

fn to_account_info(&self, account_info: &mut AccountInfo<'_>) -> Option<()>

Serializes the sysvar to AccountInfo.

impl SysvarId for Rent

fn id() -> Pubkey

The Pubkey of the sysvar.

fn check_id(pubkey: &Pubkey) -> bool

Returns true if the given pubkey is the program ID.

impl Copy for Rent

impl StructuralPartialEq for Rent