> 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/proxy-provider-guide.md).

# Proxy Provider Guide

You'll do six things, in order. Each links to a more detailed guide if you need it.

1. **Check prerequisites** — supported OS, open port 9090 (or a tunnel), staked SPACE, \~1 CTC for gas.
2. **Download & install** — pick the GUI installer for your operating system, or the CLI binary for headless servers.
3. **Run first-time setup** — generate or import your identity key, set your staking address, choose a network mode.
4. **Click Start** — your node enters **qualifying**, then moves to **earning** after the first review period.
5. **Watch your earnings** — the Earnings screen tallies SPACE owed for every request you serve.
6. **Claim** — once you have a few receipts, hit *Claim All Outstanding* to settle them on-chain. Your SPACE arrives in your collection wallet.

### What you'll see

#### The status badge

* **qualifying** — first 1–2 review periods after install. The network is verifying your reliability.
* **earning** — you're approved and earning SPACE on every request routed through you.
* **unstaked** — your stake is below the minimum. Add SPACE in the staking dApp.
* **inactive** — your node is offline or the wallet is draining.

#### The Earnings screen

Every request you serve produces a small **receipt**. The Earnings screen shows them grouped:

* **Claimable** — receipts ready to settle on-chain.
* **Pending signing** — receipts the gateway hasn't yet acknowledged.
* **Needs attention** — receipts that hit a transient error and will be retried.
* **Locked** — receipts that failed permanently and won't be retried.
* **History** — receipts already claimed.

### The single most important thing

{% hint style="warning" %}
**Top up your Identity wallet with CTC**

The app generates an **Identity wallet** on first launch. That wallet — not your staking wallet — submits your claim transactions to Creditcoin. It needs **\~1 CTC** for gas. Without CTC there, every claim will fail with `insufficient funds`. The Earnings screen shows the Identity wallet address with a copy button. Send a small amount of CTC to it before your first claim.
{% endhint %}

### Where to go next

**Prerequisites** — System requirements, network setup, wallets you'll need.

**Install** — Desktop installer or headless CLI binary.

**First-Time Setup** — Identity key, staking address, network mode.

**Claim Your Earnings** — How payments work and how to settle on-chain.