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

Daily Operation

What the app shows you, what each status means, and how to read your earnings.

Status screen

The home screen of the app has a single status badge plus your wallet info.

Status states

Status
Indicator
Meaning
What to do

earning

green

Your node is online, your stake is approved, and you are earning SPACE on every routed request.

Nothing — keep the node online.

qualifying

yellow

Your node is online, but the network hasn't approved you yet. New nodes spend their first review period(s) here.

Wait. Reviews run every 4 hours.

unstaked

red

Your node is online, but your stake is below the 1,000 SPACE minimum.

Open the staking dApp and stake more SPACE.

inactive

dim

Your node is offline, draining, or has no staking address.

Click Start; if it stays inactive, see Troubleshooting.

What "qualifying" actually means

The Coordination API runs a continuous health check against every Provider. Every 4 hours (at 00:00, 04:00, 08:00, 12:00, 16:00, 20:00 UTC) it scores your reliability over the most recent 240-minute window. Once you cross the pass threshold, you move to earning. Brand-new nodes typically clear it within one or two review cycles.

If you bounce between qualifying and inactive, you have a connectivity problem. Check the network mode and see Troubleshooting.

Wallet panel

The status screen shows three address chips:

  • Identity — auto-generated. Click to copy. This is the wallet that needs CTC for gas.

  • Staking — what you set during setup. Click to view it on the staking dApp.

  • Collection — where claimed SPACE lands. Equal to staking unless you set it otherwise.

Earnings screen

Click Earnings from the status screen to open the receipt dashboard.

Sections

Section
What's in it
Action

Claimable

Receipts the gateway has signed for you. Ready to settle on chain.

"Claim All Outstanding" button.

Pending signing

Receipts waiting for the gateway's EIP-712 signature.

None — they sign themselves shortly.

Needs attention

Receipts that hit a transient failure (network, RPC). Will retry automatically.

Click "Retry now" to retry immediately.

Locked

Receipts that failed twice and are permanently rejected. They show why.

None — these can't be claimed.

History

Receipts already claimed on chain.

Click for a Blockscout link.

The Claim wallet card

Right above the Claimable section is a card that shows your Identity wallet address and its current CTC balance. If the balance is too low for the next claim, the card shows a yellow warning and an explanation. Read the Claim guide →

Receipt detail

Click any receipt to open its detail modal:

  • Request UUID

  • Bytes served and price

  • Current state (pending_sign / claimable / failed_retryable / failed_terminal / claimed)

  • Error reason (if any) with a "What this means" explanation

  • Blockscout link to the on-chain claim transaction (if claimed)

Settings panel

The Settings gear opens a panel for runtime configuration:

  • Network mode (UPnP / Manual / Tunnel) — change without re-onboarding.

  • Auto-claim toggle and thresholds — see Auto-claim.

  • Log level.

  • Coordination API endpoint (advanced — only change if instructed).

Saving the settings panel restarts the daemon automatically. The status badge briefly returns to initializing.

Reset Node

The bottom of the status screen has a Reset Node button. It deletes your identity key, settings, and receipt store, and re-runs first-time setup.

Logs

Logs are written to ~/.spacerouter/logs/spacerouter-node.log. Rotate automatically; one line per event. The most useful filters:

If you need to share logs with support, redact your identity address and any private keys before sending.

Last updated

Was this helpful?