POPDOCS
OPEN APP →

// champion qr · vendor usdc · 1:1

REDEMPTION FLOW

$PURPOSE is redeemable 1:1 for USDC at any approved local vendor. Champions never broadcast a transaction — the protocol's backend signer settles every redemption.

The flow

  1. Champion presents a wallet QR code to a vendor in person, or proceeds to checkout in the online shop.
  2. The vendor's device reads the QR and posts it to a Lovable Cloud edge function.
  3. The backend signer calls redeemFor(vendor, champion, amount) on the Vendor Redemption contract.
  4. $PURPOSE is burned from the Champion's wallet.
  5. The vendor wallet receives equivalent USDC from the Treasury — instantly and verifiably on-chain.

Backend signer

The signer holds SETTLEMENT_ROLE on Vendor Redemption. Its private key lives only in Lovable Cloud's secret store as REDEMPTION_SIGNER_PRIVATE_KEY. Every redemption call is authenticated and rate-limited at the edge before signing.

Limits & safety

// never

Vendors and Champions never sign their own redemption transactions. Anyone asking you to sign a "redemption" message in your wallet is attempting to phish you.
  • Vendor must be approved on-chain via approveVendor.
  • Frozen vendors cannot receive payouts.
  • Settlement signer keys can be rotated by master admin.