Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Decentralized Service Examples

For a local-service example, use the TCP/UDP relay demos. They register a named service and carry bytes between two Rings peers:

cargo run -p rings-relay-example --example rings-tcp-relay-example
cargo run -p rings-relay-example --example rings-udp-relay-example

For HTTP access through an Onion exit, see the Native Gateway and Browser Node and Extension guides. The relay demos and Onion gateway have different routing and privacy properties; a direct relay to a named service does not provide Onion routing.

Rings Network

A peer-to-peer network for the sovereign age. Browser tabs and native daemons join one overlay, find each other by DID, and talk over direct WebRTC datachannels routed by a Chord DHT.

License
The Rings source code is released under the GNU Affero General Public License, version 3.0 only (AGPL-3.0-only). Works derived from it, including services that offer it over a network, must be released under the same license.
Commercial use
Commercial use is permitted only on the AGPL's terms: products and hosted services built on Rings must publish their source. A commercial license for use outside those terms is available from Rings Network on request. The Rings Network name, logo, and the hosted rings.rs service are not covered by the license.
No warranty
The software and this site are provided as is, without warranty of any kind, express or implied, as set out in sections 15 and 16 of the AGPL.
Security boundary
DID authentication proves control of a key. It is not Sybil or eclipse resistance for permissionless membership; read the threat model before deploying.
Privacy
rings.rs is a static site: no accounts, no analytics, no tracking cookies. Browser-node settings are kept in your browser's local storage.
© 2021–2026 Rings Network AGPL-3.0-only · Built with Rust, mdBook, and WebAssembly