AetherNet.Transport.WebRtc 2.0.0

AetherNet.Transport.WebRtc

Direct peer-to-peer transport for AetherNet over a WebRTC RTCDataChannel — two nodes talk directly over the internet with no central server in the data path.

Built on SIPSorcery (pure C#, cross-platform, Android/iOS-capable). It implements ITransportService, so TransportManager slots it into the transport ladder between the radio mesh (proximity, cheapest) and the QUIC/HTTP relay (last resort): when a direct path can be negotiated the conversation flows peer-to-peer; otherwise the relay carries it. PowerCostRelative = 45.

How it stays serverless

A WebRTC connection still needs a one-time signalling exchange (the SDP offer/answer plus ICE candidates). AetherNet carries that handshake over a channel you already have — the QUIC/HTTP relay, or even the radio mesh — instead of a dedicated signalling server. Once the channel is open, the conversation flows directly between the two devices.

• IWebRtcSignaling — the signalling seam.
• RelayWebRtcSignaling — carries the handshake over any ITransportService (the cross-device path), framed with a magic prefix + source-generated (AOT-safe) JSON; non-signalling bytes pass through untouched as ordinary app traffic.
• InMemoryWebRtcSignalingBus — ordered in-process signalling for simulations and tests.

Install

dotnet add package AetherNet.Transport.WebRtc

Usage

services
    // 1. Choose a signalling carrier:
    .AddRelayWebRtcSignaling<QuicRelayTransportService>()   // cross-device: ride the relay
    // 2. Register the transport (joins TransportManager's ladder at PowerCostRelative 45):
    .AddWebRtcTransport(localUhid: "aether:alice:01");

ICE servers default to a public STUN server. Pass an explicit list to override; an explicit empty list forces host-candidate-only ICE (same-LAN / loopback, no STUN/TURN):

services.AddWebRtcTransport(
    localUhid: "aether:alice:01",
    iceServers: new[]
    {
        new RTCIceServer { urls = "stun:stun.l.google.com:19302" },
        new RTCIceServer { urls = "turn:turn.example.com", username = "u", credential = "p" },
    });

For a single-process host (simulations, a device holding several identities) use the in-process bus instead of a relay:

services.AddInMemoryWebRtcSignaling("aether:alice:01")
        .AddWebRtcTransport(localUhid: "aether:alice:01");

License

MIT — see the repository root.