🎯 What is the NFT Marketplace Extension?

The NFT Marketplace extension transforms your v5 platform into a comprehensive multi-chain NFT marketplace. Users can create collections, mint NFTs, list them for sale (fixed price or auction), make offers, and trade digital assets across multiple blockchains including Ethereum, BSC, Polygon, Arbitrum, and Optimism.

Built on industry-standard ERC-721 smart contracts with IPFS metadata storage, the marketplace supports creator royalties, KYC integration, auction mechanics with anti-sniping protection, and real-time activity feeds. Administrators have full control over marketplace configuration, content moderation, creator verification, and multi-chain contract deployment.

The system integrates seamlessly with the Ecosystem extension for blockchain connectivity and supports both custodial and non-custodial wallet workflows.

✨ Key Features

🖼️

NFT Creation & Minting

6-step wizard for creating and minting NFTs with IPFS storage

📦

Collection Management

Deploy ERC-721 smart contracts with custom royalties and metadata

💰

Trading System

Fixed-price sales, timed auctions, and direct offers with blockchain execution

🌐

Multi-Chain Support

Deploy and trade on ETH, BSC, Polygon, Arbitrum, and Optimism

🏆

Creator Royalties

Automatic royalty distribution on secondary sales (0-50%)

🔐

KYC Integration

Optional KYC requirements for creators and high-value transactions

⚖️

Dispute Management

Comprehensive dispute resolution system with priority levels

📊

Analytics Dashboard

Real-time metrics, volume tracking, and creator performance analytics

📋 Prerequisites

✅ Required Components

v5 Core Platform installed and configured
Ecosystem Extension - Required for blockchain connectivity, wallet management, and RPC providers
User authentication system active
Database with proper user management
RPC endpoints for supported chains (Ethereum, BSC, Polygon, Arbitrum, Optimism)
Gas funds in master wallets for contract deployment

🔌 Recommended Integrations

KYC Extension - For creator and buyer verification
Email service - For transaction notifications
WebSocket server - For real-time activity feeds
SSL certificate - Required for wallet connections

⚠️ Important Notes

Smart contract deployment requires gas fees on each blockchain
Users provide their own IPFS URLs when creating NFTs (no platform IPFS setup required)
IPFS metadata validation ensures proper format before blockchain minting
Test on testnets (Sepolia) before deploying to mainnet
Configure proper permissions and access controls for admin features
Plan marketplace fee structure and royalty limits before launch
Ensure compliance with local digital asset and NFT regulations

📦 Installation Steps

1

Download License from CodeCanyon

Purchase and download the NFT Marketplace extension license from CodeCanyon:

• Visit the CodeCanyon marketplace
• Purchase the NFT Marketplace extension
• Download the license file
• Note down your username and license code

⚠️ Important: Keep your license code secure and don't share it with others.

2

Access Extension Management

Navigate to the system extension management page:

/admin/system/extension

• Login to your admin panel
• Go to System → Extensions
• Find the "NFT Marketplace" extension in the list

3

Activate the Extension

Use your CodeCanyon credentials to activate the extension:

1. Click on the "NFT Marketplace" extension
2. Enter your CodeCanyon username
3. Enter your license code
4. Click "Activate"

ℹ️ Note: The system will verify your license with CodeCanyon and activate the extension. This may take a few seconds.

⚠️ Important: Keep your license code secure and don't share it with others.

4

Verify Database Setup

After activation, the system automatically creates the following database tables:

• nft_collection - NFT collection contracts
• nft_token - Individual NFT tokens
• nft_listing - Marketplace listings
• nft_bid - Auction bids
• nft_offer - Direct offers
• nft_activity - Activity feed
• nft_creator - Creator profiles
• nft_marketplace - Marketplace contracts
• nft_category - NFT categories
• nft_dispute - Dispute management

✅ Success: Once activated, you'll see "NFT Marketplace" in your admin sidebar navigation under the Extensions section.

5

Configure Ecosystem Integration

Ensure the Ecosystem extension is properly configured for blockchain connectivity:

1. Navigate to /admin/ecosystem
2. Configure RPC endpoints for each blockchain you want to support:

• Ethereum (chainId: 1)
• BSC (chainId: 56)
• Polygon (chainId: 137)
• Arbitrum (chainId: 42161)
• Optimism (chainId: 10)
• Sepolia testnet (chainId: 11155111) - for testing

3. Set up master wallets with sufficient gas for each chain
4. Enable the blockchains in the Ecosystem settings

⚠️ Gas Requirements

Deploying marketplace contracts requires approximately 0.05-0.1 ETH (or equivalent) per chain. Ensure master wallets are funded before deployment.

6

Run Onboarding Setup

Complete the guided onboarding process to set up your NFT marketplace:

1. Navigate to /admin/nft/onboarding
2. Follow the 4-phase setup wizard:

Phase 1: Infrastructure Setup (CRITICAL)

• Deploy primary marketplace contract (choose your main chain)
• Verify blockchain integration health
• Configure marketplace fee structure (default 2.5%)

Phase 2: Marketplace Configuration (IMPORTANT)

• Enable trading types (fixed-price, auctions, offers)
• Configure auction mechanics (duration limits, bid increments)
• Set up content policies (metadata validation)

Phase 3: Content Management (IMPORTANT)

• Create NFT categories (minimum 2 required)
• Review and approve first user collection
• Ensure collections have minted NFTs

Phase 4: User & Creator Management (IMPORTANT)

• Verify first creator profile
• Configure KYC requirements (if applicable)
• Set high-value transaction thresholds

✅ Progress Tracking

The onboarding wizard tracks your progress and estimates time remaining. You can pause and resume at any time.

🗄️ Database Tables

The NFT Marketplace extension creates the following database tables automatically during activation:

📦 nftCollection

NFT collections and smart contract details

🖼️ nftToken

Individual NFT tokens with metadata

💰 nftListing

Active marketplace listings (sales/auctions)

🎯 nftBid

Auction bids with status tracking

💵 nftOffer

Direct offers on NFTs

📊 nftActivity

All marketplace activities and transactions

👤 nftCreator

Creator profiles and verification

🏪 nftMarketplace

Deployed marketplace contracts per chain

📁 nftCategory

NFT categories for organization

⚖️ nftDispute

Dispute management and resolution

🔐 Permissions & Access Control

The NFT Marketplace extension includes a comprehensive permission system:

Admin Permissions

access.nft Main NFT admin access

access.nft.onboarding Access onboarding wizard

access.nft.category Manage categories

access.nft.collection Manage collections

access.nft.token Manage NFT tokens

access.nft.creator Manage creator profiles

access.nft.marketplace Deploy & manage contracts

access.nft.blockchain Blockchain operations

access.nft.listing Manage listings

access.nft.auction Manage auctions & bids

access.nft.offer Manage offers

access.nft.sale Manage sales & transactions

access.nft.activity View & manage activity feed

access.nft.dispute Handle disputes

access.nft.review Review & approve content

access.nft.analytics View analytics dashboard

access.nft.stats View statistics

access.nft.backup Backup management

User Access

All authenticated users can:

• Browse marketplace and view NFTs
• Create collections (requires wallet connection)
• Mint NFTs to their own collections
• List owned NFTs for sale
• Purchase, bid, and make offers on NFTs
• Manage creator profile

Paranoid Mode Protection

When paranoid mode is enabled, the following admin actions require additional confirmation: deleting categories, collections, tokens, listings, offers, and activity records.

🧭 Navigation Structure

Admin Routes

/admin/nft Dashboard & overview

/admin/nft/onboarding Setup wizard

/admin/nft/category Category management

/admin/nft/collection Collection management

/admin/nft/marketplace Contract deployment

/admin/nft/settings Marketplace configuration

/admin/nft/analytics Performance analytics

User Routes

/nft Marketplace home

/nft/marketplace Browse NFTs

/nft/create Mint new NFT

/nft/collection/create Create collection

/nft/creator Creator dashboard

/nft/token/[id] NFT details page

🔧 Troubleshooting

Extension activation failed

• Check database connection and permissions
• Ensure Ecosystem extension is activated first
• Verify no conflicting database table names exist
• Check server error logs for detailed error messages
• Ensure sufficient disk space for uploads

Marketplace contract deployment fails

• Verify master wallet has sufficient gas funds
• Check RPC endpoint is accessible and not rate-limited
• Ensure blockchain network is not congested
• Verify smart contract bytecode is valid
• Check firewall allows outbound connections to RPC endpoint

Users can't connect wallets

• Ensure site is running on HTTPS (required for wallet connections)
• Verify Reown (Coinbase) AppKit project ID is configured
• Check browser console for wallet provider errors
• Ensure users have MetaMask or compatible wallet installed
• Verify chain IDs match between frontend and smart contracts

NFT transactions not processing

• Check user wallet has sufficient native token for gas
• Verify smart contract approvals are set correctly
• Ensure blockchain network is operational
• Check gas price estimation is reasonable
• Review transaction logs for revert reasons

NFT Marketplace Extension