🔥 Ignit3 — Telegram Bot

Telegram bot interface for Ignit3, a decentralized GPU compute platform on Solana. Built with TypeScript + grammY.

Features

• Dashboard (/start) — live SOL price, network utilization, providers & VRAM online
• ⚡ Run Task — submit a GPU compute job (task name → units → submit)
• 🦊 Get Quote — estimate cost before running, then run it in one tap
• 🖥 Providers — paginated list of GPU providers (region, GPU, price, reliability)
• 🤖 Agents — create / list / view / close persistent agent sessions
• 📁 My Jobs — look up job status by ID, with live progress & results
• 📊 Market — network market stats with 24h change
• 👛 Wallet — connect / refresh / disconnect a Solana wallet (base58 validated), with balance & reputation
• 🎮 GPUs — supported GPU models as a monospace table, sorted by price
• 🔗 Referral — referral code, link, earnings; deep-link attribution on /start ref_XXX; copy & share
• 🏗 Be Provider — multi-step GPU-provider onboarding (GPU → region → wallet check → submit → status)
• 🔔 Notifications — background polling notifies you when a submitted job completes or fails
• 💬 Ask Bot — keyword FAQ about Ignit3
• ⚙️ Settings — per-user API key, wallet, and notification toggle
• Persistent store — JSON-file DB with sensitive fields (API keys, wallets) AES-256-GCM encrypted at rest
• Clean inline-keyboard navigation with in-place message editing and loading states

Setup

npm install
cp .env.example .env   # then fill in TELEGRAM_BOT_TOKEN (+ IGNIT3_API_KEY)

Get a bot token from @BotFather.

Run

npm run dev      # watch mode (tsx)
# or
npm run build && npm start

Demo / mock mode

@ignit3/sdk and api.ignit3.dev are not publicly available yet. To try the bot end-to-end without a live backend, set:

IGNIT3_MOCK=true

This serves deterministic demo data for all API calls (providers, market, quotes, jobs that progress queued → running → completed, sessions, and a simulated SOL price).

Environment variables

Variable	Required	Default	Description
TELEGRAM_BOT_TOKEN	✅	—	Bot token from BotFather
IGNIT3_API_KEY	—	demo-key	Ignit3 API key (Bearer auth)
IGNIT3_BASE_URL	—	https://api.ignit3.dev/v1	API base URL
COINGECKO_API_URL	—	https://api.coingecko.com/api/v3	SOL price source
IGNIT3_MOCK	—	false	Serve built-in demo data
LOG_LEVEL	—	info	Log verbosity
DATABASE_PATH	—	./data/ignit3.json	Persistent store location
DB_ENCRYPTION_KEY	—	TELEGRAM_BOT_TOKEN	Secret for encrypting data at rest
BOT_USERNAME	—	ignit3bot	Used for referral deep links
JOB_POLL_INTERVAL	—	15000	Job notification poll interval (ms)
JOB_POLL_TIMEOUT	—	600000	Max job polling duration (ms)

Project structure

src/
├── index.ts            # Entry point (DB + notifications init, command registration)
├── bot.ts              # Bot instance, command/callback router, error boundary
├── config.ts           # Environment configuration
├── sdk/index.ts        # Vendored @ignit3/sdk (Ignit3Client + types)
├── handlers/           # One module per feature/menu (incl. wallet, gpus, referral, beProvider)
├── services/           # ignit3 facade (+ mock backend), SOL price, notifications
├── db/store.ts         # Encrypted JSON persistence (users, wallets, referrals, prefs)
├── utils/              # keyboards, formatters, validators, conversation state
└── types/              # Shared types

The src/sdk module mirrors the documented @ignit3/sdk API exactly. Once the real package ships, swap the imports in src/services/ignit3.ts for @ignit3/sdk.