# Overview

## SpaceRouter

A decentralized residential proxy network powered by the Spacecoin community.

SpaceRouter 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    │  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 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spacecoin.org/spacerouter/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.