aitbc/docs/reference/8_blockchain-deployment-summary.md

AITBC Blockchain Node Deployment Summary

Overview

Successfully deployed two independent AITBC blockchain nodes on the same server for testing and development.

Node Configuration

Node 1

• Location: /opt/blockchain-node
• P2P Port: 7070
• RPC Port: 8082
• Database: /opt/blockchain-node/data/chain.db
• Status: ✅ Operational
• Chain Height: 717,593+ (actively producing blocks)

Node 2

• Location: /opt/blockchain-node-2
• P2P Port: 7071
• RPC Port: 8081
• Database: /opt/blockchain-node-2/data/chain2.db
• Status: ✅ Operational
• Chain Height: 174+ (actively producing blocks)

Services

Systemd Services

# Node 1
systemctl status blockchain-node    # Consensus node
systemctl status blockchain-rpc     # RPC API

# Node 2
systemctl status blockchain-node-2  # Consensus node
systemctl status blockchain-rpc-2   # RPC API

API Endpoints

• Node 1 RPC: http://127.0.0.1:8082/docs
• Node 2 RPC: http://127.0.0.1:8081/docs

Testing

Test Scripts

1. Basic Test: /opt/test_blockchain_simple.py

   • Verifies node responsiveness
   • Tests faucet functionality
   • Checks chain head

2. Comprehensive Test: /opt/test_blockchain_nodes.py

   • Full test suite with multiple scenarios
   • Currently shows nodes operating independently

Running Tests

cd /opt/blockchain-node
source .venv/bin/activate
cd ..
python test_blockchain_final.py

Current Status

✅ Working

• Both nodes are running and producing blocks
• RPC APIs are responsive
• Faucet (minting) is functional
• Transaction submission works
• Block production active (2s block time)

⚠️ Limitations

• Nodes are running independently (not connected)
• Using memory gossip backend (no cross-node communication)
• Different chain heights (expected for independent nodes)

Production Deployment Guidelines

To connect nodes in a production network:

1. Network Configuration

• Deploy nodes on separate servers
• Configure proper firewall rules
• Ensure P2P ports are accessible

2. Gossip Backend

• Use Redis for distributed gossip:

  GOSSIP_BACKEND=memory
  GOSSIP_BROADCAST_URL=redis://redis-server:6379/0
  

3. Peer Discovery

• Configure peer list in each node
• Use DNS seeds or static peer configuration
• Implement proper peer authentication

4. Security

• Use TLS for P2P communication
• Implement node authentication
• Configure proper access controls

Troubleshooting

Common Issues

1. Port Conflicts: Ensure ports 7070/7071 and 8081/8082 are available
2. Permission Issues: Check file permissions in /opt/blockchain-node*
3. Database Issues: Remove/rename database to reset chain

Logs

# Node logs
sudo journalctl -u blockchain-node -f
sudo journalctl -u blockchain-node-2 -f

# RPC logs
sudo journalctl -u blockchain-rpc -f
sudo journalctl -u blockchain-rpc-2 -f

Next Steps

1. Multi-Server Deployment: Deploy nodes on different servers
2. Redis Setup: Configure Redis for shared gossip
3. Network Testing: Test cross-node communication
4. Load Testing: Test network under load
5. Monitoring: Set up proper monitoring and alerting

Files Created/Modified

Deployment Scripts

• /home/oib/windsurf/aitbc/scripts/deploy/deploy-first-node.sh
• /home/oib/windsurf/aitbc/scripts/deploy/deploy-second-node.sh
• /home/oib/windsurf/aitbc/scripts/deploy/setup-gossip-relay.sh

Test Scripts

• /home/oib/windsurf/aitbc/tests/test_blockchain_nodes.py
• /home/oib/windsurf/aitbc/tests/test_blockchain_simple.py
• /home/oib/windsurf/aitbc/tests/test_blockchain_final.py

Configuration Files

• /opt/blockchain-node/.env
• /opt/blockchain-node-2/.env
• /etc/systemd/system/blockchain-node*.service
• /etc/systemd/system/blockchain-rpc*.service

Summary

✅ Successfully deployed two independent blockchain nodes ✅ Both nodes are fully operational and producing blocks ✅ RPC APIs are functional for testing ✅ Test suite created and validated ⚠️ Nodes not connected (expected for current configuration)

The deployment provides a solid foundation for:

• Development and testing
• Multi-node network simulation
• Production deployment preparation