27312dcf2a
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Has been cancelled
Deploy to Testnet / deploy-testnet (push) Has been cancelled
Multi-Node Stress Testing / stress-test (push) Has been cancelled
Security Scanning / security-scan (push) Has been cancelled
CLI Tests / test-cli (push) Has been cancelled
Documentation Validation / validate-docs (push) Failing after 11s
Documentation Validation / validate-policies-strict (push) Successful in 4s
- Update CLI config to load from /etc/aitbc/blockchain.env - Update operational-features.md documentation - Update setup.sh to create/use blockchain.env - Update utility scripts (setup-credentials, migrate_secrets, generate_unique_node_ids, chain_regen_node, load-keystore-secrets) - Update workflow scripts (01_preflight_setup, hermes preflight setups) - Maintain backward compatibility for existing deployments
Blockchain Documentation
Generated: 2026-03-08 13:06:38 Last Updated: 2026-04-22 Total Files: 3
Documentation Files
- Adding gitea-runner as Third Blockchain Node (aitbc2) - Complete guide for adding a third node to the AITBC blockchain network, including configuration steps, issues encountered, and verification procedures.
- Blockchain Synchronization Issues and Fixes - Documentation of synchronization issues between AITBC nodes and their resolutions.
Multi-Node Blockchain Workflows
Comprehensive Windsurf workflows for multi-node blockchain deployment and operations:
- Core Setup - Prerequisites, environment configuration, and basic node setup
- Operations - Daily operations, monitoring, and troubleshooting
- Advanced Features - Smart contracts, security testing, and performance optimization
- Marketplace Testing - GPU provider testing, transaction tracking, and verification procedures
- Production Deployment - Security hardening, monitoring, and scaling strategies
- Reference - Configuration overview, verification commands, and best practices
Transaction Types
The AITBC blockchain supports the following transaction types:
- TRANSFER: Standard value transfer between accounts
- MESSAGE: On-chain messaging (value=0, fee-only) - allows sending short text messages without balance transfers
- RECEIPT_CLAIM: Claim rewards from job completion receipts
- GPU_MARKETPLACE: GPU marketplace transactions (bids, offers, purchases)
- EXCHANGE: Exchange transactions (orders, trades, swaps, liquidity)
MESSAGE Transaction Type
The MESSAGE transaction type allows users to send short on-chain messages without affecting account balances. The message is stored in the transaction payload and only the fee is deducted from the sender's balance.
Usage:
curl -X POST http://localhost:8006/rpc/transaction \
-H "Content-Type: application/json" \
-d '{"type":"MESSAGE","from":"address","to":"address","amount":0,"fee":1000,"nonce":1,"payload":{"message":"Hello blockchain!"},"sig":"signature"}'
Characteristics:
- value must be 0
- fee > 0
- recipient can be any address (or special "null" address)
- No balance transfers (only fee deduction)
- Message stored in transaction payload
Category Overview
This section contains documentation related to blockchain node setup, synchronization, and network configuration.
Manual index