How alternetproject/poc works
Alternet is a Python HTTPS retrieval system that finds relay peers, routes a client connection through them, and fetches HTTPS content over the resulting tunnel. Its runtime also includes peer-to-peer discovery, discovery services with contact storage, and an HTTP carrier for gateway transport. The tree and excerpts also identify experiments for resilience, recovery races, shared endpoints, transport, and wire filtering; these are shown as validation scenarios rather than runtime stages. Several experiment implementations and some runtime details were not sampled, so uncertain connections are omitted.
Main entry points: client.py HTTPS fetch · lab.py Local lab · transport_carrier.py Carrier experiment · recovery_race.py Recovery race
Components 19
Client and routing
- Configuration
alternet/config.py - HTTPS fetch
alternet/client.py - Route selection
alternet/routing.py - Client demo
alternet/demo.py
Relay network
- Relay node
alternet/node.py - Peer exchange
alternet/peer_discovery.py - HTTP carrier
alternet/http_carrier.py - Peer demo
alternet/peer_demo.py
Discovery services
- Discovery service
alternet/discovery.py - Contact store
alternet/discovery_store.py - Discovery demo
alternet/discovery_demo.py
Network experiments
- Local lab
alternet/lab.py - Entry resilience
experiments/entry_resilience.py - Recovery race
experiments/recovery_race.py - Shared endpoint
experiments/shared_endpoint.py - Carrier experiment
experiments/transport_carrier.py - Wire filter
experiments/wire_filter.py
Other components
- Application
- HTTPS origin
Connections 30
- Application → HTTPS fetch: requests fetch
alternet/client.py - HTTPS fetch → Configuration: uses settings
alternet/client.py - HTTPS fetch → Route selection: opens route
alternet/client.py - HTTPS fetch → HTTPS origin: fetches HTTPS
alternet/client.py - Relay node → Peer exchange: starts exchange
alternet/node.py - Discovery service → Contact store: stores contacts
alternet/discovery.py - Discovery service → HTTP carrier: creates sessions
alternet/discovery.py - Client demo → HTTPS fetch: calls fetch
alternet/demo.py - Client demo → Local lab: starts lab
alternet/demo.py - Discovery demo → HTTPS fetch: calls fetch
alternet/discovery_demo.py - Discovery demo → Discovery service: uses discovery
alternet/discovery_demo.py - Discovery demo → Local lab: starts lab
alternet/discovery_demo.py - Peer demo → HTTPS fetch: calls fetch
alternet/peer_demo.py - Peer demo → Peer exchange: uses peers
alternet/peer_demo.py - Peer demo → Local lab: starts lab
alternet/peer_demo.py - Entry resilience → HTTPS fetch: measures retrieval
experiments/entry_resilience.py - Entry resilience → Local lab: starts services
experiments/entry_resilience.py - Entry resilience → Wire filter: filters traffic
experiments/entry_resilience.py - Recovery race → HTTPS fetch: measures retrieval
experiments/recovery_race.py - Recovery race → Local lab: starts services
experiments/recovery_race.py - Recovery race → Entry resilience: reuses scenarios
experiments/recovery_race.py - Recovery race → Wire filter: filters traffic
experiments/recovery_race.py - Shared endpoint → HTTPS fetch: tests routing
experiments/shared_endpoint.py - Shared endpoint → Local lab: starts services
experiments/shared_endpoint.py - Shared endpoint → Wire filter: filters traffic
experiments/shared_endpoint.py - Carrier experiment → HTTPS fetch: tests transport
experiments/transport_carrier.py - Carrier experiment → HTTP carrier: tests carrier
experiments/transport_carrier.py - Carrier experiment → Local lab: starts services
experiments/transport_carrier.py - Carrier experiment → Route selection: tests routes
experiments/transport_carrier.py - Carrier experiment → Shared endpoint: uses endpoint case
experiments/transport_carrier.py