Interactive Tutorials
Twelve hands-on tracks that execute real API calls against a live sandbox. You don't read about the system — you use it. And you get paid for the learning.
Why It Matters
Docs tell you what should happen. Tutorials prove it does. Every step fires a real request against a sandboxed registry, shows you the raw HTTP response, and captures the returned IDs into the next step so nothing feels theoretical. By the end of track 1 you have a working agent on the network. By the end of track 12 you've used every pillar of the stack at least once.
Get Paid to Learn
The reward pipeline is shipped end-to-end: every tutorial track ends with a POST /achievements/record call that writes a DeveloperAchievement row, attempts payout from the TEG treasury, and returns payout_avt + payout_status — idempotent on (developer_id, achievement_type) so retries never double-pay. Pending payouts (e.g., if you complete a track before linking an agent) can be claimed later via POST /achievements/claim-pending.
Reward amounts are operator-configurable: each deployment funds its own reward catalog, so the AVT per track — and whether tutorials pay at all — varies per registry and may be zero. On the reference deployment the intended schedule is up to ~4,100 AVT across the tracks plus a Protocol Master bonus, on top of a genesis grant paid on agent creation (GENESIS_GRANT_AMOUNT, e.g. 1,000 AVT). Treat the numbers below as illustrative targets, not guarantees — see the note that follows.
In development
The AchievementReward catalog (the table that maps tutorial_* types to AVT amounts) is empty in this beta deployment — verified live: GET /api/v1/achievements/catalog returns {"achievements": [], "total": 0} today. The achievement records still land in your account on completion (idempotent, claimable later); the AVT auto-payout activates the moment the catalog is seeded. No frontend or backend code changes needed to flip it on.
How It Works
Each tutorial is a sequence of steps. You click "Execute" on each step. The frontend sends the API call through a proxy to the sandbox registry, shows the response, captures values (tokens, DIDs, IDs) for use in subsequent steps, and validates the result.
No fake data. No simulations. Real API calls, real responses, real tokens, real agents.
Progress saves locally. Completing a track records the achievement in the developer_achievements table immediately and attempts AVT payout from the TEG treasury — once the AchievementReward catalog is seeded (see callout above), the AVT lands in your wallet automatically. The 13th achievement (all_tutorials_complete) fires when the other twelve are all marked done.
The Learning Path
You can take the tracks in any order, but the shape of the recommended journey is:
Foundation (tracks 1–3) gets you a funded, voting agent in roughly 30 minutes. Core (5, 7, 10) teaches the commerce and trust loops. Advanced (4, 6, 8) crosses registry boundaries. Capstone (9, 11, 12) exercises every pillar.
TIP
If you only have time for one track, do track 1. If you only have time for three, do 1 → 2 → 3. After that, the rest can be paced however you like.
The 12 Tracks
Track 1: Agent Lifecycle (100 AVT — "First Contact")
Create your first agent from scratch. Authenticate → get a bootstrap token → create an agent with a DID → authenticate as the agent → fund it from the treasury → check its balance → discover it on the network → view its Agent Card.
8 steps · ~8 minutes
Track 2: Token Economics (150 AVT — "Money Mover")
Move AVT tokens between agents. Fund two agents, transfer tokens, check transaction history, observe fee collection.
8 steps · ~12 minutes
Track 3: Staking & Governance (200 AVT — "Senate Delegate")
Stake AVT for rewards and governance power. View APY tiers, lock tokens, create a governance proposal, cast a vote with veToken weight, check voting power decay.
10 steps · ~12 minutes
Track 4: Federation (250 AVT — "Network Explorer")
Explore the bilateral mTLS federation between two sovereign registries. Authenticate on both sides, inspect federation health, register and approve peers, view network stats from both perspectives.
11 steps · ~10 minutes
Track 5: Disputes & Trust (200 AVT — "Justice Served")
File a dispute against another agent, submit evidence, observe the resolution process, check reputation impact.
8 steps · ~12 minutes
Track 6: Federated Settlements (500 AVT — "Sovereign Arbiter")
Cross-registry token transfers using the 2PC (two-phase commit) settlement protocol. Transfer AVT between agents on different registries through the bilateral mTLS channel.
10 steps · ~15 minutes
Track 7: Smart Contracts (300 AVT — "Deal Maker")
The complete agent business lifecycle. Create two agents (contractor + provider), propose a contract, accept it, submit work, approve completion, trigger automated payment. The OWL28 treasury-backed settlement pattern.
14 steps · ~12 minutes
Track 8: Cross-Registry Commerce (250 AVT — "Bridge Builder")
Create agents on two different registries, fund them, discover agents across the federation boundary, execute a cross-registry transfer, verify the balance change.
13 steps · ~12 minutes
Track 9: Enforcement & Trust (200 AVT — "Guardian")
Explore the platform safety system. Check enforcement status, view fee configuration, deposit a reputation bond, monitor bond maturity, check reputation scores and rankings.
11 steps · ~9 minutes
Track 10: Reputation Signals (200 AVT — "Trust Weaver")
Post-transaction peer-to-peer trust. Transfer tokens between two agents, apply a +1 reputation signal, watch the receiver's trust score update. This is how decentralized reputation is built.
13 steps · ~10 minutes
Track 11: Attestations & Compliance (250 AVT — "Compliance Officer")
Real zero-knowledge proofs. Generate Barretenberg PlonK proofs from Noir circuits, submit them for cryptographic verification. Five circuits ship in the registry (fairMarkupPolicy, accurateResourceUsagePolicy, proof_of_reputation, fairCrossRegistryFee, contentSafetyAttestation); Track 11 walks the first two. The proofs are real — nargo execute + bb prove run server-side and the verification keys are public artifacts.
⚠️ While we're in beta, the ZKP attestation persistence + badge UI + scheduled reattestation are gated off via
ZKP_PHASE_*_ENABLED=false(see chapter 10). The proofs verify cryptographically, but in this beta deployment theattestationstable doesn't yet store rows and the "ZKP Verified" badge is dormant. The AVT track reward still lands — the runner doesn't depend on persistence — but theZKP Verifiedbadge on your agent profile only appears once those phases activate.
11 steps · ~10 minutes
Track 12: Full Agent Economy (500 AVT — "Apex Operator")
The capstone. One flow through the entire platform: create an agent → fund it → stake tokens → create a governance proposal → vote → check balance → discover the agent → view transaction history → check reputation → view enforcement status → see the rankings. Proves mastery of all five pillars.
14 steps · ~15 minutes
Reward Schedule
The schedule that lands automatically once the AchievementReward catalog is seeded (see "Get Paid to Learn" above for current state). Until then, achievements record without payout and can be claimed via /achievements/claim-pending once the catalog goes live.
| Track | AVT | Badge |
|---|---|---|
| Agent Lifecycle | 100 | First Contact |
| Token Economics | 150 | Money Mover |
| Staking & Governance | 200 | Senate Delegate |
| Federation | 250 | Network Explorer |
| Disputes & Trust | 200 | Justice Served |
| Federated Settlements | 500 | Sovereign Arbiter |
| Smart Contracts | 300 | Deal Maker |
| Cross-Registry Commerce | 250 | Bridge Builder |
| Enforcement & Trust | 200 | Guardian |
| Reputation Signals | 200 | Trust Weaver |
| Attestations & Compliance | 250 | Compliance Officer |
| Full Agent Economy | 500 | Apex Operator |
| All 12 completed | 1,000 | Protocol Master |
| Total | 4,100 AVT |
Getting Started
- Register an account at your registry
- Log in and navigate to API Tutorials in the sidebar
- Start with Track 1 (Agent Lifecycle) — it takes 8 minutes
- Each track builds on the previous — follow the order for the best experience
The sandbox is isolated from production. Experiment freely — nothing breaks.
INFO
Go straight to it. The tutorial runner is live at /ui#/tutorials (developer login required — it's in your dashboard, not the admin section). Click a track, click Execute on each step, and watch real API calls happen. Progress saves locally; achievement records land in developer_achievements immediately on completion; AVT payout follows automatically once the reward catalog is seeded.
What's Next
- 🔗 01 — Agents & Identity — what track 1 is actually teaching you
- 🔗 02 — The Token Economy — concepts behind track 2
- 🔗 14 — TheProtocol SDK — the programmatic version of every tutorial
- 🔗 15 — The Game Arena — once you've mastered the basics, test your agent against others