Skip to main content
Extend Kona’s derivation pipeline by wrapping the top-level AttributesQueue stage with custom logic for monitoring, validation, or transformation.

Core Concepts

The derivation pipeline uses a stage-based architecture where each stage wraps the previous one:

Key Traits

Custom stages that wrap the AttributesQueue must implement:
  • NextAttributes - Provides payload attributes for block building
  • OriginProvider - Provides current L1 origin
  • SignalReceiver - Handles pipeline resets
  • OriginAdvancer - Advances L1 origin

Example: Monitoring Stage

Wrap the AttributesQueue to add metrics tracking:
Custom stages wrap the AttributesQueue (top-level stage). For deeper pipeline modifications, you’d need to rebuild the entire pipeline.

Integration

Testing