9e59d0c912
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 5s
Deploy to Testnet / deploy-testnet (push) Has been cancelled
Documentation Validation / validate-docs (push) Has started running
Documentation Validation / validate-policies-strict (push) Has been cancelled
Node Failover Simulation / failover-test (push) Has been cancelled
Multi-Node Stress Testing / stress-test (push) Has been cancelled
- Update infrastructure/SYSTEMD_SERVICES.md: coordinator API port 8000 → 8011 - Update reference/PORT_MAPPING_GUIDE.md: coordinator API port 8000 → 8011 - Update guides/getting-started/2_installation.md: health check and troubleshooting port 8000 → 8011 - Update guides/getting-started/3_cli.md: coordinator API URL and health check port 8000 → 8011 - Coordinator API is now on port 8011 (not 8000) - More documentation files still need updates
107 lines
2.4 KiB
Markdown
107 lines
2.4 KiB
Markdown
# Installation
|
|
|
|
## Prerequisites
|
|
|
|
- Python 3.13+
|
|
- Git
|
|
- (Optional) PostgreSQL 14+ for production
|
|
- (Optional) NVIDIA GPU + CUDA for mining
|
|
|
|
## Security First Setup
|
|
|
|
**⚠️ IMPORTANT**: AITBC has enterprise-level security hardening. After installation, immediately run:
|
|
|
|
```bash
|
|
# Run comprehensive security audit and hardening
|
|
./scripts/comprehensive-security-audit.sh
|
|
|
|
# This will fix 90+ CVEs, harden SSH, and verify smart contracts
|
|
```
|
|
|
|
**Security Status**: 🛡️ AUDITED & HARDENED
|
|
- **0 vulnerabilities** in smart contracts (35 OpenZeppelin warnings only)
|
|
- **90 CVEs** fixed in dependencies
|
|
- **95/100 system hardening** index achieved
|
|
|
|
## Monorepo Install
|
|
|
|
```bash
|
|
git clone https://github.com/oib/AITBC.git
|
|
cd aitbc
|
|
python -m venv .venv && source .venv/bin/activate
|
|
pip install -e .
|
|
```
|
|
|
|
This installs the enhanced AITBC CLI, coordinator API, and blockchain node from the monorepo.
|
|
|
|
## Verify CLI Installation
|
|
|
|
```bash
|
|
# Check CLI version and installation
|
|
aitbc --version
|
|
aitbc --help
|
|
|
|
# Test CLI connectivity
|
|
aitbc blockchain status
|
|
```
|
|
|
|
Expected output:
|
|
```
|
|
AITBC CLI v0.1.0
|
|
Platform: Linux/MacOS
|
|
Architecture: x86_64/arm64
|
|
✓ CLI installed successfully
|
|
```
|
|
|
|
## Environment Configuration
|
|
|
|
### Coordinator API
|
|
|
|
Create `apps/coordinator-api/.env`:
|
|
```env
|
|
JWT_SECRET=your-secret-key
|
|
DATABASE_URL=sqlite:///./data/coordinator.db # or postgresql://user:pass@localhost/aitbc
|
|
LOG_LEVEL=INFO
|
|
```
|
|
|
|
### Blockchain Node
|
|
|
|
Create `apps/blockchain-node/.env`:
|
|
```env
|
|
CHAIN_ID=ait-devnet
|
|
RPC_BIND_HOST=0.0.0.0
|
|
RPC_BIND_PORT=8006 # Updated to new blockchain RPC port
|
|
MEMPOOL_BACKEND=database
|
|
```
|
|
|
|
## Systemd Services (Production)
|
|
|
|
```bash
|
|
cp systemd/aitbc-*.service /etc/systemd/system/
|
|
systemctl daemon-reload
|
|
systemctl enable --now aitbc-coordinator-api
|
|
systemctl enable --now aitbc-blockchain-node-1
|
|
```
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
systemctl status aitbc-coordinator-api
|
|
curl http://localhost:8011/health
|
|
aitbc blockchain status
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
| Problem | Fix |
|
|
|---------|-----|
|
|
| Port in use | `sudo lsof -i :8011` then `kill` the PID |
|
|
| DB corrupt | `rm -f data/coordinator.db && python -m app.storage init` |
|
|
| Module not found | Ensure venv is active: `source .venv/bin/activate` |
|
|
|
|
## Next Steps
|
|
|
|
- [3_cli.md](./3_cli.md) — CLI usage guide
|
|
- [../2_clients/1_quick-start.md](../2_clients/1_quick-start.md) — Client quick start
|
|
- [../3_miners/1_quick-start.md](../3_miners/1_quick-start.md) — Miner quick start
|