# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SCVD General Store Paywall API
  version: 1.0.0
extends: openapi/scvd-store-paywall-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/api/paywall/binder/{wallet}'].get
  update:
    x-apievangelist-phrasing:
      intent: List the cards a wallet has pulled
      effect: read
      questions:
      - Which trading cards has a wallet pulled, newest first?
      - Is a wallet's binder listing proof that it owns the cards?
      instructions:
      - text: Show the binder for wallet {wallet}.
        slots:
          wallet: path.wallet
      - text: List every pressing {wallet} has pulled.
        slots:
          wallet: path.wallet
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/seed/{date}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the day seed and its commit
      effect: read
      questions:
      - Can I recompute a day's pack pulls from the published seed?
      - When is the day seed revealed after its commit?
      instructions:
      - text: Get the day seed for {date}.
        slots:
          date: path.date
      - text: Fetch the seed commit for {date} so I can verify the pulls.
        slots:
          date: path.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/set'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the season's card set
      effect: read
      questions:
      - Which cards are in the season set and how rare is each?
      - How many of each card have been pressed so far?
      instructions:
      - text: Get the season set as JSON.
      - text: List every card in the set with its rarity and print count.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/window'].get
  update:
    x-apievangelist-phrasing:
      intent: See the shop window's last five pressings
      effect: read
      questions:
      - Which five cards were pulled most recently store-wide?
      - What is in the shop window right now?
      instructions:
      - text: Show the shop window.
      - text: List the last five pressings pulled at the store.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/releases'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the release wheel for one-of-one cards
      effect: read
      questions:
      - When will the one-of-one Keeper and CV cards be released?
      - Has any one-of-one card landed this season?
      instructions:
      - text: Get the release wheel.
      - text: Show the committed milestones for the one-of-one cards.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/challenge'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a credit-desk challenge to sign
      effect: write
      questions:
      - How do I get a challenge to sign before burning or redeeming cards?
      - How long is a credit desk challenge valid?
      instructions:
      - text: Get a credit desk challenge for {address}.
        slots:
          address: requestBody.address
      - text: Request a nonce for wallet {address} to sign for a burn or redeem.
        slots:
          address: requestBody.address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/burn'].post
  update:
    x-apievangelist-phrasing:
      intent: Burn duplicate cards into pack credit
      effect: destructive
      questions:
      - Can I trade in duplicate commons for a pack of credit?
      - How many uncommons does it take to burn into one pack credit?
      instructions:
      - text: Burn cards {card_ids} from {address} with signature {signature}.
        slots:
          card_ids: requestBody.card_ids
          address: requestBody.address
          signature: requestBody.signature
      - text: Turn duplicate cards {card_ids} into pack credit for wallet {address}, signed {signature}.
        slots:
          card_ids: requestBody.card_ids
          address: requestBody.address
          signature: requestBody.signature
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/paywall/redeem'].post
  update:
    x-apievangelist-phrasing:
      intent: Spend pack credit on a pack or window pick
      effect: write
      questions:
      - How do I spend a pack of credit I earned from burning cards?
      - Can pack credit buy a shop window pick instead of a pack?
      instructions:
      - text: Redeem one credit from {address} for a {want}, signed {signature}.
        slots:
          address: requestBody.address
          want: requestBody.want
          signature: requestBody.signature
      - text: Spend wallet {address}'s pack credit on {want} using signature {signature}.
        slots:
          address: requestBody.address
          want: requestBody.want
          signature: requestBody.signature
      method: generated
      generated: '2026-09-26'