Skip to main content

Perks Marketplace

Discover rewards. Claim with one click. Zero crypto knowledge needed.

The Perks Marketplace at perks.rsnc.network is the consumer-facing storefront where users discover and claim brand perks as NFTs using their earned RSNC credits.

What Users Get​

  • Browse Perks — Discover rewards from all brands in the Resonance network
  • Filter & Search — Find perks by category, price, or brand
  • One-Click Claiming — Burn RSNC credits to claim perks as NFTs, gasless
  • Portfolio — View all claimed NFTs in one place
  • No Crypto Knowledge Required — Privy embedded wallets handle everything

How It Works​

User browses perks at perks.rsnc.network
    ↓
Selects a perk and clicks "Claim"
    ↓
RSNC credits are burned (gasless via relayer)
    ↓
Perk NFT minted to user's wallet
    ↓
Perk appears in user's portfolio

Authentication​

Users sign in via Privy with:

  • Email — Magic link login
  • Google / Apple — Social login
  • Discord — OAuth login
  • External wallets — MetaMask, Coinbase Wallet, etc.

All users get an automatic embedded wallet — no MetaMask or crypto knowledge needed.

Key Features​

Collection Discovery​

Browse all perk collections from brands across the network. Collections display:

  • Perk name and description
  • Price in RSNC credits
  • Available supply and low-stock warnings
  • Brand information

Collection Types​

Not all collections appear in the marketplace browse view:

  • Marketplace perks — Visible in browse, claimable with RSNC
  • Earned items — Items like Gear, Parts, and Ingredients earned through gameplay or crafting. These have their own detail pages but are marked "Earned in-game" and link back to the marketplace
  • Retired collections — Perks from past seasons. No longer mintable, but still visible in your portfolio if you own them

Affordability Indicators​

The marketplace shows whether a user can afford each perk based on their current RSNC balance. Perks display the RSNC amount needed if the user is short.

Gasless Claiming​

Claiming a perk is a blockchain transaction (RSNC burn + NFT mint), but the user pays nothing. The Gas Relayer sponsors all transaction fees.

User Portfolio​

The Mine tab shows all owned perks, including items from retired and past-season collections. Users can view their full collection history and perk details.

Multi-Wallet Balance​

If a user has RSNC spread across multiple linked wallets, the marketplace displays a banner with a link to consolidate funds. The Settings → Wallet tab provides a one-click consolidation tool that batches all source wallets into a single transaction.

Rewards are always minted to the user's embedded wallet to minimize future fragmentation.

Signal Subscription​

Signal is an optional $5/month premium subscription available in Settings → Signal. Subscribers receive:

  • Reduced Dissolver fees — 20% discount on dissolve operations
  • Reduced Transmute fees — 20% discount on transmute operations
  • Discord Subscriber role — Automatically granted and revoked

Payment methods:

  • Credit card via Stripe Checkout
  • USDSC stablecoin (on-chain)

Subscription status, renewal date, and cancellation are managed from the Signal tab.

Account Linking​

Users can link their Discord account to their Privy account, connecting their community identity with their marketplace profile.

Data Flow​

The marketplace reads data from two sources:

  1. Blockchain (primary) — Direct queries to the PerkNFT smart contract on Soneium for real-time collection and balance data
  2. Supabase (optional cache) — Cached collection data for performance

No mock data is used — the marketplace shows real on-chain data or an empty state.

Smart Contracts​

ContractPurpose
PerkNFTPerk collection creation and NFT minting
Resonance Token (RSNC)Credit balance and burns
PointsSaleRSNC purchasing

See Architecture for contract addresses.

For AI Developers​

The Reward Agent and MCP Server can both interact with perks:

  • rsnc_agent_browse_perks — Search perks by category and budget
  • rsnc_agent_redeem_perk — Claim perks for users
  • resonance_list_perks / resonance_redeem_perk (MCP Server)

Next Steps​

Last updated on