Add basic DSN client implementation

crates/subspace-gateway/Cargo.toml

@@ -22,6 +22,8 @@ clap = { version = "4.5.18", features = ["derive"] }
 fdlimit = "0.3.0"
 futures = "0.3.30"
 mimalloc = "0.1.43"
+parking_lot = "0.12.2"
+subspace-networking = { version = "0.1.0", path = "../subspace-networking" }
 supports-color = "3.0.1"
 thiserror = "1.0.64"
 tokio = { version = "1.40.0", features = ["macros"] }

crates/subspace-gateway/README.md

@@ -1,6 +1,6 @@
 # Subspace Gateway
 
-Data Gateway implementation for Subspace Network Blockchain using [Substrate](https://docs.substrate.io/) framework.
+Data Gateway implementation for the Subspace Network Blockchain.
 
 ## Getting Started
 

crates/subspace-gateway/src/commands/run.rs

@@ -1,6 +1,9 @@
 //! Gateway run command.
 //! This is the primary command for the gateway.
 
+mod dsn;
+
+use crate::commands::run::dsn::NetworkArgs;
 use crate::commands::shutdown_signal;
 use clap::Parser;
 use futures::{select, FutureExt};
@@ -19,8 +22,14 @@ pub struct RunOptions {
 #[derive(Debug, Parser)]
 pub(super) struct GatewayOptions {
     /// Enable development mode.
-    #[arg(long)]
+    ///
+    /// Implies following flags (unless customized):
+    /// * `--allow-private-ips`
+    #[arg(long, verbatim_doc_comment)]
     dev: bool,
+
+    #[clap(flatten)]
+    dsn: NetworkArgs,
 }
 
 /// Default run command for gateway
@@ -29,14 +38,23 @@ pub async fn run(run_options: RunOptions) -> anyhow::Result<()> {
     let signal = shutdown_signal();
 
     let RunOptions {
-        gateway: GatewayOptions { dev: _ },
+        gateway: GatewayOptions { dev, mut dsn },
     } = run_options;
 
+    // Development mode handling is limited to this section
+    {
+        if dev {
+            dsn.allow_private_ips = true;
+        }
+    }
+
     info!("Subspace Gateway");
     info!("✌️  version {}", env!("CARGO_PKG_VERSION"));
     info!("❤️  by {}", env!("CARGO_PKG_AUTHORS"));
 
-    let dsn_fut = future::pending::<()>();
+    let (_dsn_node, mut dsn_node_runner) = dsn::configure_network(dsn)?;
+    let dsn_fut = dsn_node_runner.run();
+
     let rpc_fut = future::pending::<()>();
 
     // This defines order in which things are dropped

crates/subspace-gateway/src/commands/run/dsn.rs

@@ -0,0 +1,62 @@
+//! DSN config and implementation for the gateway.
+
+use clap::Parser;
+use subspace_networking::libp2p::kad::Mode;
+use subspace_networking::libp2p::Multiaddr;
+use subspace_networking::{construct, Config, KademliaMode, Node, NodeRunner};
+
+/// Configuration for network stack
+#[derive(Debug, Parser)]
+pub(crate) struct NetworkArgs {
+    /// Multiaddrs of bootstrap nodes to connect to on startup, multiple are supported
+    #[arg(long)]
+    pub(crate) bootstrap_nodes: Vec<Multiaddr>,
+
+    /// Enable non-global (private, shared, loopback..) addresses in the Kademlia DHT.
+    /// By default these addresses are excluded from the DHT.
+    #[arg(long, default_value_t = false)]
+    pub(crate) allow_private_ips: bool,
+
+    /// Multiaddrs of reserved nodes to maintain a connection to, multiple are supported
+    #[arg(long)]
+    pub(crate) reserved_peers: Vec<Multiaddr>,
+
+    /// Maximum established outgoing swarm connection limit.
+    #[arg(long, default_value_t = 100)]
+    pub(crate) out_connections: u32,
+
+    /// Maximum pending outgoing swarm connection limit.
+    #[arg(long, default_value_t = 100)]
+    pub(crate) pending_out_connections: u32,
+}
+
+/// Create a DSN network client with the supplied configuration.
+pub(crate) fn configure_network(
+    NetworkArgs {
+        bootstrap_nodes,
+        allow_private_ips,
+        reserved_peers,
+        out_connections,
+        pending_out_connections,
+    }: NetworkArgs,
+) -> anyhow::Result<(Node, NodeRunner<()>)> {
+    // TODO:
+    // - store keypair on disk and allow CLI override
+    // - cache known peers on disk
+    // - get default dsnBootstrapNodes from chainspec?
+    // - prometheus telemetry
+    let default_config = Config::<()>::default();
+    let config = Config {
+        reserved_peers,
+        allow_non_global_addresses_in_dht: allow_private_ips,
+        max_established_outgoing_connections: out_connections,
+        max_pending_outgoing_connections: pending_out_connections,
+        bootstrap_addresses: bootstrap_nodes,
+        kademlia_mode: KademliaMode::Static(Mode::Client),
+        ..default_config
+    };
+
+    let (node, node_runner) = construct(config)?;
+
+    Ok((node, node_runner))
+}