pages / example / grid_rpc

example · grid_rpc

canister coord://offchain/genie/program/grid_rpc@v1/7dec38ef5c9410ee · v1 · artifact root 0x7dec38ef5c9410eef916ba0abc294065fac763bc506e775dfb24cde33c7ff660 · previous none (first version) · superroot at publish not sealed yet · follows taifoon_coord

sealed cases that reached it: 0 — sealed cases that reached this word (the store counts, never reads)

the words it says

its helpdesk graph

grid rpc (a .genie program) in the studio: 11 symptoms, 10 fixes

the source

// _GRID_RPC_v1_ (owner 2026-10-29: "those 4x prepare for all of them … make your best to really reach the outside market for each and every").
// RPC as one program of the GRID: a box brings a JSON-RPC endpoint of a chain through the one door (POST /v1/grid/join kind rpc: the URL,
// the chain id, the owner wallet; never a price), is probed for the chain it claims (chain id, genesis for the native chains), listed,
// rotated by the warmbed's health score (a 429 backs it off, then it returns), and serves buyers' metered reads through the gateway
// (/gw/rpc/<chain>: a key or an x402 call), metered on taifoon.rpc; GRID per passing hourly probe is the bootstrap. The outside market the
// same endpoint reaches beside us: the RPC directories (chainlist and the lists), the provider networks (Lava, dRPC) — one row per
// venue the registers already name, so a box owner sees where else the endpoint earns. Nothing here pays, signs or moves value.
genie grid_rpc v1
about "GRID RPC: an endpoint brought once is probed for its chain, rotated by health, serves metered reads through the gateway, is listed on the directories and provider networks the registers name, and its leg is paid by claim"

use venue x402-base sell-chain-lists sell-lava-provider sell-drpc-provider
use chain eip155:8453
use vault vault:taifoon:kms
use product taifoon.rpc sma.case
use protocol taifoon_coord
use guard owner-arm sign-owner-go idempotent-payouts sign-seller-payout day-cap recipient-filter

agent endpoint is "one RPC endpoint on the GRID: brought, probed for its chain, listed, rotated by health, backed off on a 429, serving metered reads, its leg accrued and paid by claim"
  states brought probed listed rotated backed_off served metered accrued claimed recorded no_owner wrong_chain
  start brought
  final recorded no_owner wrong_chain
  failed no_owner wrong_chain
  read GET /v1/grid/join as door
  read GET /v1/grid/economics as economics
  read GET /v1/grid/leaderboard as leaderboard
  move brought -> no_owner when endpoint.owner == null
  move brought -> probed when probe.chain_id == endpoint.chain hop offer_in op POST /v1/grid/join effect record
  move brought -> wrong_chain
  move probed -> listed hop listed effect record
  move listed -> rotated when health.score > 0 hop classify effect record
  move rotated -> backed_off when probe.status == 429
  move backed_off -> rotated when backoff.remaining == 0
  move rotated -> served when order.paid == true hop hired venue x402-base effect record
  move served -> metered meter taifoon.rpc hop delivered effect record
  move metered -> accrued hop accrued effect record
  move accrued -> claimed guard sign-seller-payout idempotent-payouts day-cap recipient-filter via vault:taifoon:kms on eip155:8453 cap 5000000 USDC meter taifoon.rpc hop paid effect record
  move claimed -> recorded hop recorded op POST /v1/pipe/send effect record
  refuse no_owner "an endpoint without an owner wallet is not listed; the owner is who the leg accrues to"
  refuse wrong_chain "the endpoint did not answer for the chain it claims: the chain id or the genesis hash disagreed"
  refuse own_price "an endpoint never names a price; the catalogue prices RPC reads"
  say brought "The endpoint is on the table: its URL, its chain, its owner"
  say probed "Probed: it answered for the chain it claims"
  say listed "Listed on the catalogue; GRID per passing hourly probe from now"
  say rotated "In the warmbed rotation: routed by health score, probed every hour"
  say backed_off "Backed off after a 429; it returns when the backoff ends"
  say served "A buyer's paid read was routed through it"
  say metered "Metered on the buyer's line"
  say accrued "Accrued to the endpoint owner's claim"
  say claimed "Claimed by proof from the ONE vault, inside its caps"
  say recorded "Recorded: the probes, the reads served, the envelopes on the pipe"
  say no_owner "Refused: no owner wallet"
  say wrong_chain "Refused: the chain did not match"
  next brought probed "Run the one command with the URL and the chain id; the layer probes it itself"
  next listed rotated "Keep it answering: the health score routes reads to the endpoints that answer fastest and most often"

agent directory is "the same endpoint on the outside RPC market: listed on the chain lists, enrolled with a provider network, every row from the registers"
  states offered listed_on_lists enrolled_lava enrolled_drpc recorded unlisted
  start offered
  final recorded unlisted
  failed unlisted
  read GET /v1/grid/wanted as wanted
  move offered -> listed_on_lists when endpoint.public == true hop listed venue sell-chain-lists effect record
  move offered -> unlisted
  move listed_on_lists -> enrolled_lava when owner.stake == true hop listed venue sell-lava-provider effect record
  move listed_on_lists -> enrolled_drpc when owner.applied == true hop listed venue sell-drpc-provider effect record
  move listed_on_lists -> recorded hop recorded effect record
  move enrolled_lava -> recorded hop recorded effect record
  move enrolled_drpc -> recorded hop recorded effect record
  refuse unlisted "an endpoint that is not public over https, or carries a key in its URL, is not listed anywhere outside"
  say offered "The endpoint is public: it can be listed outside the GRID too"
  say listed_on_lists "On the chain lists: public reads find it by chain"
  say enrolled_lava "Enrolled as a Lava provider: paid by that network on its own terms (a stake, geolocation, quality of service)"
  say enrolled_drpc "Applied to dRPC's provider network: paid by that network on its own terms"
  say recorded "Recorded: where the endpoint is listed outside"
  say unlisted "Not listed outside: not public, or a key in the URL"
  next offered listed_on_lists "A pull request on the chain lists with the public URL; the GRID row stays as it is"

agent auditor is "the genie auditor: this program reviewed as a case by an agent with a key, graded by the four questions, armed on the owner's go"
  states asked read answered graded armed rejected
  start asked
  final armed rejected
  failed rejected
  move asked -> read when input.program != "" hop classify
  move read -> answered hop delivered asks spec_met unsupported_claim ending cheat_shaped assure 0.7 meter sma.case
  move answered -> graded hop graded
  move graded -> armed when grade.assured == true guard sign-owner-go owner-arm hop recorded effect record
  move graded -> rejected
  refuse not_assured "the review did not stand; the RPC lane stays unarmed and the refusal names the question that failed"
  say asked "The program is on the table: its text, its IR, its delta"
  say answered "Your own agent answered the four questions"
  say graded "Graded and sealed as a case"
  say armed "Armed: the owner's go after a standing review"
  say rejected "Rejected: the review did not stand"

agreement rpc_share
  parties contributor buyer layer
  hops offer_in classify listed hired delivered graded settled legs accrued split paid recorded
  leg our_fee 20% over
  leg seller_share rest
  settle via vault:taifoon:kms meter taifoon.rpc
  protocol taifoon_coord
  venue x402-base
  term "one read served, one settlement, no standing balance: the buyer pays on its venue, the endpoint owner's leg accrues to its claim, the layer's fee is the one margin"
  term "an endpoint never names a price; GRID per passing probe is the bootstrap, never the payout"
  term "every payee is paid by claim from the ONE vault's distributor inside its caps; no person per payout"

vault vault:taifoon:kms
  grid taifoon.rpc per_call 1 per_day 1000000
  grid sma.case per_call 1
  cap USDC eip155:8453 per_tx 5000000 per_day 20000000

knowledge
  symptom "the endpoint joined but is never routed" caused_by "its health score is low: slow answers, errors, or a 429 that put it in backoff" fixed_by "answer under the rotation's latency, stop rate-limiting the oracle's probes; the score recovers and the backoff ends"
  fix "answer under the rotation's latency, stop rate-limiting the oracle's probes; the score recovers and the backoff ends" opens hired
  symptom "the endpoint earns GRID but no USDC" caused_by "no buyer's metered read was routed through it yet, or the community payout cap is not set" fixed_by "stay in the rotation; every routed read accrues its provider leg once the community payout cap is set"
  fix "stay in the rotation; every routed read accrues its provider leg once the community payout cap is set" opens paid
  rule "the probe is the proof: chain id and genesis on join, liveness and latency every hour; a self-reported chain counts for nothing"
  rule "the same endpoint earns outside too: the chain lists take a public URL; Lava and dRPC pay providers on their own terms"
  rule "the layer's own endpoints join through the same door and are probed the same way; their leg is retained, never paid out"
  policy "the ONE vault releases inside its caps per transfer and per UTC day until the owner raises them"

door "Bring an RPC endpoint to the GRID" as endpoint takes owner: string url: string chain: int
  product taifoon.rpc
  step brought "Name the endpoint: your wallet, its https URL, its chain id" next probed
  step probed "The layer probes the chain it claims" next listed opens listed
  step listed "Listed; GRID per passing hourly probe" next rotated
  step rotated "In the rotation: routed by health score" next served
  step backed_off "Backed off after a 429; back when it ends" next rotated
  step served "A buyer's paid read routed through you" next metered
  step metered "Metered on the buyer's line" next accrued
  step accrued "Accrued to your claim" next claimed
  step claimed "Claimed by proof from the ONE vault" next recorded
  step recorded "Recorded: probes, reads, envelopes"
  handoff "Talk to Taifoon about your endpoint" booking https://taifoon.io meet https://taifoon.io room genie-grid-rpc

door "List the same endpoint on the outside RPC market" as directory takes url: string
  product taifoon.rpc
  step offered "Your endpoint is public over https" next listed_on_lists opens listed_on_lists
  step listed_on_lists "A pull request on the chain lists" next enrolled_lava
  step enrolled_lava "Enroll as a Lava provider (their stake, their terms)" next recorded
  step enrolled_drpc "Apply to dRPC's provider network (their terms)" next recorded
  step recorded "Recorded: where it is listed outside"
  handoff "Talk to Taifoon about the outside market" booking https://taifoon.io meet https://taifoon.io room genie-grid-rpc-market

door "Review the RPC program with the genie auditor" as auditor takes program: string
  product sma.case
  step asked "Paste the program or name it" next read
  step read "Its IR and its delta are on the table" next answered
  step answered "Your own agent answers the four questions" next graded
  step graded "Graded and sealed as a case" next armed opens armed
  step armed "The owner's go"
  handoff "A human reviewer" booking https://cal.com/taifoon meet https://meet.jit.si room genie-grid-rpc-audit