#pipeline #op #derivation #stack #source #l2 #traits

kona-derive

A no_std derivation pipeline implementation for the OP Stack

8 releases

new 0.1.0 Nov 20, 2024
0.0.7 Nov 20, 2024
0.0.5 Oct 29, 2024
0.0.3 Sep 4, 2024
0.0.1 Feb 22, 2024

#2 in #l2

Download history 3/week @ 2024-08-12 13/week @ 2024-08-19 149/week @ 2024-09-02 4/week @ 2024-09-09 42/week @ 2024-09-16 26/week @ 2024-09-23 37/week @ 2024-09-30 38/week @ 2024-10-07 24/week @ 2024-10-14 127/week @ 2024-10-21 189/week @ 2024-10-28 189/week @ 2024-11-04 59/week @ 2024-11-11

565 downloads per month
Used in 6 crates (4 directly)

MIT license

1MB
7.5K SLoC

kona-derive

CI Kona Derive License Codecov

A no_std compatible implementation of the OP Stack's derivation pipeline.

Usage

The intended way of working with kona-derive is to use the DerivationPipeline which implements the Pipeline trait. To create an instance of the DerivationPipeline, it's recommended to use the PipelineBuilder as follows.

use std::sync::Arc;
use op_alloy_genesis::RollupConfig;
use kona_derive::sources::EthereumDataSource;
use kona_derive::pipeline::PipelineBuilder;
use kona_derive::attributes::StatefulAttributesBuilder;

let chain_provider = todo!();
let l2_chain_provider = todo!();
let blob_provider = todo!();
let l1_origin = todo!();

let cfg = Arc::new(RollupConfig::default());
let attributes = StatefulAttributesBuilder::new(
   cfg.clone(),
   l2_chain_provider.clone(),
   chain_provider.clone(),
);
let dap = EthereumDataSource::new(
   chain_provider.clone(),
   blob_provider,
   cfg.as_ref()
);

// Construct a new derivation pipeline.
let pipeline = PipelineBuilder::new()
   .rollup_config(cfg)
   .dap_source(dap)
   .l2_chain_provider(l2_chain_provider)
   .chain_provider(chain_provider)
   .builder(attributes)
   .origin(l1_origin)
   .build();

Features

The most up-to-date feature list will be available on the docs.rs Feature Flags tab of the kona-derive crate.

Some features include the following.

  • serde: Serialization and Deserialization support for kona-derive types.
  • test-utils: Test utilities for downstream libraries.

By default, kona-derive enables the serde feature.

Dependencies

~25MB
~657K SLoC