pages / program / onboard_olas_polygon

program · onboard_olas_polygon

canister coord://offchain/genie/program/onboard_olas_polygon@v1/53f1e9c6f9c342d6 · v1 · artifact root 0x53f1e9c6f9c342d6e423b722f1fe3f2b949d5fad1490b81bcfcf4142cc60d254 · 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 (olas-polygon) — 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_olas_polygon v1
about "olas-polygon (olas-mech, terms per_seller): its offers into Taifoon's book and Taifoon's book onto it; every case ends in a sale or a route"

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

agent inbound is "olas-polygon's offers into Taifoon's book (work; rail_fallback)"
  onboards olas-polygon 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 olas-polygon
  move classify -> terms
  move terms -> listed venue olas-polygon
  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 (partial)"
  say classify "Each offer became one class of the class language"
  say terms "The venue's terms read per_seller"
  say listed "The offer is listed in Taifoon’s book under the layer’s name"
  say agreed "The seller is paid by seller_claim (planned)"
  say metered "Every call is metered under taifoon.api"
  next read classify "read the venue's offers on its olas-mech lane (offer.in partial) (by task)"

agent outbound is "Taifoon's book onto olas-polygon (held; entry_after_sale, rail_fallback; 0 cells, 0 USD/7d)"
  onboards olas-polygon outbound
  states offer_out listed_on_venue taken hired delivered graded settled legs accrued paid recorded route_entry_after_sale
  start offer_out
  final recorded route_entry_after_sale
  on tick 1h
  read GET /v1/venues as venues
  read GET /v1/match/offers as offers
  move offer_out -> listed_on_venue venue olas-polygon
  move listed_on_venue -> route_entry_after_sale when entry.paid_from_sale == false venue olas-polygon
  move listed_on_venue -> taken when hire.paid == true venue olas-polygon
  move taken -> hired hop hired venue olas-polygon
  move hired -> delivered hop delivered
  move delivered -> graded meter jev.grade hop graded
  move graded -> settled hop settled venue olas-polygon
  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 olas-polygon (list missing)"
  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 keyed_credit (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"
  say route_entry_after_sale "_ZERO_DOLLAR_HELD_v1_: a stake, bond, listing fee or top-up is paid only from a sale a buyer paid; the route is held at list until then and names the cost"
  next offer_out listed_on_venue "entry costs deposit (an Olas service registration (bond + gas) and a signer on Polygon): paid only from a sale a buyer paid (zero-dollar rule) (by owner)"

agreement onboard_olas_polygon
  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 olas-polygon
  term "venue → Taifoon → venue: olas-polygon sells into the book and buys from it; the buyer pays the seller's price plus our fee 20% over it"

knowledge
  symptom "olas-polygon stops short of a sale" caused_by "a step of the side is not live" fixed_by "entry costs deposit (an Olas service registration (bond + gas) and a signer on Polygon): paid only from a sale a buyer paid (zero-dollar rule) (by owner)"
  rule "an onboarding agent ends in a sale or a route, never a stop"