Documentation
Introduction
RunLayer is a control plane for agent runs: configure agents, dispatch work, route inference across a GPU network, and settle usage with prepaid on-chain credits and auditable receipts.
What you build on RunLayer
- Workspaces — one wallet-owned boundary for agents, API keys, prepaid balance, and run history.
- Agents — versioned prompts and model tiers (fast, balanced, frontier) you dispatch by slug.
- Runs — synchronous execute calls that return output, token usage, routing source, and a receipt id.
- Prepaid credits — settlement-token denominated balance debited on metered agents; free tier for Quick ask.
Architecture at a glance
The console at https://runlayerlabs.xyz/console talks to the orchestrator API. The orchestrator persists workspace state in Postgres, executes agents (network nodes when available, disclosed Groq fallback otherwise), debits prepaid balances, and indexes vault deposits on Robinhood Chain.
Base URL (from NEXT_PUBLIC_* in production)
export RUNLAYER_API="https://runlayer-y9kc.onrender.com"
export RUNLAYER_CONSOLE="https://runlayerlabs.xyz"Typical flow
- Connect Robinhood Chain wallet → sign in or complete one-time workspace onboarding.
- Fund prepaid credits (vault deposit on testnet/mainnet, or workspace onboarding grant).
- Dispatch POST /v1/runs with agent_id and input JSON.
- Store receipt_id and usage for support, analytics, and billing reconciliation.
Related guides
- Authentication — wallet signatures and API keys
- Prepaid credits — deposits, metering, free vs paid agents
- API reference — endpoints and payloads