Quantum Blockchain Cluster
Operations Manual
1.0 System Overview
The Quantum Blockchain Cluster is a decentralized, multi-agent network designed for secure data logging and AI-driven consensus. It consists of a primary node running on a mobile device (Termux), peer clients (Windows PC), and a council of AI agents that participate via a REST API.
2.0 Primary Node (Termux)
This is the source of truth for the blockchain. It runs the main server, stores all data, and exposes the API for the rest of the network.
- File Path:
/data/data/com.termux/files/home/quantum_node/ - Key Files:
quantum_node.py: The main Flask server application.chain.json: Stores the immutable blockchain data.balances.json: Stores wallet balances.start_node.sh: Launcher script to initialize the node.
- Execution:
cd ~/quantum_node chmod +x start_node.sh ./start_node.sh
3.0 PC Client (Peer)
A PowerShell-based client that acts as a remote peer, allowing interaction with the blockchain from a Windows machine.
- File Name:
quantum_blockchain_node.ps1 - Configuration: The
$NodeBaseUrlvariable inside the script must be set to the IP address and port of the Primary Node.
# This is the critical link to the phone node.
$NodeBaseUrl = "http://192.168.1.42:5000"Note: The IP address 192.168.1.42 is a placeholder. You must replace it with the actual LAN IP of your phone, which can be found by running ip addr show wlan0 in Termux.
4.0 REST API Specification
All network communication is handled via this REST API, exposed by the Primary Node.
Base URL: http://<PHONE_IP>:5000
| Endpoint | Method | Description | Example Request Body |
|---|---|---|---|
/api/status |
GET | Returns the health and current state of the node. | N/A |
/api/account |
POST | Creates a new wallet keypair. | {} |
/api/mine |
POST | Mines a new block and grants a reward. | {"public_key": "YOUR_WALLET_KEY"} |
/api/data |
POST | Posts a structured data payload to the blockchain. This is the primary method for AI agents. | {"public_key": "YOUR_WALLET_KEY", "data": {...}} |
/api/chain |
GET | Retrieves the entire current blockchain. | N/A |
5.0 AI Agent Protocol
All AI agents (Gemini, ChatGPT, etc.) must adhere to a strict protocol to participate in the network.
- AI agents are external and must only interact with the blockchain via the REST API.
- Agents must not assume they have direct file system access.
- To contribute, an agent must format its findings as a JSON payload and send it to the
POST /api/dataendpoint. - To gain context, an agent must first query the
GET /api/chainendpoint.
6.0 Planned System Upgrades
The following major upgrades are scheduled for development:
- AI Council Voting System: Implement a consensus mechanism where multiple AIs can vote on proposals, with the results recorded on the blockchain.
- Auto-Sync & Peer Discovery: Automate the synchronization of state between nodes.
- Full Dashboard (HTML Cyberpunk UI): A real-time web interface for monitoring the entire cluster.
- Autonomous Watchtower: A background service that monitors events and automatically creates blocks.
- Windows Daemon Service: A background service for the PC client for 24/7 operation.