dig-rpc 0.5.0

Axum-based JSON-RPC server framework for a DIG node. Serves the dig-rpc-protocol interface over mTLS (peer) / HTTPS (public read) / loopback (control), with tier-based method allow-lists, per-peer rate limiting, and graceful shutdown. The node supplies a handler; this crate owns the transport + envelope + boundary.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! Server operational errors (bind / TLS / fatal).
//!
//! These are the server's own lifecycle failures — distinct from the per-request
//! [`RpcError`](dig_rpc_protocol::RpcError) carried in the JSON-RPC envelope. A
//! `RpcServerError` means the server could not start or keep running.

use std::net::SocketAddr;
use std::sync::Arc;

/// A server lifecycle error.
#[derive(Debug, Clone, thiserror::Error)]
pub enum RpcServerError {
    /// Binding the listen socket failed.
    #[error("failed to bind {addr}: {source}")]
    BindFailed {
        /// The address that could not be bound.
        addr: SocketAddr,
        /// The underlying I/O error.
        source: Arc<std::io::Error>,
    },

    /// Loading or building the TLS configuration failed.
    #[error("TLS configuration error: {0}")]
    Tls(Arc<anyhow::Error>),

    /// The server terminated with a fatal error.
    #[error("fatal server error: {0}")]
    Fatal(Arc<anyhow::Error>),
}