> 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/reference.md).

# Reference

### Latest release v1.5.0

All Provider apps and SDK packages are aligned on version **v1.5.0**.

<table><thead><tr><th width="252.2265625">Component</th><th>Version</th><th>Where</th></tr></thead><tbody><tr><td>Provider app (GUI &#x26; CLI)</td><td>v1.5.0</td><td><a href="https://github.com/space-labs/space-router-node/releases/">GitHub releases</a></td></tr><tr><td>Python SDK (<code>spacerouter</code>)</td><td>v1.5.0</td><td><a href="https://pypi.org/project/spacerouter/">PyPI</a></td></tr><tr><td>JavaScript SDK (<code>@spacenetwork/spacerouter</code>)</td><td>v1.5.0</td><td><a href="https://www.npmjs.com/package/@spacenetwork/spacerouter">npm</a></td></tr></tbody></table>

### Network endpoints

| Service               | URL                                         | Purpose                                      |
| --------------------- | ------------------------------------------- | -------------------------------------------- |
| Proxy gateway (HTTPS) | `https://gateway.spacerouter.org`           | Single entry point for all consumer traffic. |
| Proxy gateway (HTTP)  | `gateway.spacerouter.org:8080`              | HTTP proxy port.                             |
| Staking dApp          | `https://penguinbase.com/dapp/spacestaking` | Stake SPACE, view rewards, unstake.          |

### Tokens

| Symbol            | What it is                             | Where used                              |
| ----------------- | -------------------------------------- | --------------------------------------- |
| **SPACE** mainnet | Spacecoin token (ERC-20 on Creditcoin) | Staking, on-chain payment, rewards      |
| **CTC** mainnet   | Creditcoin native gas token            | Pays gas for every on-chain transaction |

### Creditcoin mainnet

| Setting          | Value                                                           |
| ---------------- | --------------------------------------------------------------- |
| Chain ID         | `102030`                                                        |
| RPC URL          | `https://mainnet3.creditcoin.network`                           |
| Block explorer   | [creditcoin.blockscout.com](https://creditcoin.blockscout.com/) |
| Native gas token | CTC                                                             |

### Smart contracts

Production contracts on Creditcoin mainnet:

<table><thead><tr><th width="308.8203125">Contract</th><th>Address</th></tr></thead><tbody><tr><td>SPACE token</td><td><code>0x7ab7C6A935Ab2D1437398790C9C0660af62A80b9</code></td></tr><tr><td>StakingV2</td><td><code>0x5d07fEd750F77C2DB8e7D1c031c05E3A5d2bc9fA</code></td></tr><tr><td>TokenPaymentEscrow</td><td><code>0xC130F5D76f0b4Ce8FE2ceA0D2C2b8f53A39a5cd0</code></td></tr></tbody></table>

{% hint style="warning" %}
**Why aren't the addresses fixed in this doc?**

Contracts may be redeployed or upgraded across releases. The Provider app and SDK ship with the canonical addresses for the matching version. The release notes for v1.5.0 list the deployed addresses; treat those as authoritative.
{% endhint %}

### Routing parameters

#### Country codes

Any 2-letter ISO 3166-1 alpha-2 code, e.g. `US`, `KR`, `JP`, `BR`, `DE`, `GB`.

#### IP types

| Value         | Description                                         |
| ------------- | --------------------------------------------------- |
| `residential` | Home internet connections (most demand).            |
| `mobile`      | Cellular / mobile broadband.                        |
| `business`    | Business / enterprise ISPs.                         |
| `hosting`     | Datacenter / VPS IPs (cheapest, easiest to detect). |

### HTTP status codes

The full table is in [Consumer Errors & Troubleshooting](/spacerouter-proxy/service-user-guide/errors-and-troubleshooting.md). Common codes:

* **200** — Success.
* **402** — Payment required (escrow empty or below request price).
* **407** — Payment headers missing or challenge signature failed.
* **429** — Rate limited.
* **502** — Provider couldn't reach target.
* **503** — No matching Provider.
* **504** — Provider didn't respond in time.

### File & data layout

Provider data directory (all platforms):

```
~/.spacerouter/
├── certs/
│   ├── node-identity.key
│   ├── node.crt
│   ├── node.key
│   └── gateway-ca.crt
├── settings.json
├── receipts.db          (SQLite)
├── incidents.json
└── logs/
    └── spacerouter-node.log
```

Linux package install (`.deb`, `.rpm`) places these under `/opt/spacerouter/` instead.

### Useful environment variables

#### Consumer SDK / CLI

| Variable                     | Purpose                                        |
| ---------------------------- | ---------------------------------------------- |
| `SR_GATEWAY_URL`             | Override gateway.                              |
| `SR_GATEWAY_MANAGEMENT_URL`  | Management API (`/auth/challenge`, `/leg1/*`). |
| `SR_ESCROW_CHAIN_RPC`        | Creditcoin RPC for on-chain calls.             |
| `SR_ESCROW_CONTRACT_ADDRESS` | TokenPaymentEscrow contract address.           |
| `SR_ESCROW_PRIVATE_KEY`      | Wallet key for deposit/withdraw.               |

#### Provider

| Variable                             | Purpose                             |
| ------------------------------------ | ----------------------------------- |
| `SR_IDENTITY_PASSPHRASE`             | Decrypt identity key.               |
| `SR_RECEIPT_MAX_SIGN_ATTEMPTS`       | Sign retry cap (default 2).         |
| `SR_RECEIPT_MAX_CLAIM_ATTEMPTS`      | Claim retry cap (default 2).        |
| `SR_RECEIPT_REAPER_INTERVAL_SECONDS` | Reaper tick interval (default 300). |

### Repositories

* **Provider app:** [github.com/space-labs/space-router-node](https://github.com/space-labs/space-router-node)
* **SDK (Python & JS):** [github.com/space-labs/space-router-sdk](https://github.com/space-labs/space-router-sdk)

### Support

Email: <router.support@spacenetwork.com> Bug reports: open an issue on the relevant GitHub repo.