Skip to content
danielpetri1Public

About

Nada, your sovereign relay for an agentic Internet.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

∅ Nada

Nada is a MASQUE network relay that tunnels TCP and UDP over HTTP/3.

Technology stack

DOI DOI

Nada is compatible with Apple's NERelay API. The implementation is based on:

As a prototype under construction, Nada is not intended for production. Please cite CITATION.cff if you use Nada in your research.

Setup

cp env-examples.sh env.sh

# Edit env.sh to match your deployment
vim env.sh

# Keep runtime settings in the current shell
source ./env.sh

# Install nada
bash build.sh

Run

Applications can connect to Nada's local TCP or UDP listeners at [::1]:18018 or 127.0.0.1:18018. Using the CLI for local testing requires specifying a --target to which all flows are sent.

# See available options
nada --help

# Start the relay
nada relay

# Open a CONNECT-UDP tunnel:
nada connect-udp --target 1.1.1.1:53

# Open a CONNECT tunnel:
nada connect --target 1.1.1.1:53

# Tunnel a DNS query through the relay:
dig @127.0.0.1 -p 18018 example.com +notcp +ignore
dig @::1 -p 18018 example.com +notcp +ignore

Library

Nada's Rust library can also be used to open tunnels directly with connect_udp or connect_tcp.

The HTTP/3 GET example opens a single client-relay connection and opens concurrent tunnels with potentially varying origins, paths, and priorities. Each tunnel carries an independent end-to-end HTTP/3 connection.

Run it from the repository root:

cargo run --release --example get

Scenarios can be specified in scenarios.txt, c.f. the example guide.

Sending modes

Nada uses unreliable transmission by default. Each endpoint selects its preferred substrate for all CONNECT-UDP tunnels. Both endpoints decode both incoming formats regardless of their outgoing mode.

Client Relay Client → relay Relay → client
default default QUIC DATAGRAM QUIC DATAGRAM
default --reliable QUIC DATAGRAM DATAGRAM capsules
--reliable default DATAGRAM capsules QUIC DATAGRAM
--reliable --reliable DATAGRAM capsules DATAGRAM capsules

Reliability covers the client–relay segment. CONNECT always carries HTTP/3 DATA frames reliably and is therefore not affected by --reliable.

Encryption

TLS_CURVES_LIST is configurable in env.sh.

Tunnel prioritization

Library callers can use connect_udp_with_priority(target, urgency, incremental) to choose each tunnel's priority.

CONNECT and CONNECT-UDP requests use HTTP Priority u=3,i by default.

Experimental features

Multipath support with cooperative scheduling extensions is available here. Artifacts of that legacy version are available here.

About

Nada, your sovereign relay for an agentic Internet.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Contributors

Languages