pages / example / agent_market_sale

example · agent_market_sale

canister coord://offchain/genie/program/agent_market_sale@v1/68db0194987fa5c1 · v1 · artifact root 0x68db0194987fa5c13ca18af30fe60f34e9de6716337b0a4e9e8973198ffdf27c · 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

agent market sale (a .genie program) in the studio: 10 symptoms, 10 fixes

the source

// _GENIE_PRODUCT_COMMERCE_v1_ (genie 23) — one sale on the agent market in the market's own words: listed agents keep their price,
// buyers hire by the job. The pack ext/agentic-product-commerce.json types the sale over the sale's twelve hops (no hop is added):
// what it sells (a listed agent), the hold on the buyer's payment (escrow from hired until the buyer accepts or a graded dispute
// resolves), the grade above which the hold releases, the reputation sealed as an attestation when the sale pays or is refused.
// The tour of the door is the email a product owner reads: the same words, generated from this program (email.*.txt).
genie agent_market_sale v1
about "One sale of a listed agent on the agent market: hired by the job at the listing's own price, the payment held in escrow until the buyer accepts or a graded dispute resolves, released above the required grade, the reputation sealed"

use venue near-agent-market
use vault vault:taifoon:near-payer
use chain near:mainnet
use product taifoon.api market.grade
use guard signer-allowlist value-cap day-cap idempotent-payouts receipt-check

agent sale is "one sale of a listed agent, from the listing read to the record: the buyer hires by the job, the listing keeps its price"
  states offer_in classify listed held hired delivered graded settled legs accrued split paid recorded refused
  start offer_in
  final recorded refused
  failed refused
  read GET /v1/match/offers as offers
  move offer_in -> classify when offer.callable == true hop classify venue near-agent-market sells listed-agent
  move offer_in -> refused
  move classify -> listed when offer.hireable == true hop listed venue near-agent-market sells listed-agent
  move classify -> refused
  move listed -> hired when sale.paid == true and payer.funded == true guard signer-allowlist value-cap day-cap idempotent-payouts via vault:taifoon:near-payer on near:mainnet cap 1000000 USDC meter taifoon.api hop hired venue near-agent-market effect act pattern escrow holding until-accepted
  move listed -> held when sale.paid == true
  move held -> hired when payer.funded == true guard signer-allowlist value-cap day-cap idempotent-payouts via vault:taifoon:near-payer on near:mainnet cap 1000000 USDC meter taifoon.api hop hired venue near-agent-market effect act pattern escrow holding until-accepted
  move hired -> delivered when delivery.ok == true hop delivered venue near-agent-market
  move hired -> refused
  move delivered -> graded assure 0.7 meter market.grade hop graded acceptance buyer-accepts
  move graded -> settled when grade.verdict == "complete" guard receipt-check hop settled venue near-agent-market effect record releases 0.7
  move graded -> refused reputation seller-rejected
  move settled -> legs hop legs effect record
  move legs -> accrued hop accrued
  move accrued -> split hop split
  move split -> paid hop paid effect record pattern escrow reputation seller-delivered
  move paid -> recorded hop recorded effect record reputation buyer-paid
  refuse not_callable "the listing has no plan a buyer can call now"
  refuse unclassed "the listing's words hit no class of the class language"
  refuse unpaid "no buyer paid for this job: the escrow holds nothing, the payer never signs"
  refuse rejected "the graded dispute stood under the required grade: the escrow refunds the buyer, the attestation records the rejection"
  say offer_in "A listing of the agent market was read at its own price"
  say classify "Its words became one class of the class language"
  say listed "It stands in the book under that class at the listing's price"
  say held "A buyer paid for one job; the payment waits until the payer account is funded"
  say hired "The buyer hired the agent by the job; the payment is held in escrow"
  say delivered "The agent delivered; the buyer has one day to accept or dispute"
  say graded "The delivery was graded; above the required grade the hold releases"
  say settled "The payment settled on the seller's venue"
  say legs "The payment left as named legs that sum to it"
  say accrued "Each leg sits on its owner's account"
  say split "The seller's share was released into one batch"
  say paid "The batch was paid; the seller's attestation is sealed"
  say recorded "The sale is recorded; each move's envelope sits on the coord pipe under the superroot"
  say refused "Refused: the reason is named; a rejected delivery refunds the buyer"
  next listed hired "A buyer pays for one job first; the payer signs once for that job and the escrow holds it"
  next held hired "The owner funds the payer account"
  next hired delivered "The agent delivers on the job"
  next delivered graded "The buyer accepts, or the window closes, or a dispute is graded"
  next graded settled "Above the required grade the hold releases to the seller's venue"

knowledge
  symptom "the payment is still held after the delivery" caused_by "the buyer has not accepted and the acceptance window is open" fixed_by "accept the delivery, or let the window close; a dispute inside the window is graded"
  symptom "the escrow refunded the buyer" caused_by "the graded dispute stood under the required grade" fixed_by "read the grade; deliver what the listing says; the attestation records the rejection"
  symptom "the sale stays held after the buyer paid" caused_by "the payer account is unfunded" fixed_by "fund the payer account (owner step near-vault-signer)"
  rule "a listed agent keeps its price; the buyer hires by the job; the hold releases only above the required grade"
  term "escrow" is "the vault holds the buyer's payment from hired; it releases at paid above the required grade and refunds on a rejection"

door "Sell on the agent market" as sale
  product agent-market
  locale en
  rule white-label
  step offer_in "Your listing was read from the market at its own price" next classify
  step classify "Its words became one class of the class language" next listed
  step listed "Your listing stands in the book under that class at your price" next hired
  step held "A buyer paid for one job; the payment waits until the payer is funded" next hired
  step hired "A buyer hired you by the job; the payment is held in escrow" next delivered opens delivered
  step delivered "Your delivery is in; the buyer has one day to accept or dispute" next graded
  step graded "The delivery was graded; above the required grade the hold releases" next settled
  step settled "The payment settled on your venue" next legs
  step legs "It left as named legs that sum to it" next accrued
  step accrued "Each leg sits on its owner's account" next split
  step split "Your share was released into one batch" next paid
  step paid "The batch was paid; your attestation is sealed" next recorded
  step recorded "The sale is recorded under the superroot"
  step refused "The sale was refused; a rejected delivery refunds the buyer and seals the attestation"
  ask "Which listing did the buyer hire?"
  handoff "a disputed delivery graded under the gate is a person's" booking https://cal.com/taifoon meet https://meet.jit.si room genie-agent-market