iHOST — Interchained Hosting Platform

License: GNU General Public License v3.0 Copyright: 2024-2026 Interchained https://interchained.org

A crypto-powered VPS hosting platform with automated DigitalOcean provisioning, atomic USDx balance management, mandatory 2FA, auto-billing, and an integrated support ticket system. Pay for cloud infrastructure entirely in USDx.

Features

• Automated Provisioning — DigitalOcean integration spins up VPS instances on payment confirmation
• USDx Payments — All billing in USDx; atomic Redis Lua scripts for balance deductions
• Mandatory 2FA — TOTP-based two-factor authentication required for all critical operations
• Auto-Billing Worker — Recurring billing cycle with low-balance alerts and auto-suspend
• Support Ticket System — Integrated helpdesk with admin response workflow
• Server Management — Start, stop, rebuild, resize, snapshot via DigitalOcean API

Stack

Layer	Technology
Backend	FastAPI, Redis, DigitalOcean API
Frontend	Next.js 15, React 19, TypeScript
Payments	USDx (internal) — atomic Redis Lua
2FA	PyOTP (TOTP)
Workers	Async billing cycle worker

Quick Start

pip install -r requirements.txt
cp .env.example .env
# Start billing worker separately:
./start_billing_worker.sh
uvicorn main:app --reload --port 8000

Architecture

backend/hosting/
  billing_worker.py      → Recurring USDx billing cycles
  digitalocean.py        → DO API wrapper (provision, manage)
  nowpayments.py         → Crypto top-up via NowPayments
  atomic_balance.py      → Lua-script-based balance operations
  email_notifications.py → Low balance / suspend alerts

Environment Variables

REDIS_URL=redis://localhost:6379/0
JWT_SECRET=<your-secret>
DO_API_TOKEN=<your-digitalocean-token>
NOWPAYMENTS_API_KEY=<your-key>
SMTP_HOST=<your-smtp-host>
SMTP_USER=<your-email>
SMTP_PASS=<your-smtp-password>

License

GNU General Public License v3.0 — see LICENSE