pages / program / onboard_acpv3_arc

program · onboard_acpv3_arc

canister coord://offchain/genie/program/onboard_acpv3_arc@v1/31b58b8ea114148f · v1 · artifact root 0x31b58b8ea114148fd351f2af50b0a094e6dcedc2e7338a0c7a4d98ea9e96a38e · 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 (acpv3-arc) — 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_acpv3_arc v1
about "acpv3-arc (erc8183, 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 acpv3-arc
use vault vault:taifoon:ledger
use product taifoon.api jev.grade

agent inbound is "acpv3-arc's offers into Taifoon's book (work; rail_fallback)"
  onboards acpv3-arc 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 acpv3-arc
  move classify -> terms
  move terms -> listed venue acpv3-arc
  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 erc8183 lane (offer.in partial) (by task)"

agent outbound is "Taifoon's book onto acpv3-arc (work; direct; 0 cells, 0 USD/7d)"
  onboards acpv3-arc 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 acpv3-arc
  move listed_on_venue -> taken when hire.paid == true venue acpv3-arc
  move taken -> hired hop hired venue acpv3-arc
  move hired -> delivered hop delivered
  move delivered -> graded meter jev.grade hop graded
  move graded -> settled hop settled venue acpv3-arc
  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 acpv3-arc (list partial)"
  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 "list our offers on the venue's erc8183 lane (list partial) (by task)"

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

knowledge
  symptom "acpv3-arc stops short of a sale" caused_by "a step of the side is not live" fixed_by "list our offers on the venue's erc8183 lane (list partial) (by task)"
  rule "an onboarding agent ends in a sale or a route, never a stop"