Struct SettlementConfig 

pub struct SettlementConfig {
    pub pessimistic_proof_tx_config: SettlementTransactionConfig,
    pub validium_tx_config: SettlementTransactionConfig,
    pub settlement_service_config: SettlementServiceConfig,
}

The Agglayer settlement configuration.

This configuration controls how the Agglayer settlement service interacts with the L1 blockchain for settling certificates and validium transactions. It provides separate transaction configurations for certificate settlements and validium settlements, allowing fine-grained control over gas prices, retries, and confirmation requirements.

Configuration Structure

The settlement configuration is organized into three main components:

• Certificate Transaction Config: Controls settlement transactions for certificates with pessimistic proofs (proofs of state transitions).
• Validium Transaction Config: Controls settlement transactions for validium data (off-chain data availability).
• Settlement Service Config: General settlement service configuration.

Gas Price Configuration

Gas prices can be specified with units for readability:

• "1gwei" = 1,000,000,000 wei
• "0.1eth" = 100,000,000,000,000,000 wei
• "1000000000wei" = 1,000,000,000 wei

The final gas price is calculated as:

gas_price = max(
    floor,
    min(ceiling, estimate_gas_price * gas_price_multiplier_factor)
)

Each retry can increase the price by the multiplier factor.

Security Considerations

• Settlement policy: Choose the appropriate finality level based on security requirements.
• Gas Price Ceiling: Acts as a safety mechanism to prevent excessive transaction costs during network congestion.
• Confirmations: Higher confirmation counts increase security for receipt retrieval but do not replace proper finality guarantees.
• Max Retries: Should be set high enough to handle temporary network issues.

Fields

pessimistic_proof_tx_config: SettlementTransactionConfig

Configuration for certificate settlement transactions.

This controls how pessimistic proofs (proofs of state transitions for certificates) are submitted to the L1 settlement layer.

validium_tx_config: SettlementTransactionConfig

Configuration for validium settlement transactions.

This controls how validium data (off-chain data availability proofs) are submitted to the L1 settlement layer. Validium transactions may have different gas and retry requirements than certificate transactions.

settlement_service_config: SettlementServiceConfig

General settlement service configuration.

Contains service-wide settings that apply to the overall settlement service operation (beyond individual transaction parameters).

Trait Implementations

impl Clone for SettlementConfig

fn clone(&self) -> SettlementConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SettlementConfig

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

Formats the value using the given formatter.

impl Default for SettlementConfig

fn default() -> SettlementConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SettlementConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SettlementConfig

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

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 SettlementConfig

impl StructuralPartialEq for SettlementConfig