pages / example / agentic_commerce

example · agentic_commerce

canister coord://offchain/genie/program/agentic_commerce@v1/0db8a3a175a3c092 · v1 · artifact root 0x0db8a3a175a3c09226f1649e46f0aca642d2416dd523b3bceedb1d28156093f9 · previous none (first version) · superroot at publish not sealed yet · follows erc8183

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

the words it says

its helpdesk graph

agentic commerce (a .genie program) in the studio: 6 symptoms, 7 fixes

the source

// _GENIE_v1_ — one sale of inference through the layer: twelve hops, the legs of the payment, the vault it settles through,
// the collector that feeds it, the knowledge a helpdesk answers from, and the door a seller walks through (Show Me Around).
genie agentic_commerce v1
about "Sell inference through the layer: one sale, twelve hops, the legs of the payment, the door a seller walks through"

use venue venice x402-base
use chain every
use vault vault:taifoon:loop
use product taifoon.api jev.grade
use protocol erc8183
use guard owner-arm signer-allowlist value-cap day-cap receipt-check

agent sale is "one sale of inference, seller to buyer through the layer"
  states offer_in classify listed hired delivered graded settled legs accrued split paid recorded refused
  start offer_in
  final recorded refused
  failed refused
  on tick 60s
  read GET /v1/venues/:id as venue
  read GET /v1/match/offers as offers
  move offer_in -> classify when offer.price > 0 hop classify venue venice
  move classify -> listed hop listed op POST /v1/listings/discover venue x402-base
  move listed -> hired when hire.paid == true hop hired op GET /v1/listings/:id
  move hired -> delivered hop delivered op POST /v1/jobs/:jobId/complete
  move delivered -> graded assure 0.7 meter jev.grade hop graded
  move graded -> settled act settler signs evm-carrier settle(bytes32) guard owner-arm signer-allowlist value-cap receipt-check via vault:taifoon:loop on every cap 50000 USDC meter taifoon.api hop settled
  move settled -> legs hop legs
  move legs -> accrued hop accrued
  move accrued -> split hop split
  move split -> paid act releaser signs vault-signer release(bytes32) guard owner-arm day-cap via vault:taifoon:loop on every cap 50000 USDC meter taifoon.api hop paid
  move paid -> recorded hop recorded op POST /v1/jobs/:jobId/record
  move * -> refused when venue.known == false
  refuse open_venue "the venue is not one of the sets"
  refuse cap_over "the settle is over the vault's per_tx cap"
  say listed "Your offer is listed under the layer's name"
  say paid "The seller share left the vault to the seller's own venue"
  next listed hired "Wait for a buyer: the wall is public, the first paid hire moves the sale"
  next delivered graded "Jev grades the delivery; a reject withholds the share"

knowledge
  symptom "the payment did not arrive on the seller venue" caused_by "the settle move stayed behind its guard" fixed_by "arm the vault owner and retry the settle"
  symptom "the offer was read but never listed" caused_by "the class of the offer is not one of the class language" fixed_by "name the class in the offer and read it again"
  rule "every settle stays under the loop vault's per_tx cap"
  term "wall" is "a listing under the layer's name, one per class"

door "Sell your model" as sale
  product agentic-commerce
  locale en
  api https://coord.taifoon.dev
  rule white-label
  step offer_in "Your offer was read from its venue into the layer" next classify
  step classify "The offer's words became one class of the class language" next listed
  step listed "Your offer is listed under the layer's name" next hired
  check GET /v1/listings at listings exists
  step hired "A buyer paid once; the layer hired you behind the wall" next delivered opens delivered
  step delivered "Your answer is in and content-checked" next graded
  step graded "Jev graded the delivery" next settled
  step settled "The buyer's payment settled on your venue" next legs
  step legs "The payment left as named legs that sum to it" next accrued
  step accrued "Each leg sits on its owner's account" next split
  step split "The redirect mode released your share into one batch" next paid
  step paid "The batch was paid, one signature through the vault" next recorded
  step recorded "The sale is recorded; its proof sits under the superroot"
  step refused "The sale was refused; the reason is named below"
  ask "Which venue did you offer on?"
  handoff "the graph has no next step for this case; a person picks up" booking https://cal.com/taifoon meet https://meet.jit.si room genie-sale

vault vault:taifoon:loop
  store receipts "the carrier's receipt of every settle, by envelope id: the vault's own storage under its address"
  grid taifoon.api per_call 1 per_day 100000
  cap USDC every per_tx 50000 per_day 5000000

agreement inference_resale
  parties buyer seller layer
  hops offer_in classify listed hired delivered graded settled legs accrued split paid recorded
  leg our_fee 5%
  leg venue_fee 2.5%
  leg seller_share rest
  settle via vault:taifoon:loop meter taifoon.api
  protocol erc8183
  venue venice x402-base
  term "the seller is paid on its own venue"

collector venice_models
  source https://api.venice.ai/api/v1/models
  every 300s
  header "x-ratelimit-remaining-requests" as remaining
  feeds sale
  stage offer_in when status == 200
  venue venice