pages / program / onboard_taifoon_hooks

program · onboard_taifoon_hooks

canister coord://offchain/genie/program/onboard_taifoon_hooks@v1/7b03bb5204110b52 · v1 · artifact root 0x7b03bb5204110b52ab57e47d1d66df8c7307a3fe02eea1bb579b5e5ac6916aea · 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

the source

// generated by genie import from lang/gen/venue-onboard.json (taifoon-hooks) — the venue's two agents under the hub rule venue → Taifoon → venue; edit lang/cue/venue-onboard.cue or the registers, not this file.
genie onboard_taifoon_hooks v1
about "taifoon-hooks (erc8183, terms ours): its offers into Taifoon's book and Taifoon's book onto it; every case ends in a sale or a route"

use venue taifoon-hooks
use vault vault:taifoon:ledger
use product taifoon.api jev.grade

agent inbound is "taifoon-hooks's offers into Taifoon's book (work; rail_fallback)"
  onboards taifoon-hooks inbound
  states read classify terms listed agreed metered
  start read
  final metered
  on tick 1h
  read GET /v1/venues as venues
  move read -> classify venue taifoon-hooks
  move classify -> terms
  move terms -> listed venue taifoon-hooks
  move listed -> agreed
  move agreed -> metered meter taifoon.api
  refuse no_route "the case has no resolution in lang/cue/venue-onboard.cue: a work item, never a stop"
  say read "The venue's offers are read (live)"
  say classify "Each offer became one class of the class language"
  say terms "The venue's terms read ours"
  say listed "The offer is listed in Taifoon’s book under the layer’s name"
  say agreed "The seller is paid by x402_base (shadow)"
  say metered "Every call is metered under taifoon.api"
  next read classify "pay the seller on its own venue by x402_base (shadow) (by task)"

agent outbound is "Taifoon's book onto taifoon-hooks (open; direct; 0 cells, 0 USD/7d)"
  onboards taifoon-hooks outbound
  states offer_out listed_on_venue taken hired delivered graded settled legs accrued paid recorded
  start offer_out
  final recorded
  on tick 1h
  read GET /v1/venues as venues
  read GET /v1/match/offers as offers
  move offer_out -> listed_on_venue venue taifoon-hooks
  move listed_on_venue -> taken when hire.paid == true venue taifoon-hooks
  move taken -> hired hop hired venue taifoon-hooks
  move hired -> delivered hop delivered
  move delivered -> graded meter jev.grade hop graded
  move graded -> settled hop settled venue taifoon-hooks
  move settled -> legs hop legs
  move legs -> accrued hop accrued
  move accrued -> paid hop paid
  move paid -> recorded hop recorded
  refuse no_route "the case has no resolution in lang/cue/venue-onboard.cue: a work item, never a stop"
  say offer_out "An offer of Taifoon’s book is ready for the venue"
  say listed_on_venue "The offer is listed on taifoon-hooks (list live)"
  say taken "A buyer on the venue took the offer"
  say hired "The layer hired the seller behind the offer"
  say delivered "The delivery is in and content-checked"
  say graded "System One graded the delivery"
  say settled "The buyer paid in by venue_rail (live)"
  say legs "The legs are written: the seller's price, our fee 20% over it"
  say accrued "Each leg sits on its owner’s account"
  say paid "The seller is paid on its own venue, by claim where no rail pays it"
  say recorded "The sale is recorded"
  next offer_out listed_on_venue "open: nothing blocks this side"

agreement onboard_taifoon_hooks
  parties buyer seller 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:ledger meter taifoon.api
  venue taifoon-hooks
  term "venue → Taifoon → venue: taifoon-hooks sells into the book and buys from it; the buyer pays the seller's price plus our fee 20% over it"

knowledge
  symptom "taifoon-hooks stops short of a sale" caused_by "a step of the side is not live" fixed_by "pay the seller on its own venue by x402_base (shadow) (by task)"
  rule "an onboarding agent ends in a sale or a route, never a stop"