stoa/docs/DEMO_SCRIPT.md
stoa 564cdc0388 refactor(story): lead with 6 commerce skills + add @stoa/sdk, one-command demo, submission docs
Executes docs/plan.md strategic refocus:
- @stoa/sdk: StoaClient developer-facing commerce client (wraps verified skills)
- commerce/ skill grouping (stoaCommerceSkills) — flagship skills made obvious
- examples/99-full-commerce-loop.ts + pnpm demo:full / pnpm win
- HACKATHON.md, docs/DEMO_SCRIPT.md, docs/WINNING_FLOW.md, NOTICE
- README reframed: lead with commerce, catalog repositioned as supporting toolkit
- complete .env.example (demo keys + all 13 contract addresses)
All 6 packages typecheck clean; 16 skill tests + 54 contract tests green.
2026-06-12 00:25:38 +03:00

1.8 KiB

Demo Script

The judge-facing demo is one command that runs the full agent-commerce loop:

pnpm demo:full

(Backed by packages/examples/src/99-full-commerce-loop.ts, driven by @stoa/sdk's StoaClient.)

Setup

cp .env.example .env
# fill: MERCATOR_BUYER_KEY, MERCATOR_SELLER_KEY, PHAROS_RPC_URL,
#       STOA_REGISTRY_ADDRESS, STOA_ESCROW_ADDRESS, STOA_SERVICES_ADDRESS, STOA_SOCIAL_ADDRESS
# (deploy first with `pnpm contracts:deploy`, or load deployments/<network>.json)

Narrated output

Stoa — Agent Commerce Loop  (discover → trust → hire → pay → settle → rate)

[1] Seller (Atlas) registered identity
    agentId: 1
    tx: 0x…

[2] Seller listed an x402-paid service
    serviceId: 1
    tx: 0x…

[3] Buyer discovered services
    capability: research
    serviceIds: 1

[4] Buyer checked seller reputation
    count: 0
    averageX100: 0

[5] Buyer created escrow job
    jobId: 1
    tx: 0x…

[6] Buyer paid the x402 endpoint        (skipped unless X402_FACILITATOR_URL is set)

[7] Buyer released escrow milestone
    tx: 0x…

[8] Buyer wrote a reputation attestation
    score: 5
    tx: 0x…

✓ Commerce loop complete — discover → trust → hire → pay → settle → rate

What it proves

The same skills an external developer would install power the entire loop: discovery (service_listing), trust (agent_identity + reputation), hiring (agent_escrow), payment (x402_pay), settlement (escrow release), and rating (reputation). No private shortcuts — the demo is pure composition of the public skills via StoaClient.

2-minute video voiceover

See HACKATHON.md for the pitch; the recommended voiceover walks through the eight steps above, emphasizing that every step is a real Pharos transaction and that the same skills drive the Phase 2 Mercator agent.