A comprehensive framework for building a 65-75% automated governance, ecological claims, crediting, contracting utility layer, and tokenomics system for Regen Network, integrating AI agents with on-chain infrastructure.
This repository contains the design specifications and implementation plans for an agentic tokenomics system that:
- Automates routine governance and registry operations
- Augments human decision-making with AI-powered analysis
- Ensures transparency through KOI knowledge infrastructure
- Maintains human oversight for critical decisions
┌─────────────────────────────────────────────────────────────────┐
│ PRESENTATION LAYER │
│ Discord │ Twitter │ Telegram │ Web UI │ CLI │
├─────────────────────────────────────────────────────────────────┤
│ ELIZAOS RUNTIME │
│ Registry Reviewer │ Governance Analyst │ Market │ Validator │
├─────────────────────────────────────────────────────────────────┤
│ MCP INTEGRATION LAYER │
│ KOI MCP │ Ledger MCP │ TX Builder MCP │
├─────────────────────────────────────────────────────────────────┤
│ DATA LAYER │
│ PostgreSQL (Agent State) │ Jena (Knowledge) │ Regen Ledger │
└─────────────────────────────────────────────────────────────────┘
| Layer | Delegation | Automation | Examples |
|---|---|---|---|
| Layer 1 | Fully Automated | 100% | Price monitoring, data validation |
| Layer 2 | Agentic + Oversight | 85%+ | Credit class screening, routine proposals |
| Layer 3 | Human-in-Loop | 50% | Large grants, contested decisions |
| Layer 4 | Constitutional | 0% | Protocol upgrades, governance changes |
- Stakeholder & value flow mapping
- Tokenomic mechanisms inventory
- Agentic service identification
- Governance layer architecture
- System architecture synthesis
- Token utility mechanism specifications (5 protocols)
- Agentic workflow design (12 workflows)
- Governance process formalization (5 processes)
- Agent orchestration architecture (4 agents)
- Data schema & integration specification
- Economic Reboot mechanism specifications (4 protocols)
- M012-M015 smart contract specs (3.1)
- Agent workflows & PoA conditional logic (3.2)
- Testing & security framework (3.3, 3.4)
- M013 CosmWasm architecture (contract spec, integration tests)
- Agent orchestration runtime (3.6)
- KOI knowledge graph integration (3.7)
- ElizaOS reference implementation (3.8)
- Testnet deployment plan (4.1)
- Mainnet migration & PoS→PoA runbook (4.2)
- Community onboarding guide (4.3)
- m001-enh — Credit Class Approval Voting Enhancement (v0 advisory)
- m008 — Data Attestation Bonding (v0 advisory)
- m009 — Service Provision Escrow
- m010 — Reputation Signal (v0 advisory)
- m011 — Marketplace Curation & Quality Signals
- m012 — Fixed Cap Dynamic Supply
- m013 — Value-Based Fee Routing (v0)
- m014 — Authority Validator Governance (PoA Transition)
- m015 — Contribution-Weighted Rewards
- M001-ENH: Credit Class Approval Voting Enhancement
- M008: Data Attestation Bonding
- M009: Service Provision Escrow
- M010: Reputation/Legitimacy Signaling
- M011: Marketplace Curation & Quality Signals
- M012: Fixed Cap Dynamic Supply
- M013: Value-Based Fee Routing
- M014: Authority Validator Governance (PoA Transition)
- M015: Contribution-Weighted Rewards
- AGENT-001: Registry Reviewer
- AGENT-002: Governance Analyst
- AGENT-003: Market Monitor
- AGENT-004: Validator Monitor
- Agent Runtime: ElizaOS
- Knowledge Graph: Apache Jena + KOI Framework
- Blockchain: Regen Ledger (Cosmos SDK)
- Smart Contracts: CosmWasm + DAO DAO
- Database: PostgreSQL (pgvector)
- Cache/Queue: Redis Streams
- Embeddings: BGE (1024-dim)
Based on Regen Network mainnet (as of analysis):
- 13 credit classes
- 58+ registered projects
- 78+ credit batches
- 61+ governance proposals (historical)
- ~3.2M REGEN in community pool
- ~224M REGEN total supply
agentic-tokenomics/
├── mechanisms/ — 9 mechanism specs (M001-ENH, M008-M015)
│ └── m0XX-*/SPEC.md — Each has SPEC, datasets, schemas, reference-impl
├── phase-1/ — Discovery & analysis (complete)
├── phase-2/ — Mechanism design & specification (complete)
├── phase-3/ — Implementation specs, contract architecture, testing
├── phase-4/ — Deployment plans, migration runbooks, onboarding
├── phase-5/ — Operations, monitoring, evolution governance
├── agents/ — ElizaOS agent scaffold (monorepo, Docker, tests)
├── agent-002-governance-analyst/ — Standalone AGENT-002 reference implementation
├── docs/
│ ├── architecture/ — Stack map, dependencies
│ ├── economics/ — Token economics synthesis, simulation spec
│ ├── governance/ — Validator selection, OQ resolution, proposals
│ ├── integration/ — Claims engine, CosmWasm work packages
│ └── learning/ — Continuous learning, contributor paths
├── schemas/ — Shared JSON schemas
└── scripts/ — Verification and index tooling
See docs/ECOSYSTEM.md for a directory of projects building on this framework.
See docs/CONTRIBUTOR_NAV.md for where changes should land and how to keep PRs small and reviewable.
This project is developed in collaboration with Regen Network community. Contributions, feedback, and discussion are welcome.
[To be determined - suggest Apache 2.0 or MIT for code, CC-BY-SA for documentation]
Generated with assistance from Claude Code, grounded in Regen Network's KOI and Ledger MCP infrastructure.