A very simple iroh protocol for pinging a remote node. It's a high level example & easy starting point for new projects.
Walk through the quickstart example in the Documentation Website.
This example demonstrates basic ping functionality between two endpoints.
First, start the receiver in one terminal:
cargo run --example quickstart receiverThe receiver will print a ticket. Copy this ticket, then in another terminal run:
cargo run --example quickstart sender <TICKET>Replace <TICKET> with the ticket printed by the receiver.
If the IROH_SERVICES_API_SECRET environment variable is set, the receiver will register with iroh-services and push endpoint metrics in the background. If it isn't set, the example prints a notice and continues without it.
export IROH_SERVICES_API_SECRET=<your-api-key>
cargo run --example quickstart receiverGet a free API key at services.iroh.computer.
Iroh has all sorts of internal ping-type messages, this is a high level demo of a protocol, and in no way necessary for iroh's normal operation.
Copyright 2026 N0, INC.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.