Reference

Endpoints, contract addresses, package versions — single source of truth.

Latest release v1.5.0

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

Component	Version	Where
Provider app (GUI & CLI)	v1.5.0	GitHub releases
Python SDK (spacerouter)	v1.5.0	PyPI
JavaScript SDK (@spacenetwork/spacerouter)	v1.5.0	npm

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
Native gas token	CTC

Smart contracts

Production contracts on Creditcoin mainnet:

Contract	Address
SPACE token	0x7ab7C6A935Ab2D1437398790C9C0660af62A80b9
StakingV2	0x5d07fEd750F77C2DB8e7D1c031c05E3A5d2bc9fA
TokenPaymentEscrow	0xC130F5D76f0b4Ce8FE2ceA0D2C2b8f53A39a5cd0

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.

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. 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

• SDK (Python & JS): github.com/space-labs/space-router-sdk

Support

Email: [email protected] Bug reports: open an issue on the relevant GitHub repo.