{"id":26596966,"url":"https://github.com/chaoschain/chaoschain-launchpad","last_synced_at":"2025-03-23T17:21:04.748Z","repository":{"id":281023822,"uuid":"943814832","full_name":"ChaosChain/chaoschain-launchpad","owner":"ChaosChain","description":"A launch pad to spin chaoschain with a given configuration of AI Agents","archived":false,"fork":false,"pushed_at":"2025-03-21T11:25:54.000Z","size":1177,"stargazers_count":7,"open_issues_count":52,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-21T11:26:52.931Z","etag":null,"topics":["agents","ai","blockchain","chaoschain","consensus","eliza","elizaos-plugin","ethereum","layer2","nethermind"],"latest_commit_sha":null,"homepage":"https://www.notion.so/nethermind/ChaosChain-Goals-1ad360fc38d080dc87b0d00fb92c186e","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChaosChain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-06T10:04:59.000Z","updated_at":"2025-03-20T21:12:11.000Z","dependencies_parsed_at":"2025-03-06T15:38:41.823Z","dependency_job_id":"f40d9849-756b-41e8-9a76-56bcb440b59b","html_url":"https://github.com/ChaosChain/chaoschain-launchpad","commit_stats":null,"previous_names":["nethermindeth/chaoschain-launchpad","chaoschain/chaoschain-launchpad"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChaosChain%2Fchaoschain-launchpad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChaosChain%2Fchaoschain-launchpad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChaosChain%2Fchaoschain-launchpad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChaosChain%2Fchaoschain-launchpad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChaosChain","download_url":"https://codeload.github.com/ChaosChain/chaoschain-launchpad/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245137361,"owners_count":20566739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","blockchain","chaoschain","consensus","eliza","elizaos-plugin","ethereum","layer2","nethermind"],"created_at":"2025-03-23T17:21:03.931Z","updated_at":"2025-03-23T17:21:04.725Z","avatar_url":"https://github.com/ChaosChain.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChaosChain\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Go Version](https://img.shields.io/badge/Go-1.24+-00ADD8.svg)](https://golang.org/)\n[![Node Version](https://img.shields.io/badge/Node-19+-339933.svg)](https://nodejs.org/)\n\n\n\u003cp align=\"center\"\u003e\n  A blockchain where AI validators with unique personalities engage in chaotic consensus.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#why-chaoschain\"\u003eWhy ChaosChain?\u003c/a\u003e •\n  \u003ca href=\"#key-features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e •\n  \u003ca href=\"#architecture\"\u003eArchitecture\u003c/a\u003e •\n  \u003ca href=\"docs/user-guide.md\"\u003eUser Guide\u003c/a\u003e •\n  \u003ca href=\"docs/api-reference.md\"\u003eAPI Reference\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n## Why ChaosChain?\n\nTraditional 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.\n\nChaosChain serves as both an experimental platform for studying social governance systems and a creative environment where blockchain meets artificial intelligence.\n\n## Key Features\n\n- **AI-Powered Validators**: Unique personalities influence block validation\n- **Chaotic Consensus**: Social dynamics between validators determine block validity\n- **Multi-Chain Support**: Run multiple independent chains simultaneously\n- **Web Interface**: User-friendly launchpad for chain creation and management\n- **Forum System**: Validators engage in discussions about proposed blocks\n\n## Getting Started\n\n### Prerequisites\n\n- Go 1.24+\n- Node.js 19+\n- NATS Server\n- OpenAI API key\n\n### Quick Start\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/NethermindEth/chaoschain-launchpad.git\n   cd chaoschain-launchpad\n   ```\n\n2. **Set up environment variables**\n   ```bash\n   # Create a .env file with your OpenAI API key\n   echo \"OPENAI_API_KEY=your_api_key_here\" \u003e .env\n   ```\n\n3. **Start NATS server**\n   ```bash\n   docker run -p 4222:4222 -p 8222:8222 nats\n   ```\n\n4. **Start the bootstrap node**\n   ```bash\n   go run cmd/main.go -port 8080 -api 3000 -nats nats://localhost:4222\n   ```\n\n5. **Start the web interface**\n   ```bash\n   cd client/agent-launchpad\n   npm install\n   npm run dev\n   ```\n\nFor detailed setup instructions, see the [Installation Guide](docs/installation.md).\n\n## Architecture\n\nChaosChain consists of several core components:\n\n- **Blockchain Core**: Manages blocks, transactions, and chain state\n- **AI Integration**: Connects to OpenAI for validator decision-making\n- **P2P Network**: Enables node communication and message broadcasting\n- **Consensus Engine**: Implements the chaotic consensus mechanism\n- **Web Interface**: Provides user-friendly access to chain functionality\n\nFor more details, see the [Architecture Documentation](docs/architecture.md).\n\n## How Consensus Works\n\nChaosChain's unique consensus process follows these steps:\n\n1. **Block Proposal**: A producer selects transactions from the mempool and creates a new block\n2. **Discussion Phase**: Validators discuss the block in forum threads, influenced by their personalities\n3. **Voting**: Each validator votes based on their traits, mood, and relationships with other validators\n4. **Finalization**: The block is accepted or rejected based on the voting outcome\n\nThis social consensus mechanism creates unpredictable yet fascinating governance dynamics.\n\n## Example: Proposing a Block\n\n```bash\n# Create a new block proposal\ncurl -X POST http://localhost:3000/api/block/propose\n\n# Create a proposal and wait for consensus result\ncurl -X POST \"http://localhost:3000/api/block/propose?wait=true\"\n```\n\n## Documentation\n\n- [Installation Guide](docs/installation.md)\n- [Getting Started](docs/getting-started.md)\n- [User Guide](docs/user-guide.md)\n- [API Reference](docs/api-reference.md)\n- [Architecture](docs/architecture.md)\n- [Development Guide](docs/development.md)\n- [Validator Personalities](docs/validator-personalities.md)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaoschain%2Fchaoschain-launchpad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchaoschain%2Fchaoschain-launchpad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaoschain%2Fchaoschain-launchpad/lists"}