For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Python SDK (spacerouter)

v1.5.0

JavaScript SDK (@spacenetwork/spacerouter)

v1.5.0

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

Native gas token

CTC

Smart contracts

Production contracts on Creditcoin mainnet:

Contract
Address

SPACE token

0x7ab7C6A935Ab2D1437398790C9C0660af62A80b9

StakingV2

0x5d07fEd750F77C2DB8e7D1c031c05E3A5d2bc9fA

TokenPaymentEscrow

0xC130F5D76f0b4Ce8FE2ceA0D2C2b8f53A39a5cd0

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):

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

Support

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

Last updated

Was this helpful?