feat: add storage api

Cargo.toml

@@ -5,7 +5,7 @@ resolver = "2"
 [workspace.package]
 version = "0.16.0-rc.4"
 edition = "2024"
-rust-version = "1.88"
+rust-version = "1.92"
 authors = ["init4"]
 license = "MIT OR Apache-2.0"
 homepage = "https://github.com/init4tech/signet-sdk"
@@ -77,12 +77,15 @@ alloy-contract = { version = "1.4.0", features = ["pubsub"] }
 reth = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-ethereum = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-chainspec = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
+reth-codecs = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-db = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
+reth-db-api = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-db-common = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-eth-wire-types = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-evm-ethereum = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-exex = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-exex-test-utils = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
+reth-libmdbx = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-network-api = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-network-peers = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }
 reth-node-api = { git = "https://github.com/paradigmxyz/reth", tag = "v1.9.1" }

crates/storage/Cargo.toml

@@ -0,0 +1,24 @@
+[package]
+name = "signet-storage"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+authors.workspace = true
+license.workspace = true
+homepage.workspace = true
+repository.workspace = true
+
+[dependencies]
+alloy.workspace = true
+auto_impl = "1.3.0"
+bytes = "1.11.0"
+reth.workspace = true
+reth-db = { workspace = true, features = ["test-utils"] }
+reth-db-api.workspace = true
+reth-libmdbx.workspace = true
+thiserror.workspace = true
+trevm.workspace = true
+
+[dev-dependencies]
+serial_test = "3.3.1"
+tempfile.workspace = true

crates/storage/README.md

@@ -0,0 +1,17 @@
+# Signet Storage
+
+High-level API for Signet's storage layer
+
+This library contains the following:
+
+- Traits for serializing and deserializing Signet data structures as DB keys/
+  value.
+- Traits for hot and cold storage operations.
+- Relevant KV table definitions.
+
+## Significant Traits
+
+- `HotKv` - Encapsulates logic for reading and writing to hot storage.
+- `ColdKv` - Encapsulates logic for reading and writing to cold storage.
+- `KeySer` - Provides methods for serializing a type as a DB key.
+- `ValueSer` - Provides methods for serializing a type as a DB value.

crates/storage/src/cold/mod.rs

@@ -0,0 +1 @@
+//! Placeholder module for cold storage implementation.