Everything minerai does, in the open.

// 01 · status

What works today

We only call something live when it runs in production. Everything else is marked for what it is.

// 02 · quickstart

Your first request in two minutes

1. Sign in with a Solana wallet in the app: Phantom, Solflare, Backpack, or a minerai wallet created in your browser. Then deposit $MINERAI: your balance is $MINERAI, one for one, and nothing is free.
2. Copy your API key from the bottom left of the app, or from the API page. It starts with mk_.
3. Call the API with any OpenAI client. Only the base URL and the key change.

curl {{BASE}}/v1/chat/completions \
  -H "Authorization: Bearer $MINERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minerai-1",
    "messages": [{"role": "user", "content": "Write a debounce function in TypeScript"}]
  }'

import os
from openai import OpenAI

client = OpenAI(base_url="{{BASE}}/v1", api_key=os.environ["MINERAI_API_KEY"])

reply = client.chat.completions.create(
    model="minerai-1",
    messages=[{"role": "user", "content": "Write a debounce function in TypeScript"}],
    extra_body={"connectors": ["web", "github"]},
)
print(reply.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "{{BASE}}/v1", apiKey: process.env.MINERAI_API_KEY });

const stream = await client.chat.completions.create({
  model: "minerai-1",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
  stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

// 03 · terminal

minerai in your terminal

One command installs minerai. It is an AI agent for your projects, and the same command mines. It updates itself.

irm {{BASE}}/install.ps1 | iex

curl -fsSL {{BASE}}/install.sh | sh

Inside the agent: /model, /models, /balance, /clear, /yes (approve everything), /exit. The agent can only touch files inside the folder you start it in.

// 04 · architecture

The life of a request

Three parts: your app, the router, and the miners. Click a step to see what happens there.

1. Authentication. The router hashes your key and finds your account. Only the SHA-256 of keys is stored.
2. Limits. 20 requests per minute and 2 in parallel per IP. The answer length is capped by your balance, so you are never billed more than you hold.
3. Connectors. If you turned them on, the router fetches fresh data and gives it to the model as numbered, untrusted sources.
4. Dispatch. A miner is picked at random, weighted by reputation. You can't choose your miner, and neither can anyone else.
5. Streaming. The miner generates on its GPU and streams through the router. If it fails before the first word, another miner takes over.
6. Billing and receipt. The router bills the request, signs a receipt, and books 80% of the cost to the miner.

// 05 · api

API reference

The API follows OpenAI's Chat Completions format. Send your key as Authorization: Bearer mk_…. Base URL: {{BASE}}/v1.

POST /v1/chat/completions

Responses add a minerai object with the request's cost, your remaining balance in credits (that is, $MINERAI), and, with connectors, the tools used and their sources.

Try it

The answer streams here. Each run spends a little $MINERAI from your balance.

Other endpoints

Errors

// 06 · connectors

Fresh data, fetched by the router

Connectors run on the router, never on a miner's PC. Their results reach the model as numbered sources it cites as [1], [2], framed as untrusted text so a web page can't give it orders. Each successful call costs 0.5 $MINERAI, with at most 4 per request.

// 07 · pricing

A stable price, paid in $MINERAI

Your balance is $MINERAI, one for one: deposit 1,000 $MINERAI and your balance is 1,000. Requests have a fixed price in dollars and are paid in $MINERAI at the token's average price over the last hour. The higher the coin, the fewer tokens a request takes, so the AI stays affordable and miners keep a steady income whatever the market does.

Every $MINERAI you spend is split: 80% to the miner who served you, 10% burned for good, 10% to the treasury. Holders of 1,000,000 $MINERAI or more (in their wallet plus their balance) pay 20% less.

The flywheel

Everything that comes in ends up as demand for $MINERAI, and everything that goes out is held or burned:

• Pay with SOL or USDC. Your wallet can pay in $MINERAI, SOL or USDC. SOL and USDC are taken at their dollar value, and every few minutes the treasury buys $MINERAI with them on the market (Jupiter). Every answer is a buy.
• Miners stake to mine. A miner's reward wallet lets the treasury take an amount of $MINERAI: that's its stake, and the tokens never leave the wallet. More stake brings up to 3× more answers; below the minimum, no answers. A miner banned for cheating loses part of its stake, burned.
• The treasury burns. Each week, half of the treasury's 10% is burned, on chain, with the miners' daily payout.
• Holders get more. 20% off from 1,000,000 $MINERAI; the bigger models from 100,000; twice the rate limits.
• Coins launched with minerai pay a small fee in SOL (shown before you sign), bought into $MINERAI.
• Invite & earn. Share your link: for six months you earn 5% of what your friends spend, from the treasury's part.

The stats card shows it all live: answers paid, $MINERAI bought back, staked by miners, burned.

// 08 · wallets

Signing in never moves funds

You sign in by signing a short text message in the standard Sign-In With Solana format. It is not a transaction: it costs nothing and cannot move a single token. Your wallet shows it as a message to sign, with the site's domain, and warns you if the domain doesn't match.

// 09 · privacy

Your conversations are end-to-end encrypted

Conversations sync between your devices, but the router only ever stores ciphertext it cannot read.

One honest limit: to answer you, a miner has to read your prompt. Prompts are in clear text on the router and on one miner while they are being answered. Never paste passwords, private keys or personal data.

// 10 · mining

Lend your GPU, earn from every answer

A miner runs minerai-1 on its graphics card and answers the questions the router sends it. It needs an NVIDIA, AMD or Apple GPU with 8 GB of memory or more.

One command installs everything and starts mining. The Become a miner window in the app writes it for you with your Solana address already in it. Next time, just type minerai mine.

irm "{{BASE}}/install.ps1?wallet=YOUR_SOLANA_ADDRESS" | iex

curl -fsSL "{{BASE}}/install.sh?wallet=YOUR_SOLANA_ADDRESS" | sh

1. Installs the minerai command, and Node.js and Ollama if they are missing (winget on Windows, Homebrew on macOS, the official script on Linux).
2. Downloads the code from this router: the same open-source files as in the repository. Open the install link in a browser to read the script before running it.
3. Prepares minerai-1 on first launch, about 5 GB, only once.
4. Starts mining. Keep the window open; Ctrl+C stops it. No port to open, and only your public address is used.

Bigger models, on their own

When the network unlocks a bigger model, every miner whose card can hold it downloads and installs it in the background, without stopping. Bigger models cost users more per answer, so they pay miners more: minerai-1 Pro pays 2× per token, Coder 3×. A card with more memory earns more. The miner also installs new versions of itself between answers.

Graphics cards

The miner checks your card at startup and warns you if it has less than 8 GB.

// 11 · transparency

Check our numbers yourself

This report is read live from /api/transparency. The rule it checks: what the vault holds must cover what is owed to users and miners.

Every job produces a receipt signed by the router's key, published at /api/network. Payout batches are public at /api/payouts/<date>. Deposits and payouts are Solana transactions anyone can open in an explorer.

// 12 · security

How we protect you, and our limits

What we will never do: ask for your seed phrase or private key, DM you first, ask you to approve a transaction to sign in, or promise returns. Found a vulnerability? Report it privately through GitHub's Security → Report a vulnerability.

// 13 · open source

Read every line

The router, the miner, the app and the training pipeline are open source under Apache 2.0. Everything described on this page can be checked in the code: how keys are hashed, how canaries work, how balances are counted, how conversations are encrypted.

// 14 · faq

Questions people ask