Merge branch 'main' into 0xkitsune/alloy

Author: 0xKitsune

Cargo.lock

@@ -46,9 +46,8 @@ revm = { version = "12.1", features = ["alloydb", "optimism"] }
 
 # Kona + OP Types
 superchain-registry = "0.2.6"
-kona-derive = { git = "https://github.com/ethereum-optimism/kona", rev = "4e57dd35ea08b31d0baa293c7a12165f28e6cd92", features = [
-    "online",
-] }
+kona-primitives = { git = "https://github.com/ethereum-optimism/kona", version = "0.0.2", features = ["online"] }
+kona-derive = { git = "https://github.com/ethereum-optimism/kona", version = "0.0.3", features = ["online"] }
 
 # Internal
 op-test-vectors = { path = "crates/op-test-vectors" }

Cargo.toml

@@ -38,14 +38,32 @@ Each has it's own cli tool to generate test fixtures. [opt8n](./bin/opt8n) can b
 
 **`op-test-vectors`**
 
+A rust crate exposing types used to generate test fixtures in [./fixtures](./fixtures/).
+
+`op-test-vectors` contains two primary modules:
+
 - [`execution`](./crates/op-test-vectors/src/execution.rs): Rust types for the execution test fixtures.
 - [`derivation`](./crates/op-test-vectors/src/derivation.rs): Rust types for the derivation test fixtures.
 
-**`opt8n` Commands**
+**`opt8n`**
+
+A binary to generate execution test fixtures.
+
+`opt8n` has two subcommands:
 
 - `repl`: Spins up a REPL that allows the user to send transactions to and generate a test fixture from those transactions.
 - `script`: Executes a forge script against an anvil instance and generates the test fixture.
 
+**`opdn`**
+
+A binary to generate derivation test fixtures.
+
+`opdn` has the following subcommands:
+
+- `from-l2`: Generates a derivation test fixture from the specified range of L2 blocks.
+- `from-l1`: Generates a derivation test fixture from the specified range of L1 blocks.
+- `info`: Outputs the L2 block info including the L1 origin for the given L2 block number.
+
 ## Book
 
 The [book][book] contains an in-depth overview of the project, contributor guidelines, and tutorials for creating your own test fixtures as well as you own test runners.

README.md

@@ -30,5 +30,6 @@ alloy-eips.workspace = true
 
 # OP Types + Kona
 op-test-vectors.workspace = true
+kona-primitives.workspace = true
 kona-derive.workspace = true
 superchain-registry.workspace = true

bin/opdn/Cargo.toml

@@ -9,7 +9,7 @@ use kona_derive::online::{
     OnlineBeaconClient, OnlineBlobProviderWithFallback, SimpleSlotDerivation,
 };
 use kona_derive::traits::BlobProvider;
-use kona_derive::types::{Blob, BlockInfo, IndexedBlobHash};
+use kona_primitives::{Blob, BlockInfo, IndexedBlobHash};
 
 /// Loads blobs for the given block number.
 pub async fn load(

bin/opdn/src/cmd/blobs.rs

@@ -8,6 +8,7 @@ use kona_derive::online::{
     AlloyChainProvider, OnlineBeaconClient, OnlineBlobProviderWithFallback, SimpleSlotDerivation,
 };
 use kona_derive::traits::ChainProvider;
+use kona_primitives::Blob;
 use op_test_vectors::derivation::FixtureBlock;
 
 /// Constructs [FixtureBlock]s for the given L1 blocks.
@@ -21,7 +22,7 @@ pub async fn build_fixture_blocks(
         OnlineBeaconClient,
         SimpleSlotDerivation,
     >,
-) -> Result<Vec<FixtureBlock>> {
+) -> Result<Vec<FixtureBlock<Blob>>> {
     let mut fixtures = Vec::with_capacity(blocks.len());
     for b in blocks {
         let block_info = l1_provider

bin/opdn/src/cmd/fixtures.rs

@@ -6,10 +6,8 @@ use color_eyre::{
     Result,
 };
 use hashbrown::HashMap;
-use kona_derive::{
-    online::*,
-    types::{L2BlockInfo, StageError},
-};
+use kona_derive::{errors::StageError, online::*};
+use kona_primitives::L2BlockInfo;
 use op_test_vectors::derivation::DerivationFixture;
 use reqwest::Url;
 use std::path::PathBuf;

bin/opdn/src/cmd/from_l1.rs

@@ -6,10 +6,8 @@ use color_eyre::{
     Result,
 };
 use hashbrown::HashMap;
-use kona_derive::{
-    online::*,
-    types::{L2BlockInfo, StageError},
-};
+use kona_derive::{errors::StageError, online::*};
+use kona_primitives::L2BlockInfo;
 use op_test_vectors::derivation::DerivationFixture;
 use reqwest::Url;
 use std::path::PathBuf;

bin/opdn/src/cmd/from_l2.rs

@@ -1,6 +1,6 @@
 //! Utilities
 
-use kona_derive::types::{L2ExecutionPayloadEnvelope, L2PayloadAttributes, RawTransaction};
+use kona_primitives::{L2ExecutionPayloadEnvelope, L2PayloadAttributes, RawTransaction};
 
 /// Converts an [L2ExecutionPayloadEnvelope] to an [L2PayloadAttributes].
 pub fn to_payload_attributes(payload: L2ExecutionPayloadEnvelope) -> L2PayloadAttributes {

bin/opdn/src/cmd/util.rs

@@ -27,4 +27,5 @@ alloy-eips.workspace = true
 
 # OP Types + Kona
 kona-derive.workspace = true
+kona-primitives.workspace = true
 superchain-registry.workspace = true