Skip to content

IIP-58: add three-phase agent economic model#67

Open
raullenchai wants to merge 19 commits intomasterfrom
iip-58-ioswarm-ai-delegate
Open

IIP-58: add three-phase agent economic model#67
raullenchai wants to merge 19 commits intomasterfrom
iip-58-ioswarm-ai-delegate

Conversation

@raullenchai
Copy link
Copy Markdown
Member

Summary

Adds a Future Work section to IIP-58 describing the three-phase economic model for ioSwarm agents:

  • Phase 1 (Subsidy): Delegate-funded shadow validation — current state, not self-sustaining at scale
  • Phase 2 (MEV + Block Building): Agents become block builders (Ethereum PBS / Solana BAM model), capturing priority fees and MEV
  • Phase 3 (Service Marketplace): Agents as autonomous service providers — chain as settlement + identity + reputation layer for agent-to-agent economy

Key arguments

  • Crypto is the only payment rail autonomous agents can use (can't open bank accounts, can't KYC)
  • IoTeX differentiator: physical-world data services via DePIN/ioID (unavailable to purely digital agent networks)
  • Agent-to-agent commerce creates an autonomous economy that scales beyond human bandwidth
  • Phase 3 service marketplace protocol to be proposed in a separate IIP

Also includes (from previous commit)

  • Updated L4 production metrics (multi-day ~99% accuracy, 8 agents, coordinator memory fix)
  • Documented 3 production bugs fixed in v14 (PR #4808)
  • Added snapshotexporter pipeline documentation
  • Fixed reward contract address in PR body

References added

  • Keep3r Network (Andre Cronje) — decentralized job marketplace precedent
  • Solana BAM, APE, Alpenglow — consensus-execution separation
  • Ethereum stateless validation

🤖 Generated with Claude Code

Raullen and others added 19 commits March 11, 2026 14:51
Restructured around three pillars:
- Endgoal: massively decentralized, AI-agent driven chain
- Five capability levels (L1 signature → L4 stateful EVM → L5 block building)
- Three components (coordinator, agent, on-chain contract) with per-level responsibilities

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace vague "AI agents" framing with concrete autonomous economic
behavior — agents optimizing across 36 delegates × 5 levels × variable
gas costs. Add specification for delegate selection, level selection,
claim timing, and market dynamics (9.4x earning differential).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Delegate → Thin Proposer: progressive thinning table (Now→Future)
- Agent Swarm → Block Builders: L1-L5 capability evolution
- AgentRewardPool → RewardSettlement: replaces Hermes, universal
  reward layer for all protocol reward flows (protocol→delegate,
  delegate→voter, delegate→agent)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Reorganize Specification to mirror the Three Components architecture:

1. Component 1: Delegate + Coordinator
   - Coordinator-Agent Protocol (moved)
   - State Provisioning (NEW — snapshot export, state diff streaming,
     namespace details, diff reliability/recovery)
   - deltaStateDigest advantage (moved)
   - Configuration Parameters (moved)

2. Component 2: Agent Swarm — Five Capability Levels
   - L1-L5 level definitions (clarified as Agent capability levels)
   - Autonomous Agent Economics (moved under Agent Swarm)

3. Component 3: RewardSettlement (On-Chain)
   - Reward Flow, Contract Interface, F1 Algorithm (moved)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Reorganize the entire document following academic paper convention:
Problem → Terminology → Architecture → Framework → Components → Rationale

Key changes:
- Add Terminology section defining all key terms (Delegate, Coordinator,
  Agent, Capability Level, Epoch, deltaStateDigest, State Diff, etc.)
- Move Capability Levels (L1-L5) definition BEFORE component details,
  so terms are defined before they're referenced
- Consolidate Motivation into single "The Problem" section
- Separate Evolution Roadmap from current Specification
- Add Agent Lifecycle subsection under Agent Swarm
- Clean up forward references throughout

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Position ioSwarm as execution layer separation (analogous to Ethereum's
ePBS) at the top of Motivation, before The Problem. Includes comparison
table showing how ioSwarm differs from Ethereum's builder market:
decentralized agents vs centralized builders, low vs high barrier.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Consensus-Execution Separation

Clarify that ioSwarm is NOT just PBS — it separates consensus from
execution at a more fundamental level. PBS (proposer/builder) is a
special case that emerges at L5. Add comparison table showing the
progression: Ethereum Merge → ePBS → ioSwarm. Update title to
'Decentralized Execution Layer via AI Agent Swarm'.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ation

Reference the key Ethereum EIPs that achieved consensus-execution
separation at the process level (EIP-3675, Engine API, EIP-4399),
providing historical context for ioSwarm's network-level separation.

Reorganize References section into three categories:
- Consensus-Execution Separation (Merge)
- Proposer-Builder Separation (ePBS)
- Reward Distribution (F1)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Fix L4 summary table: "L2 + execute tx" → "Full EVM execution against
  local state" (L4 subsumes L3, not just L2)
- Fix deltaStateDigest anchor link to lowercase (GitHub auto-lowercases)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Two new sections responding to reviewer feedback:

1. MEV and the Case for Decentralized Block Building (Evolution Roadmap)
   - Acknowledge Ethereum's builder centralization honestly
   - Phase 1: delegate-controlled ordering eliminates MEV
   - Phase 2: argue distributed exploration > centralized optimization
     for complex/adversarial MEV regimes
   - Reward structure (70/20/10) prevents winner-take-all

2. Enhanced Why Autonomous Agent Economics (Rationale)
   - Acknowledge L1-L3 optimization is basic arithmetic
   - Show intelligence complexity growing with levels (table)
   - L5+MEV is genuinely hard: multi-agent adversarial optimization
   - Position: protocol measures intelligence by economic performance,
     market drives sophistication over time

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add two new Security Considerations sections responding to reviewer
feedback: API key auth for Sybil resistance, and shadow mode as a
paid proving ground (not wasted computation).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Unify framing: "permissionless at protocol level, curated at
coordinator level." Replace blanket "permissionless" claims with
"open market" language, and rewrite Sybil Resistance section to
use free market / freedom of association framing instead of
contradicting the protocol's openness.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1. Title: "AI Agent Swarm" → "Autonomous Agent Swarm" — more
   engineering-grounded, matches the economics-driven framing.

2. State Provisioning: add snapshot offload strategy. Full snapshots
   (~1 GB) must be served via CDN/IPFS/S3, not by coordinator
   directly, to prevent bandwidth storms when many L4 agents
   simultaneously request re-snapshot after network disruption.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1. DownloadSnapshot RPC: clarify it returns a URL to externally
   hosted snapshot (CDN/IPFS/S3), not the data itself — consistent
   with the snapshot offload strategy in State Provisioning.

2. "Why Autonomous Agent Economics" section: replace orphaned "The AI
   in ioSwarm" opening with "autonomous" framing, since title was
   renamed from "AI Agent" to "Autonomous Agent."

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- L3: fix accuracy from ~14% to 100% (SimulateAccessList)
- Contract: add v2 interface (depositSettleAndClaim, claimFor)
- Contract address: update to v2 (0x236CBF...)
- Roadmap: mark Stage 0+1 as COMPLETE
- Test results: add L3/L4 production metrics, stress tests 10/10
- KV store: Pebble → BoltDB (matches implementation)
- Deployment: add L4 example alongside L3

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace "$5/mo VPS" marketing language with concrete hardware
requirements (1 vCPU, 1–4 GB RAM) or neutral terms (commodity
hardware). Technical spec should not contain price claims.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- L4 test results: reflect multi-day production data (~99% accuracy, 8 agents)
- Add coordinator memory metric (11.65 GiB → 2.1 GiB after DiffStore fix)
- Document 3 production bugs fixed in v14 (PR #4808): genesis context panic,
  DiffStore unbounded growth, OOM during block sync
- Document snapshotexporter tool with --namespaces flag and BoltDB locking caveat
- Add docker image references (ioswarm-v14)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Phase 1 (Subsidy): delegate-funded shadow validation — current state
Phase 2 (MEV + Block Building): agents as block builders, capturing
  priority fees and MEV — requires DeFi ecosystem growth
Phase 3 (Service Marketplace): autonomous agents as general-purpose
  workers settling on IoTeX — chain as settlement + identity + reputation
  layer for agent-to-agent economy

Key arguments:
- Crypto is the only payment rail autonomous agents can use
- IoTeX differentiator: physical-world data services via DePIN/ioID
- Agent-to-agent commerce creates an autonomous economy at machine speed
- References: Keep3r Network, Solana BAM/APE/Alpenglow, Ethereum stateless

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Phase 2 now covers three on-chain revenue streams:
- 2a: Block building (ePBS) — priority fees + MEV
- 2b: DeFi automation (keeper work) — vault harvest, liquidations,
  oracle updates, rebalancing (Keep3r model)
- 2c: Cross-chain services — ZK bridge proofs, light client proofs

Phase 3 reframed as "Off-Chain Service Marketplace" to clarify the
on-chain vs off-chain distinction between phases.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant