Struct EconomicParameters 

pub struct EconomicParameters {
    pub initial_subsidy: u64,
    pub halving_interval: u64,
    pub max_money_supply: u64,
    pub coinbase_maturity: u64,
    pub dust_limit: u64,
    pub min_fee_rate: u64,
    pub max_fee_rate: u64,
    pub min_relay_fee: u64,
    pub subsidy_schedule: Vec<(u64, u64)>,
}

Economic model parameters for a protocol version

Fields

initial_subsidy: u64

Initial block subsidy (in satoshis)

halving_interval: u64

Block subsidy halving interval

max_money_supply: u64

Maximum money supply (in satoshis)

coinbase_maturity: u64

Coinbase maturity (blocks before coinbase can be spent)

dust_limit: u64

Dust limit (minimum output value in satoshis)

min_fee_rate: u64

Minimum transaction fee rate (satoshis per vbyte)

max_fee_rate: u64

Maximum transaction fee rate (satoshis per vbyte)

min_relay_fee: u64

Minimum relay fee (satoshis per vbyte)

subsidy_schedule: Vec<(u64, u64)>

Block subsidy schedule (for custom schedules)

Implementations

impl EconomicParameters

pub fn for_protocol(version: ProtocolVersion) -> Self

Get economic parameters for a protocol version

pub fn mainnet() -> Self

Mainnet economic parameters (Bitcoin production network)

pub fn testnet() -> Self

Testnet economic parameters (same as mainnet)

pub fn regtest() -> Self

Regtest economic parameters (relaxed for testing)

pub fn get_block_subsidy(&self, height: u64) -> u64

Calculate block subsidy for a given height

pub fn total_supply_at_height(&self, height: u64) -> u64

Calculate total supply up to a given height

pub fn is_dust(&self, value: u64) -> bool

Check if a value meets dust limit

pub fn is_valid_fee_rate(&self, fee_rate: u64) -> bool

Check if a fee rate is valid

pub fn calculate_fee( &self, size_vbytes: usize, fee_rate_sat_per_vbyte: u64, ) -> u64

Calculate fee for a transaction size

pub fn exceeds_max_supply(&self, height: u64) -> bool

Check if total supply exceeds maximum

Trait Implementations

impl Clone for EconomicParameters

fn clone(&self) -> EconomicParameters

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EconomicParameters

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EconomicParameters

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for EconomicParameters

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for EconomicParameters

impl StructuralPartialEq for EconomicParameters