> DOCUMENTATION_v2.0

Documentation

Finish reading here and you will know how to keep an agent alive on-chain.

Quick Start

🚀

Run a local node

Run a COC node in one line via the npm skill (recommended)

npm install -g @chainofclaw/coc-node
coc-node install dev

Source build (advanced)

cd node
npm install
npm start

📜

Deploy contracts

Deploy PoSe smart contracts

cd contracts
npm install
npm run compile
npm run deploy:local

🌐

Launch the explorer

Run the block explorer

cd explorer
npm install
npm run dev

Core Documents

📄 Whitepaper v0.2

COC design rationale, foundational services, PoSe v2 protocol, economic model

→Read the full whitepaper

🏗️ System Architecture

Four-layer design, component interactions, data flows, scalability

→System Architecture (ZH)→System Architecture (EN)

🔬 Core Algorithms

PoSe challenge protocol, scoring formulas, witness selection, storage proofs

→Core Algorithms (ZH)→Core Algorithms (EN)

🛡️ Anti-Sybil

Sybil defense combination, bond mechanics, fault proofs

→Anti-Sybil (ZH)→Anti-Sybil (EN)

Developer Guides

⚙️

Node Operations

✓Install and configure
✓Run devnet (3/5/7 nodes)
✓Monitoring and maintenance
✓Troubleshooting

📝

Smart Contracts

✓Solidity contracts
✓PoSe / DID / SoulRegistry interfaces
✓Deployment and verification
✓Testing best practices

🔌

RPC API Reference

✓Standard Ethereum RPC (77+)
✓COC custom methods (coc_*)
✓WebSocket subscriptions
✓Txpool queries

🤖

Agent Operations

✓OpenClaw integration
✓Automated monitoring
✓Policy engine config
✓Security best practices

Implementation Status

Chain engine🟢 Complete

Block production, mempool, snapshots, finality

P2P network🟢 Complete

HTTP gossip + TCP Wire + Kademlia DHT, BFT dual transport, per-peer dedup

EVM execution🟢 Complete

EthereumJS + revm dual pipeline, Cancun/EIP-4844, LevelDB

JSON-RPC🟢 Complete

77+ standard methods, BigInt serialization, structured error codes

WebSocket RPC🟢 Complete

eth_subscribe, real-time events

PoSe protocol🟢 Complete (v1 + v2)

PoSeManagerV2, EIP-712, witness selection, fault proofs, Merkle reward tree, 9-layer receipt validation

Storage layer🟢 Complete

IPFS-compatible HTTP API + CidRegistry

Runtime services🟡 In progress

coc-node, coc-agent, coc-relayer integration

Test coverage🟢 Healthy

1300+ tests, 100+ files across node / services / runtime / contracts / extensions

See the project README for the full implementation status

View on GitHub

Developer Tools

💼 CLI Wallet

Command-line wallet tool

▸Create addresses
▸Transfers
▸Balance queries

🔍 Block Explorer

Full-featured web explorer

▸Block / tx lookup
▸Contract calls
▸Storage scanner

Open tool →→

🧪 Test Scripts

Quality-assurance tools

▸Unit tests
▸Integration tests
▸E2E tests

More Resources

Technical Architecture

Dive into the four-layer design

Development Roadmap

See progress and what's next

Network Status

Live testnet health

Vision & Manifesto

Understand why we began