Struct SigmoidPayoutConfig

pub struct SigmoidPayoutConfig<T, F>
where
    F: FixedPointNumber,
{
    pub max_reward: T,
    pub growth_start: F,
    pub growth_end: F,
}

Defines the configuration for the SigmoidPayout model.

This struct specifies the parameters for a sigmoid (S-curve) reward function, enabling smooth growth and saturation behavior.

Concept: Logistic Growth Curve

Rewards follow a sigmoid function:

reward = L / (1 + e^(-k(x - x0)))

where:

• L = maximum reward (upper bound)
• k = growth rate (steepness of the curve)
• x0 = midpoint (inflection point)
• x = input variable (e.g., time, era, or score)

Instead of directly specifying k and x0, this model derives them from:

• growth_start (a): lower percentile of growth (0 < a < 1)
• growth_end (b): upper percentile of growth (0 < b < 1)

This allows intuitive configuration of the curve shape.

Fields

max_reward: T

Maximum reward (L): asymptotic upper bound

growth_start: F

Lower growth bound (a): fraction where growth begins (0 < a < 1)

growth_end: F

Upper growth bound (b): fraction where growth saturates (0 < b < 1)

Trait Implementations

impl<FixedPoint, Asset> PurePluginModel<Asset, SigmoidPayoutConfig<Asset, FixedPoint>, Asset> for SigmoidPayout

where Asset: Copy + IntegerToFixed + FixedForInteger<FixedPoint = FixedPoint> + Zero, FixedPoint: FixedPointNumber + FixedSignedCast<Signed = FixedI128>,

fn compute( &self, x: Asset, context: &SigmoidPayoutConfig<Asset, FixedPoint>, ) -> Asset

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