👨‍💼

# NFT Admin Features

Complete Administrator Management Guide

## 🎯 Admin Dashboard Overview

The NFT Admin Dashboard provides comprehensive control over your multi-chain NFT marketplace. Monitor real-time statistics, manage content, deploy blockchain contracts, configure trading rules, handle disputes, and analyze performance metrics—all from a centralized interface.

Access the admin panel at `/admin/nft` with appropriate permissions.

## 📊 Dashboard Metrics

📦

### Collections

Total collections with active/verified counts

🖼️

### NFTs

Total minted NFTs and active listings

💰

### Trading Volume

Total sales value across all chains

📈

### Platform Revenue

Marketplace fees + royalty earnings

## 📁 Content Management

### Categories

Route: `/admin/nft/category`

#### Features:

- • Create categories: Define NFT types (Art, Music, Gaming, Collectibles, etc.)
- • Edit metadata: Update name, slug, description, and emoji icons
- • Delete categories: Remove unused categories (protected by paranoid mode)
- • Auto-slug generation: URL-friendly slugs created automatically

#### 💡 Best Practice

Create at least 5-10 categories before launch to help users organize their collections. Popular categories: Art, Photography, Music, Gaming, Sports, Collectibles, Virtual Worlds, Domain Names.

### Collections

Route: `/admin/nft/collection`

#### Management Capabilities:

- • View all collections: See creator, category, chain, supply, volume, floor price
- • Edit status: DRAFT, PENDING, ACTIVE, INACTIVE, SUSPENDED
- • Verify collections: Award verification badge to legitimate creators
- • Monitor deployment: Track smart contract deployment status
- • Delete collections: Remove fraudulent or policy-violating collections

#### Collection Details:

Contract Info

Address, chain, standard (ERC-721)

Supply Stats

Current vs. max supply tracking

Trading Metrics

Volume, floor price, listings

#### ⚠️ Note

Admins cannot create collections—only users can. Collections require PENDING approval after creation. Use status management to control which collections appear in the marketplace.

### NFT Tokens

Route: `/admin/nft/token`

#### Content Moderation:

- • View all minted NFTs: Browse complete token registry
- • Review metadata: Check name, description, image, attributes
- • Edit token details: Update if needed (rare cases)
- • Delete problematic NFTs: Remove policy violations, fraudulent content
- • Track ownership: Monitor current owner and transfer history
- • Review metadata: Users provide their own IPFS URLs (validated for format)

#### Token Information:

Metadata

IPFS URI, image, attributes, properties

Minting Details

Token ID, collection, mint date, creator

Ownership

Current owner, listing status

Trading History

Sales, transfers, price history

## 💰 Trading Management

### Marketplace Contracts

Route: `/admin/nft/marketplace`

#### Contract Deployment:

- • Deploy to multiple chains: ETH, BSC, Polygon, Arbitrum, Optimism
- • Configure fee structure: Set marketplace fee (0-10%)
- • Set royalty limits: Maximum creator royalty (0-50%)
- • Define fee recipient: Address to receive marketplace fees
- • Set listing fees: Optional fixed fee per listing (in native token)

#### Emergency Controls:

- • Pause marketplace: Emergency stop for security issues
- • Resume trading: Re-enable after resolving issues
- • Withdraw fees: Extract accumulated marketplace fees
- • Update configuration: Change fee percentage and recipients

#### Contract Monitoring:

Status

ACTIVE, PAUSED deployment status

Balance

Accumulated fees with USD conversion

Health

Contract health and connectivity

#### 🚨 Critical

Contract deployment is irreversible and requires gas fees. Test thoroughly on Sepolia testnet before mainnet deployment. Ensure master wallets have sufficient funds (0.05-0.1 ETH equivalent per chain).

### Listings

Route: `/admin/nft/listing`

#### Management:

- • Monitor active listings: View all fixed-price and auction listings
- • Track listing type: FIXED_PRICE vs AUCTION identification
- • View pricing: See asking price, reserve price, current bid
- • Edit listings: Modify details if policy violations detected
- • Delete listings: Remove fraudulent or problematic listings
- • Monitor status: ACTIVE, SOLD, CANCELLED, EXPIRED states

### Offers

Route: `/admin/nft/offer`

- • Monitor all offers on NFTs
- • Track offer status and expiration
- • View offer amounts and currency
- • Edit/delete problematic offers

### Auctions

Route: `/admin/nft/auction`

- • Monitor active auctions
- • Track bidding activity
- • View auction timeline
- • Manage auction status

### Sales

Route: `/admin/nft/sale`

#### 📋 View-Only Access

Sales records are immutable transaction history. Admins can view but cannot edit or delete completed sales.

- • View transaction details and blockchain hashes
- • Track buyer and seller information
- • Monitor marketplace fee collection
- • Analyze revenue and performance metrics

## 👥 Community Management

### Creator Profiles

Route: `/admin/nft/creator`

#### Creator Management:

- • View all creators: Browse complete creator registry
- • Verify creators: Award verification badges (Silver, Gold, Platinum)
- • Unverify creators: Remove verification for policy violations
- • Monitor performance: Collections, sales, volume, earnings
- • Review profiles: Username, bio, social links, website

#### Creator Analytics:

Collections

Total created collections

NFTs Created

Total minted tokens

Sales Volume

Total trading volume

Royalty Earnings

Secondary sales royalties

#### ⚠️ Note

Admins cannot delete creator profiles—only verify/unverify. Creator profiles are automatically created when users mint their first NFT or create a collection.

### Review Moderation

Route: `/admin/nft/review`

#### Review Management:

- • Moderate user reviews: Approve or reject NFT reviews
- • Filter by status: PENDING, APPROVED, REJECTED, HIDDEN
- • View ratings: 1-5 star ratings with helpful count
- • Verify reviews: Mark authentic reviews from verified purchasers
- • Hide spam: Hide inappropriate or fake reviews

#### ⚠️ Note

Review moderation helps maintain marketplace trust. Focus on removing spam and fraudulent reviews while allowing honest feedback.

### Activity Monitoring

Route: `/admin/nft/activity`

#### Real-Time Monitoring:

- • Live activity feed: All marketplace actions in real-time
- • Filter by type: MINT, SALE, TRANSFER, LIST, BID, OFFER, DELIST, BURN
- • Search capabilities: Find by collection, creator, or token
- • Transaction details: View blockchain hash, timestamp, participants
- • Delete records: Remove spam or test activity (for moderation)
- • Infinite scroll: Load more activities as you browse

#### Activity Types:

MINT

SALE

TRANSFER

LIST

DELIST

BID

OFFER

BURN

## ⚖️ Dispute Management

Route: `/admin/nft/dispute`

### Dispute Resolution System:

#### Status Management:

- • PENDING - New disputes
- • INVESTIGATING - Under review
- • AWAITING_RESPONSE - Waiting for party
- • RESOLVED - Dispute closed
- • REJECTED - No action taken
- • ESCALATED - Sent to higher authority

#### Priority Levels:

- • LOW - Minor issues
- • MEDIUM - Standard disputes
- • HIGH - Significant issues
- • CRITICAL - Urgent fraud/security

#### Resolution Actions:

REFUND

Full refund to buyer

PARTIAL_REFUND

Partial compensation

CANCEL_SALE

Reverse transaction

BAN_USER

Suspend violator

REMOVE_LISTING

Delist problematic NFT

WARNING

Issue warning to user

NO_ACTION

Dispute invalid

#### Features:

- • Internal notes: Add admin-only comments for investigation
- • Communication system: Message disputants directly
- • Evidence tracking: Attach screenshots, blockchain proofs
- • Statistics dashboard: Resolution time, success rate, volume
- • Dispute categories: Fraud, quality issues, delivery, description mismatch

## 📊 Analytics & Insights

Route: `/admin/nft/analytics`

### Comprehensive Metrics:

#### KPI Cards

- • Total collections, NFTs, trading volume
- • Sales count and average price
- • Active users and listings
- • 24-hour activity metrics

#### Visual Charts

- • Category distribution pie chart
- • Blockchain distribution chart
- • Growth trend line charts
- • Volume over time graphs

#### Top Performers:

Top Collections

By volume, floor price, sales

Top Creators

By earnings and activity

Recent Sales

Latest transactions

#### Timeframe Selection:

View analytics for: 7 days, 30 days, 90 days, or 1 year

#### 💡 Export Functionality

Export analytics data to CSV for external analysis, reporting, or sharing with stakeholders.

## 🔧 Infrastructure Management

### Dashboard Statistics

Route: `/admin/nft/stats`

#### Real-Time Statistics:

Collections & Tokens

Total, active, pending, verified counts

Listings & Sales

Active listings, auctions, total volume

Revenue & Activity

Fees collected, 24h activity, unique users

#### 💡 Usage

Dashboard stats provide instant overview of marketplace health. Use this alongside analytics for comprehensive monitoring.

### Blockchain Configuration

Route: `/admin/nft/blockchain/options`

#### Supported Chains:

- • EVM Compatible: ETH, BSC, Polygon, Arbitrum, Optimism, Avalanche, Fantom, Celo, Base, RSK
- • Non-EVM: Solana (SOL), Movement (MO)
- • Selection API: Returns enabled chains for dropdown/deployment options
- • Integration: Works with Ecosystem extension for RPC connectivity

#### ✅ Note

Only blockchains enabled in the Ecosystem extension will appear in the NFT deployment options. Ensure chains are properly configured before attempting contract deployment.

### Data Backup

Route: `/admin/nft/backup/schedule`

#### Backup Features:

- • Schedule backups: Create automated backup schedules for NFT data
- • Chain-specific: Filter backups by blockchain (ETH, BSC, Polygon)
- • View schedules: List all configured backup routines
- • Delete schedules: Remove outdated backup configurations
- • Data protection: Safeguard collections, tokens, and transaction history

#### 🚨 Critical

Regular backups are essential for NFT marketplaces. Blockchain data is immutable, but database records (metadata, ownership, listings) must be backed up regularly to prevent data loss.

### Onboarding Progress

Route: `/admin/nft/onboarding/status`

#### Setup Tracking:

- • Infrastructure: Marketplaces deployed, chains active, total contracts
- • Configuration: Fees configured, settings complete, policies set
- • Content: Categories created, collections approved, featured content
- • User Management: Verification enabled, roles configured, KYC setup
- • Readiness Score: 0-100% completion with critical tasks list
- • Launch Ready: Flag indicating marketplace is production-ready

#### 💡 Wizard

The onboarding wizard (at /admin/nft/onboarding) uses this status endpoint to track progress through the 4-phase setup process.

## ⚙️ Settings Configuration

Settings are managed through multiple endpoints and the marketplace contract configuration. See the Settings Documentation for detailed information on all configuration options.

#### ℹ️ Configuration Sources

NFT marketplace settings are distributed across:

- • Marketplace Contracts: Via `/admin/nft/marketplace` PUT endpoint (fees, royalties)
- • System Settings: Stored in database systemSetting model
- • Feature Toggles: Through onboarding and configuration endpoints

### Configuration Categories:

#### Trading Settings

Enable/disable trading types, auction mechanics, anti-snipe protection

#### Fee Settings

Marketplace fee percentage, royalty limits, listing fees

#### Verification Settings

KYC requirements, high-value transaction protection

#### Content Settings

Metadata validation requirements

## 💡 Admin Best Practices

### Marketplace Launch Checklist

- ✓ Complete onboarding wizard
- ✓ Deploy contracts to primary chain
- ✓ Create 5-10 diverse categories
- ✓ Configure trading and fee settings
- ✓ Set up KYC integration (if applicable)
- ✓ Test all workflows on testnet
- ✓ Ensure users can provide valid IPFS URLs
- ✓ Review and approve first collections
- ✓ Verify first set of creators
- ✓ Monitor initial transactions closely

### Daily Operations

- • Check dashboard for anomalies
- • Review pending collections
- • Monitor activity feed for spam
- • Process new disputes promptly
- • Verify legitimate creator requests
- • Check marketplace contract balances
- • Review analytics for trends
- • Moderate reported content
- • Respond to support tickets

### Security Practices

- • Enable paranoid mode for critical actions
- • Use multi-factor authentication
- • Limit admin permissions by role
- • Regular backup of database
- • Monitor for fraudulent patterns
- • Keep emergency pause ready
- • Document all major decisions
- • Audit fee withdrawals

### Growth Strategies

- • Feature high-quality collections
- • Verify reputable creators
- • Promote top performers
- • Run creator campaigns
- • Analyze category trends
- • Optimize fee structure
- • Expand to new blockchains
- • Share marketplace analytics

## 🚀 Next Steps

### 👥 User Features

Learn about the user experience and workflows

### ⚙️ Settings Guide

Detailed configuration options explained

### 📦 Installation

Setup and deployment instructions

### 💬 Need Help?

For admin-specific questions or technical support, visit our support portal or contact the support team via your admin panel.