19d415a235
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 3s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 2s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 3s
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 2s
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Deploy to Testnet / deploy-testnet (push) Successful in 1m12s
Documentation Validation / validate-docs (push) Failing after 8s
Documentation Validation / validate-policies-strict (push) Successful in 3s
Integration Tests / test-service-integration (push) Successful in 2m6s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Successful in 2s
Multi-Node Blockchain Health Monitoring / health-check (push) Failing after 4s
P2P Network Verification / p2p-verification (push) Successful in 4s
Package Tests / Python package - aitbc-agent-sdk (push) Successful in 32s
Package Tests / Python package - aitbc-core (push) Successful in 14s
Package Tests / Python package - aitbc-crypto (push) Successful in 12s
Package Tests / Python package - aitbc-sdk (push) Successful in 9s
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 8s
Package Tests / JavaScript package - aitbc-token (push) Successful in 17s
Python Tests / test-python (push) Successful in 15s
Security Scanning / security-scan (push) Successful in 27s
Node Failover Simulation / failover-test (push) Successful in 7s
Multi-Node Stress Testing / stress-test (push) Successful in 6s
Cross-Node Transaction Testing / transaction-test (push) Successful in 4s
- Add SQLCipher encryption for ait-mainnet database with configurable flag - Add db_encryption_enabled and db_encryption_key_path config settings - Implement encryption key loading and PRAGMA key setup via connection events - Add shutdown_db function for proper database cleanup - Export middleware classes in aitbc/__init__.py - Fix import path in sync.py for settings - Remove duplicate agent documentation from docs
157 lines
4.2 KiB
Markdown
157 lines
4.2 KiB
Markdown
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
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:
|
|
```env
|
|
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
|
|
```bash
|
|
# 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
|