diff --git a/images/how-iroh-works/connect-by-key.svg b/images/how-iroh-works/connect-by-key.svg deleted file mode 100644 index f686cee..0000000 --- a/images/how-iroh-works/connect-by-key.svg +++ /dev/null @@ -1,112 +0,0 @@ - - - - - - - - - - - - 10.0.0.42 - - 192.168.1.7 - - 203.0.113.15 - - 172.20.4.88 - - 192.168.10.55 - - - - - - iroh - a4f7c0… - - - - - - - iroh - 8e2b1d… - - - Alice - Bob - - - - - connect - - - - - - - - - - diff --git a/images/how-iroh-works/embedding-phone.svg b/images/how-iroh-works/embedding-phone.svg deleted file mode 100644 index df4cb51..0000000 --- a/images/how-iroh-works/embedding-phone.svg +++ /dev/null @@ -1,121 +0,0 @@ - - - - - iOS app (Swift) -iroh via iroh-ffi - - - - swift app - - iroh - - - - - Android app (Kotlin) -iroh via iroh-ffi - - - - - kotlin app - - iroh - - - - - Native desktop (C++) -iroh via iroh-c-ffi - - - - c++ app - - iroh - - - - - - - Web app (JavaScript) -iroh compiled to WASM - - - - - - - - - js app - - iroh - - - - - Server daemon (Rust) -iroh crate directly - - - - - - - - - - - - rust daemon - - iroh - - - - - Embedded firmware (Rust) -iroh crate - - - - - - - - - - - - - - - - - - firmware - - iroh - - diff --git a/images/how-iroh-works/endpoint-startup.svg b/images/how-iroh-works/endpoint-startup.svg deleted file mode 100644 index 2e8c23a..0000000 --- a/images/how-iroh-works/endpoint-startup.svg +++ /dev/null @@ -1,137 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - us-west - - - - - - - - - - - - 52.10.18.7 - - - - - us-east - - - - - - - - - - - - 44.208.61.5 - - - - - eu-west - - - - - - - - - - - - 18.196.142.9 - - - - - - - - - - - - - - - iroh - 8e2b… - - - - 73.118.42.9 - - - - - - - - - - us-east: 19 ms - us-west: 71 ms - eu-west: 102 ms - - - - - - - - - - diff --git a/images/how-iroh-works/hole-punching-lan.svg b/images/how-iroh-works/hole-punching-lan.svg deleted file mode 100644 index c62dfaa..0000000 --- a/images/how-iroh-works/hole-punching-lan.svg +++ /dev/null @@ -1,156 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - relay - - - - - - - - - - 192.168.0.1 - - - - - - - - iroh - 1a9c… - Alice - - - EndpointId: 1a9c… - Addr: 192.168.0.3:2104 - Addr: 4.9.8.2:2104 - relay: us-east - - - - - - - - - iroh - 8e2b… - Bob - - - EndpointId: 8e2b… - Addr: 192.168.0.5:4153 - Addr: 4.9.8.2:4153 - relay: us-east - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - direct (LAN) - - - - - - - ADD_ADDRESS 192.168.0.5:4153 - ADD_ADDRESS 4.9.8.2:4153 - - - - - - - - Bob - Candidate: 192.168.0.5:4153 - Candidate: 4.9.8.2:4153 - - - - - REACH_OUT192.168.0.3:2104 - REACH_OUT4.9.8.2:2104 - - - - - - - - Alice - Candidate: 192.168.0.3:2104 - Candidate: 4.9.8.2:2104 - - - - - PATH_CHALLENGE - 192.168.0.5:4153 - - - - - PATH_RESPONSE - PATH_CHALLENGE - 192.168.0.3:2104 - - - - - PATH_RESPONSE - - - - - - - diff --git a/images/how-iroh-works/hole-punching.svg b/images/how-iroh-works/hole-punching.svg deleted file mode 100644 index d4757f1..0000000 --- a/images/how-iroh-works/hole-punching.svg +++ /dev/null @@ -1,257 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - relay - - - - 8.3.1.9 - - - - - - - 10.0.0.1 - - - - 4.9.8.2 - - - - - - - 192.168.0.1 - - - - - - - - iroh - 1a9c… - Alice - - - EndpointId: 1a9c… - Addr: 10.0.0.3:2104 - Addr: 8.3.1.9:2104 - relay: us-west - - - - - - - - - iroh - 8e2b… - Bob - - - EndpointId: 8e2b… - Addr: 192.168.0.3:4153 - Addr: 4.9.8.2:4153 - relay: us-east - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - not routable - - - - - - not routable - - - - - - no mapping - - - - - - - - 4.9.8.2:4153 → - 10.0.0.3:2104 - - - - - - - - - - - - - - - - - - - 8.3.1.9:2104 → - 192.168.0.3:4153 - - - - - - - - - - - - - - - - - - ADD_ADDRESS 192.168.0.3:4153 - ADD_ADDRESS 4.9.8.2:4153 - - - - - - - - Bob - Candidate: 192.168.0.3:4153 - Candidate: 4.9.8.2:4153 - - - - - REACH_OUT10.0.0.3:2104 - REACH_OUT8.3.1.9:2104 - - - - - - - - Alice - Candidate: 10.0.0.3:2104 - Candidate: 8.3.1.9:2104 - I need to reach out - - - - - PATH_CHALLENGE - 192.168.0.3:4153 - - - - - PATH_CHALLENGE - 10.0.0.3:2104 - - - - - PATH_CHALLENGE - 4.9.8.2:4153 - - - - - PATH_CHALLENGE - 8.3.1.9:2104 - - - - - PATH_RESPONSE - PATH_CHALLENGE - - - - - PATH_RESPONSE - - - - - - - diff --git a/images/how-iroh-works/publish-relay-dht.svg b/images/how-iroh-works/publish-relay-dht.svg deleted file mode 100644 index cdf67db..0000000 --- a/images/how-iroh-works/publish-relay-dht.svg +++ /dev/null @@ -1,149 +0,0 @@ - - - - - - - - - - - - - Mainline DHT - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - iroh - 8e2b… - Bob - - - NodeId: 8e2b… - Home relay: us-east - - - - - - - - - iroh - 1a9c… - Alice - - 8e2b… is at relay us-east - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - DHT put - 8e2b… - Relay: us-east - - - - - - - DHT get - 8e2b… - - - - - - - ;; ANSWER SECTION: - TXT "relay=https://us-east" - - - - - - - diff --git a/images/how-iroh-works/publish-relay.svg b/images/how-iroh-works/publish-relay.svg deleted file mode 100644 index ca079a7..0000000 --- a/images/how-iroh-works/publish-relay.svg +++ /dev/null @@ -1,125 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - dns.iroh.link - - - - - - 1f3a… → eu-west - 7c0e… → us-west - b48d… → us-east - 2a91… → eu-west - 8e2b… → us-east - - - - - - - - - iroh - 8e2b… - Bob - - - NodeId: 8e2b… - Home relay: us-east - - - - - - - - - iroh - 1a9c… - Alice - - - 8e2b… is at relay us-east - - - - - - - - - - - - - - - - - HTTPS PUT - Relay: us-east - Signed by: 8e2b… - - - - - - - - - DNS LOOKUP - TXT _iroh.8e2b….dns.iroh.link - - - - ;; ANSWER SECTION: - TXT "relay=https://us-east" - - - - - - - - diff --git a/images/how-iroh-works/routing-moves.svg b/images/how-iroh-works/routing-moves.svg deleted file mode 100644 index 357ba06..0000000 --- a/images/how-iroh-works/routing-moves.svg +++ /dev/null @@ -1,148 +0,0 @@ - - - - - - - - - - - 10.0.0.42 - - - - iroh - a4f7c0… - Alice - - - - - - 10.0.0.7 - 192.168.1.7 - 172.16.0.7 - - - - - iroh - 8e2b1d… - Bob - - - - - - - - - - - - - - - - - - - - - - - - home router - - 203.0.113.1 - - - - - - - 10.0.0.1 - - - - - - - mobile network - - 198.51.100.1 - - - - - - 192.168.1.1 - - - - - - - satellite internet - - 100.64.10.1 - - - 172.16.0.1 - - - - - - - - - - diff --git a/what-is-iroh.mdx b/what-is-iroh.mdx index a36c91a..41ebbbf 100644 --- a/what-is-iroh.mdx +++ b/what-is-iroh.mdx @@ -11,7 +11,7 @@ application — in Rust, or in C, C++, Swift, Python, JavaScript, and Kotlin through [our bindings](/languages). - iroh embedded across six device contexts: iOS, Android, desktop, browser, server, embedded + iroh embedded across six device contexts: iOS, Android, desktop, browser, server, embedded ## Core features @@ -52,7 +52,7 @@ That key — not an IP address — is the address. It lets you connect to a peer matter where it is, even as its network location changes underneath it. - Alice connects to Bob by key — IPs change, the key stays stable + Alice connects to Bob by key — IPs change, the key stays stable ### Reliable connections @@ -62,7 +62,7 @@ possible. When network conditions change, iroh immediately reacts and switches to the new best path — transparently, without dropping the connection. - Alice and Bob connected via a shared router, with two more routers available for when Bob moves + Alice and Bob connected via a shared router, with two more routers available for when Bob moves Now that we've seen *what* iroh does, here's *how*. @@ -94,7 +94,7 @@ closest relay becomes the **home relay**, and the endpoint keeps a secure WebSocket connection open to it. - A map of the US and Europe with iroh relays in us-west (Seattle), us-east (Delaware), and eu-west (Frankfurt), and an endpoint in Florida + A map of the US and Europe with iroh relays in us-west (Seattle), us-east (Delaware), and eu-west (Frankfurt), and an endpoint in Florida ### Finding peers @@ -110,7 +110,7 @@ reach Bob resolves that record with a DNS or HTTPS query. See [DNS address lookup](/connecting/dns-address-lookup). - Bob publishes a signed DNS record with his home relay to dns.iroh.link via an HTTPS PUT; Alice resolves it with a DNS lookup + Bob publishes a signed DNS record with his home relay to dns.iroh.link via an HTTPS PUT; Alice resolves it with a DNS lookup #### Mainline DHT lookup @@ -122,7 +122,7 @@ exact same signed record using the [DHT address lookup](/connecting/dht-address-lookup). - Bob publishes his signed record to several random nodes of the Mainline DHT; Alice resolves it by querying several random nodes + Bob publishes his signed record to several random nodes of the Mainline DHT; Alice resolves it by querying several random nodes ### Direct connections @@ -141,7 +141,7 @@ but using its own transport parameter ID. See [NAT traversal](/concepts/nat-traversal). - Alice and Bob, each behind a home router, connected through the relay — all data flows up to the relay and back down + Alice and Bob, each behind a home router, connected through the relay — all data flows up to the relay and back down #### Local connections @@ -151,7 +151,7 @@ just needs to learn the other's local address. See [local address lookup](/connecting/local-address-lookup). - Alice and Bob on the same home network discover each other over the relay, then connect directly across the LAN — the relay uplink fades away once the local path is validated + Alice and Bob on the same home network discover each other over the relay, then connect directly across the LAN — the relay uplink fades away once the local path is validated ## How the pieces stack together