Overview
Ignit3 is a Solana-native GPU bot protocol. It connects users who need compute with providers who have idle GPUs, pricing, routing, executing, and settling every job on-chain. You reach it through a Telegram bot, a web dashboard, the @ignit3/sdk package, or the REST API.
Architecture at a glance:
User / Agent ──▶ Bot / SDK / API
│
▼
Matching engine ──▶ prices + routes job
│
▼
Anchor program (Solana) ──▶ escrow SOL, record job
│
▼
GPU provider ──▶ executes, returns result hash
│
▼
settle_job() ──▶ release SOL + bump reputationKey concepts: jobs are the unit of work, providers supply GPUs, the reputation oracle scores them 300–850, and x402 lets agents pay per task without accounts.
Getting Started
Install the SDK:
npm i @ignit3/sdkRequest a quote and submit a job:
import { Ignit3Client } from "@ignit3/sdk";
const client = new Ignit3Client({ cluster: "mainnet-beta" });
// 1. Quote
const quote = await client.quote({
task: "stable-diffusion-xl",
gpu: "RTX 4090",
units: 4,
});
console.log(quote.totalSol, quote.estDuration);
// 2. Submit (escrows SOL on-chain)
const job = await client.submit({
task: "stable-diffusion-xl",
units: 4,
prompt: "an ignition spark over Solana",
});
// 3. Poll until complete
const result = await client.wait(job.id);
console.log(result.outputUrl);Prefer the CLI? Quote without writing code:
npx ignit3 quote stable-diffusion-xl 4Or start from chat — open @ignit3_gpu_bot on Telegram and send /run.
Concepts
Jobs
A job moves through a fixed lifecycle: quote → submit → queued → running → completed | failed. SOL escrows at submit and releases only on verified completion. Poll status with the SDK or the REST endpoint.
const job = await client.getJob("job_a1b2c3");
// job.status: "queued" | "running" | "completed" | "failed"
// job.resultHash, job.payoutSol, job.providerScorePricing
Every job carries a flat protocol fee of 1.5–3% (default 2%). The base price is pricePerUnit × units × taskMultiplier; the fee is total × feeBps / 10000. Task multipliers: inference 1.0, analysis 1.2, generation 1.5, training 3.0. You always see the exact cost before submitting.
GPUs
Supported models and reference pricing:
API Reference
REST API
Base URL https://api.ignit3.dev/v1. All requests are JSON.
POST /quote
{ "task": "llama-70b", "gpu": "A100 80GB", "units": 8 }
→ 200 { "totalSol": 0.64, "feeSol": 0.0128, "estDuration": 3.4 }
POST /jobs
{ "task": "llama-70b", "units": 8, "input": { ... } }
→ 201 { "id": "job_d4e5f6", "status": "queued" }
GET /jobs/:id
→ 200 { "id": "job_d4e5f6", "status": "running", "progress": 0.42 }SDK (TypeScript)
The Ignit3Client wraps the REST API and on-chain calls.
const client = new Ignit3Client({
cluster: "mainnet-beta",
wallet, // optional: a Solana signer for on-chain submit
});
client.quote(params) // Promise<Quote>
client.submit(params) // Promise<Job> (escrows SOL)
client.getJob(id) // Promise<Job>
client.wait(id, { timeout }) // Promise<JobResult>
client.listProviders(filter) // Promise<Provider[]>CLI
ignit3 quote <task> <units> # print a price quote
ignit3 run <task> --units 4 # submit a job
ignit3 status <jobId> # check job status
ignit3 providers --gpu "H100 SXM" # list providers
# flags: --json, --cluster, --wallet <keypair>Guides
Provider Setup
Hardware: any supported GPU (RTX 4080 or better) on Linux with a recent NVIDIA/AMD driver. Install the provider agent, then register on-chain.
curl -fsSL https://get.ignit3.dev | sh
ignit3-provider register --wallet ~/.config/solana/id.json
ignit3-provider start # begins accepting jobsNo staking gate. You earn SOL per completed job and build reputation from uptime, speed, and execution quality.
Agent Integration
Agents call the same API but pay per task via x402 — no API keys, no accounts. Include payment in the request and the protocol settles it.
const res = await fetch("https://api.ignit3.dev/v1/jobs", {
method: "POST",
headers: { "X-PAYMENT": x402.sign(quote) },
body: JSON.stringify({ task: "whisper-large", units: 2, input }),
});x402 Payments
x402 lets machines pay machines: a 402 Payment Required response returns a quote, the client attaches a signed X-PAYMENT header, and settlement happens in SOL on Solana. Ignit3 is the first GPU marketplace to support it natively.
Reference
Reputation
A 300–850 score on an on-chain oracle, tracking uptime, speed, reliability, and job quality. Tiers: Bronze 300–499, Silver 500–649, Gold 650–749, Platinum 750–850. Higher tiers win more work and better pay. Improve your score by completing jobs quickly and staying online.