nym-smoldvpn 1.21.5-rc.3

Pure-Rust userspace 1-/2-hop WireGuard dVPN datapath (boringtun on nym-smol-core) exposing tokio socket surfaces, with an optional QUIC bridge transport
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
30
31
32
33
34
35
36
37
38
39
40

// Copyright 2026 - Nym Technologies SA <contact@nymtech.net>
// SPDX-License-Identifier: Apache-2.0

use thiserror::Error;

/// Errors from the `smoldvpn` datapath.
#[derive(Error, Debug)]
pub enum DvpnError {
    /// A transport (UDP / QUIC bridge) operation failed.
    #[error("transport error: {0}")]
    Transport(String),

    /// The underlying smol-core stack errored.
    #[error("stack error: {0}")]
    Stack(#[from] nym_smol_core::SmolCoreError),

    /// Socket / IO error.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// Setup or teardown was cancelled via the `CancellationToken`.
    #[error("cancelled")]
    Cancelled,

    /// Invalid configuration.
    #[error("invalid configuration: {0}")]
    Config(String),

    /// QUIC bridging was requested for a one-hop tunnel (only valid on the
    /// two-hop entry leg).
    #[error("QUIC bridge is only valid on the two-hop entry leg")]
    QuicRequiresTwoHop,

    /// The QUIC bridge handshake / connection failed.
    #[error("QUIC bridge error: {0}")]
    Bridge(String),
}

/// Result alias for the datapath.
pub type Result<T> = std::result::Result<T, DvpnError>;