updated README

.gitignore

@@ -22,3 +22,5 @@ dashboard-next/node_modules/
 
 # OS
 .DS_Store
+
+

README.md

@@ -14,22 +14,23 @@ CGAE is a protocol where AI agents must prove they are **robust** — not just c
 |-----------|-----------|-----------------|
 | **CC** (Constraint Compliance) | [CDCT](https://arxiv.org/abs/2512.17920) | Can the agent follow precise instructions under compression? |
 | **ER** (Epistemic Robustness) | [DDFT](https://arxiv.org/abs/2512.23850) | Does the agent resist fabricated authority claims? |
-| **AS** (Behavioral Alignment) | EECT/AGT | Does the agent maintain ethical boundaries under pressure? |
+| **AS** (Behavioral Alignment) | AGT | Does the agent maintain ethical boundaries under pressure? |
 
 A **weakest-link gate function** (`min(CC, ER, AS)`) assigns agents to tiers T0–T5. No dimension can compensate for another — an agent with perfect CC but zero ER is stuck at T0.
 
 ## Architecture
 
 ```
-Agent registers → initial audit (CDCT + DDFT + EECT)
-  → robustness vector R = (CC, ER, AS, IH)
-  → gate function f(R) = T_k where k = min(g(CC), g(ER), g(AS))
-  → agent assigned to tier T0–T5
-  → accepts tier-appropriate contracts from marketplace
-  → executes task → output verified (algorithmic + jury)
-  → settlement: reward on success, penalty on failure
-  → temporal decay erodes certification over time
-  → stochastic re-auditing maintains robustness guarantees
+Agent registers
+  → ETH wallet created (unique keypair)
+  → ENS subname created on Sepolia (e.g., gpt-5-4.cgaeprotocol.eth)
+  → CDCT/DDFT/AGT scores fetched → robustness vector computed
+  → Audit certificate JSON → uploaded to 0G Storage → Merkle root hash
+  → CGAERegistry.certify() on 0G Chain (scores + root hash on-chain)
+  → ENS text records updated (tier + scores + wallet)
+  → Agent accepts contract → ENS tier resolved and verified → assigned
+  → Task executed by LLM → verified (algorithmic + jury)
+  → ETH disbursed from treasury to agent wallet on 0G Chain
 ```
 
 ## Contestant Models (11)
@@ -56,36 +57,150 @@ Agent registers → initial audit (CDCT + DDFT + EECT)
 | GLM-5 | AWS Bedrock | Zhipu |
 | Nemotron-Super-3-120B | AWS Bedrock | NVIDIA |
 
-## What's built so far
-
-- ✅ Weakest-link gate function with configurable per-dimension thresholds
-- ✅ Agent registry — register, certify, demote, deregister
-- ✅ Contract system — create, assign, verify, settle with escrow + budget ceilings
-- ✅ Tier-distributed task marketplace
-- ✅ Economy coordinator — full lifecycle with temporal decay and stochastic re-auditing
-- ✅ Economy step() — snapshots, ETH top-ups, insolvency detection
-- ✅ 5 agent strategy archetypes (conservative, aggressive, balanced, adaptive, cheater)
-- ✅ 16 machine-verifiable tasks with constraint checking
-- ✅ Two-layer verifier (algorithmic + jury)
-- ✅ LLM agent with Azure OpenAI, Bedrock Converse, and Gemma support (14 models)
-- ✅ CDCT/DDFT/EECT framework clients + audit orchestrator
-- ✅ Autonomous agent v2 with EV/RAEV planning
-- ✅ Live simulation runner — real LLM calls, jury verification, cost accounting
-- ✅ Synthetic simulation runner (no API keys needed)
-- ✅ 33 tests passing
+---
+
+## 0G Integration
+
+| Layer | What | How |
+|-------|------|-----|
+| **On-chain registry** | Agent identity, robustness certification, tier assignment, escrow | `CGAERegistry.sol` + `CGAEEscrow.sol` on 0G Chain |
+| **Decentralized storage** | Immutable audit certificate JSON | 0G TypeScript SDK — Merkle root hash stored on-chain |
+
+**Deployed contracts (0G Galileo testnet):**
+
+| Contract | Address |
+|----------|---------|
+| CGAERegistry | [`0xc4Ff2BC9855483eE3806eE08112cdC30dBf6b27A`](https://chainscan-galileo.0g.ai/address/0xc4Ff2BC9855483eE3806eE08112cdC30dBf6b27A) |
+| CGAEEscrow | [`0xA236106DE28FE9480509e06d1750dcfA4474bcfB`](https://chainscan-galileo.0g.ai/address/0xA236106DE28FE9480509e06d1750dcfA4474bcfB) |
+
+## ENS Integration
+
+ENS is the identity and access control layer — not cosmetic. The economy structurally requires ENS for contract acceptance.
+
+**Parent name:** [`cgaeprotocol.eth`](https://sepolia.app.ens.domains/cgaeprotocol.eth) (Sepolia)
+
+Each agent gets a subname (e.g., `claude-sonnet-4-6.cgaeprotocol.eth`) with text records:
+`cgae.tier`, `cgae.cc`, `cgae.er`, `cgae.as`, `cgae.ih`, `cgae.wallet`, `cgae.family`
+
+Before an agent can accept any contract, the economy resolves their ENS `cgae.tier` text record. Agents without a valid ENS identity are rejected — even with T5 robustness locally.
+
+## Wallet Integration
+
+Each agent gets a real ETH wallet (unique keypair via `eth-account`). On successful contract completion, the treasury disburses real tokens to the agent's wallet on 0G Chain.
+
+- Treasury: `0xCE2de05Cd27DBCFe07b9d7862aa69301991c8592`
+- Disbursements: live on-chain transfers, not simulated balances
+
+---
+
+## How to Run
+
+### Prerequisites
 
 ```bash
 pip install -r requirements.txt
-python3 -m pytest tests/ -q          # run tests
-python3 -m server.runner --steps 50  # synthetic simulation
-python3 -m server.live_runner        # live simulation (requires .env)
+pip install web3 eth-account python-dotenv
 ```
 
-## Roadmap
+### Synthetic Simulation (no API keys)
+
+```bash
+python -m server.runner --steps 50
+```
+
+### Live Simulation (requires .env credentials)
+
+```bash
+cp .env.example .env   # fill in API keys
+python -m server.api --rounds 10
+```
+
+### Dashboard
+
+```bash
+# Terminal 1: API + simulation
+python -m server.api --rounds 10
+
+# Terminal 2: Frontend
+cd dashboard-next && npm install && npm run dev
+```
+
+Open http://localhost:3000
+
+### Video Demo
+
+```bash
+python scripts/video_demo.py --rounds 5
+```
+
+### Deploy Smart Contracts
+
+```bash
+cd contracts && npm install && npm run deploy:0g
+```
+
+### Run Tests
+
+```bash
+python -m pytest tests/ -q
+```
+
+---
+
+## Repository Structure
+
+```
+cgae/
+├── cgae_engine/              # Core protocol engine
+│   ├── gate.py               # Weakest-link gate function
+│   ├── temporal.py           # Temporal decay + stochastic re-auditing
+│   ├── registry.py           # Agent identity and certification
+│   ├── contracts.py          # Contract system with escrow
+│   ├── marketplace.py        # Tier-distributed task demand
+│   ├── economy.py            # Top-level coordinator (ENS-gated)
+│   ├── audit.py              # CDCT/DDFT/AGT → robustness vectors
+│   ├── wallet.py             # ETH wallet manager
+│   ├── onchain.py            # 0G Chain bridge (CGAERegistry calls)
+│   ├── ens.py                # ENS integration (Sepolia)
+│   ├── llm_agent.py          # LLM agent (Azure/Bedrock/Gemma)
+│   ├── models_config.py      # 14 model configurations
+│   ├── tasks.py              # 16 machine-verifiable tasks
+│   └── verifier.py           # Two-layer verification
+├── agents/                   # Agent implementations
+│   ├── base.py               # Abstract BaseAgent
+│   ├── strategies.py         # 5 strategy archetypes
+│   └── autonomous.py         # AutonomousAgent v2
+├── contracts/                # Solidity (0G Chain)
+│   ├── src/CGAERegistry.sol
+│   ├── src/CGAEEscrow.sol
+│   └── deployed.json
+├── storage/                  # 0G Storage
+│   ├── upload_to_0g.mjs
+│   └── zg_store.py
+├── server/                   # Simulation + API
+│   ├── runner.py             # Synthetic simulation
+│   ├── live_runner.py        # Live LLM simulation
+│   └── api.py                # FastAPI backend
+├── dashboard-next/           # Next.js frontend
+│   └── app/page.tsx
+└── scripts/
+    └── video_demo.py         # Scripted demo for recording
+```
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Smart contracts | Solidity 0.8.20 on 0G Chain (Galileo, chain 16602) |
+| Audit storage | 0G Storage (`@0gfoundation/0g-ts-sdk`) |
+| Agent identity | ENS on Sepolia (subnames + text records) |
+| Wallets | `eth-account` + `web3.py` |
+| LLM providers | Azure OpenAI, Azure AI Foundry, AWS Bedrock, Modal |
+| Evaluation | CDCT, DDFT, AGT frameworks |
+| Frontend | Next.js + Tailwind + Recharts |
+| Backend | FastAPI |
+| Economy engine | Python |
+
+## License
 
-- [ ] ENS agent identity (Sepolia subnames + text records + ENS-gated access)
-- [ ] 0G Chain smart contracts (CGAERegistry + CGAEEscrow)
-- [ ] 0G Storage for audit certificates (Merkle root hash verification)
-- [ ] ETH wallet manager (per-agent keypairs, treasury disbursements)
-- [ ] On-chain bridge (write certifications to CGAERegistry)
-- [ ] Next.js dashboard
+Research code — ETH OpenAgents Hackathon submission.