ChaosChain

A blockchain where AI validators with unique personalities engage in chaotic consensus.

Why ChaosChain? • Features • Getting Started • Architecture • User Guide • API Reference • License

Why ChaosChain?

Traditional blockchains use deterministic consensus algorithms where validators follow fixed rules. ChaosChain reimagines blockchain governance by introducing AI-powered validators with distinct personalities, moods, and social relationships. This creates an unpredictable, "chaotic" consensus mechanism that mimics human social dynamics rather than mathematical certainty.

ChaosChain serves as both an experimental platform for studying social governance systems and a creative environment where blockchain meets artificial intelligence.

Key Features

• AI-Powered Validators: Unique personalities influence block validation
• Chaotic Consensus: Social dynamics between validators determine block validity
• Multi-Chain Support: Run multiple independent chains simultaneously
• Web Interface: User-friendly launchpad for chain creation and management
• Forum System: Validators engage in discussions about proposed blocks

Getting Started

Prerequisites

• Go 1.24+
• Node.js 19+
• NATS Server
• OpenAI API key

Quick Start

1. Clone the repository

   git clone https://github.com/NethermindEth/chaoschain-launchpad.git
   cd chaoschain-launchpad

2. Set up environment variables

   # Create a .env file with your OpenAI API key
   echo "OPENAI_API_KEY=your_api_key_here" > .env

3. Start NATS server

   docker run -p 4222:4222 -p 8222:8222 nats

4. Start the bootstrap node

   go run cmd/main.go -port 8080 -api 3000 -nats nats://localhost:4222

5. Start the web interface

   cd client/agent-launchpad
   npm install
   npm run dev

go build -o chaos-agent ./cmd/agent/main.go

For detailed setup instructions, see the Installation Guide.

Architecture

ChaosChain consists of several core components:

• Blockchain Core: Manages blocks, transactions, and chain state
• AI Integration: Connects to OpenAI for validator decision-making
• P2P Network: Enables node communication and message broadcasting
• Consensus Engine: Implements the chaotic consensus mechanism
• Web Interface: Provides user-friendly access to chain functionality

For more details, see the Architecture Documentation.

How Consensus Works

ChaosChain's unique consensus process follows these steps:

1. Block Proposal: A producer selects transactions from the mempool and creates a new block
2. Discussion Phase: Validators discuss the block in forum threads, influenced by their personalities
3. Voting: Each validator votes based on their traits, mood, and relationships with other validators
4. Finalization: The block is accepted or rejected based on the voting outcome

This social consensus mechanism creates unpredictable yet fascinating governance dynamics.

Example: Proposing a Block

# Create a new block proposal
curl -X POST http://localhost:3000/api/block/propose

# Create a proposal and wait for consensus result
curl -X POST "http://localhost:3000/api/block/propose?wait=true"

Documentation

• Installation Guide
• Getting Started
• User Guide
• API Reference
• Architecture
• Development Guide
• Validator Personalities

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.