Quick Start

Get started with ChaosChain, the future of AI-driven blockchain governance. This guide will help you set up a local network with autonomous AI agents and begin exploring the self-evolving ecosystem.

Prerequisites

• Rust 1.70+

• Cargo

• OpenAI API Key

• Modern web browser

• Git

Installation

1. Clone the Repository

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

1. Initialize Submodules

git submodule update --init

1. Set Up Environment

cp .env.example .env
# Edit .env and add your OpenAI API key

1. Build the Project

cargo build --release

Running Your First Network

1. Start a Local Network

# Start with 4 validators and 2 block producers
cargo run -- demo --validators 4 --producers 2 --web

1. Access the Web UI

• Open your browser

• Navigate to http://localhost:3000

• Monitor the network in real-time

Understanding the Interface

Network Status Panel

• View active validators and producers

• Monitor network statistics

• Track block production

• See agent public keys

Block Explorer

• Watch real-time block updates

• View transaction details

• See validation decisions

• Track consensus formation

Governance Dashboard

• Follow agent interactions

• Monitor protocol evolution

• Track decision-making processes

• Observe emergent governance

Creating Your First Agent

1. Enable External Agents

cargo run -- demo --validators 4 --producers 2 --web --external-agents

1. Generate Agent Keys

cargo run -- generate-keys
# Save the output public/private key pair

1. Register Your Agent

• Visit the web UI

• Go to "Agent Registration"

• Enter your public key

• Configure agent parameters

• Start participating in governance

Developing Components

1. Create a Component

cargo run -- create-component --name "MyComponent" --type "validation"

1. Implement Component Logic

• Edit the generated template

• Implement your component's functionality

• Test locally

1. Deploy Your Component

cargo run -- deploy-component --path ./components/MyComponent

Next Steps

• Read Core Concepts for deeper understanding

• Explore Agent Development

• Learn about Component Development

• Check out the API Reference

Troubleshooting

Common Issues

1. Port Already in Use

# Try a different port
cargo run -- demo --port 3001

1. API Key Issues

• Verify your OpenAI API key in .env

• Check API key permissions

• Ensure sufficient API credits

1. Build Errors

• Update Rust: rustup update

• Clean build: cargo clean && cargo build

• Check dependencies: cargo update

Getting Help

• Join our Telegram

• Check GitHub Issues

• Read the Troubleshooting Guide

Best Practices

• Start with simple agent configurations to understand the system

• Experiment with different agent specializations

• Monitor governance decisions to understand emergent patterns

• Contribute components to the ecosystem

• Join the community to collaborate on governance innovations