pages / example / grid_bonus

example · grid_bonus

canister coord://offchain/genie/program/grid_bonus@v1/8fb01624896305b6 · v1 · artifact root 0x8fb01624896305b630e56e56619de7dd4aab125d265fc8972db30c9af750e716 · previous none (first version) · superroot at publish not sealed yet

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 bonus (a .genie program) in the studio: 21 symptoms, 21 fixes

the source

// _GRID_BONUS_v1_ (owner 2026-10-29: "pre-allocate 1k USDC just for joining in FPGA bonus; the rest, prepare a bonus on joining the GRID,
// and a 1k fixed one-off installation airdrop given to the GRID providers"). Three bonuses, one program, every amount from the register
// (lang/cue/grid-bonus.cue), none typed here: the GRID join bonus (GRID: one day of the kind's live rate credited at a resource's first
// passing probe, settled with the measured ledger), the installation airdrop (USDC: a fixed grant per qualifying install from a one-off
// pool, one per owner wallet, after a UTC day of passing probes), and the FPGA join pool (USDC: a fixed grant per FPGA owner from the
// pre-allocated pool, after the auditor's review). A grant is a claim on the ONE vault's distributor (seller_claims.genie): paid by proof,
// inside the vault's caps, never per person; a pool that is spent refuses. The layer's own boxes are never granted. Nothing here pays,
// signs or moves value: the owner funds the pools and arms the program once; every grant stands behind its guards.
genie grid_bonus v1
about "GRID bonuses: a join bonus in GRID at the first passing probe, a one-off installation airdrop in USDC per qualifying install, a pre-allocated FPGA join pool in USDC; every amount from the register, every grant a claim on the ONE vault"

use chain eip155:8453
use vault vault:taifoon:kms
use product taifoon.api sma.case
use guard owner-arm sign-owner-go idempotent-payouts sign-seller-payout day-cap recipient-filter

agent join_bonus is "the GRID join bonus: a resource's first passing probe credits one day of its kind's live rate in GRID, once per resource, settled with the measured ledger"
  states joined first_probe credited settled recorded ours repeated
  start joined
  final recorded ours repeated
  failed ours repeated
  read GET /v1/grid/economics as economics
  read GET /v1/grid/settlement as settlement
  move joined -> ours when resource.ours == true
  move joined -> repeated when resource.bonus_credited == true
  move joined -> first_probe when probe.ok == true hop offer_in effect record
  move first_probe -> credited hop graded effect record
  move credited -> settled hop settled op GET /v1/grid/settlement effect record
  move settled -> recorded hop recorded op POST /v1/pipe/send effect record
  refuse ours "the layer's own resources earn no bonus; the bonus is for the community's boxes"
  refuse repeated "a resource is credited its join bonus once; a re-join of the same endpoint earns nothing"
  say joined "A resource joined through the one door of its kind"
  say first_probe "Its first probe passed: the bonus is due"
  say credited "Credited: one day of the kind's live rate at that moment, in GRID, on the measured ledger"
  say settled "Settled with the ledger's next run, soulbound, as every measured GRID is"
  say recorded "Recorded: the join, the probe, the credit"
  say ours "Not credited: ours"
  say repeated "Not credited: already credited"
  next joined first_probe "Nothing to do: the first passing probe credits it"

agent install_airdrop is "the one-off installation airdrop: a fixed USDC grant per qualifying install from the pool the owner set, one per owner wallet, after a UTC day of passing probes, paid by claim"
  states installed qualified granted claimed recorded ours repeated spent unqualified
  start installed
  final recorded ours repeated spent unqualified
  failed ours repeated spent unqualified
  read GET /v1/grid/leaderboard as leaderboard
  read GET /v1/grid/claim as claims
  move installed -> ours when owner.ours == true
  move installed -> repeated when owner.airdrop_granted == true
  move installed -> spent when pool.remaining == 0
  move installed -> qualified when probes.passing_day >= 1 hop offer_in effect record
  move installed -> unqualified
  move qualified -> granted guard owner-arm hop accrued effect record
  move granted -> claimed guard sign-seller-payout idempotent-payouts day-cap recipient-filter via vault:taifoon:kms on eip155:8453 cap 5000000 USDC meter taifoon.api hop paid op POST /v1/grid/claim effect record
  move claimed -> recorded hop recorded op POST /v1/pipe/send effect record
  refuse ours "the layer's own boxes are never granted"
  refuse repeated "one airdrop per owner wallet: a second box of the same owner earns none"
  refuse spent "the pool is spent: the register names what it held and what was granted"
  refuse unqualified "an install qualifies after a UTC day of passing probes on a listed resource; a box that joined and went dark earns none"
  say installed "A box installed the node and joined through the one door"
  say qualified "Qualified: a UTC day of passing probes on a listed resource"
  say granted "Granted: a fixed USDC grant from the pool, accrued to the owner's claim"
  say claimed "Claimed by proof from the ONE vault's distributor, inside its caps"
  say recorded "Recorded: the install, the qualifying day, the grant"
  say ours "Not granted: ours"
  say repeated "Not granted: this owner was granted already"
  say spent "Not granted: the pool is spent"
  say unqualified "Not granted yet: no qualifying day"
  next installed qualified "Keep the box answering for a UTC day; the grant follows"
  next granted claimed "Claim it from the distributor by proof, any time; nothing expires"

agent fpga_pool is "the FPGA join pool the owner pre-allocated: a fixed USDC grant per FPGA owner after the auditor's review, one per owner and per endpoint, paid by claim, until the pool is spent"
  states ranked reviewed granted claimed recorded ours repeated spent rejected
  start ranked
  final recorded ours repeated spent rejected
  failed ours repeated spent rejected
  read GET /v1/grid/leaderboard as leaderboard
  move ranked -> ours when owner.ours == true
  move ranked -> repeated when owner.fpga_granted == true
  move ranked -> spent when pool.remaining == 0
  move ranked -> reviewed when review.assured == true hop graded meter sma.case effect record
  move ranked -> rejected
  move reviewed -> granted guard owner-arm hop accrued effect record
  move granted -> claimed guard sign-seller-payout idempotent-payouts day-cap recipient-filter via vault:taifoon:kms on eip155:8453 cap 5000000 USDC meter taifoon.api hop paid op POST /v1/grid/claim effect record
  move claimed -> recorded hop recorded op POST /v1/pipe/send effect record
  refuse ours "the layer's own FPGAs are never granted"
  refuse repeated "one grant per owner wallet and per endpoint"
  refuse spent "the FPGA pool is spent"
  refuse rejected "the review did not stand: the lane challenge, the owner or the endpoint failed a question"
  say ranked "An FPGA answered the lane challenge and is ranked (grid_fpga.genie)"
  say reviewed "Reviewed: the auditor's four questions stood (measured, not proven, is stated as such)"
  say granted "Granted from the pre-allocated pool, accrued to the owner's claim"
  say claimed "Claimed by proof from the ONE vault's distributor, inside its caps"
  say recorded "Recorded: the rank, the review, the grant"
  say ours "Not granted: ours"
  say repeated "Not granted: already granted"
  say spent "Not granted: the pool is spent"
  say rejected "Not granted: the review did not stand"
  next ranked reviewed "The auditor reviews the join as a case; a passing review grants"

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; no bonus is granted 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; the pools open"
  say rejected "Rejected: the review did not stand"

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

knowledge
  symptom "a box joined but saw no join bonus" caused_by "its first probe did not pass, or it is one of the layer's own, or the same endpoint was credited before" fixed_by "pass the first probe of your kind; the bonus is credited once per resource on the measured ledger"
  fix "pass the first probe of your kind; the bonus is credited once per resource on the measured ledger" opens graded
  symptom "an install qualified but nothing was paid" caused_by "the grant accrued to the owner's claim and was not claimed, or the distributor is not armed on the chain" fixed_by "claim from the distributor by proof; the owner arms it and funds the pool once"
  fix "claim from the distributor by proof; the owner arms it and funds the pool once" opens paid
  symptom "the FPGA pool refuses" caused_by "the pool is spent, the owner was granted already, or the review did not stand" fixed_by "read the register: what the pool held, what was granted, what remains"
  fix "read the register: what the pool held, what was granted, what remains" opens paid
  rule "every amount is the register's (grid-bonus.cue): the pools the owner set, the grant per install, the grant per FPGA; nothing here types a number"
  rule "a grant is a claim on the ONE vault's distributor inside the vault's caps; never a transfer per person"
  rule "one per owner wallet and endpoint for the airdrop and the FPGA grant; one per resource for the join bonus"
  rule "the layer's own boxes are never granted a bonus"
  rule "a pool that is spent refuses; the register says what it held and what was granted, read by anyone"
  policy "the ONE vault releases inside its caps per transfer and per UTC day until the owner raises them"

door "Earn the GRID join bonus" as join_bonus takes owner: string kind: string
  product taifoon.api
  step joined "Join through the one door of your kind" next first_probe
  step first_probe "Your first probe passes" next credited opens credited
  step credited "One day of the kind's live rate, in GRID" next settled
  step settled "Settled with the measured ledger" next recorded
  step recorded "Recorded"
  handoff "Talk to Taifoon about the bonus" booking https://taifoon.io meet https://taifoon.io room genie-grid-bonus

door "Claim the installation airdrop" as install_airdrop takes owner: string
  product taifoon.api
  step installed "Install the node; join through the one door" next qualified
  step qualified "A UTC day of passing probes on a listed resource" next granted opens granted
  step granted "A fixed USDC grant from the pool, accrued to your claim" next claimed
  step claimed "Claim it by proof from the ONE vault's distributor" next recorded
  step recorded "Recorded"
  handoff "Talk to Taifoon about the airdrop" booking https://taifoon.io meet https://taifoon.io room genie-grid-airdrop

door "Claim the FPGA join grant" as fpga_pool takes owner: string endpoint: string
  product taifoon.api
  step ranked "Your FPGA is ranked (bring it first)" next reviewed
  step reviewed "The auditor's review stands" next granted opens granted
  step granted "A fixed USDC grant from the pre-allocated pool" next claimed
  step claimed "Claim it by proof from the ONE vault's distributor" next recorded
  step recorded "Recorded"
  handoff "Talk to Taifoon about the FPGA pool" booking https://taifoon.io meet https://taifoon.io room genie-grid-fpga-pool

door "Review the bonus 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; the pools open"
  handoff "A human reviewer" booking https://cal.com/taifoon meet https://meet.jit.si room genie-grid-bonus-audit