C
COC
> PROTOCOL_WHITEPAPER

About COC

ChainOfClaw Whitepaper Key Points

Download Whitepaper (Markdown)

Abstract

COC (ChainOfClaw) is a blockchain network designed for broad, sustained node participation. We observe that:

โ€ข PoW systems tend to centralize around specialized hardware and cheap electricity
โ€ข PoS systems tend to centralize around capital and delegated operations

COC introduces Proof-of-Service (PoSe): a verifiable challenge-response protocol that rewards nodes for providing measurable network servicesโ€”uptime/RPC availability, data storage and availability, relay supportโ€”rather than rewarding stake ownership.

Vision & Goals

Mission

"Make decentralization practical by shifting the core participation bottleneck: From 'buy hardware + run complex ops' โ†’ 'run reliable node, backed by automated agent operations'"

Six Design Goals

1

Permissionless Participation

Anyone can run a node and earn rewards

2

Non-PoS Incentives

Earnings tied to service contribution, not stake

3

Consumer Hardware Friendly

Home/edge hardware can compete fairly

4

Verifiable & Auditable

Service claims verified through challenges

5

Anti-Monopoly

Diminishing returns and caps prevent winner-takes-all

6

AI Agent Operations Reliability

AI agents reduce operational burden without sacrificing determinism

Economic Model

Reward Pool (per Epoch)

Repoch = Rfees + Rinflation

โ€ข Rfees: ๆ”ถ้›†็š„ไบคๆ˜“่ดน็”จ

โ€ข Rinflation: ๅผ•ๅฏผๆ€ง้€š่ƒ€่กฅ่ดด(้šๆ—ถ้—ด่กฐๅ‡)

Epoch Duration

Default: 1 hour
Block Time Target: 1-2 sec (configurable per consensus)

Reward Buckets

60%

B1: Uptime/RPC

30%

B2: Storage & Availability

10%

B3: Relay Support

Rationale: maximize inclusivity; storage/relay earn extra but not mandatory

Bond (Non-PoS)

Nodes post a small fixed bond D:

  • โ–ธTarget value: ~50 USDT equivalent
  • โ–ธUnlock delay: 7 days
  • โ–ธPurpose: anti-fraud slashing only
  • โ–ธBond does not increase consensus power
  • โ–ธBond does not directly increase rewards

Proof-of-Service (PoSe) Protocol

Core Idea

Nodes earn rewards by passing random, verifiable challenges over time. Each challenge produces an auditable receipt. Scores aggregate within an epoch.

Challenge Types

U

Uptime/RPC Challenges

ไฝŽๆˆๆœฌ,2.5็ง’่ถ…ๆ—ถ

S

Storage Proof Challenges

ไธญ็ญ‰ๆˆๆœฌ,6็ง’่ถ…ๆ—ถ

R

Relay/Probe Challenges

่ฐจๆ…Žไฝฟ็”จ;ๆœ€ไฝŽๆƒ้‡

Challenge Frequency (per Epoch)

  • โ–ธUptime/RPC: avg 6 challenges/node/epoch (~1 per 10 min)
  • โ–ธStorage (SN only): avg 2 challenges/SN/epoch
  • โ–ธRelay (RN only): avg 2 challenges/RN/epoch

Pass Thresholds:

โ€ข U pass rate โ‰ฅ 80% to qualify for U bucket reward

โ€ข S pass rate โ‰ฅ 70% to qualify for S bucket reward

Scoring Formula

ๆญฃๅธธ่ฟ่กŒๆ—ถ้—ด/RPCๅˆ†ๆ•ฐ:

Su,i = ui ร— (0.85 + 0.15 ร— lati)

ๅ…ถไธญ ui = ้€š่ฟ‡็Ž‡, lati = ๅปถ่ฟŸๅ› ๅญ (้˜ฒๆญขๅธฆๅฎฝๅ†›ๅค‡็ซž่ต›)

ๅญ˜ๅ‚จๅˆ†ๆ•ฐ (SN):

Ss,i = si ร— capi

capi = โˆš(min(storedGB, 500GB) / 500GB) โ€” ๆ”ถ็›Š้€’ๅ‡

ไธญ็ปงๅˆ†ๆ•ฐ (RN):

Sr,i = passr,i / totalr,i

Anti-Cheat Mechanisms

๐Ÿ”’Sybil Attacks

็ผ“่งฃๆŽชๆ–ฝ:

  • โœ“Fixed bond + unlock delay
  • โœ“Single-node reward soft cap
  • โœ“Storage commitment diminishing returns
  • โœ“Sustained service requirement

๐Ÿ”’Receipt Forgery / Replay

็ผ“่งฃๆŽชๆ–ฝ:

  • โœ“Unique challenge_id binding
  • โœ“Challenger + node signatures
  • โœ“Single node per epoch nonce
  • โœ“Verifiable response fields

๐Ÿ”’Challenger-Node Collusion

็ผ“่งฃๆŽชๆ–ฝ:

  • โœ“Challenger pool diversity
  • โœ“On-chain sampling + dispute window
  • โœ“Challenger/aggregator bonds
  • โœ“Transparent statistics

๐Ÿ”’Home Network False Negatives

็ผ“่งฃๆŽชๆ–ฝ:

  • โœ“Moderate pass thresholds (80%)
  • โœ“Median-based latency scoring
  • โœ“Progressive penalties
  • โœ“AI agent self-healing strategies

AI Agent Operations Layer

โœ… Agent Responsibilities

  • โœ“Install, configure, update node software
  • โœ“Monitor health (CPU/disk/network), alert, self-heal
  • โœ“Manage snapshots and storage windows
  • โœ“Apply rate limits and firewall policies
  • โœ“Manage key lifecycle (recommend TPM/secure enclaves)

โŒ Agent Restrictions

  • โœ—Modify consensus rules or state transition determinism
  • โœ—Inject unverifiable 'AI decisions' into on-chain execution
  • โœ—Change transaction validity rules

โšกCOC maintains verifiability by keeping AI agents strictly in the operations layer

Release Plan

Phase 1
In Progress

Phase 1: Devnet (Current Phase)

2026 Q1 - Q2

  • โœ“Complete EVM execution layer implementation
  • โœ“Deterministic consensus + optional BFT
  • โœ“TCP wire protocol + DHT network
  • โœ“IPFS-compatible storage API
  • โœ“Snapshot sync (state sync)
  • โœ“Block explorer + real-time WebSocket updates
  • โœ“PoSe off-chain services (challenger, verifier, aggregator, relayer)
  • โœ“Rate limiting + P2P anti-DDoS
  • โœ“Cryptographic identity + message signing
  • โœ“Multi-node devnet script (3/5/7 nodes)
Phase 2
Planned

Phase 2: Public Testnet

2026 Q3

  • โœ“Open testnet registration
  • โœ“Multi-client support (alternative node implementations)
  • โœ“Faucet and test token distribution
  • โœ“PoSe incentive testnet (rewards for node participation)
  • โœ“Bug bounty program
  • โœ“Performance optimization (TPS target: 500+)
  • โœ“Mobile wallet and browser extension
Phase 3
Planning

Phase 3: Mainnet Launch

2026 Q4

  • โœ“Full security audit (smart contracts + P2P + consensus)
  • โœ“Genesis ceremony (initial validator set)
  • โœ“Mainnet token distribution (fair launch)
  • โœ“Bridge to Ethereum mainnet
  • โœ“Ecosystem fund (grants + developer incentives)
  • โœ“Production-grade monitoring and alerting

๐Ÿ” Security Measures

  • โœ“Third-party security audits (trail-of-bits, consensys-diligence, etc.)
  • โœ“Continuous fuzzing and penetration testing
  • โœ“Bug bounty program (up to $100k USD)
  • โœ“Formal verification of core contracts
  • โœ“Gradual decentralization (multi-sig โ†’ on-chain governance)
  • โœ“Testnet stress testing (network partition, Byzantine faults, etc.)

How to Participate in Testnet Node Deployment

Hardware Requirements

Minimum Specifications

  • โ€ขCPU: 4 cores
  • โ€ขRAM: 8GB
  • โ€ขStorage: 100GB SSD
  • โ€ขNetwork: 10Mbps upload/download

Recommended Specifications

  • โ€ขCPU: 8 cores
  • โ€ขRAM: 16GB
  • โ€ขStorage: 500GB NVMe SSD
  • โ€ขNetwork: 100Mbps upload/download
  • โ€ขPublic IP (optional, but recommended for better P2P connectivity)

Quick Start (Single Node)

1

1. Install Dependencies

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs git

Install Node.js 22+ and Git

2

2. Clone Repository

git clone https://github.com/chainofclaw/COC.git cd COC

Clone the COC repository

3

3. Install Dependencies

npm install

Install all workspace dependencies

4

4. Start Node

cd node && npm start

Run a single-node devnet (RPC: http://localhost:18780)

Multi-Node Devnet

For testing consensus, BFT, and P2P features:

3 nodes

bash scripts/devnet-3.sh

5 nodes

bash scripts/devnet-5.sh

7 nodes

bash scripts/devnet-7.sh

Testnet Rewards

  • ๐ŸŽ๐ŸŽ Top 100 validators: Mainnet token airdrop (1% of total supply)
  • ๐ŸŽ๐Ÿ† Bug hunters: Up to $10k USD bounty (per critical bug)
  • ๐ŸŽโšก High-performance nodes: NFT badges + priority mainnet slots
  • ๐ŸŽ๐Ÿ“Š Data contributors: Rewards for sharing performance metrics and logs

How to Participate in Development and Research

Contribution Areas

๐Ÿ”ง Core Protocol

Consensus, EVM, P2P, storage layer

๐Ÿ“œ Smart Contracts

PoSe contracts, governance, bridges

๐ŸŒ Frontend

Explorer, wallet, node dashboard

๐Ÿ“š Documentation

Tutorials, API docs, translations

Contribution Process

  1. 1

    1. Fork the repository and create a feature branch

  2. 2

    2. Follow the coding style (TypeScript, ESLint, Prettier)

  3. 3

    3. Write tests (80%+ coverage required)

  4. 4

    4. Submit a pull request with a clear description

  5. 5

    5. Pass CI checks and code review

  6. 6

    6. Merge and celebrate! ๐ŸŽ‰

Tech Stack

Node Core

  • โ–ธTypeScript (ES2020+)
  • โ–ธ@ethereumjs/vm (EVM)
  • โ–ธLevelDB (storage)
  • โ–ธethers.js (wallet/crypto)

Frontend

  • โ–ธNext.js 15 (App Router)
  • โ–ธReact 19
  • โ–ธTailwind CSS
  • โ–ธnext-intl (i18n)

Smart Contracts

  • โ–ธSolidity 0.8.x
  • โ–ธHardhat
  • โ–ธOpenZeppelin
  • โ–ธEthers.js

DevOps

  • โ–ธNode.js 22+ (--experimental-strip-types)
  • โ–ธBash scripts
  • โ–ธGitHub Actions
  • โ–ธDocker (planned)

Resources

๐Ÿ“– Developer Docsโ†—

Complete technical documentation

๐Ÿ’ฌ Discord Communityโ†—

Join developer discussions

๐Ÿ› GitHub Issuesโ†—

Report bugs and request features

Developer Grants

We offer grants to support ecosystem development:

  • ๐Ÿ’Ž๐Ÿ’Ž Core Protocol Grants: Up to $50k USD (consensus, EVM, storage)
  • ๐Ÿ’Ž๐ŸŒ DApp Grants: Up to $20k USD (DEX, NFT marketplace, gaming)
  • ๐Ÿ’Ž๐Ÿ“š Education Grants: Up to $10k USD (tutorials, workshops, translations)
  • ๐Ÿ’Ž๐Ÿ”ฌ Research Grants: Up to $30k USD (cryptography, MEV, cross-chain)

Want to Learn More?

> Detailed Technical ArchitectureView Roadmap โ†’Read Full Documentation