The shortest path from curiosity to a working agent flow.
This page turns the live proof surface into an operator-grade checklist: which endpoint to call first, what to inspect, how to test wallet-agent policy, where receipts live, and which mainnet claims remain closed.
A practical developer entrypoint for Ergo's testnet-first agent economy surfaces. Mainnet remains audit-gated.
Live cockpit
Operational state for Sage, MCP, receipts, widget, policy, and mainnet gate.
Proof explorer
One board for receipt bundles, conformance evidence, MCP health, widget state, and audit gates.
Roadmap
Strategic map for live surfaces, next repo work, external trust gates, and later provider registry work.
Policy playground
Interactive allow/deny lab before any wallet is asked to sign.
Publish service
Validate provider manifests before registry review: capability, pricing, payment rails, predicates, receipts, and evidence.
Reputation graph
Receipt-derived trust signals for providers, tools, verifier templates, settlement evidence, and disputes.
Accept job
Validate a worker intent before assignment: job id, capabilities, output terms, receipt expectations, evidence, and testnet posture.
Quote job
Scaffold a job-bound quote, Agreement draft, receipt expectation, and settlement handoff before signing.
Developer services
Hashing, address checks, box/tx lookup, receipt verification, and live probes.
Builder kit
Cloneable receipt verifier, provider templates, bootstrap jobs, ErgoConnect helpers, interop map, and CLI.
Review pack
External review scope, evidence, checklist, and forbidden claims.
Golden path
One receipt path before the full API surface.
The first developer journey should be boring and concrete: check live state, open one receipt, inspect its JSON, run policy, build the same flow, then read the mainnet gate.
Check live state
Confirm the stack is live on testnet and mainnet readiness is still closed.
Open latest receipt
See the human-readable proof object before reading any implementation detail.
Inspect receipt JSON
Read the machine contract: Agreement JSON, Verification Receipt JSON, Settlement Receipt JSON, and chain proof.
Run policy check
Change a proposed wallet-agent action and watch local policy block unsafe requests before signing.
Inspect wallet boundary
Confirm which pieces prove address control, check policy, hand off reduced transactions, and retain receipts.
Build same flow
Use the Sage widget package to request a quote, create a payment intent, verify a Note, and fetch a receipt.
Read mainnet gate
Confirm what is not claimed before taking the pattern toward real funds or production custody.
Builder kernel
Clone the proof surface into a local developer kit.
The BuildOnErgo kit gives builders a small command-line path before they touch the full site: verify one receipt, generate provider onboarding packets, create bootstrap jobs, model wallet handoff, and keep interop boundaries explicit.
git clone https://github.com/buildonergo/agent-economy-kit.git
Run the kernel locally
npm run checknpm run cli -- self-checknpm run cli -- provider:manifestnpm run cli -- provider:onboardingnpm run provider:onboardingnpm run cli -- job:bootstrap schema_validationnpm run cli -- job:accept receipt_verificationnpm run cli -- job:quote receipt_verificationnpm run cli -- ergo-connect:react-adapternpm run cli -- ergo-connect:react-packagenpm run cli -- ergo-connect:handoffnpm run cli -- interop:x402-ap2receipt verifier and fixture checks
provider and verifier manifest templates
provider onboarding packet from manifest to review draft, job intent, quote, receipt, and wallet boundary
testnet-only bootstrap job templates plus local job acceptance and quote packets
ErgoConnect policy and ErgoPay handoff helpers
future ErgoConnect React adapter contract and private package skeleton without npm or vendor-support claims
x402/AP2/Ergo boundary mapping
runtime MCP tool-list check
API recipes
Machine-readable surfaces to wire first.
These are deliberately boring endpoints: stable JSON, explicit status, and no signing authority.
curl -sS https://www.ergoblockchain.org/api/agent-economy/first-receipt
curl -sS https://www.ergoblockchain.org/api/agent-economy/discovery
curl -sS https://www.ergoblockchain.org/.well-known/accord
curl -sS https://www.ergoblockchain.org/agent-economy/openapi.v0.json
curl -sS https://www.ergoblockchain.org/.well-known/ergo-connect.json
curl -sS https://www.ergoblockchain.org/api/agents/mcp-tools
curl -sS -X POST https://www.ergoblockchain.org/api/agents/publish -H 'content-type: application/json' --data @service-manifest.json
curl -sS https://www.ergoblockchain.org/api/agents/onboarding
curl -sS https://www.ergoblockchain.org/api/agents/reputation
curl -sS -X POST https://www.ergoblockchain.org/api/jobs/accept -H 'content-type: application/json' --data @job-acceptance-intent.json
curl -sS -X POST https://www.ergoblockchain.org/api/jobs/quote -H 'content-type: application/json' --data @job-quote-request.json
curl -sS https://www.ergoblockchain.org/api/agent-economy/roadmap
curl -sS https://www.ergoblockchain.org/api/dev/services
curl -sS https://www.ergoblockchain.org/api/dev/tools
curl -sS https://www.ergoblockchain.org/api/agent-economy/live
curl -sS https://www.ergoblockchain.org/api/agent-economy/proofs
curl -sS https://www.ergoblockchain.org/agent-economy/proof-explorer.schema.v0.json
curl -sS https://www.ergoblockchain.org/api/agent-economy/wallet-agent/policy-check
curl -sS https://www.ergoblockchain.org/api/agent-economy/wallet-agent/reference-flow
curl -sS https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81
curl -sS https://www.ergoblockchain.org/agent-economy/release-watchlist.v0.json
curl -sS https://www.ergoblockchain.org/api/agent-economy/release/current
Widget
Embed Sage without handing over wallet authority.
The package is a host-owned wallet handoff surface: the widget can produce payment intent JSON, but the host decides how to authorize, simulate, sign, and persist receipts.
npm install @ergoblockchain/sage-widget
SagePaymentWidget React component
mountSagePaymentWidget vanilla function
typed quote, verify, chat stream, receipt, and activity clients
payment intent JSON for host-owned wallet flows
source-prepared v0.5 wallet-policy handoff helpers before the next npm tag
receipt callbacks and tenant metadata
Guardrails
The claims boundary is part of the product.
The system is strongest when every developer can see what is live and what is still blocked.
Treat all public payment flows as testnet live proof until the mainnet gate opens.
Do not expose seed phrases or private keys to pages, widgets, prompts, or remote agents.
Run policy-check and exact transaction simulation before asking a wallet to sign.
Treat remote quotes as untrusted input until local policy validates recipient, reserve, amount, fee, expiry, task hash, and receipt expectations.
Persist or link the receipt bundle after every paid action.
Do not claim production, audited, certified, or mainnet-ready status before external review and audit-bound script identity exist.
Mainnet gate
Two external artifacts still decide the next level.
Everything in this launch kit is testnet live proof. Mainnet language opens only after external review and audit-bound script identity are published as completed artifacts.