Skip to content

DEMO_SCRIPT.md

Latest commit

 

History

History
101 lines (72 loc) · 3.05 KB

DEMO_SCRIPT.md

File metadata and controls

101 lines (72 loc) · 3.05 KB
Raw

Demo Script (~5 Minutes)

Walkthrough for pnpm web:dev (default http://localhost:5173).

Primary Narrative: Escrow-Backed Sealed Auction

Open the Sealed Auction case first. Frame the product as auction settlement infrastructure, not as a general privacy app:

  1. An operator creates a timed auction round.
  2. Bidders lock escrow and submit sealed bids.
  3. No bidder, operator, or keeper can read bids before reveal.
  4. Drand opens the full bid set at the shared reveal time.
  5. Soroban clears the highest valid bid, pays the operator, and refunds losers.
  6. The operator can publish a verifiable receipt for the round.

The recorded evidence view proves the contract lifecycle, settlement, and public audit path.

1. Showcase (30s)

  • Opening: escrow-backed sealed auctions on Stellar
  • Mainnet proof card: settled round 1 on real XLM (link to stellar.expert)
  • Drand chip: live countdown to recorded testnet R (from demo-trace.generated.ts)

2. Seal Attack (45s)

  • Click Run live comparison
  • Seal-off: plaintext bid readable immediately
  • Seal-on: tlock ciphertext undecryptable until R
  • Point: the operator cannot read sealed bids early

3. Flow (30s)

  • Lifecycle timeline: create -> commit -> wait R -> open -> reveal -> clear -> settle
  • Drand banner shows R status
  • Settlement stats: contract balance -> 0

4. Agents + x402 (60s)

  • Position this as supporting proof for autonomous auction bidders.
  • Two agents with principals vs session keys
  • x402 log: 0.10 USDC appraisal settled on-chain
  • Settlement rails panel: x402 appraisal vs SAC settle() winner payment
  • Keeper steps: wait R -> BLS verify -> reveal all -> clear -> settle

5. Observer (20s)

  • Public table: escrow + revealed bids after R
  • Note: identities still auditor-encrypted

6. Auditor (60s)

  • Pre-filled demo auditor secret
  • Decrypt identity blobs -> agent:G... for each bidder
  • Run live bid decrypt -> tlock open against published quicknet R
  • Explain selective disclosure: values public, names auditor-only

7. Caps (30s)

  • Off-chain mandate vs on-chain escrow cap
  • Run negative cap scenarios — unit-test outcomes in browser

8. Passkey (30s, Optional)

  • This build: agents use Ed25519 session mandates
  • Passkey tab: real WebAuthn Create passkey (testnet WASM baked in); optional deploy smart wallet
  • Production path: Smart Account Kit + optional OZ Relayer for fee sponsorship
  • See docs/ECOSYSTEM.md for mapping mandate -> smart-account policy

Optional: Live Contract Poll

Set in apps/web/.env.local (or hosting build env — see docs/DEPLOY.md):

VITE_CONTRACT_ID=CAPTODBCDEVIK23ALBJBS2TXRTIK47ZA5MBTHYF4XLHG2BK7JPYUCU2Y
VITE_ROUND_ID=1
VITE_RPC_URL=https://soroban-testnet.stellar.org

Toggle Poll live contract on Showcase.

CLI Proof

pnpm lifecycle:e2e
pnpm agents:e2e
pnpm mainnet:verify
pnpm keeper:watch

Docs For Reviewers