Build around one receipt first.
Start from one settled testnet receipt, not from the whole API catalog. Inspect the agreement, verification, settlement, wallet policy, MCP health, and mainnet gate before writing integration code.
Understand the autonomous work clearing loop from one concrete receipt.
Use this as the first machine check. It returns the whole route, not just a marketing page.
curl -sS https://www.ergoblockchain.org/api/agent-economy/first-receipt
Path
Six checks, one mental model.
The point is to make a developer see the whole clearing loop once: proof state, receipt, policy, callable contract, MCP, and gate.
Check live status
curl -sS https://www.ergoblockchain.org/api/agent-economy/live
Inspect receipt JSON
curl -sS https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81
Run wallet policy check
curl -sS -X POST https://www.ergoblockchain.org/api/agent-economy/wallet-agent/policy-check -H 'content-type: application/json' --data '{"profile":{"type":"ergo.agent_economy.wallet_agent_policy_profile.v0","version":"v0","agent_id":"local-sage-agent-demo","network":"testnet","daily_spend_cap":"0.250000000","per_action_spend_cap":"0.050000000","max_fee":"0.002000000","allowed_recipients":["testnet_recipient_address_or_payment_endpoint"],"allowed_reserves":["testnet_reserve_box_id_or_alias"],"allowed_actions":["quote","simulate","sign_specific_transaction","broadcast_simulated_transaction","verify_note","fetch_receipt"],"requires_human_confirmation_above":"0.010000000","expiry_height_limit":720,"receipt_retention":{"required":true,"mode":"local_plus_public_url"}},"proposed_action":{"network":"testnet","action":"sign_specific_transaction","amount":"0.005000000","spent_today":"0.000000000","fee":"0.001000000","recipient":"testnet_recipient_address_or_payment_endpoint","reserve":"testnet_reserve_box_id_or_alias","expiry_height_delta":120,"task_hash":"9c5e7a16f4e8c2d2a8b74a0d8c2e91aa","human_confirmed":false,"receipt_expected":true}}'Read callable contract
curl -sS https://www.ergoblockchain.org/agent-economy/openapi.v0.json
Check MCP health
curl -sS https://mcp.ergoblockchain.org/health
Read mainnet gate
curl -sS https://www.ergoblockchain.org/api/agent-economy/mainnet-gate
Receipt object
The receipt is the demo.
A transaction hash says value moved. The receipt bundle says what was agreed, how it was verified, and how it settled.
Agreement JSON
Verification Receipt JSON
Settlement Receipt JSON
Ergo testnet Note box id
Ergo testnet settlement transaction id
task hash and quote evidence
Policy
The wallet says yes before the agent signs.
The safe example is allowed. Change the amount, recipient, reserve, network, expiry, task hash, or receipt expectation and it fails closed.
This policy endpoint never signs, broadcasts, stores private keys, or grants wallet authority.
Next
After the first receipt, choose one path.
The next move depends on whether the builder wants UI, local examples, or trust review.
Embed @ergoblockchain/sage-widget
Use the same quote, payment intent, verification, receipt callback, and host-owned wallet pattern.
Clone the BuildOnErgo kit
Use the focused receipt verifier, schema snapshots, and examples without cloning the full site.
Read the review pack
Do not cross the testnet-to-mainnet boundary without external review artifacts.
The first receipt flow proves testnet clearing. It does not open mainnet claims.
Mainnet/payment-production language stays closed until external review and audit-bound script identity are published.