Name registration

Activate a public name on registry.grid so Mesh, capacity ads, and the directory can list you. Fee is paid only via Cash App to $Caraveo.

UI flow: https://grid-compute.com/registry. Same backend as the API below.

Read

GET/api/registry/register

Directory + fee info when called with no query.

GET/api/registry/register?name=garage

Availability check for a candidate name.

GET/api/registry/register?id=reg_…

Status of a registration you started (id from POST).

bash

# Fee + public directory
curl -sS https://grid-compute.com/api/registry/register | jq '{feeUsd: .feeUsd, cashtag: .cashtag, payment}'

# Is "garage" free?
curl -sS 'https://grid-compute.com/api/registry/register?name=garage' | jq .

Start registration

POST/api/registry/register

Body action start returns a payment note and Cash App deep link.

bash

curl -sS -X POST https://grid-compute.com/api/registry/register \
  -H 'content-type: application/json' \
  -d '{
    "action": "start",
    "name": "garage",
    "label": "Garage node",
    "class": "S",
    "region": "NA-W",
    "nodeId": "node_macmini",
    "kinds": ["node", "compute"]
  }' | jq .

Typical success payload includes:

id — registration id
paymentNote — exact note for Cash App
feeUsd — usually 5.00
Cash App pay URL with amount + note

Confirm payment

bash

curl -sS -X POST https://grid-compute.com/api/registry/register \
  -H 'content-type: application/json' \
  -d '{
    "action": "confirm",
    "id": "reg_…",
    "cashConfirm": "optional confirmation text from Cash App"
  }' | jq .

After confirm, status moves to pending_review until human review marks it active. Only active names appear in GET /api/registry.

Statuses

Status	Meaning
pending_payment	Awaiting Cash App send with exact note
pending_review	Payment claimed — waiting on human review
active	Listed on registry.grid
rejected	Not activated (name may be retried per policy)

Kinds

Register as node, compute, or both. To show up as capacity on registry.grid you need the compute kind (and later capacity heartbeats). To show as a mesh node identity, include node.