Struct HalvingPayout

pub struct HalvingPayout;

The HalvingPayout model computes rewards using a binary exponential decay based on the input interval.

Concept: Discrete Halving Function

Formula

reward = R0 / 2^n

Characteristics:

• Exponential decay: Reward halves with each increment of input
• Deterministic: Same input and configuration yield identical output
• Efficient: Uses bit shifting instead of division
• Discrete: Stepwise reduction per interval
• Context-driven: Controlled via HalvingPayoutConfig

Applications:

• Blockchain issuance schedules
• Mining or staking reward decay
• Long-term economic stabilization
• Scarcity-driven incentive design

Behavior

• At n = 0: reward = R0
• At n = 1: reward = R0 / 2
• At n = 2: reward = R0 / 4
• …

Use Cases

• Bitcoin-style emission schedules
• Deflationary tokenomics
• Long-term reward tapering
• Controlled supply issuance

Example

let config = HalvingPayoutConfig {
    initial_reward: 100,
};

assert_eq!(HalvingPayout::compute(0, Some(config)), 100); // 100 / 2^0
assert_eq!(HalvingPayout::compute(1, Some(config)), 50);  // 100 / 2^1
assert_eq!(HalvingPayout::compute(2, Some(config)), 25);  // 100 / 2^2

Trait Implementations

impl Debug for HalvingPayout

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

Formats the value using the given formatter.

impl Default for HalvingPayout

fn default() -> HalvingPayout

Returns the “default value” for a type.

impl<Asset> PurePluginModel<Asset, HalvingPayoutConfig<Asset>, Asset> for HalvingPayout

where Asset: Copy + Shr<Output = Asset> + Zero,

fn compute(&self, n: Asset, context: &HalvingPayoutConfig<Asset>) -> Asset

Computes the model’s output for a given immutable input and context.