Documentation — Coming Soon

NFT Marketplace

Browse, buy, and sell music NFTs — available in a future update

Marketplace Basics

Buy & Sell Music NFTs

The Marketplace is a decentralized platform for trading music NFTs directly within Stori:

  • ✓ Browse NFTs: Explore music from creators worldwide
  • ✓ Audio Preview: Listen before you buy via IPFS streaming
  • ✓ Album Artwork: Full artwork display from IPFS
  • ✓ Filtering: Search by genre, price, creator, license type
  • ✓ Wallet Integration: Connect Core wallet for purchases
  • ✓ My Collection: View and manage your owned NFTs
  • ✓ Creator Dashboard: Track sales and royalties
đŸĒ

Marketplace browse view with NFT cards

🔍 Browsing & Discovery

📊 Browse Views

  • Grid View - Card-based layout
  • List View - Detailed information
  • Featured - Curated selections
  • New Releases - Recently minted
  • Trending - Popular tracks
  • Top Sellers - Best-selling NFTs

🎨 Filters

  • Genre - Electronic, Hip Hop, Rock, etc.
  • License Type - Ownership, Streaming, etc.
  • Price Range - Min/max TUS amount
  • Creator - Filter by specific artist
  • Date Listed - Recent or older
  • Audio Length - Duration filters

🔎 Search

  • Text Search - Search titles and descriptions
  • Tag Search - Search by tags
  • Creator Search - Find by wallet address
  • Token ID Search - Look up specific NFT
  • Real-Time Results - Instant filtering

đŸŽĩ Audio Preview

  • Click to Play - Stream from IPFS
  • Play/Pause Control - Toggle playback
  • Waveform Display - Visual representation
  • Progress Bar - Track playback position
  • Volume Control - Adjust playback level
  • Auto-Cleanup - Stops when modal closed

📸 NFT Cards

  • Album Artwork - From IPFS storage
  • Track Title - NFT name
  • Creator Name - Artist/wallet
  • Price - In TUS tokens
  • License Type Badge - Rights indicator
  • Play Button - Quick audio preview

ℹī¸ Detail View

  • Full Metadata - Complete information
  • Track Listing - All audio stems
  • Ownership Info - Co-creator shares
  • Transaction History - Sales record
  • IPFS Links - Content IDs
đŸ’ŗ

Purchase flow with wallet confirmation

Buying NFTs

Purchase Workflow

Complete process for buying music NFTs:

  • 1 Connect Wallet: Ensure Core wallet is connected
  • 2 Browse Marketplace: Find NFT you want to purchase
  • 3 Preview Audio: Click play button to listen
  • 4 Click Buy: Opens purchase confirmation modal
  • 5 Review Details: Price, license type, creator info
  • 6 Confirm Purchase: Approve transaction in wallet
  • 7 Wait for Confirmation: Transaction processes (~1-2 seconds)
  • 8 NFT Received: Appears in "My Collection" view
Creating Listings

Sell Your Music NFTs

Create listings to sell licenses from your Digital Masters:

  • ✓ My Digital Masters: View → My Digital Masters tab
  • ✓ Select Master: Click the Digital Master NFT you want to sell from
  • ✓ Create License: Click "Create License" button
  • ✓ Choose License Type: Select from 5 license types
  • ✓ Set Price: Enter price in TUS tokens
  • ✓ Set Quantity: How many licenses to mint
  • ✓ Set Restrictions: Time limits, play limits, etc.
  • ✓ Create Listing: Mint and list licenses on marketplace
🏷ī¸

Create license listing interface

đŸ’ŧ Managing Your Collection

👑

My Digital Masters

View and manage your original creations (ERC-721 NFTs):

  • All minted Digital Masters
  • Co-ownership displays
  • Create license listings
  • View sales history
  • Track royalty earnings
  • Transfer ownership
đŸ’ŋ

My Licenses

View licenses you've purchased (ERC-1155 NFTs):

  • All owned license NFTs
  • Play/download based on rights
  • Resell Full Ownership licenses
  • View expiration dates
  • Track remaining plays
  • License details and restrictions
📊

Activity feed with transaction history

Activity & Analytics

Track Your Activity

Monitor marketplace activity and your transactions:

  • ✓ Activity Feed: Real-time marketplace events
  • ✓ Your Transactions: Personal buy/sell history
  • ✓ Sales Analytics: Track revenue and royalties
  • ✓ Play Counts: How many times each track was played
  • ✓ Revenue Dashboard: Total earnings breakdown
  • ✓ Royalty Tracking: Secondary sales royalty income
  • ✓ Transaction Details: Block explorer links for verification

💰 Creator Royalties & Revenue

đŸ’ĩ Primary Sales (First Sale)

Sale Price: 10.0 TUS

Platform Fee (1%): -0.1 TUS

Creator Receives: 8.9 TUS (89%)

Co-Creators Split 8.9 TUS:
â€ĸ Artist (50%): 4.45 TUS
â€ĸ Producer (30%): 2.67 TUS
â€ĸ Songwriter (20%): 1.78 TUS

🔄 Secondary Sales (Resale)

Resale Price: 15.0 TUS

Original Creator Royalty (10%): 1.5 TUS

Platform Fee (1%): 0.15 TUS

Seller Receives: 13.35 TUS (89%)

✨ Forever Royalties: Original creators earn 10% on every resale, automatically, forever.