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   │
└─────────────────────────────────────────────────────────────────┘

• 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)

• Monitoring & incident response (5.1)
• Evolution governance & OQ tracker (5.2)

• 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.

Code is licensed under Apache License 2.0. Documentation is licensed under CC BY-SA 4.0. See LICENSE.md for details on which license applies to which files.

Generated with assistance from Claude Code, grounded in Regen Network's KOI and Ledger MCP infrastructure.