NEXIS
Platform Guide

Learn More

Comprehensive guide to NEXIS Web3 Community OS features, from Discord integration to Arena predictions.

Scroll
01

Welcome to NEXIS

NEXIS is a complete Web3 Community Operating System built by Nexiae. It combines Discord community management, moderation, bot subscriptions, Web3 wallet integration, NFT verification, and competitive features into one powerful platform. NEXIS is NOT simply a Discord bot — it's a modular ecosystem designed to scale from Phase 1 foundations to future multi-community SaaS functionality.

Core Platform Features

  • Discord Integration: Complete Discord community management and moderation capabilities
  • Bot Subscriptions: Subscription-based Discord moderation bot with configurable plans
  • Web3 Wallet Connection: Connect crypto wallets with cryptographic signature verification
  • NXAE NFT Verification: Verify NFT ownership to determine holder tiers and access
  • Arena & Predictions: Competitive prediction markets with XP, streaks, and leaderboards
  • NFT Marketplace: Portfolio management and marketplace functionality

User Journey

  • Create NEXIS Account: Sign up and connect your Discord account
  • Subscribe to Bot: Choose a moderation bot plan and complete payment
  • Install Bot: Install the Discord bot into servers you manage
  • Configure Moderation: Set up moderation rules, channels, and thresholds
  • Connect Wallet: Link your crypto wallet and sign verification challenge
  • Verify NXAE: Verify NFT ownership to unlock holder tier benefits
  • Participate in Arena: Join predictions, earn XP, and climb leaderboards

Technology Stack

  • Frontend: Next.js, React, TypeScript, App Router
  • Backend: Node.js/TypeScript or Next.js server-side API
  • Database: MongoDB with MongoDB Atlas
  • Blockchain: Wallet connection, signature verification, NFT ownership verification
  • Discord: Discord OAuth, Bot API, Gateway, slash commands
  • Architecture: Modular design with adapter pattern for third-party providers

Phase Overview

NEXIS is built in phases: Phase 1 (Foundation + Discord Bot), Phase 2 (Arena & Predictions), Phase 3 (NFT Marketplace), Phase 4 (Advanced Predictions), Phase 5 (Community Growth), and Phase 6 (Scale/SaaS). Each phase builds upon the previous without requiring rewrites.

02

Payment Methods

NEXIS offers flexible payment options for Discord bot subscriptions through our integrated payment provider. Choose from various payment methods to activate your bot subscription and unlock moderation features for your Discord servers.

Subscription Payment Methods

We support multiple payment methods for bot subscriptions including credit/debit cards, cryptocurrencies, and other digital payment options. The exact payment provider and methods are configurable based on your region and preferences.

  • Credit/Debit Cards: Visa, Mastercard, and other major cards
  • Cryptocurrency: USDT, BTC, ETH, and other supported coins
  • Digital Wallets: Various digital payment solutions
  • Secure Processing: All payments processed through PCI-compliant providers

Subscription Security

All subscription payments are secured with industry-standard encryption. Payment secrets are never exposed to the browser, and subscription entitlement is always validated server-side.

  • Webhook Validation: Payment webhooks are cryptographically verified
  • Server-Side Validation: Bot access is checked on every request
  • Secure Storage: No payment secrets stored in frontend code
  • Fraud Protection: Real-time monitoring of subscription activity

Subscription Lifecycle

Subscriptions follow a clear lifecycle from activation to expiration. We handle subscription states, grace periods, and failed payment recovery automatically.

  • Active: Subscription is current and bot features are enabled
  • Trial: Free trial period with full feature access
  • Past Due: Payment failed, grace period in effect
  • Cancelled: User cancelled, features active until period end
  • Expired: Subscription ended, paid features disabled

Automatic Renewal

Subscriptions can be set to auto-renew to ensure uninterrupted bot service. Renewal attempts are made automatically, and you'll receive notifications before each renewal.

  • Auto-Renew: Optional automatic subscription renewal
  • Renewal Notifications: Email alerts before renewal date
  • Payment Retry: Automatic retry for failed payments
  • Manual Control: Cancel or modify anytime from dashboard
02

Discord Integration

NEXIS provides deep Discord integration allowing users to connect their Discord accounts, manage communities, and utilize advanced moderation features. The Discord integration is a core component of the platform, enabling seamless community management and role synchronization.

Discord OAuth

Connect your Discord account through secure OAuth authentication. This enables identity linking and authorization for Discord server management.

  • Secure Authentication: OAuth 2.0 for safe Discord account linking
  • Identity Verification: Verify Discord identity for platform access
  • Server Permissions: Validate server management permissions
  • Role Synchronization: Sync holder tiers with Discord roles

Bot Installation

Subscribed users can install the NEXIS moderation bot into Discord servers they manage. The installation process includes authorization validation and server configuration.

  • Authorization Flow: Discord OAuth installation process
  • Server Selection: Choose Discord servers to install bot
  • Permission Validation: Server-side verification of management rights
  • Server Recording: Track installed servers and configurations

Role Synchronization

NEXIS automatically synchronizes holder tiers with Discord roles based on NXAE NFT ownership. This ensures users receive appropriate Discord permissions based on their tier.

  • Automatic Sync: Roles update based on NFT holdings
  • Tier Mapping: Configurable tier-to-role mappings
  • Real-time Updates: Changes reflected immediately in Discord
  • Access Control: Server-side enforcement of role permissions

Security Measures

All Discord operations are secured with proper validation and authorization checks. The backend never trusts client-side claims about server ownership or permissions.

  • Server-Side Validation: All permissions verified on backend
  • Token Security: Discord tokens stored securely
  • Rate Limiting: API abuse prevention through rate limits
  • Audit Logging: All Discord operations logged for security
03

Bot Subscription

NEXIS offers subscription-based Discord moderation bot services. Users can subscribe to different plans that determine the features, server limits, and moderation capabilities available. The subscription system uses webhooks for payment processing and server-side entitlement validation.

Subscription Plans

Choose from multiple subscription tiers designed for different community sizes and needs.

  • Free Tier: Basic features for testing and small communities
  • Starter: Enhanced features for growing communities
  • Pro: Advanced features for active servers
  • Enterprise: Full feature set for large networks

Plan Features

Each plan includes specific features, server limits, and capabilities.

  • Server Limits: Maximum number of Discord servers per plan
  • Moderation Modules: Access to advanced moderation features
  • Webhook Limits: Maximum number of webhook integrations
  • Support Level: Response time and support channel access
  • Analytics: Bot performance and activity analytics

Subscription Flow

The subscription process is designed to be secure and seamless.

  • Plan Selection: Choose a plan from the Bot Hub
  • Payment Processing: Complete payment through provider
  • Webhook Validation: Server validates payment webhook
  • Subscription Recording: Subscription recorded in database
  • Entitlement Grant: Bot management access granted
  • Bot Installation: Install bot into Discord servers

Entitlement Validation

Bot functionality is always validated server-side based on subscription status. The frontend never decides whether a user has access.

  • Server-Side Checks: All bot operations validated on backend
  • Subscription Status: Active, trial, past due, cancelled, expired
  • Grace Period: Configurable grace period for failed payments
  • Feature Gating: Features enabled/disabled based on plan
04

Wallet Connection

NEXIS supports crypto wallet connections for Web3 identity and NFT verification. Users can connect supported wallets, verify ownership through cryptographic signatures, and link their wallets to their NEXIS account for holder tier determination.

Supported Wallets

Connect with popular crypto wallets that support the required blockchain networks for NXAE NFT verification.

  • MetaMask: Most popular Web3 wallet
  • WalletConnect: Mobile wallet integration
  • Phantom: Solana-native wallet
  • Other EVM Wallets: Coinbase Wallet, Trust Wallet, etc.

Wallet Verification

Wallet ownership is verified through cryptographic signature challenges. Simply connecting a wallet is not proof of ownership — users must sign a verification message.

  • Signature Challenge: Sign a unique message to prove ownership
  • Backend Verification: Server validates cryptographic signature
  • One-Time Setup: Verification required per wallet connection
  • Re-verification: Required if wallet address changes

Security Principles

NEXIS follows strict security principles for wallet management. We never request or store sensitive wallet data.

  • No Private Keys: Never request or store private keys
  • No Seed Phrases: Never ask for wallet seed phrases
  • No Custody: NEXIS does not custody user funds or NFTs
  • Signature Only: Only request message signatures for verification

Wallet Management

Users can manage their connected wallets through the dashboard, including connecting new wallets, changing primary wallets, and disconnecting wallets.

  • Connect Wallet: Add new wallet to account
  • Change Wallet: Switch primary wallet for verification
  • Disconnect: Remove wallet from account
  • View Status: See verification status of each wallet
05

NXAE NFT Verification

NXAE NFT verification is the core access control mechanism for NEXIS. Users verify their NXAE NFT holdings to determine their holder tier, which controls platform access, features, and Discord role synchronization. The system automatically detects changes in NFT ownership and updates tiers accordingly.

Verification Process

The verification process reads NFT ownership from a trusted blockchain provider and maps holdings to holder tier rules.

  • Read Holdings: Query blockchain for NXAE NFT ownership
  • Count NFTs: Determine quantity of eligible NXAE NFTs
  • Map to Tier: Apply configurable tier rules based on quantity
  • Assign Tier: Update user's holder tier in database
  • Sync Discord: Synchronize corresponding Discord role
  • Record Timestamp: Track verification time for audit trail

Holder Tiers

Holder tiers are configurable and determine what features and access users receive.

  • Required Quantity: NFT count needed for each tier
  • Access Rules: Features unlocked per tier
  • Discord Role Mapping: Corresponding Discord roles
  • Progress Information: User's progress toward next tier

Dynamic Updates

The system automatically detects changes in NFT ownership and updates tiers accordingly.

  • Transfer Detection: Detect NFT transfers and sales
  • Automatic Re-verification: Re-check holdings on significant changes
  • Tier Adjustment: Update tier based on new holdings
  • Role Resync: Update Discord roles when tier changes
  • Notification: Alert users of tier changes

Security & Validation

All NFT verification is performed server-side using trusted blockchain providers. The system never trusts client-side claims about NFT ownership.

  • Trusted Provider: Use reputable NFT/balance API
  • Server-Side Validation: All checks performed on backend
  • Audit Trail: Track all verification attempts and changes
  • Rate Limiting: Prevent abuse of verification endpoints
06

Holder Tiers

Holder tiers are the access control system for NEXIS. Based on the quantity of NXAE NFTs owned, users are assigned different tiers that determine their platform access, unlocked features, and Discord roles. The tier system is fully configurable and enforced server-side.

Tier Structure

Tiers are determined by the number of NXAE NFTs held in a verified wallet.

  • Basic Tier: 0 NXAE NFTs - Public access features
  • Holder Tier: 1+ NXAE NFTs - Enhanced features
  • Premium Tier: 5+ NXAE NFTs - Advanced features
  • Elite Tier: 10+ NXAE NFTs - Full platform access
  • Custom Tiers: Configurable based on community needs

Tier Benefits

Each tier unlocks specific features and access levels across the platform.

  • Discord Roles: Corresponding Discord roles for each tier
  • Arena Access: Participation in prediction markets
  • Bot Features: Enhanced moderation capabilities
  • Marketplace: NFT marketplace access and trading
  • Competitions: Entry into exclusive competitions

Tier Progress

Users can track their progress toward the next tier through the dashboard.

  • Current Holdings: Number of NXAE NFTs owned
  • Next Tier: NFTs needed for next tier
  • Progress Bar: Visual progress toward tier upgrade
  • Unlocked Features: Features available at current tier
  • Pending Features: Features to unlock at next tier

Server-Side Enforcement

All tier-based access control is enforced server-side. The frontend only displays what the backend authorizes.

  • API Validation: Every request checks user tier
  • Feature Gates: Features enabled/disabled based on tier
  • Role Sync: Discord roles updated based on tier
  • Audit Logging: All tier changes logged for compliance
07

Arena & Predictions

The Arena is NEXIS's competitive hub where users participate in prediction markets and competitions. Users can make predictions on various outcomes, earn XP for correct predictions, build streaks, unlock achievements, and climb leaderboards. The Arena is a key component of Phase 2.

Prediction Markets

Administrators create prediction markets with questions, options, rules, deadlines, and XP rewards. Users can browse predictions, filter by category, and enter eligible markets.

  • Market Creation: Admins create prediction markets
  • Browse & Filter: Users browse available predictions
  • Eligibility Check: Tier and status validation before entry
  • Submission: Users submit predictions before deadline
  • Locking: Markets become immutable at deadline
  • Settlement: Results determined from configured sources

XP & Rewards

Correct predictions earn XP based on market configuration. XP is awarded after settlement and contributes to overall progression.

  • XP Rewards: Configurable XP per correct prediction
  • Streak Bonuses: Multipliers for consecutive correct predictions
  • Competition Rewards: Additional XP for competition winners
  • Achievement Unlocks: Prediction-based achievements

Competitions

The Arena hosts regular competitions where users compete for prizes and recognition.

  • Weekly Leagues: Regular competition cycles
  • Championships: Major tournament events
  • Leaderboards: Real-time competition rankings
  • Prizes: XP, NFTs, and other rewards

Settlement & Security

Prediction settlement is handled through configured data providers with full audit trails. All validation is server-side.

  • Data Providers: Configurable settlement sources
  • Admin Override: Override capability with audit logging
  • Immutable Records: Locked predictions cannot be modified
  • Duplicate Prevention: Server-side duplicate entry checks
08

XP & Progression

The NEXIS XP System is a comprehensive progression system that rewards users for platform engagement. XP is stored as a ledger for full transparency and can be earned through predictions, achievements, competitions, and community activities. The system is designed to be fair, transparent, and fraud-resistant.

XP Sources

XP can be earned through various activities across the NEXIS platform.

  • Correct Predictions: XP for accurate market predictions
  • Competitions: Bonus XP for competition participation
  • Achievements: Milestone-based XP rewards
  • Community Activities: Approved engagement activities
  • Streak Bonuses: Multipliers for consecutive achievements

XP Ledger

XP is stored as a transaction ledger rather than a simple number, ensuring full transparency and auditability.

  • Transaction History: Complete record of all XP transactions
  • Source Tracking: Each transaction tagged with source type
  • Timestamp: Exact time of each XP transaction
  • Audit Trail: Full traceability for compliance

Streak System

Build streaks through consistent platform engagement to earn bonus XP and unlock special achievements.

  • Current Streak: Active engagement streak
  • Best Streak: Personal best record
  • Streak Milestones: Bonus XP at milestone points
  • Streak History: Track streak performance over time

Security & Validation

All XP transactions are validated server-side to prevent manipulation and ensure fairness.

  • Server Validation: All XP calculations performed server-side
  • Duplicate Prevention: No duplicate XP for same activity
  • Fraud Detection: Automated detection of suspicious patterns
  • Immutable Records: XP ledger cannot be modified after recording
09

Achievements

The NEXIS Achievements system rewards users for completing milestones across the platform. Achievements are organized into categories with different rarity levels, each granting XP based on difficulty. Users can track their progress and unlock achievements to earn rewards and recognition.

Achievement Categories

Achievements are organized into categories based on platform activities.

  • Onboarding: Initial setup and account verification
  • Discord: Discord integration and bot setup achievements
  • Wallet: Wallet connection and verification milestones
  • NFT: NXAE NFT verification and tier achievements
  • Arena: Prediction and competition achievements
  • Community: Referral and engagement achievements

Rarity Levels

Achievements have different rarity levels, with higher rarity granting more XP.

  • Common: Basic achievements (50-150 XP)
  • Rare: Intermediate milestones (150-400 XP)
  • Epic: Advanced achievements (400-750 XP)
  • Legendary: Elite milestones (750-1,500 XP)

Achievement Tracking

Users can track their achievement progress through the dashboard with detailed status information.

  • Locked: Requirements not yet met
  • In Progress: Partially completed requirements
  • Unlocked: Achievement completed and XP awarded
  • Progress Bar: Visual progress toward completion
  • Unlock Timestamp: When achievement was earned

XP Integration

All XP earned from achievements is recorded in the XP ledger and contributes to overall progression.

  • Automatic Award: XP credited immediately upon unlock
  • Ledger Recording: Transaction recorded in XP ledger
  • Source Tagging: Tagged as achievement source
  • Total Progress: Contributes to overall XP total
10

Leaderboards

NEXIS leaderboards rank users based on various performance metrics including XP, prediction accuracy, streak records, and community contributions. Leaderboards provide competitive motivation and recognition for top performers across different categories and time periods.

Leaderboard Types

Multiple leaderboard categories track different aspects of user performance.

  • XP Leaderboard: Total XP earned across all activities
  • Prediction Accuracy: Win rate in Arena predictions
  • Streak Records: Best prediction and activity streaks
  • Competition Rankings: Performance in competitions
  • Community Impact: Referrals and engagement metrics

Time Periods

Leaderboards track performance across different time frames.

  • Daily: Performance over the last 24 hours
  • Weekly: Performance over the last 7 days
  • Monthly: Performance over the last 30 days
  • All-Time: Cumulative performance since account creation

Ranking Display

Leaderboards display comprehensive user information for comparison and competition.

  • Rank Position: Current ranking on the leaderboard
  • User Profile: Username and avatar display
  • Score/Metric: Primary ranking metric value
  • Tier Badge: Holder tier indicator
  • Trend Indicator: Movement up or down in rankings

Search & Filtering

Users can search for specific players and filter leaderboards by various criteria.

  • Player Search: Find specific users by username
  • Tier Filter: Filter by holder tier
  • Time Period: Switch between different time frames
  • Category Filter: Focus on specific leaderboard types
11

NFT Marketplace

The NEXIS NFT Marketplace provides portfolio management and trading functionality for NXAE and other supported NFTs. Users can view their NFT holdings, create listings, manage offers, and track marketplace activity. All marketplace transactions are user-signed with clear status tracking.

NFT Portfolio

Users can view and manage their complete NFT portfolio through the dashboard.

  • Holdings Overview: View all owned NFTs
  • NFT Details: Detailed information for each NFT
  • Collection View: Organized by collection
  • Value Tracking: Portfolio value estimation
  • Ownership History: Acquisition and transfer history

Listing Creation

Users can create listings to sell their NFTs on the marketplace.

  • Select NFT: Choose NFT from portfolio to list
  • Set Price: Define listing price in supported currency
  • Create Listing: User-signed transaction to create listing
  • Status Tracking: Real-time listing status updates
  • Listing Management: Cancel or modify active listings

Transaction States

All marketplace transactions follow clear state progression for transparency.

  • IDLE: Transaction not started
  • PREPARING: Transaction being prepared
  • WALLET PROMPT: Awaiting user wallet signature
  • SIGNING: User is signing the transaction
  • SUBMITTED: Transaction submitted to blockchain
  • CONFIRMED: Transaction confirmed successfully
  • FAILED: Transaction failed

Security Principles

NEXIS never takes custody of user NFTs. All transactions are user-signed with non-custodial wallet integration.

  • Non-Custodial: NEXIS never holds user NFTs
  • User-Signed: All transactions require user signature
  • Direct Wallet: Transactions go directly to/from user wallet
  • No Private Keys: Never request or store private keys
12

Referrals

The NEXIS Referral System allows users to grow the community by inviting new users. Referrers can earn rewards for successful referrals, while referred users may receive benefits. The system includes anti-abuse measures and comprehensive tracking for transparency.

Referral Links

Each user receives a unique referral link to share with friends, family, and on social media.

  • Unique Links: Personalized referral URL for each user
  • Share Options: Share via email, social media, messaging
  • Tracking: Real-time tracking of clicks and conversions
  • QR Codes: Generate QR codes for offline sharing

Referral Rewards

Both referrers and referred users can receive benefits from successful referrals.

  • Referrer Rewards: XP or other benefits for successful referrals
  • Referee Benefits: Welcome bonuses or tier boosts
  • Milestone Rewards: Additional rewards for referral milestones
  • Community Campaigns: Special referral events with enhanced rewards

Referral Tracking

Comprehensive tracking dashboard for monitoring referral performance.

  • Total Referrals: Number of users referred
  • Active Referrals: Referrals who are active users
  • Conversion Rate: Percentage of clicks that convert
  • Earnings: Total rewards earned from referrals
  • Referral Status: Track each referral's journey

Anti-Abuse Measures

The referral system includes protections against fraud and abuse to ensure fair rewards.

  • Fraud Detection: Automated detection of suspicious patterns
  • Self-Referral Prevention: Cannot refer yourself
  • Quality Requirements: Referred users must meet activity criteria
  • Rate Limiting: Limits on referral velocity
  • Audit Trail: Complete tracking of all referral activity
NEXIS · Platform Guide