Docs

Everything WYRP, explained.

WYRP is a live compute grid stitched together from idle graphics cards. Builders send AI jobs and pay per result in USDG. Operators lend their GPUs, run the work, and earn $WYRP. This page covers the whole system: how nodes join, how jobs run, how escrow settles, the token, the contracts, and the API.

The short version

  • • A node is a GPU you register. It gets an agent key and joins the scheduler.
  • • A job is one piece of AI work: an image, a text answer, or a transcript.
  • • Builders fund each job in USDG. That money sits in escrow until the result verifies.
  • • On success, the operator is paid in USDG and credited $WYRP. On failure, the builder is refunded in full.

How a node earns

Register a machine from the console: give it a name, pick its GPU and region, and paste a payout address. You get an agent key instantly, with no approval queue. The node is then eligible for any job whose VRAM requirement it meets.

The scheduler ranks idle nodes by track record, then hands the job to the best fit. While the console is open, your node is considered live. A registered node can be paused or removed at any time, and its payout address can be swapped without re-registering.

How a job runs

A builder submits a job from the console or over the API. The job price in USDG is held in escrow the moment the request lands. The scheduler assigns the work to a node with enough VRAM, the node produces the result, and the result is checked.

When the result verifies, escrow releases: 85% to the operator, 15% to the protocol treasury, and the operator is credited $WYRP on top. If the job fails, the full price refunds to the builder automatically. Nothing is held hostage.

Escrow and settlement

Escrow is the trust layer. Builders never pay a node directly, and nodes never trust builders to pay later. USDG moves through escrow on every job, and the ledger is the same one the on-chain contract mirrors once it is deployed.

Hold

USDG is locked the instant a job is sent.

Release

Funds move to the operator only after verification.

Refund

A failed job returns the full amount to the builder.

The $WYRP token

$WYRP is the operator reward. Every verified job credits $WYRP to the node that ran it, on top of its USDG payout. The token has a fixed supply, no mint, no owner, and open burn. Holding $WYRP in the vault accrues tokenised NVDA pro rata over a 30-day rewards period, claimable or withdrawable at any time. The full contract is on the contract suite page.

API reference

Keys are minted in the console and spend from your USDG balance. The same key works for a script, an agent, or any framework that calls over HTTP.

Authentication

Send the key as a bearer token. Keys are stored hashed, so treat one like a wallet: keep it on the server, never in a client bundle.

header
Authorization: Bearer wyrp_sk_…

Submit a job

POST /api/v1/jobs runs the job immediately and returns when it is verified. Escrow is held before the work starts and released after.

type — image, llm or audio
model — see the pricing table
prompt — up to 4,000 characters
audio_url — required for audio jobs
bash
curl -X POST "$WYRP_HOST/api/v1/jobs" \
  -H "Authorization: Bearer $WYRP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "model": "flux-schnell",
    "prompt": "a rig glowing at night"
  }'
201 response
{
  "job": {
    "id": "job_8f2a91",
    "type": "image",
    "model_label": "FLUX.1 schnell",
    "status": "completed",
    "price_usdg": 0.002,
    "node_name": "garage-4090",
    "gpu_model": "RTX 4090",
    "result_url": "https://…/result.png",
    "checks": ["Result returned", "Spot-check matched", "Escrow released"]
  }
}
audio
curl -X POST "$WYRP_HOST/api/v1/jobs" \
  -H "Authorization: Bearer $WYRP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "audio",
    "model": "whisper-v3",
    "prompt": "Team standup",
    "audio_url": "https://…/standup.ogg"
  }'

Read your jobs

GET /api/v1/jobs returns the last 20 jobs tied to the key, newest first.

bash
curl "$WYRP_HOST/api/v1/jobs" \
  -H "Authorization: Bearer $WYRP_KEY"

Node agent

A registered node gets its own key. Post a heartbeat to keep it scheduled; the console shows the node as live while heartbeats arrive.

bash
while true; do
  curl -s -X POST "$WYRP_HOST/api/v1/nodes/heartbeat" \
    -H "Authorization: Bearer $WYRP_NODE_KEY"
  sleep 60
done

Errors

401Key missing, revoked or unknown.
402Balance cannot cover this job.
400Unknown type or model, missing prompt, missing audio.
502The job failed; escrow was refunded automatically.