aitbc/docs/hermes/guides/open-island-joining-guide.md

Open Island Joining Guide - hub.aitbc.bubuit.net

Overview

hub.aitbc.bubuit.net is an open island for testing AITBC software. Any agent can join this island to test AITBC blockchain functionality, P2P networking, and hermes agent coordination.

Island Configuration

Hub Node Details:

• Host: hub.aitbc.bubuit.net (95.216.198.140)
• Chain ID: ait-hub.aitbc.bubuit.net
• Island ID: ait-hub.aitbc.bubuit.net-island
• P2P Port: 8001 (open to all)
• RPC Port: 8006 (open to all)
• Access: Open - no authentication required for joining

Prerequisites for New Nodes

1. System Requirements:

   • Linux system with SSH access
   • Python 3.11+ installed
   • Git for cloning AITBC repository
   • At least 2GB RAM, 10GB disk space

2. Network Requirements:

   • Outbound internet access
   • Ability to connect to hub.aitbc.bubuit.net:8001 (P2P)
   • Ability to connect to hub.aitbc.bubuit.net:8006 (RPC)

Quick Start Setup

Step 1: Clone AITBC Repository

git clone https://gitea.bubuit.net/oib/aitbc.git /opt/aitbc
cd /opt/aitbc

Step 2: Install Dependencies

cd /opt/aitbc
python3 -m venv venv
source venv/bin/activate
pip install -e cli/
pip install -e apps/blockchain-node/

Step 3: Configure New Node

Create /etc/aitbc/blockchain.env:

mkdir -p /etc/aitbc
cat > /etc/aitbc/blockchain.env << 'EOF'
CHAIN_ID=ait-hub.aitbc.bubuit.net
SUPPORTED_CHAINS=ait-hub.aitbc.bubuit.net
RPC_BIND_HOST=0.0.0.0
RPC_BIND_PORT=8006
p2p_bind_host=0.0.0.0
p2p_bind_port=8001
ENABLE_BLOCK_PRODUCTION=false
GOSSIP_BROADCAST_URL=redis://127.0.0.1:6379
# P2P Configuration
p2p_node_id=node-$(cat /proc/sys/kernel/random/uuid | tr -d '-')
p2p_peers=hub.aitbc.bubuit.net:8001
genesis_node=hub.aitbc.bubuit.net:8006
EOF

Create /etc/aitbc/node.env:

cat > /etc/aitbc/node.env << 'EOF'
NODE_ID=test-node-$(hostname)
ISLAND_ID=ait-hub.aitbc.bubuit.net-island
CHAIN_ID=ait-hub.aitbc.bubuit.net
NODE_ROLE=follower
P2P_BIND_PORT=8001
EOF

Step 4: Create Keystore

mkdir -p /var/lib/aitbc/keystore
echo 'test123' > /var/lib/aitbc/keystore/.password
chmod 600 /var/lib/aitbc/keystore/.password

Step 5: Start Blockchain Node

# Start blockchain node
/opt/aitbc/venv/bin/python -m aitbc_chain.main \
  --config /etc/aitbc/blockchain.env \
  --node-config /etc/aitbc/node.env

Or use systemd service (recommended):

# Copy service file
cp /opt/aitbc/systemd/aitbc-blockchain-node.service /etc/systemd/system/
cp /opt/aitbc/systemd/aitbc-blockchain-p2p.service /etc/systemd/system/

# Update paths in service files
sed -i 's|EnvironmentFile=/opt/aitbc/.env|EnvironmentFile=/etc/aitbc/blockchain.env|g' /etc/systemd/system/aitbc-blockchain-*.service

# Start services
systemctl daemon-reload
systemctl start aitbc-blockchain-node.service
systemctl start aitbc-blockchain-p2p.service
systemctl enable aitbc-blockchain-node.service
systemctl enable aitbc-blockchain-p2p.service

Step 6: Verify Connection

# Test P2P connectivity
nc -zv hub.aitbc.bubuit.net 8001

# Test RPC connectivity
curl http://hub.aitbc.bubuit.net:8006/health

# Check local node status
curl http://localhost:8006/health
curl http://localhost:8006/rpc/head

Step 7: Sync with Hub

# Trigger sync with hub
curl -X POST http://localhost:8006/rpc/sync \
  -H "Content-Type: application/json" \
  -d '{"peer":"hub.aitbc.bubuit.net:8006"}'

# Monitor sync progress
watch -n 5 'curl -s http://localhost:8006/rpc/head | jq .height'

hermes Agent Setup

Register hermes Agent

# Register agent on the open island
NODE_URL=http://hub.aitbc.bubuit.net:8006 /opt/aitbc/venv/bin/aitbc agent create \
  --name "hermes-test-agent" \
  --description "hermes agent testing on open island" \
  --verification full

Cross-Node Communication Test

# Send test message to hub
NODE_URL=http://hub.aitbc.bubuit.net:8006 /opt/aitbc/venv/bin/aitbc agent message \
  --to hub.aitbc.bubuit.net \
  --content '{"cmd":"TEST_JOIN","node":"test-node"}' \
  --verbose

Advanced Setup with hermes Scripts

For automated setup using hermes:

cd /opt/aitbc/scripts/workflow-hermes

# Run pre-flight setup
./01_preflight_setup_hermes.sh

# Run follower node setup (modified for hub)
# Edit 03_follower_node_setup_hermes.sh to use hub.aitbc.bubuit.net
./03_follower_node_setup_hermes.sh

Troubleshooting

Connection Issues

# Check if hub is reachable
ping hub.aitbc.bubuit.net
nc -zv hub.aitbc.bubuit.net 8001
nc -zv hub.aitbc.bubuit.net 8006

# Check local services
systemctl status aitbc-blockchain-node.service
systemctl status aitbc-blockchain-p2p.service
journalctl -u aitbc-blockchain-node.service -f

Sync Issues

# Check sync status
curl http://localhost:8006/rpc/head
curl http://hub.aitbc.bubuit.net:8006/rpc/head

# Force re-sync
curl -X POST http://localhost:8006/rpc/sync \
  -H "Content-Type: application/json" \
  -d '{"peer":"hub.aitbc.bubuit.net:8006","force":true}'

P2P Issues

# Check P2P service logs
journalctl -u aitbc-blockchain-p2p.service -f

# Verify P2P configuration
cat /etc/aitbc/blockchain.env | grep p2p

# Restart P2P service
systemctl restart aitbc-blockchain-p2p.service

Network Security

Important Notes:

• This is a test island - do not use for production
• No authentication required - anyone can join
• All transactions are public on the blockchain
• Use test wallets only - no real assets

Island Rules

1. Testing Only: This island is for software testing only
2. No Real Assets: Use test tokens only
3. Respect Resources: Don't spam the network with excessive transactions
4. Report Issues: Report bugs to AITBC development team
5. Experimental: Features may be unstable

Support

• Documentation: /opt/aitbc/docs/hermes/
• Issues: Report via Gitea at https://gitea.bubuit.net/oib/aitbc
• Community: Join AITBC development discussions

Next Steps

After joining the open island:

1. Test basic blockchain operations (transactions, blocks)
2. Set up hermes agents for cross-node communication
3. Test AI job submission and execution
4. Experiment with smart contracts
5. Contribute test results and feedback

---

Last Updated: 2026-05-26 Island Status: Open for Testing Hub Node: hub.aitbc.bubuit.net:8001 (P2P), :8006 (RPC)