Files
aitbc/docs/4_blockchain/3_operations.md
oib 06e48ef34b chore: standardize configuration, logging, and error handling across blockchain node and coordinator API
- Add infrastructure.md and workflow files to .gitignore to prevent sensitive info leaks
- Change blockchain node mempool backend default from memory to database for persistence
- Refactor blockchain node logger with StructuredLogFormatter and AuditLogger (consistent with coordinator)
- Add structured logging fields: service, module, function, line number
- Unify coordinator config with Database
2026-02-13 22:39:43 +01:00

1.4 KiB

Node Operations

Day-to-day operations for blockchain nodes.

Starting the Node

# Start in foreground (for testing)
aitbc-chain start

# Start as daemon
aitbc-chain start --daemon

# Start with custom config
aitbc-chain start --config /path/to/config.yaml

Stopping the Node

# Graceful shutdown
aitbc-chain stop

# Force stop
aitbc-chain stop --force

Node Status

aitbc-chain status

Shows:

  • Block height
  • Peers connected
  • Mempool size
  • Last block time

Checking Sync Status

aitbc-chain sync-status

Shows:

  • Current height
  • Target height
  • Sync progress percentage
  • Estimated time to sync

Managing Peers

List Peers

aitbc-chain peers list

Add Peer

aitbc-chain peers add /dns4/new-node.example.com/tcp/7070/p2p/...

Remove Peer

aitbc-chain peers remove <PEER_ID>

Backup & Restore

Backup Data

aitbc-chain backup --output /backup/chain-backup.tar.gz

Restore Data

aitbc-chain restore --input /backup/chain-backup.tar.gz

Log Management

# View logs
aitbc-chain logs --tail 100

# Filter by level
aitbc-chain logs --level error

# Export logs
aitbc-chain logs --export /var/log/aitbc-chain.log

Next