refactor(node): split into config, sequencer, and full crates (#428)

Split `katana-node` into three separate crates under `crates/node/`: `katana-node-config` for shared config types (db, rpc, metrics), `katana-sequencer-node` for the sequencer node, and `katana-full-node` for the full node. Shared configs are re-exported from each node crate so consumers access them through a single path. All downstream crates (cli, utils, rpc-server, tests/snos) updated accordingly. Replaces `katana_rpc_server::cors::HeaderValue` with `http::HeaderValue` in shared config to avoid coupling config to the RPC server implementation.

```
crates/node/
├── config/     → katana-node-config     (shared: db, rpc, metrics)
├── sequencer/  → katana-sequencer-node  (sequencer node)
└── full/       → katana-full-node       (full node)
```

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: kariy

Cargo.lock

@@ -18,7 +18,9 @@ members = [
 	"crates/grpc",
 	"crates/messaging",
 	"crates/metrics",
-	"crates/node",
+	"crates/node/config",
+	"crates/node/sequencer",
+	"crates/node/full",
 	"crates/node-bindings",
 	"crates/oracle/gas",
 	"crates/pool/pool",
@@ -92,7 +94,9 @@ katana-genesis = { path = "crates/genesis" }
 katana-grpc = { path = "crates/grpc" }
 katana-messaging = { path = "crates/messaging" }
 katana-metrics = { path = "crates/metrics" }
-katana-node = { path = "crates/node" }
+katana-node-config = { path = "crates/node/config" }
+katana-sequencer-node = { path = "crates/node/sequencer" }
+katana-full-node = { path = "crates/node/full" }
 katana-node-bindings = { path = "crates/node-bindings" }
 katana-pipeline = { path = "crates/sync/pipeline" }
 katana-pool = { path = "crates/pool/pool" }

Cargo.toml

@@ -9,7 +9,8 @@ version.workspace = true
 katana-chain-spec.workspace = true
 katana-core.workspace = true
 katana-messaging.workspace = true
-katana-node.workspace = true
+katana-sequencer-node.workspace = true
+katana-full-node.workspace = true
 katana-genesis.workspace = true
 katana-primitives.workspace = true
 katana-rpc-server.workspace = true
@@ -42,23 +43,24 @@ starknet.workspace = true
 paymaster = [
 	"dep:katana-paymaster",
 	"dep:katana-slot-controller",
-	"katana-node/paymaster",
+	"katana-sequencer-node/paymaster",
 	"katana-rpc-server/paymaster",
 ]
 vrf = [
 	"cartridge",
 	"dep:cartridge",
-	"katana-node/vrf",
+	"katana-sequencer-node/vrf",
 	"katana-rpc-server/vrf",
 ]
 cartridge = [
-	"katana-node/cartridge",
+	"katana-sequencer-node/cartridge",
+	"katana-full-node/cartridge",
 	"katana-rpc-server/cartridge",
 	"paymaster",
 ]
-grpc = [ "katana-node/grpc" ]
+grpc = [ "katana-sequencer-node/grpc" ]
 default = ["server", "tee", "vrf", "paymaster", "cartridge", "grpc"]
-explorer = ["katana-node/explorer", "katana-utils/explorer"]
-native = ["katana-node/native"]
+explorer = ["katana-sequencer-node/explorer", "katana-full-node/explorer", "katana-utils/explorer"]
+native = ["katana-sequencer-node/native"]
 server = []
-tee = ["dep:katana-tee", "katana-node/tee", "katana-node/tee-snp", "katana-tee/snp"]
+tee = ["dep:katana-tee", "katana-sequencer-node/tee", "katana-sequencer-node/tee-snp", "katana-tee/snp"]

crates/cli/Cargo.toml

@@ -14,26 +14,26 @@ use katana_core::constants::DEFAULT_SEQUENCER_ADDRESS;
 use katana_genesis::allocation::DevAllocationsGenerator;
 use katana_genesis::constant::DEFAULT_PREFUNDED_ACCOUNT_BALANCE;
 use katana_messaging::MessagingConfig;
-use katana_node::config::db::DbConfig;
-use katana_node::config::dev::{DevConfig, FixedL1GasPriceConfig};
-use katana_node::config::execution::ExecutionConfig;
-use katana_node::config::fork::ForkingConfig;
-use katana_node::config::gateway::GatewayConfig;
+use katana_sequencer_node::config::db::DbConfig;
+use katana_sequencer_node::config::dev::{DevConfig, FixedL1GasPriceConfig};
+use katana_sequencer_node::config::execution::ExecutionConfig;
+use katana_sequencer_node::config::fork::ForkingConfig;
+use katana_sequencer_node::config::gateway::GatewayConfig;
 #[cfg(all(feature = "server", feature = "grpc"))]
-use katana_node::config::grpc::GrpcConfig;
-use katana_node::config::metrics::MetricsConfig;
+use katana_sequencer_node::config::grpc::GrpcConfig;
+use katana_sequencer_node::config::metrics::MetricsConfig;
 #[cfg(feature = "cartridge")]
-use katana_node::config::paymaster::PaymasterConfig;
+use katana_sequencer_node::config::paymaster::PaymasterConfig;
 #[cfg(feature = "vrf")]
-use katana_node::config::paymaster::VrfConfig;
-use katana_node::config::rpc::RpcConfig;
+use katana_sequencer_node::config::paymaster::VrfConfig;
+use katana_sequencer_node::config::rpc::RpcConfig;
 #[cfg(feature = "server")]
-use katana_node::config::rpc::{RpcModuleKind, RpcModulesList};
-use katana_node::config::sequencing::SequencingConfig;
+use katana_sequencer_node::config::rpc::{RpcModuleKind, RpcModulesList};
+use katana_sequencer_node::config::sequencing::SequencingConfig;
 #[cfg(feature = "tee")]
-use katana_node::config::tee::TeeConfig;
-use katana_node::config::Config;
-use katana_node::Node;
+use katana_sequencer_node::config::tee::TeeConfig;
+use katana_sequencer_node::config::Config;
+use katana_sequencer_node::Node;
 use serde::{Deserialize, Serialize};
 use tracing::info;
 use url::Url;
@@ -616,7 +616,7 @@ impl SequencerNodeArgs {
 
             use anyhow::anyhow;
             use katana_genesis::allocation::GenesisAccountAlloc;
-            use katana_node::config::paymaster::CartridgeApiConfig;
+            use katana_sequencer_node::config::paymaster::CartridgeApiConfig;
 
             // Derive paymaster credentials from genesis account 0
             let (address, private_key) = {
@@ -780,13 +780,13 @@ mod test {
         DEFAULT_ETH_L1_DATA_GAS_PRICE, DEFAULT_ETH_L1_GAS_PRICE, DEFAULT_ETH_L2_GAS_PRICE,
         DEFAULT_STRK_L1_DATA_GAS_PRICE, DEFAULT_STRK_L1_GAS_PRICE,
     };
-    use katana_node::config::execution::{
+    use katana_primitives::chain::ChainId;
+    use katana_primitives::{address, felt, Felt};
+    use katana_sequencer_node::config::execution::{
         DEFAULT_INVOCATION_MAX_STEPS, DEFAULT_VALIDATION_MAX_STEPS,
     };
     #[cfg(feature = "server")]
-    use katana_node::config::rpc::RpcModuleKind;
-    use katana_primitives::chain::ChainId;
-    use katana_primitives::{address, felt, Felt};
+    use katana_sequencer_node::config::rpc::RpcModuleKind;
 
     use super::*;
 

crates/cli/src/args.rs

@@ -2,11 +2,10 @@ use std::path::PathBuf;
 
 use anyhow::{Context, Result};
 pub use clap::Parser;
-use katana_node::config::db::DbConfig;
-use katana_node::config::metrics::MetricsConfig;
-use katana_node::config::rpc::RpcConfig;
-use katana_node::full;
-use katana_node::full::Network;
+use katana_full_node::config::db::DbConfig;
+use katana_full_node::config::metrics::MetricsConfig;
+use katana_full_node::config::rpc::RpcConfig;
+use katana_full_node::Network;
 use serde::{Deserialize, Serialize};
 use tracing::info;
 
@@ -78,7 +77,7 @@ impl FullNodeArgs {
     async fn start_node(&self) -> Result<()> {
         // Build the node
         let config = self.config()?;
-        let node = full::Node::build(config).context("failed to build full node")?;
+        let node = katana_full_node::Node::build(config).context("failed to build full node")?;
 
         if !self.silent {
             info!(target: LOG_TARGET, "Starting full node");
@@ -102,13 +101,13 @@ impl FullNodeArgs {
         Ok(())
     }
 
-    fn config(&self) -> Result<full::Config> {
+    fn config(&self) -> Result<katana_full_node::Config> {
         let db = self.db_config();
         let rpc = self.rpc_config()?;
         let metrics = self.metrics_config();
         let pruning = self.pruning_config();
 
-        Ok(full::Config {
+        Ok(katana_full_node::Config {
             db,
             rpc,
             metrics,
@@ -118,7 +117,7 @@ impl FullNodeArgs {
         })
     }
 
-    fn pruning_config(&self) -> full::PruningConfig {
+    fn pruning_config(&self) -> katana_full_node::PruningConfig {
         use crate::options::PruningMode;
 
         // Translate CLI pruning mode to distance from tip
@@ -127,7 +126,7 @@ impl FullNodeArgs {
             PruningMode::Full(n) => Some(n),
         };
 
-        full::PruningConfig { distance }
+        katana_full_node::PruningConfig { distance }
     }
 
     fn db_config(&self) -> DbConfig {