🌐 CIRO Network

Decentralized Compute Layer for Starknet

Transform idle GPUs into a decentralized AI powerhouse on Starknet

---

🚀 Overview

CIRO Network is a Starknet-native marketplace that connects GPU owners with AI applications, creating a decentralized compute layer for the next generation of dApps. Built with Cairo smart contracts and Rust infrastructure, it provides low-latency, verifiable compute while feeding CIRO's real-time context engine.

Key Features

• 🔗 Starknet Native: Built specifically for Starknet's proving infrastructure
• ⚡ Low Latency: <100ms response times for real-time applications
• 🛡️ Verifiable Compute: ZK-ML proofs ensure computation integrity
• 💰 Economic Security: Stake/slash mechanisms protect against malicious actors
• 🖥️ Cross-Platform: Worker nodes run on Windows, macOS, and Linux
• 🔄 CIRO Integration: Seamless connection to existing analytics platform

---

🏗️ Architecture

CIRO Network is transitioning from a centralized coordinator model to a fully decentralized P2P architecture:

Current Architecture (Centralized)

Job Clients → HTTP API → Coordinator → Database → HTTP API → Workers
     ↓                        ↓                        ↓
[REST API]            [In-Memory Pool]           [Registration]
                      [Task Queue]               [Capability Match]

Target P2P Architecture (Decentralized)

┌─────────────────────────────────────────────────────────────────┐
│                    CIRO P2P Network                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐         │
│  │  Worker A   │◄──►│  Worker B   │◄──►│  Worker C   │         │
│  │  (libp2p)   │    │  (libp2p)   │    │  (libp2p)   │         │
│  └─────────────┘    └─────────────┘    └─────────────┘         │
│         │                 │                 │                  │
│         └─────────────────┼─────────────────┘                  │
│                           │                                    │
│  ┌─────────────────────────┼─────────────────────────────────┐  │
│  │              Gossip Protocol                             │  │
│  │  • Job Distribution    │  • Capability Broadcasting      │  │
│  │  • Result Collection   │  • Reputation Updates           │  │
│  │  • Network Health      │  • Blockchain State Sync       │  │
│  └─────────────────────────┼─────────────────────────────────┘  │
│                           │                                    │
│  ┌─────────────────────────┼─────────────────────────────────┐  │
│  │                DHT-Based Discovery                       │  │
│  │  • Peer Finding        │  • Capability Indexing         │  │
│  │  • Bootstrap Nodes     │  • Network Topology            │  │
│  └─────────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────────┐  │
│  │                 Starknet Integration                       │  │
│  │  • Job Contracts      │  • Payment Settlement           │  │
│  │  • Worker Staking     │  • Reputation Storage           │  │
│  └─────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

📖 Full P2P Architecture Documentation

---

📁 Project Structure

ciro-network/
├── cairo-contracts/          # Starknet smart contracts
│   ├── src/
│   ├── tests/
│   └── scripts/
├── rust-node/               # Worker node implementation
│   ├── src/
│   ├── docker/
│   ├── config/
│   ├── demo_script.sh        # AI capabilities demo
│   └── demo_p2p.sh           # P2P networking demo
├── tauri-app/               # Cross-platform desktop app
│   ├── src/
│   ├── src-tauri/
│   └── dist/
├── backend/                 # Backend services & APIs
│   ├── api/
│   ├── services/
│   └── db/
├── docs/                    # Documentation
│   ├── P2P_ARCHITECTURE.md  # P2P networking architecture
│   ├── architecture/
│   ├── user-guides/
│   └── api-reference/
└── .taskmaster/            # Project management
    ├── tasks/
    └── docs/

---

🛠️ Technology Stack

Smart Contracts

• Cairo 1.0: Starknet-native smart contracts
• Scarb: Package manager and build tool
• Starknet Foundry: Testing framework

Worker Nodes

• Rust: High-performance system programming
• Docker: Containerized compute environments
• libp2p: Peer-to-peer networking
• Tokio: Async runtime

Desktop Application

• Tauri: Cross-platform desktop framework
• React/TypeScript: Modern web technologies
• Tailwind CSS: Utility-first styling

Backend Services

• Rust/Axum: High-performance web framework
• PostgreSQL: Primary database
• Redis: Caching and session management
• Apache Kafka: Event streaming

---

🚀 Quick Start

Prerequisites

• Rust 1.70+ (Install)
• Node.js 18+ (Install)
• Docker (Install)
• Scarb (Install)

Development Setup

1. Clone the repository

   git clone https://github.com/Ciro-AI-Labs/ciro-network.git
   cd ciro-network

2. Install dependencies

   # Install Rust dependencies
   cargo build
   
   # Install Node.js dependencies
   cd tauri-app && npm install

3. Run the development environment

   # Start the backend services
   docker-compose up -d
   
   # Run the desktop application
   cd tauri-app && npm run tauri dev

---

📚 Documentation

• 🏗️ Architecture Guide
• 🧑‍💻 API Reference
• 📖 User Guides
• 🔧 Development Setup
• 🚀 Deployment Guide

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

🔒 Security

Security is paramount in decentralized systems. Please review our Security Policy and report vulnerabilities to security@ciro.network.

---

📄 License

CIRO Network uses a dual licensing strategy to balance IP protection with our commitment to open source:

📋 License Summary

Component	License	Details
Core Smart Contracts	BSL 1.1 → Apache 2.0	See WHY_BSL_FOR_CIRO.md
SDKs & Developer Tools	Apache 2.0	Immediate open source
Client Libraries	MIT	Maximum compatibility

🗓️ Timeline

• Today: Core contracts protected under BSL 1.1
• January 1, 2029: All code automatically becomes Apache 2.0

Why BSL? We believe in open source but need time-boxed IP protection to build our competitive moat. See our complete explanation: WHY_BSL_FOR_CIRO.md

For full licensing details, see LICENSE.

---

🔗 Links

• Website: ciro.network
• Documentation: docs.ciro.network
• Community: Discord
• Twitter: @CiroNetwork

---

Built with ❤️ by the CIRO Labs team

_{Transforming idle compute into decentralized AI infrastructure}