🎨

# NFT Marketplace Extension

Complete Installation & Setup Guide

## 🎯 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. 1. Click on the "NFT Marketplace" extension
2. 2. Enter your CodeCanyon username
3. 3. Enter your license code
4. 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. 1. Navigate to `/admin/ecosystem`
2. 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. 3. Set up master wallets with sufficient gas for each chain
4. 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. 1. Navigate to `/admin/nft/onboarding`
2. 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

## 🚀 Next Steps

### 👨‍💼 Admin Features Guide

Learn about all admin management features, analytics, and moderation tools

### 👥 User Features Guide

Understand user workflows for creating, minting, listing, and trading NFTs

### ⚙️ Settings Configuration

Detailed guide to all marketplace settings and configuration options

### 🔗 Ecosystem Extension

Set up blockchain connectivity and wallet infrastructure

### 💬 Need Help?

If you encounter any issues during installation or have questions about the NFT Marketplace extension:

- • Check the FAQ section
- • Visit our support portal
- • Contact our support team via the admin panel
- • Join our community Discord server