🎯 Marketplace Overview

The NFT Marketplace allows users to create collections, mint unique digital assets, list them for sale, participate in auctions, make offers, and build their creator profile across multiple blockchains. Whether you're an artist, collector, or trader, the platform provides all the tools needed for a complete NFT experience.

Access the marketplace at /nft - browsing is open to all, but creating and trading require authentication and wallet connection.

🚀 Quick Start Guide

1️⃣

Connect Wallet

MetaMask, Coinbase Wallet, or WalletConnect

2️⃣

Create Collection

Deploy your smart contract on supported chains

3️⃣

Mint NFT

Upload art, add metadata, mint to blockchain

4️⃣

List for Sale

Fixed price or auction with royalties

🔗 Wallet Connection

Supported Wallets:

🦊 MetaMask

🔗 Reown AppKit

Connect 300+ wallets including Coinbase, Trust Wallet, Rainbow

📱 Mobile Wallets

Connect mobile wallets via WalletConnect QR code

Supported Networks:

⟠

Ethereum

Chain ID: 1

🟡

BSC

Chain ID: 56

🟣

Polygon

Chain ID: 137

🔵

Arbitrum

Chain ID: 42161

🔴

Optimism

Chain ID: 10

💡 Auto-Network Switching

The platform automatically prompts you to switch networks when needed. Make sure your wallet has native tokens (ETH, BNB, MATIC, etc.) for gas fees.

📦 Creating Collections

Route: /nft/collection/create

Collection Setup Process:

1. Basic Information

• Name: Collection title (1-255 characters, alphanumeric)
• Symbol: Token ticker (1-10 uppercase characters, unique)
• Description: Detailed information about your collection
• Category: Choose from admin-defined categories

2. Visual Assets

• Logo Image: Square collection logo (recommended 500x500px)
• Banner Image: Wide collection banner (recommended 1400x400px)
• Supported formats: PNG, JPG, WebP, GIF

3. Blockchain Settings

• Chain: Select blockchain (ETH, BSC, Polygon, etc.)
• Network: Mainnet or testnet
• Standard: ERC-721 (default)

4. Economic Settings

• Royalty Percentage: Earn 0-50% on secondary sales
• Max Supply: Optional supply cap
• Mint Price: Optional fee to mint from your collection
• Currency: Native token of selected chain

⚠️ Important Notes

• Collections require admin approval before becoming active
• Symbol must be unique across entire marketplace
• Smart contract deployment requires gas fees
• Collections cannot be deleted after NFTs are minted

🎨 Minting NFTs

Route: /nft/create

6-Step Minting Wizard:

Step 1: Select Collection

Choose an active, deployed collection you own. Only approved collections appear here.

Step 2: Connect Wallet

Connect wallet and validate network. System checks:

• Chain ID matches collection blockchain
• Sufficient balance for gas fees
• Wallet signature authorization

Step 3: Provide IPFS Image

Three options to provide your NFT image:

• Upload to platform: Upload image directly (10MB max, PNG/JPG/WebP/GIF)
• Your IPFS URL: Paste your own IPFS URL (ipfs:// or gateway URL)
• IPFS guide provided: Step-by-step instructions for Pinata, NFT.Storage, Web3.Storage

System validates:

• IPFS URL format correctness (CIDv0 and CIDv1 support)
• Gateway URL conversion (ipfs:// → https://)
• No duplicate metadata URIs (prevents reminting same content)

Step 4: Add Details

• Name: NFT title (required)
• Description: Detailed information about the NFT
• External URL: Link to additional content
• Tags: Keywords for discoverability

Step 5: Configure Properties

• Attributes: Key-value pairs (e.g., "Rarity: Legendary", "Color: Blue")
• Royalties: Secondary sale percentage (0-50%, inherits collection default)
• Unlockable Content: Private content revealed to owner only

Step 6: Preview & Mint

Final review with:

• Complete NFT preview
• Gas fee estimation
• Affordability check (warns if low balance)
• One-click mint button

✅ Blockchain Integration

After final review, you sign the mint transaction in your wallet (MetaMask, etc.). The system records the transaction hash, block number, and updates your creator profile. All minting happens directly on the blockchain - you maintain full custody.

💰 Listing NFTs for Sale

Route: /nft/token/[id]/list

3-Step Listing Process:

Step 1: Choose Listing Type

Fixed Price

Set a fixed price for immediate purchase.

• Set asking price in native token
• Optional expiration date
• Instant transactions

Auction

Create a timed auction with bidding.

• Set reserve price (minimum bid)
• Optional buy-now price
• Duration: 1-30 days or custom
• Minimum bid increment
• Anti-snipe auto-extend option

Step 2: Approval Check

System verifies setApprovalForAll for marketplace contract:

• If not approved: prompts wallet approval transaction
• One-time approval per collection
• Gas fee required for approval
• Status tracked automatically

Step 3: Confirm & List

Final review and listing:

• Preview listing details
• Gas estimation display
• Fee breakdown (marketplace + royalty)
• One-click list button

💡 Auction Features

• Reserve Price: Minimum acceptable bid
• Buy Now: Optional instant purchase price
• Anti-Sniping: Auto-extends if bid placed near end
• Automatic Refunds: Outbid users refunded automatically

🛒 Buying & Bidding

Fixed-Price Purchase

1. Browse marketplace or view NFT details
2. Click "Buy Now" button
3. Connect wallet if not connected
4. System validates:
- • Network matches NFT chain
- • Sufficient balance
- • KYC status (if high-value)
5. Approve transaction in wallet
6. Ownership transfers instantly

Auction Bidding

1. View auction details and current bid
2. Enter bid amount (must exceed minimum)
3. Click "Place Bid" button
4. System checks:
- • Bid meets minimum increment
- • Auction still active
- • Not your own auction
5. Previous bidder auto-refunded
6. You become highest bidder
7. Win NFT when auction ends

Making Offers

Make offers on any NFT (even if not listed):

• Click "Make Offer" button
• Enter offer amount and expiration
• Seller receives notification
• Seller can accept, reject, or counter
• Offer expires automatically if not accepted

Note: Offers require marketplace settings to have offers enabled.

Transaction Fees

When purchasing NFTs, you pay:

• NFT Price: Set by seller
• Marketplace Fee: % goes to platform (default 2.5%)
• Creator Royalty: % goes to original creator (0-50%)
• Gas Fee: Blockchain transaction cost

Gas Optimization: Gas estimates shown before every transaction. Transactions may fail if gas price spikes.

🎨 Creator Dashboard

Route: /nft/creator (requires authentication + wallet)

Dashboard Tabs:

📊 Portfolio Stats

Created

Total NFTs minted

Owned

Current holdings

Portfolio Value

Estimated worth

Listed

Active listings

📦 Collections

View all your collections with:

• Deployment status and contract address
• Current vs. max supply tracking
• Quick edit and manage options

🖼️ Created & Owned NFTs

Separate tabs for:

• Created: All NFTs you minted (even if sold)
• Owned: NFTs currently in your wallet (with profit calculation)
• Grid view with filtering and sorting

📊 Activity

Real-time transaction feed showing:

• Mints, sales, transfers, listings
• Blockchain transaction hashes
• Timestamps and amounts

💰 Earnings

Breakdown of income:

• Primary Sales: Initial NFT sales
• Secondary Sales: Resales of your NFTs
• Royalties: Automatic royalty earnings
• Total earnings with USD conversion

👤 Creator Profile

Profile Customization

Route: /nft/creator/profile

• Display Name: Public username
• Bio: About you (500 characters)
• Avatar: Profile picture
• Banner: Cover image
• Social Links: Twitter, Instagram, website

Verification Tiers

Admin-awarded verification badges:

🥈

Silver

Basic verification

🥇

Gold

Established creator

💎

Platinum

Top-tier verified

🔍 Marketplace Discovery

Route: /nft/marketplace

Filters

• Search by name, collection, creator
• Filter by category
• Filter by collection
• Price range slider
• Listing type (sale, auction, has offers)
• Ending soon (auctions)

Sorting Options

• Recently listed (newest first)
• Price: Low to High
• Price: High to Low
• Most viewed
• Ending soon (auction countdown)
• Trending (most active)

Display Options:

Grid Layout

Traditional card grid with consistent sizing

Masonry Layout

Pinterest-style dynamic heights

NFT Card Information:

• Image with hover preview
• Collection name and verified badge
• Price in native token with USD conversion
• View count, favorite count
• Rarity badge (if applicable)
• Current bid (for auctions)
• Time remaining (for auctions)

💡 User Best Practices

For Creators

✓ Create high-quality, original artwork
✓ Use descriptive names and detailed descriptions
✓ Set reasonable royalty percentages (5-10% typical)
✓ Build a cohesive collection theme
✓ Engage with your collectors
✓ Customize your creator profile completely
✓ Price fairly based on market research
✓ Ensure IPFS URLs are accessible before minting

For Collectors

✓ Research collection and creator before buying
✓ Check verification status
✓ Ensure IPFS metadata and images load properly
✓ Consider gas fees in total cost
✓ Use offers to negotiate prices
✓ Track portfolio value regularly
✓ Keep sufficient native tokens for gas
✓ Enable wallet security features

Security Tips

⚠️ Never share private keys or seed phrases
⚠️ Double-check contract addresses
⚠️ Review all transaction details before signing
⚠️ Use hardware wallets for large holdings
⚠️ Beware of phishing attempts
⚠️ Verify URLs match official marketplace
⚠️ Don't click suspicious links in DMs

Gas Optimization

💡 Mint during off-peak hours (lower gas)
💡 Batch operations when possible
💡 Use Layer 2 chains (Polygon, Arbitrum, Optimism)
💡 Check gas prices before transactions
💡 Set reasonable gas limits
💡 Consider transaction urgency

NFT User Features