Prerequisites — Run a node
Pentru a rula propriul nod OmbraChain (miner-node + API + P2P), ai nevoie de:
Hardware
| Componentă | Minim | Recomandat |
|---|---|---|
| CPU | 2 cores | 4+ cores |
| RAM | 4 GB | 8 GB |
| Disk | 20 GB SSD | 50 GB SSD |
| Network | 10 Mbps | 100 Mbps |
| GPU (opțional, pentru Ollama mining) | — | RTX 3060+ (12GB VRAM) |
Pentru validator-only mode (fără mining AI local), un VPS mic ($5/lună Linode/DigitalOcean) e suficient.
Pentru mining cu Ollama local (model 70B), recomandat RTX 4090 sau echivalent.
Software
OS
| OS | Status |
|---|---|
| Ubuntu 22.04 LTS | ✅ Testat, recomandat |
| Debian 12 | ✅ Testat |
| Ubuntu 24.04 | ✅ Compatibil |
| Windows 11 | ⚠ Dev/test only (folosește WSL2 sau Ombra Wallet) |
| macOS 14+ | ⚠ Dev/test only |
Producția = Linux strict (systemd unit, firewall, log rotation).
Node.js
Node 22+ obligatoriu (libp2p 3.x require Promise.withResolvers, disponibil din Node 22).
# Verifică versiunea
node --version
# v22.x.x sau superior
Install pe Ubuntu:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
pnpm
pnpm 9+ pentru workspace monorepo:
npm install -g pnpm
pnpm --version
# 9.x.x
Git
sudo apt-get install -y git
Build tools
sudo apt-get install -y build-essential python3
# necesar pentru native modules (libp2p)
Network
Porturi
| Port | Protocol | Direcție | Scop |
|---|---|---|---|
| 9090 | TCP | Inbound | P2P libp2p |
| 3001 | TCP | Inbound | REST API |
| 80/443 | TCP | Inbound | (opțional) HTTPS reverse proxy |
Firewall
sudo ufw allow 9090/tcp comment "Ombra P2P"
sudo ufw allow 3001/tcp comment "Ombra API"
sudo ufw allow 22/tcp comment "SSH"
sudo ufw enable
DNS (opțional)
Pentru a face nodul accesibil public via domain:
A node.yourname.com → YOUR_VPS_IP
Apoi nginx reverse proxy pentru https://node.yourname.com/api/* → localhost:3001.
Cloud providers testați
| Provider | Tier | Cost/lună | Notes |
|---|---|---|---|
| Linode/Akamai | Nanode 1GB | $5 | Validator-only |
| Linode/Akamai | Linode 4GB | $24 | Full miner-node |
| DigitalOcean | Basic 4GB | $24 | OK |
| Hetzner | CPX21 | €5.83 | Best perf/$ EU |
| AWS Lightsail | 4GB | $20 | OK |
| OVH | VPS Comfort | €7 | OK |
Mainnet oficial rulează pe Linode 4GB (172.239.15.32) ca seed peer.
Wallet existent
Trebuie să ai deja un wallet OMBRA (mnemonic salvat) pentru a configura miner-node-ul. Setup wallet:
- Folosește Ombra Wallet desktop → backup mnemonic
- Sau creează un wallet nou direct pe VPS:
node scripts/generate-wallet.mjs# → afișează mnemonic + adresa (ține-le în safe!)
Verificare pre-flight
Înainte de install, verifică:
node --version # >= v22
pnpm --version # >= 9
git --version # >= 2.30
free -h # >= 4GB available RAM
df -h / # >= 20GB free
ufw status # ports 9090, 3001 open
ping ombra-net.com # connectivity
Dacă toate trec → continuă cu Setup.