> For the complete documentation index, see [llms.txt](https://docs.spacecoin.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spacecoin.org/spacerouter-proxy/overview.md).

# Overview

## SpaceRouter Proxy

A decentralized residential proxy network powered by the Spacecoin community.

SpaceRouter Proxy routes web traffic through residential connections contributed by people around the world. Consumers send proxy requests to a single gateway and reach websites with real, geo-targeted residential IPs. Providers run a small app at home, earn SPACE for the bandwidth they share, and stake SPACE to qualify.

### How it works

```
┌──────────────┐         ┌────────────────────┐         ┌────────────┐         ┌──────────┐
│   Proxy      │  HTTP   │SpaceRouter  Proxy  │  TLS    │   Proxy    │  HTTPS  │ Internet │
│   Consumer   │ ──────▶ │  Gateway + Coord.  │ ──────▶ │  Provider  │ ──────▶ │  target  │
│   (your app) │         │       API          │         │  (at home) │         │          │
└──────────────┘         └────────────────────┘         └────────────┘         └──────────┘
                                  │
                                  ▼
                         ┌────────────────────┐
                         │  TokenPaymentEscrow│   ← on-chain settlement
                         │   (Creditcoin)     │
                         └────────────────────┘
```

The Gateway picks a healthy Provider that matches your routing preferences (region, IP type), opens a tunnel, and relays traffic. Payment for the bandwidth is settled by signed on-chain receipt automatically.

### Two ways to participate

**I want to use the proxy** — Send requests through SpaceRouter Proxy from your app, script, or browser. Pay with SPACE on-chain — deposit once, pay per request.

**I want to run a Provider** — Share your home connection, stake SPACE, and earn rewards for serving traffic.

### What's in v1.5.0

* **Pay with SPACE** — Consumers deposit SPACE into the on-chain escrow and pay per request, with no subscription.
* **Earnings dashboard** — Providers see every receipt, claim history, and lifetime earnings inside the app.
* **Auto-claim** — Providers can opt in to automatic on-chain settlement when earnings cross a threshold.
* **Unified config path** — All platforms now use `~/.spacerouter/` for keys, settings, and receipts.

### Resources

<table data-header-hidden><thead><tr><th width="264.50390625"></th><th></th></tr></thead><tbody><tr><td>Website</td><td><a href="https://spacerouter.org">spacerouter.org</a></td></tr><tr><td>Provider download</td><td><a href="https://github.com/space-labs/space-router-node/releases/latest">github.com/space-labs/space-router-node/releases/latest</a></td></tr><tr><td>Python SDK</td><td><code>pip install spacerouter</code></td></tr><tr><td>JavaScript SDK</td><td><code>npm install @spacenetwork/spacerouter</code></td></tr><tr><td>Staking dApp</td><td><a href="https://penguinbase.com/dapp/spacestaking">penguinbase.com/dapp/spacestaking</a></td></tr><tr><td>Support</td><td><a href="mailto:router.support@spacenetwork.com">router.support@spacenetwork.com</a></td></tr><tr><td>Operator</td><td>Space Labs Ltd.</td></tr></tbody></table>