ant_node/
lib.rs

1//! # ant-node
2//!
3//! A pure quantum-proof network node for the Autonomi decentralized network.
4//!
5//! This crate provides a thin wrapper around `saorsa-core` that adds:
6//! - Auto-upgrade system with ML-DSA signature verification
7//! - CLI interface and configuration
8//! - Content-addressed chunk storage with EVM payment
9//!
10//! ## Architecture
11//!
12//! `ant-node` delegates all core functionality to `saorsa-core`:
13//! - Networking via `P2PNode`
14//! - DHT via `AdaptiveDHT`
15//! - Trust via `TrustEngine`
16//! - Security via `IPDiversityConfig`
17//!
18//! ## Data Types
19//!
20//! Currently supports a single data type:
21//! - **Chunk**: Immutable content-addressed data (hash(value) == key)
22//!
23//! ## Example
24//!
25//! ```rust,no_run
26//! use ant_node::{NodeBuilder, NodeConfig};
27//!
28//! #[tokio::main]
29//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
30//!     let config = NodeConfig::default();
31//!     let mut node = NodeBuilder::new(config).build().await?;
32//!     node.run().await?;
33//!     Ok(())
34//! }
35//! ```
36
37#![deny(unsafe_code)]
38#![warn(missing_docs)]
39#![warn(clippy::all)]
40#![warn(clippy::pedantic)]
41// When the `logging` feature is off, variables used only in log macros become
42// unused. These are expected and harmless — the compiler optimises them away.
43#![cfg_attr(not(feature = "logging"), allow(unused_variables, unused_assignments))]
44
45pub mod ant_protocol;
46pub mod client;
47pub mod config;
48pub mod devnet;
49pub mod error;
50pub mod event;
51pub mod logging;
52pub mod node;
53pub mod payment;
54pub mod replication;
55pub mod storage;
56pub mod upgrade;
57
58pub use ant_protocol::{
59    ChunkGetRequest, ChunkGetResponse, ChunkMessage, ChunkMessageBody, ChunkPutRequest,
60    ChunkPutResponse, ChunkQuoteRequest, ChunkQuoteResponse, CHUNK_PROTOCOL_ID,
61    CLOSE_GROUP_MAJORITY, CLOSE_GROUP_SIZE, MAX_CHUNK_SIZE,
62};
63pub use client::{
64    compute_address, hex_node_id_to_encoded_peer_id, peer_id_to_xor_name, xor_distance, DataChunk,
65    XorName,
66};
67pub use config::{BootstrapCacheConfig, NodeConfig, StorageConfig};
68pub use devnet::{Devnet, DevnetConfig, DevnetEvmInfo, DevnetManifest};
69pub use error::{Error, Result};
70pub use event::{NodeEvent, NodeEventsChannel};
71pub use node::{NodeBuilder, RunningNode};
72pub use payment::{PaymentStatus, PaymentVerifier, PaymentVerifierConfig};
73pub use replication::{config::ReplicationConfig, ReplicationEngine};
74pub use storage::{AntProtocol, LmdbStorage, LmdbStorageConfig};
75
76/// Re-exports from `saorsa-core` so downstream crates (e.g. `ant-client`)
77/// can depend on `ant-node` alone without a direct `saorsa-core` dependency.
78pub mod core {
79    pub use saorsa_core::identity::{NodeIdentity, PeerId};
80    pub use saorsa_core::{
81        IPDiversityConfig, MlDsa65, MultiAddr, NodeConfig as CoreNodeConfig, NodeMode, P2PEvent,
82        P2PNode,
83    };
84}
ant_node/lib.rs

ant_node/
lib.rs
