Deployment

System Requirements

View as Markdown

The platform is a polyglot stack with three runtime services (API, Portal, Blockchain RPC client) and two stateful services (Postgres, Redis). Smart-contract deployment is a one-time operation and requires Hardhat-compatible tooling.

ComponentMinimum (single-node dev)Recommended (production)
CPU2 vCPU8 vCPU per API pod (HPA target 60%)
RAM8 GB16 GB per node; 4 GB per API pod
Disk20 GB SSD200 GB SSD for Postgres data; 50 GB for logs
Network100 Mbps1 Gbps with private subnet for DB/Redis
OSmacOS 13+, Ubuntu 22.04+, or any Linux with kernel 5.xUbuntu 22.04 LTS or RHEL 9

14.1.2 Software prerequisites

DependencyVersionUsed by
Docker24+All services in dev / Compose deployments
Docker Composev2+make dev, make docker-up
kubectl1.28+K8s deployments
Helm3.14+Optional — chart-based install
Go1.22Build API from source
Node.js≥ 20Portal, SDK, Blockchain (Hardhat)
npm≥ 10Workspaces
PostgreSQL16-alpine (Compose) or 16+ managedPrimary data store
Redis7-alpineSessions, OTP, ZK challenges, rate-limit buckets
golangci-lintlatestLint Go code (CI)
SolhintlatestLint Solidity (CI)

14.1.3 Outbound network requirements

The API server must be able to reach:

DestinationPortPurpose
ADI RPC endpoint (BLOCKCHAIN_RPC)443 (HTTPS) or 8545 (dev)All on-chain operations
Resend SMTP API (api.resend.com)443OTP email delivery
Google OAuth (accounts.google.com, oauth2.googleapis.com)443Google sign-in
GitHub OAuth (github.com, api.github.com)443GitHub sign-in
Object storage (S3 / R2 / GCS)443Backup uploads

14.1.4 Browser requirements (Portal)

  • Evergreen Chromium-family (Chrome, Edge, Brave) ≥ 110.
  • Firefox ≥ 110, Safari ≥ 16.
  • WebCrypto API + crypto.subtle (required for Ed25519 verification in browser).
  • WebAssembly enabled (required for browser-side ZK proof generation).