Struct L2ActivityTracker

pub struct L2ActivityTracker { /* private fields */ }

The L2ActivityTracker tracks the chain activity to determine a safety mode for setting the DA price.

Because the DA gas price can increase even when no-one is using the network, there is a potential for a negative feedback loop to occur where the gas price increases, further decreasing activity and increasing the gas price. The L2ActivityTracker is used to moderate changes to the DA gas price based on the activity of the L2 chain.

The chain activity is a cumulative measure, updated whenever a new block is processed. For each L2 block, the block usage is a percentage of the block capacity used. If the block usage is below a certain threshold, the chain activity is decreased, if above the threshold, the activity is increased The chain activity exists on a scale between 0 and the sum of the normal, capped, and decrease buffers.

e.g. if the decrease activity threshold is 20, the capped activity threshold is 80, and the max activity is 120, we’d have the following ranges:

0 <– decrease range –>20<– capped range –>80<– normal range –>120

The current chain activity determines the behavior of the DA gas price.

For healthy behavior, the activity should be in the normal range.

Implementations

impl L2ActivityTracker

pub fn new_full( normal_range_size: u16, capped_range_size: u16, decrease_range_size: u16, block_activity_threshold: ClampedPercentage, ) -> Self

pub fn new( normal_range_size: u16, capped_range_size: u16, decrease_range_size: u16, activity: u16, block_activity_threshold: ClampedPercentage, ) -> Self

pub fn new_always_normal() -> Self

pub fn safety_mode(&self) -> DAGasPriceSafetyMode

pub fn update(&mut self, block_usage: ClampedPercentage)

pub fn current_activity(&self) -> u16

pub fn max_activity(&self) -> u16

pub fn capped_activity_threshold(&self) -> u16

pub fn decrease_activity_threshold(&self) -> u16

pub fn block_activity_threshold(&self) -> ClampedPercentage

Trait Implementations

impl Clone for L2ActivityTracker

fn clone(&self) -> L2ActivityTracker

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for L2ActivityTracker

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for L2ActivityTracker

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for L2ActivityTracker

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for L2ActivityTracker