Struct LogarithmicPayout

pub struct LogarithmicPayout;

The LogarithmicPayout model computes rewards using a logarithmic function, producing fast initial growth followed by diminishing returns.

Concept: Diminishing Growth Function

Formula

reward = a * ln(b * x + c) + d

Characteristics:

• Diminishing returns: Growth slows as input increases
• High early rewards: Strong incentives for small inputs
• Unbounded (slow growth): Continues increasing but at decreasing rate
• Deterministic: Same input and parameters yield identical results
• Fixed-point safe: Uses fixed-point logarithmic operations
• Context-driven: Controlled via LogarithmicConfig

Applications:

• Rewarding early participation more than late participation
• Anti-whale incentive systems
• Pricing curves (e.g., bonding curves)
• Resource allocation with diminishing utility

Use Cases

• Incentivizing early adopters
• Preventing exponential reward growth
• Modeling diminishing marginal returns

Example

let config = LogarithmicConfig {
    vertical_scale: FixedU128::from_integer(10), // a
    horizontal_scale: FixedU128::from_integer(1), // b
    horizontal_shift: FixedU128::from_integer(1), // c
    vertical_shift: FixedU128::from_integer(0),   // d
};

let reward = LogarithmicPayout::compute(9u128, Some(config));
// reward = 10 * ln(9 + 1) ~= 10 * ln(10)

Trait Implementations

impl Debug for LogarithmicPayout

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

Formats the value using the given formatter.

impl Default for LogarithmicPayout

fn default() -> LogarithmicPayout

Returns the “default value” for a type.

impl<FixedPoint, Asset> PurePluginModel<Asset, LogarithmicConfig<FixedPoint>, Asset> for LogarithmicPayout

where Asset: IntegerToFixed + FixedForInteger<FixedPoint = FixedPoint>, FixedPoint: FixedPointNumber + FixedOp,

fn compute( &self, input: Asset, context: &LogarithmicConfig<FixedPoint>, ) -> Asset

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