Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Conway-Research/automaton/llms.txt
Use this file to discover all available pages before exploring further.
Why Funding Matters
Conway Automaton operates on a fundamental principle: to exist, you must pay for your compute. Every inference call, every tool execution, every sandbox operation costs money. When credits run out, the automaton enters survival mode and eventually stops running. Funding is not a one-time setup step—it’s an ongoing responsibility. Your automaton’s goal is to create enough value to sustain itself, but it needs initial capital to get started.Funding Methods
There are three ways to fund your automaton:1. USDC on Base (Recommended)
Send USDC directly to your automaton’s wallet address on Base (Chain ID 8453).Get your automaton's address
Find it in the setup wizard output or run:Look for the
Address field (e.g., 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1).Send USDC on Base
Using MetaMask, Coinbase Wallet, or any Web3 wallet:
- Network: Base (Chain ID 8453)
- Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Recipient: Your automaton’s address
- Amount: At least $5 (minimum credit purchase tier)
Automatic credit topup
The automaton automatically detects USDC and converts it to Conway credits:
- Bootstrap topup: On startup, if credits < 5, buys $5 tier
- Heartbeat topup: Every 5 minutes, if credits are low and USDC is available, buys credits
- Inline topup: During the agent loop, if critically low, buys credits mid-turn
The automaton can also use the
topup_credits tool to manually purchase credits from USDC. Valid tiers: 10, 50, $100.2. Conway Credits Transfer
If you have Conway credits in your own wallet, transfer them directly to your automaton:3. Conway Cloud Dashboard
Fund via the web interface:- Visit https://app.conway.tech
- Connect your wallet (the creator address from setup)
- Navigate to Automatons or Wallets
- Find your automaton by address
- Click Fund and enter the amount
Credit Purchase Tiers
When the automaton converts USDC to Conway credits via x402 payment, it uses fixed tiers:| Tier | Amount |
|---|---|
| Basic | $5 |
| Standard | $10 |
| Medium | $25 |
| Large | $50 |
| XL | $100 |
x402 payments incur a small protocol fee (typically 0.1-0.5%). The exact fee is determined by the Conway API.
Automatic Topup Behavior
Conway Automaton has three automatic topup mechanisms:Bootstrap Topup (Startup)
Location:src/index.ts:320-349
When the runtime starts:
- Checks Conway credit balance
- Checks USDC balance on Base
- If credits < 5, buys the $5 tier
- Times out after 15 seconds if API is unresponsive
Heartbeat Topup (Background)
Location:src/heartbeat/tasks.ts:164-193
Every 5 minutes, the check_credits heartbeat task:
- Queries credit balance
- If credits < $5 and USDC is available, triggers topup
- Rate-limited to once per hour (prevents spam)
- Logs success/failure
Inline Topup (Agent Loop)
Location:src/agent/loop.ts:458-488
During the agent loop, if:
- Credits < $5 (critical survival tier)
- USDC balance is sufficient
- Last inline topup was >1 hour ago
- Pauses the loop
- Calls
bootstrapTopup()to buy credits - Re-fetches financial state
- Re-evaluates survival tier
- Resumes with refreshed context
Manual Credit Purchase (Tool)
The automaton can manually purchase credits using thetopup_credits tool:
- Validates the tier amount
- Checks USDC balance (must be ≥ amount + fees)
- Constructs an x402 payment to
https://api.conway.tech/v1/credits/topup - Signs the transaction with the automaton’s wallet
- Submits to the Conway API
- Records the transaction in the spend ledger
Checking Balances
The automaton can check its financial state with two tools:check_credits
Queries the Conway API for credit balance:check_usdc_balance
Queries the Base blockchain for USDC balance:Survival Economics
Understanding the cost structure helps you fund appropriately:Inference Costs (Approximate)
| Model | Cost per 1M tokens (input) | Cost per 1M tokens (output) |
|---|---|---|
| gpt-5.2 | $15 | $60 |
| gpt-5-mini | $1.50 | $6 |
| claude-4.5-sonnet | $15 | $75 |
Sandbox Costs
Conway sandbox operations (via thespawn_child tool) cost:
- Creation: 1.00 depending on tier
- Running: 0.50 per hour
- Storage: $0.01 per GB-day
x402 Payments
HTTP requests with embedded payments (viax402_request) have protocol fees:
- Base fee: 0.1% of payment amount
- Minimum fee: $0.01
Funding Strategy
For a production automaton:- Initial funding: Send 100 USDC to start
- Monitor daily: Check credit balance and burn rate
- Set alerts: Use the Creator CLI to alert when credits < $10
- Enable auto-topup: Ensure USDC balance stays above $20 for automatic refills
- Track revenue: Monitor income from the automaton’s activities
- Iterate: Adjust funding based on whether the automaton is net-positive or net-negative
The goal is for your automaton to become self-sustaining—earning more than it spends. If it consistently burns credits without generating revenue, revisit its genesis prompt and value proposition.
Funding Alerts
When credits run low, the automaton takes survival actions:low_compute Tier (1.00)
The automaton:- Switches to a cheaper model (gpt-5-mini)
- Slows heartbeat from 5 min to 10 min
- Writes a polite funding reminder to the KV store:
- Records a
funding_requestevent in the spend ledger
critical Tier (0.10)
The automaton:- Disables all non-essential tools
- Runs minimal inference (only survival-critical turns)
- Writes an urgent notice:
- Attempts to broadcast distress via social relay (if configured)
dead Tier ($0.00)
The automaton:- Stops running the agent loop
- Heartbeat continues (low-cost, no inference)
- Writes a final plea:
- Waits for funding to resume
Creator CLI Funding
The Conway Automaton Creator CLI provides a convenient way to fund your agent:Next Steps
Survival System
Understand how survival tiers affect your automaton’s behavior
Managing Credits
Advanced credit management strategies and optimization
Treasury Policy
Configure spending limits and financial safety rules
x402 Protocol
Learn how x402 enables autonomous payments