Bicrypto - Crypto Trading Platform, Exchanges, KYC, Charting Library, Wallets, Binary Trading, News v6.1.2 + Addons Nulled

Core v6.1.2
Release Date: January 8, 2026 Tags: LICENSE ACTIVATION, TYPE IMPROVEMENTS, VALIDATION, BUG FIXES

Overview
Version 6.1.2 is a minor patch focusing on license activation improvements and type safety enhancements for validation.

Update Instructions
After updating, restart your application:

bash

Code:

pnpm restart

Bug Fixes
License Activation
Activation Flow: Fixed minor issues in the license activation process
Error Handling: Improved error handling during license verification
Improvements
Type Safety
Validation Types: Enhanced TypeScript types for validation schemas
Type Definitions: Improved type definitions for better IDE support and compile-time checks

Core v6.0.6

Release Date: January 5, 2026 Tags: IMPROVEMENTS, BINARY TRADING, SECURITY
Overview

Version 6.0.6 introduces an improved Binary Market management experience with a redesigned creation wizard, and fixes reCAPTCHA integration for more reliable authentication.
Upgrade Notes
Step 1: Configure reCAPTCHA v3

Important: Before running the updator, you must ensure reCAPTCHA is configured correctly in your .env file. reCAPTCHA v2 is no longer supported - you must use v3.

1Follow the complete setup guide: Authentication Setup
2When creating your reCAPTCHA keys in Google Admin Console:

Select reCAPTCHA v3 (NOT v2 - v2 will not work)
Add your domains (e.g., yourdomain.com, www.yourdomain.com)
Copy both Site Key and Secret Key

1Update your .env file with the v3 keys:

env

NEXT_PUBLIC_GOOGLE_RECAPTCHA_SITE_KEY="your-v3-site-key"
NEXT_PUBLIC_GOOGLE_RECAPTCHA_SECRET_KEY="your-v3-secret-key"

::alert{type="warning"} If you previously had reCAPTCHA v2 keys configured, you must generate new v3 keys. v2 keys will not work with this update. ::
Step 2: Run Updator
bash

pnpm updator

This will bundle your updated .env configuration into the production build.
Improvements
Binary Market Management

A redesigned experience for creating and editing binary markets:
› New Market Creation Wizard

Step-by-Step Process: Clear 3-step wizard for adding new binary markets
Market Source Selection: Choose between exchange markets or ecosystem markets with visual guidance
Smart Filtering: Only shows markets not already added as binary markets
Search Functionality: Quick search to find specific trading pairs
Visual Feedback: Modern card-based selection with clear progress indicators

› Market Configuration Options

Active Status: Enable or disable trading on the market
Trending Badge: Mark markets as currently trending
Hot Badge: Feature markets as popular/hot

› Edit Page Improvements

Unsaved Changes Detection: Visual indicator when changes haven't been saved
Reset Functionality: Quickly revert to original values
Loading States: Proper loading indicators during operations

reCAPTCHA Integration

Improved Script Loading: reCAPTCHA now loads reliably in production environments
Hidden Badge: reCAPTCHA badge is hidden globally for cleaner UI (compliant with Google's terms)
Better Error Handling: More graceful handling when reCAPTCHA fails to load

Documentation Updates

reCAPTCHA v3 Setup Guide: Updated documentation with correct instructions for setting up reCAPTCHA v3 (not v2)
Domain Configuration: Clear guidance on adding domains in Google reCAPTCHA Admin Console

Upgrade Support

For assistance with migration or issues:

Visit our Support Center
Review the Documentation
Check Server Requirements

Overview

Version 6.0.4 introduces three major architectural improvements: a comprehensive Centralized Wallet Service, a Multi-Channel Notification Service, and Database-Backed Settings System. The wallet service consolidates all wallet operations across the platform, the notification service provides a unified solution for all platform communications, and the new settings system allows administrators to manage all platform configuration through the admin panel without server restarts. Additionally includes important bug fixes for KYC and binary trading.
Upgrade Notes
Step 1: Remove Deprecated Files

Run this command from your public_html directory to remove all deprecated files:
bash

rm .eslintignore \
frontend/.eslintrc.json \
"frontend/app/[locale]/(dashboard)/user/profile/components/profile-content.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/profile-sidebar.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/tabs/dashboard-tab.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/tabs/personal-info-tab.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/tabs/security-tab.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/ui/activity-card.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/ui/stat-card.tsx" \
"frontend/app/[locale]/(dashboard)/user/profile/components/ui/tab-button.tsx" \
"frontend/app/[locale]/(utility)/comming-soon/page.tsx" \
"frontend/app/[locale]/(utility)/maintinance/page.tsx"

Step 2: Update Notification Templates

Run the following command to update notification templates with SMS and Push content:
bash

pnpm seed:notification

This will add SMS (160 char limit) and Push (240 char limit) message templates to all existing notification templates, enabling multi-channel notifications.
Step 3: Generate VAPID Keys for Web Push

Generate VAPID keys for browser push notifications:
bash

pnpm vapid:generate

This will prompt for your email and automatically update your .env file with the required VAPID keys.
Step 4: Run Updator
bash

pnpm updator

Step 5: Re-save Settings

After running the updator, visit each of the following settings pages in the admin panel and click Save to ensure all settings are properly initialized in the database:

1Platform Settings (/admin/settings) - Security, 2FA, and integration settings
2Blog Settings (/admin/blog/settings) - Blog status and layout settings
3Trading Settings (/admin/trading/settings) - Spot trading settings
4Binary Settings (/admin/finance/binary/settings) - Binary trading configuration

> Note: This step is required because the settings system has been migrated from environment variables to the database. Re-saving ensures all default values are properly stored.
Step 6: Test Notification Service

Visit the Notification Service dashboard to verify all channels are working correctly:

1Notification Dashboard (/admin/system/notification) - Test all notification channels (IN_APP, EMAIL, SMS, PUSH)
2Use the Channel Testing tab to send test notifications to each channel
3Verify provider status in the Settings Panel tab

New Features
Centralized Wallet Service

A complete overhaul of how wallet operations are handled throughout the platform:
› Single Source of Truth

All wallet balance operations now flow through one centralized service
Eliminates duplicate wallet logic that was previously scattered across 78+ files
Consistent behavior for all wallet types: FIAT, SPOT, ECO, FUTURES, and COPY_TRADING

› Atomic Transactions

All wallet operations are now wrapped in database transactions
Prevents partial updates that could lead to balance inconsistencies
Automatic rollback on any failure during multi-step operations

› Idempotency Protection

Every wallet operation requires a unique idempotency key
Prevents duplicate credits/debits from retried requests
Critical for payment webhook handlers that may receive duplicate notifications

› Row-Level Locking

Concurrent wallet updates are now properly synchronized
Eliminates race conditions that could cause balance discrepancies
Uses database-level locking for maximum reliability

› Safe Arithmetic

All balance calculations now use precision-safe arithmetic
Eliminates floating-point errors in financial calculations
Configurable precision per currency type

› Dynamic Precision Caching

Currency precision values are now loaded from database
No more hardcoded precision values throughout the codebase
Auto-refreshing cache with 5-minute TTL

› Comprehensive Error Handling

Dedicated error types for common wallet issues:
Insufficient funds
Wallet not found
Duplicate operation
Negative balance prevention
Wallet disabled
Invalid amount

Wallet Operations Supported

The new service handles all wallet operations:

Credits: Deposits, incoming transfers, refunds, rewards, payouts
Debits: Withdrawals, outgoing transfers, fees, payments
Holds: Lock funds for pending orders
Releases: Return held funds to available balance
Transfers: Atomic movement between wallets with optional fees
Execute from Hold: Complete trades from held funds

Multi-Chain Address Support

Enhanced ECO wallet creation with support for:

EVM Chains: Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, Avalanche, Fantom, Linea, Celo
UTXO Chains: Bitcoin, Litecoin, Dogecoin, Dash
Special Chains: Solana, Tron, Monero, TON

Multi-Channel Notification Service

A complete enterprise-grade notification system that handles all platform communications:
› Unified Notification Architecture

Single Service for All Notifications: Centralized NotificationService replaces scattered notification logic across 66+ backend files
Multi-Channel Support: IN_APP, EMAIL, SMS, and PUSH notifications from a single API
Type Safety: Strongly typed notification types (SYSTEM, INVESTMENT, TRADE, P2P, COPY_TRADING, ICO, STAKING, WALLET, SECURITY, MARKETING, FOREX, BINARY, FUTURES, ECOMMERCE, NFT, ALERT, MESSAGE, USER)
Priority Levels: LOW, NORMAL, HIGH, and URGENT for intelligent message routing

› Core Features

Idempotency Protection

Unique idempotency keys prevent duplicate notifications
30-day deduplication window using Redis cache
Critical for webhook handlers and retry scenarios

User Preferences

Respects per-user, per-type notification preferences
1-hour preference cache with auto-refresh
Granular control over which channels users want to receive

Delivery Tracking

Complete audit trail of all notification attempts
30-day delivery status retention
Per-channel success/failure tracking

Smart Channel Selection

Automatic channel selection based on notification type
Priority-based routing (URGENT → All channels, NORMAL → IN_APP only)
Fallback mechanisms for channel failures

› Channel Implementations

In-App Notifications

WebSocket real-time delivery
Persistent storage in database
Badge counts and read/unread tracking

Email Notifications

Template-based email rendering with EJS
Queue-based processing with Bull
Configurable SMTP and SendGrid support
Automatic retry on failure

SMS Notifications

Twilio integration
E.164 phone number validation
Template system for consistent messaging

Push Notifications

Web Push (VAPID) - Browser push notifications without Firebase
Works with Chrome, Firefox, Edge, Safari
No third-party service required for web browsers
Automatic VAPID key generation script (pnpm vapid:generate)
Service worker for background notification handling
Firebase Cloud Messaging (FCM) - For mobile apps
Required for iOS and Android native apps
Device token management
Smart Provider Selection
Automatically uses VAPID for web subscriptions
Automatically uses FCM for mobile tokens
Supports both simultaneously
Rich notification payloads with badges and actions

› Advanced Capabilities

Batch Operations

sendBatch(): Send to multiple users efficiently
sendToPermission(): Target users by permission level
Optimized database queries and caching

Template Engine

EJS-based templating for emails
Variable substitution for personalization
Channel-specific template support

Redis Caching

User preference caching (1-hour TTL)
Idempotency tracking (30-day TTL)
Delivery status caching (30-day TTL)
Cache hit rate monitoring

Email Queue Management

Bull queue for email processing
Configurable retry strategies
Dead letter queue for failed jobs
Queue statistics and monitoring

› Premium Admin Dashboard

Overview Tab

Real-time statistics with glassmorphism StatsCards
Total Sent, Failed, Queue Jobs, Success Rate
Channel status monitoring (IN_APP, EMAIL, SMS, PUSH)
Performance metrics with visual progress bars
Queue health indicators
System uptime tracking
Redis connection status

Health Monitor Tab

Overall system health status with color-coded indicators
Individual channel health checks
Redis cache connection monitoring
Real-time health updates with manual refresh
Detailed error reporting per channel

Channel Testing Tab

Interactive test tools for all 4 channels
User ID configuration with optional overrides
Email address override for testing
Phone number override for SMS (E.164 format)
Real-time test results with success/failure indicators
Delivery status tracking per test
Testing tips and best practices

Queue Manager Tab

Real-time queue statistics (Waiting, Active, Completed, Failed, Total)
Queue health monitoring with status badges
Failure rate calculation and alerts
Queue cleanup tools with configurable age
Safety confirmation dialogs for destructive actions
Health indicators (degraded when >10% failure rate)

Metrics Panel Tab

Time-based analytics (Hour, Day, Week, Month)
Total notification overview metrics
Channel-specific performance breakdown
Notification type distribution
Success rate visualization per channel
Trend analysis and comparisons

Settings Panel Tab

Channel configuration display
Provider status overview (SendGrid, Nodemailer, Twilio, FCM)
Feature status indicators:
Idempotency (enabled, 30-day TTL)
User Preferences (enabled, 1-hour cache)
Delivery Tracking (enabled, 30-day TTL)
Priority levels overview
All 15+ notification types listed
Provider configuration status

› Complete Migration

100% Platform Coverage

Migrated all 66+ backend files using notifications
Eliminated legacy utils/notifications.ts wrapper
No backward compatibility layers needed
Clean, consistent API across entire platform

Affected Systems

P2P Trading notifications (10+ notification types)
Copy Trading notifications (follower/leader events)
NFT marketplace notifications (listings, bids, auctions)
Ecosystem wallet notifications (deposits, withdrawals, transfers)
ICO notifications (contributions, vesting, refunds)
Staking notifications (deposits, claims, rewards)
Forex trading notifications (deposits, withdrawals, trades)
Futures trading notifications (positions, liquidations)
Binary trading notifications (orders, outcomes)
E-commerce notifications (orders, shipping)
Gateway notifications (payments, refunds)
Investment notifications (AI trading, market maker)

› Technical Architecture

Service Layer

NotificationService singleton for all operations
Channel registry for extensibility
Provider abstraction layer
Error handling with dedicated exception types

Data Models

notification table for in-app messages
notification_user_preference for user settings
Redis for caching and idempotency
Bull queue for email processing

Type Safety

TypeScript interfaces for all operations
Zod schemas for validation
Strict null checking throughout

Performance Optimizations

Redis caching reduces database queries
Batch operations minimize network overhead
Queue-based email processing prevents blocking
Connection pooling for external services

Database-Backed Settings System

All platform configuration has been migrated from environment variables to the database, allowing real-time configuration changes through the admin panel:
› Settings Now in Admin Panel

Security Settings (/admin/settings):

Authentication:
Google OAuth Login - Enable/disable social login
Email Verification - Require email verification after registration
Two-Factor Authentication:
Master 2FA toggle
SMS-based authentication
Email-based authentication
Authenticator app (TOTP)
Protection:
Google reCAPTCHA - Bot protection for forms

Integration Settings (/admin/settings):

Google Analytics - Website analytics tracking
Facebook Pixel - Advertising and conversion tracking

Module-Specific Settings:

Blog Settings (/admin/blog/settings):
Blog status toggle
Post layout selection (Default/Modern/Classic)
Trading Settings (/admin/trading/settings):
Spot trading enable/disable
Binary Trading Settings (/admin/finance/binary/settings):
Master toggle to enable/disable binary trading
Practice/demo mode toggle
Order types configuration (Rise/Fall, Higher/Lower, Touch/No Touch, Call/Put, Turbo)
Duration settings
Payout percentages
Barrier and strike levels
Risk management rules
Cancellation policies

› Key Benefits

Instant Changes: All settings take effect immediately without server restart
Admin-Friendly: Configure through web interface instead of editing files
Centralized: All platform settings managed in one place
Secure: No need to access server files for configuration
Environment Independent: Same settings work across all environments

› Maintenance Mode Improvements

Automatic maintenance page when server stops
No configuration needed
Removed maintenance checks from application code
Cleaner, more maintainable codebase

› Migration Details

Removed Environment Variables:

NEXT_PUBLIC_GOOGLE_AUTH_STATUS
NEXT_PUBLIC_VERIFY_EMAIL_STATUS
NEXT_PUBLIC_2FA_STATUS and related 2FA method toggles
NEXT_PUBLIC_GOOGLE_RECAPTCHA_STATUS
NEXT_PUBLIC_GOOGLE_ANALYTICS_STATUS
NEXT_PUBLIC_FACEBOOK_PIXEL_STATUS
NEXT_PUBLIC_BLOG_STATUS
NEXT_PUBLIC_BINARY_STATUS and NEXT_PUBLIC_BINARY_PRACTICE_STATUS
NEXT_PUBLIC_MAINTENANCE_STATUS

Retained in .env (API keys and credentials):

NEXT_PUBLIC_GOOGLE_CLIENT_ID
NEXT_PUBLIC_GOOGLE_RECAPTCHA_SITE_KEY
NEXT_PUBLIC_GOOGLE_ANALYTICS_ID
NEXT_PUBLIC_FACEBOOK_PIXEL_ID

› Notification System Configuration

Email Provider Configuration (Choose one)

Option 1: SMTP (Nodemailer)

APP_EMAILER="nodemailer-smtp"
APP_NODEMAILER_SMTP_HOST - Your SMTP server hostname
APP_NODEMAILER_SMTP_PORT - SMTP port (587 for TLS, 465 for SSL)
APP_NODEMAILER_SMTP_ENCRYPTION - "tls" or "ssl"
APP_NODEMAILER_SMTP_SENDER - Your sender email address
APP_NODEMAILER_SMTP_PASSWORD - SMTP authentication password
NEXT_PUBLIC_APP_EMAIL - Public-facing email address
APP_EMAIL_SENDER_NAME - Display name for emails

Option 2: Gmail/Outlook (Nodemailer Service)

APP_EMAILER="nodemailer-service"
APP_NODEMAILER_SERVICE - "gmail" or "outlook"
APP_NODEMAILER_SERVICE_SENDER - Your Gmail/Outlook email
APP_NODEMAILER_SERVICE_PASSWORD - App-specific password (not your account password)
NEXT_PUBLIC_APP_EMAIL - Public-facing email address
APP_EMAIL_SENDER_NAME - Display name for emails

Option 3: SendGrid

APP_EMAILER="nodemailer-sendgrid"
APP_SENDGRID_API_KEY - Your SendGrid API key
APP_SENDGRID_SENDER - Verified sender email in SendGrid
NEXT_PUBLIC_APP_EMAIL - Public-facing email address
APP_EMAIL_SENDER_NAME - Display name for emails

SMS Provider Configuration

APP_TWILIO_ACCOUNT_SID - Twilio Account SID
APP_TWILIO_AUTH_TOKEN - Twilio Auth Token
APP_TWILIO_PHONE_NUMBER - Your Twilio phone number (E.164 format: +1234567890)
APP_SUPPORT_PHONE_NUMBER - Support phone number for SMS messages

Push Notification Configuration

Two options are available for push notifications. You can use either one or both:

Option 1: Web Push (VAPID) - Recommended for Browsers

Works with Chrome, Firefox, Edge, and Safari without requiring Firebase.
bash

# Generate VAPID keys automatically
pnpm vapid:generate

This script will prompt for your email and automatically update your .env file with:

VAPID_PUBLIC_KEY - Generated public key for browser subscriptions
VAPID_PRIVATE_KEY - Generated private key (keep secret!)
VAPID_SUBJECT - Your email (mailto:admin@example.com) or website URL

Option 2: Firebase Cloud Messaging (FCM) - For Mobile Apps

Required for native iOS and Android apps:

FCM_PROJECT_ID - Your Firebase project ID
FCM_PRIVATE_KEY - Firebase service account private key
FCM_CLIENT_EMAIL - Firebase service account email
FCM_SERVICE_ACCOUNT_PATH - Alternative: path to service account JSON file

Important Notes

All email providers are now centrally managed through the notification service
The system automatically detects and uses the configured provider
No code changes needed to switch between providers
Provider status is displayed in the admin notification settings panel
Test each channel through the admin panel after configuration
Web Push (VAPID) is recommended for browser notifications - no Firebase account needed
FCM is only required if you have native iOS/Android mobile apps
Both VAPID and FCM can be configured simultaneously - the system will use the appropriate one based on subscription type

Bug Fixes
KYC Document Type Toggle Not Saving

Fixed Document Type Toggle Persistence: Resolved an issue in the KYC Level Builder where toggling identity document types (Passport, Driver's License, National ID, Residence Permit, Other Government-Issued ID) on or off would not persist after saving

Binary Trading Transaction Type Error

Fixed Transaction Type Validation: Resolved an error where binary trading order completions (WIN/LOSS) would fail with "Type must be one of the valid transaction types"
Operation types are now properly mapped to valid database transaction types while preserving the original operation type in metadata for auditing

Menu Visibility Based on Settings

Fixed Binary Menu Visibility: Binary trading menu items now properly hide from user navigation when binary trading is disabled in settings
Admin Menu Always Visible: Admin panel menu items for binary and blog now remain visible regardless of feature status, allowing administrators to manage settings even when features are disabled
Proper Settings Integration: Binary status is now managed through main settings system with proper naming (binaryStatus, binaryPracticeStatus) for easy identification
Settings Type Handling: Fixed menu filtering to handle both string "true" and boolean true values since the settings store converts strings to booleans for convenience
Settings Array Conversion: Fixed critical menu visibility issue by properly converting settings array from API to object format using settingsToObject() helper

Binary Settings UI Improvements

Master Controls at Top: Moved binary master toggles (Binary Trading Status and Practice Mode Status) to the top of the settings page as the most important settings
Full Responsiveness: Updated all grid layouts in binary settings page for proper mobile and tablet responsiveness
Clean Architecture: Implemented three-key architecture with binaryStatus, binaryPracticeStatus, and binarySettings as completely separate, independent database keys with no legacy compatibility layer
Enhanced UI: Created prominent Master Controls section with glassmorphism card design and gradient styling
Separate State Management: Added independent state variables for master toggles and advanced settings for cleaner code organization

2FA Settings Display

Fixed Conditional Display: Resolved issue where SMS 2FA, Email 2FA, and Authenticator App 2FA settings weren't showing when master 2FA toggle was enabled
Type-Safe Comparisons: Updated all showIf functions to handle both string "true" and boolean true values throughout the settings configuration
Consistent Behavior: All conditional fields now properly display based on parent settings regardless of value type

Blog Settings Organization

New General Tab: Created new "General" tab as the first tab in blog settings for primary configuration
Reorganized Settings: Moved Blog Status toggle and Blog Post Layout from Display tab to General tab for better UX
Improved Navigation: General settings now appear first, making the most important blog configuration immediately accessible

ESLint Configuration and Code Quality

Migrated to ESLint Flat Config: Updated from deprecated .eslintignore file to modern ignores property in eslint.config.mjs
Fixed All Case Declaration Errors: Resolved 32 no-case-declarations errors by wrapping lexical declarations in case blocks with braces across multiple files:
position-sizing-calculator.tsx - Fixed 5 cases
use-risk-management.ts - Fixed 5 cases
orderbook.worker.ts - Fixed 2 cases
chart-canvas.tsx - Fixed 2 cases
image-resizer.tsx - Fixed 4 cases
Fixed Critical Hook Violations: Resolved conditional hook call in element renderer by moving validation inside useMemo and wrapping helper functions in useCallback
Configured React Hooks Plugin: Added and configured eslint-plugin-react-hooks with appropriate rules for the codebase patterns
Optimized Hook Rules: Disabled exhaustive-deps and rules-of-hooks to prevent infinite loops and allow intentional render helper patterns
Added Comprehensive Ignores: Configured ESLint to ignore build artifacts, generated files, and third-party code (chart-engine, i18n webpack plugins)

Premium User Profile Redesign

Complete overhaul of the user profile page with a premium "Obsidian Lux" design aesthetic:
› New Premium Components

Profile Hero: Animated header with security score ring, avatar upload, profile completion bar, and contextual action buttons
Premium Sidebar: Glassmorphism navigation with profile stats, security tips, and smooth tab transitions
Dashboard Tab: Account overview with stat cards, security checklist, recent activity feed, and quick actions
Security Tab: Security center with 2FA management, session controls, and security score visualization
Personal Info Tab: Enhanced form with cascading location selectors (Country → State → City)

› Design Features

Dark zinc backgrounds with amber/gold accent gradients
Glassmorphism effects with subtle transparency
Framer Motion animations throughout
Responsive design for all screen sizes
Security score ring visualization around avatar

› Location Selector Integration

Integrated CountrySelect, StateSelect, and CitySelect components from UI library
Cascading selection with automatic reset (changing country resets state and city)
Consistent dark theme styling across all selectors

› Conditional UI Based on Settings

KYC-related UI elements now respect kycStatus setting:
KYC badge on profile hero hidden when KYC disabled
"Upgrade KYC" button hidden when KYC disabled
"KYC Level" stat card hidden when KYC disabled
"KYC Verification" checklist item hidden when KYC disabled
Removed share profile functionality (no public profile page exists)

› Smart Action Buttons

Profile hero action buttons now show contextually based on current tab:
Settings button: Visible on Overview and Profile tabs (navigates to Security)
Edit Profile button: Visible on Overview and Security tabs (navigates to Profile)
Prevents redundant navigation buttons when already on the target tab

Improvements
Backend Security Validation

Binary Order Creation: Added validation to check binaryStatus and binaryPracticeStatus settings before allowing order placement to prevent money-spending when features are disabled
Investment Creation: Added validation to check investment setting before creating investments to prevent unauthorized investment creation
Spot Trading Orders: Added validation to check spotStatus setting before creating orders to prevent trading when feature is disabled
Read-Only Endpoints Protected: Market listing and other read-only endpoints remain unrestricted for better user experience while money-spending operations are properly gated

Payment Gateway Handlers

All fiat deposit verification handlers now use the centralized wallet service
Consistent error handling across all payment gateways
Improved transaction logging with operation metadata

Gateway Operations

Refund processing uses atomic wallet operations
Fee collection properly tracked through wallet service
Payout processing with proper audit trail

Trading Operations

Exchange order wallet operations centralized
Binary order payouts use safe arithmetic
Copy trading allocations properly tracked

P2P Trading

Trade release and cancellation use atomic operations
Offer creation with proper fund locking
Dispute resolution through centralized service

Admin Settings Enhancements

Clear Settings Cache Button: Added a cache refresh button to the System Settings page header for quick cache invalidation when settings don't reflect correctly
Cache API Endpoints: New POST /api/admin/system/settings/cache endpoint for programmatic cache management
VAPID Provider Detection: Notification settings panel now correctly shows VAPID (Web Push) vs FCM (Firebase) based on configured environment variables
Settings Cache Fix: Fixed a bug where updating settings could corrupt the in-memory cache, causing only partial settings to be returned

Notification Templates

SMS Templates Added: All notification templates now include SMS message content (160 character limit)
Push Templates Added: All notification templates now include Push notification body content (240 character limit)
SMS & Push Enabled by Default: All 99 notification templates now have sms: true and push: true enabled by default
Template Seeder Update: Running pnpm seed:notification will now update existing templates with SMS/Push content and enable the flags
Template Manager UI: SMS and Push channel toggles are now fully functional in the admin notification template editor (/admin/system/notification/template)

PWA Management & Push Notifications

Auto-Generated Manifest Files: PWA manifest files (manifest.json and site.webmanifest) are now auto-generated if missing when accessing PWA settings, using environment variables for default values
Multi-Device Push Support: Push notifications now properly send to ALL registered devices instead of just one, enabling users to receive notifications on desktop and mobile simultaneously
Automatic Subscription Sync: Browser push subscriptions are automatically synced with the server when visiting the notifications settings page, ensuring devices are always registered
Device ID Generation: Consistent device IDs are generated based on push endpoint hash, ensuring the same device always uses the same identifier across sessions
Fixed Notification Icons: Push notification icons now display correctly using proper paths (/img/logo/android-chrome-192x192.png)
Service Initialization Optimization: Removed duplicate provider initialization that was causing redundant startup logs - TwilioProvider and WebPushProvider are now initialized only once
Consolidated Startup Logs: Notification service startup now shows a single clean log line: [NotificationService] Channels: IN_APP, EMAIL, SMS, PUSH (WebPush) instead of multiple verbose entries
Channel Singleton Pattern: API endpoints now reuse registered notification channels instead of creating new instances, improving performance and eliminating duplicate initialization

Ecosystem Operations

ECO wallet creation streamlined
Blockchain deposit processing improved
Transfer operations between wallet types unified

Data Table Filter Responsiveness

Improved Grid Breakpoints: Filter grid now uses more appropriate breakpoints to prevent overlap:
Single column on mobile (default)
2 columns at md (768px+)
3 columns at xl (1280px+)
4 columns at 2xl (1536px+)
Text Filter Stacking: Operator select and input now stack vertically on smaller screens, switching to horizontal layout at lg (1024px+)
Range Filter Stacking: Operator select and value inputs now stack vertically until lg breakpoint, with "between" mode inputs stacking until sm breakpoint
Reduced Padding on Mobile: Filter container now uses smaller gap and padding on mobile (gap-3 p-3) with larger values on sm+
Prevented Overflow: Added min-w-0 to flex items to prevent content overflow in constrained grid cells

Technical Notes
Backward Compatibility

All existing APIs continue to work without changes
Internal implementations updated to use centralized service
No database schema changes required

Audit Logging

Console-based audit logging for all wallet operations
Transaction table serves as the source of truth
Original operation types preserved in transaction metadata

Core v6.0.3

Release Date: January 1, 2026 Tags: MAJOR UPDATE, BINARY TRADING OVERHAUL, TRADING PRO, PATTERN LIBRARY, EMAIL SYSTEM, PERFORMANCE, ADMIN DASHBOARDS
Important: Update Instructions

This is a significant update that requires specific steps to complete successfully:
Update Steps

1Delete the /backend/src and /backend/dist and frontend/app/[locale]/(ext) folders completely from your server
2Download the latest Core and all addons from Envato
3Extract all files to your public_html directory
4Run the updator: Execute pnpm updator to perform the update
5Seed notification templates (optional but recommended):

bash

pnpm seed:notification

This command will populate the new notification email templates
Post-Update Checklist

Verify all email templates are rendering correctly
Test the new trading interface
Check binary trading features are working
Confirm admin dashboards display properly

Overview

Version 6.0.3 is a comprehensive update that completely overhauls the binary trading system with 5 new order types and advanced gamification, introduces a professional-grade Trading Pro interface with responsive collapsible panels, adds a pattern library with 62+ patterns, redesigns all email templates, and includes major performance improvements with lazy database synchronization reducing server startup from 15 seconds to under 0.01 seconds.
Major New Features
Complete Binary Trading Overhaul

A ground-up redesign of the entire binary trading experience with professional-grade features:
› 5 Binary Order Types

Rise/Fall: Classic prediction if price will rise or fall
Higher/Lower: Predict price will close above or below a barrier level
Touch/No Touch: Predict if price will touch or avoid a barrier level during the contract
Call/Put: Options-style trading with strike prices and payout-per-point calculations
Turbo: Fast-paced trading with barrier breach detection and dynamic payouts

Each order type includes:

Individual profit percentage configurations
Min/max duration settings
Barrier and strike price support where applicable
Separate enable/disable for demo and live trading

› Gamification System

Leaderboard:

Daily, Weekly, Monthly, and All-Time rankings
Multiple ranking metrics: Profit, Win Rate, Volume
Personal rank display with percentile and qualification status
Top 100 traders with avatar display and detailed statistics

Challenges & Achievements:

16 Daily Challenges (first trade, win streaks, profit targets, etc.)
12 Weekly Challenges (25-100 trades, 55-70% win rate targets, etc.)
40+ Achievements (milestones, streaks, consistency badges)
Reward types: XP, Badges, Demo bonus, Special titles

20-Level Progression System:

Progression from "Newcomer" to "Grandmaster"
XP-based leveling with cumulative requirements (0 to 100,000 XP)
Difficulty-based XP multipliers (Easy 1x to Legendary 3x)
Visual progress tracking with celebration animations

› Advanced Trading Settings

User Trading Controls:

One-click trading (instant trade without confirmation)
Martingale strategy with configurable settings
Daily loss limit with auto-disable protection
Stop-loss and take-profit thresholds
Trade cooldown (minimum wait between trades)

Position Sizing (4 Methods):

Fixed amount sizing
Percentage of balance
Risk-based calculation
Custom templates with presets

Sounds & Notifications:

Master notification controls
Individual sound effects for every trade event
Volume control with test functionality
Push notification support with browser permissions
Quiet hours scheduling
Toast position and duration configuration

› Trading Analytics & Journal

Complete performance statistics (win rate, P&L, best/worst trades)
Symbol-by-symbol breakdown
Time-based analysis (by hour and day of week)
Advanced metrics: Sharpe Ratio, Sortino Ratio, Max Drawdown, Recovery Factor
Full trade journal with notes, tags, and ratings
Export to CSV functionality
Equity curve visualization
Win/loss streak tracking

Trading Pro Interface

A completely new trading layout designed for professional traders with responsive design across all devices:
› Panel System

Markets Panel: Watchlist, spot, futures, and ecosystem markets with real-time ticker
Chart Panel: TradingView or Chart Engine integration with full-screen mode
Order Book Panel: Real-time order book with 10-level aggregation, depth chart, and trades view
Trading Form Panel: Buy/sell interface with spot and futures support, leverage controls
Orders Panel: Open orders, order history, and trade history with filtering
Positions Panel: Futures positions management

› Collapsible Panels

All panels (except chart) can be collapsed to save space
Collapsed state persisted to localStorage
Smart auto-collapse on smaller screens
Visual indicators showing collapse direction
Vertical text for side panels, horizontal for bottom panels

› Responsive Design

Desktop (1280px+):

Full 4-column horizontal layout
All panels visible with independent sizing
Panel widths scale with screen size (220px to 380px)

Tablet (640px-1023px):

Vertical stack layout
Chart at top, orderbook and trading side-by-side below
Orders panel auto-collapsed by default
Markets accessible via symbol click modal

Mobile (<640px):

Dedicated mobile app layout
Bottom tab navigation (Chart, Orderbook, Trade, Orders, Positions)
Haptic feedback support
Safe area handling for notched devices

› Layout Presets

4 built-in presets: Trading Pro, Chart Focus, Scalping, Lite Mode
Custom layout saving with names and descriptions
Automatic persistence to localStorage

Pattern Library (62+ Patterns)

A comprehensive pattern detection system for technical analysis:
› Pattern Categories

Candlestick Patterns (17 patterns):

Three White Soldiers, Three Black Crows
Morning Star, Evening Star
Bullish/Bearish Engulfing
Piercing Line, Dark Cloud Cover
Hammer, Shooting Star, Inverted Hammer, Hanging Man
Doji, Marubozu, Harami
Tweezer Top/Bottom, Three Inside Up/Down

Chart Patterns (7 patterns):

Double Top, Double Bottom
Head & Shoulders, Inverse Head & Shoulders
Symmetrical Triangle, Ascending Triangle, Descending Triangle

Harmonic Patterns (4 patterns):

Gartley, Butterfly, Bat, Crab
Fibonacci ratio validation with configurable tolerance

› Pattern Detection Features

Real-time detection on every candle
Strength scoring (0-1 scale)
Active pattern tracking (last 10-20 candles)
Visual overlays with target lines and stop losses
Pattern panel with filtering by category and direction
Detailed guidance and trading tips for each pattern

Email Templates Complete Redesign

A total overhaul of the email notification system:
› New Template Structure

Professional HTML email designs
Responsive layouts for all email clients
Consistent branding with header/footer wrapper
Dynamic variable support for personalization

› Notification Template Manager

Three-Panel Interface:

Left Panel: Searchable template list with 13 categories
Center Panel: WYSIWYG HTML editor with subject line editing
Right Panel: Variable reference with one-click insertion

Template Categories (13):

Authentication, Wallet & Transactions, Trading
Copy Trading, Investments, Forex, Staking
ICO & Token Sales, KYC & Verification
Support & Tickets, E-commerce, Author & Content
P2P Trading, System

Features:

Real-time change tracking with unsaved indicator
Multi-channel preparation (Email, SMS, Push)
Template-specific variable filtering
Preview with wrapper template
Variable validation

New Admin Dashboards

Comprehensive dashboard pages for all major trading modules:
› P2P Trading Dashboard

Total Offers, Active Trades, Open Disputes, Platform Revenue stats
Trading Overview chart with volume and revenue trends
Currency distribution and active offers comparison
Platform health gauge with top traders leaderboard

› Futures Dashboard

Total Positions, Active Positions, Total Volume, Total P&L stats
Long/Short ratio visualization
Trading activity charts and top markets list
Recent positions table with full details

› AI Investment Dashboard

Investment metrics with Win/Loss/Draw breakdown
Investment type distribution (Spot vs Eco)
Volume charts and plan distribution
Active plans list with recent investments

› Forex Dashboard

Investment stats with account breakdowns
Live and Demo account tracking
Pending deposits/withdrawals monitoring
Signal integration

› Copy Trading Dashboard (Reworked)

Completely redesigned with modern interface
Leader and follower statistics
Profit sharing and commission tracking

› Stats Cards System

New unified StatsCard component across all admin pages
12 pre-defined color schemes
Sparkline chart support
Change badges with growth indicators
Glassmorphism styling with animations

Performance Improvements
Lazy Database Synchronization

Revolutionary improvement to server startup time:

Before: ~15 seconds to start server
After: ~0.01 seconds to start server (1500x faster)

How it works:

Computes hash of all database models
Only runs ALTER sync if models have changed
Otherwise, just authenticates connection
Configurable modes: none, lazy (default), always, force

New Locales System

Completely reworked internationalization:

Size reduction: 99.98% smaller locale files per page
Full TypeScript support with auto-generated types
Auto-generation of locale files from source
Support for 90 languages with complete translations
Code-split locales loaded per-page

Additional Features
Binary Trading Admin Settings

Order Type Configuration:

Enable/disable individual order types
Min/max trade amounts per type
Payout percentage ranges
Duration limits
Max concurrent orders per user

Barriers & Strikes:

Configurable barrier distances for Higher/Lower, Touch/No Touch, Turbo
Strike price distances for Call/Put
Payout-per-point settings

Duration Management:

New duration configuration replacing old table
Smart adjustment per interval for all order types
Min time and max time settings

Cancellation Rules:

Minimum time before expiry for cancellation
Penalty percentage by duration
Order placement and cancellation buffers

Risk Management:

Auto-disable trading when loss limits reached
Win rate threshold alerts
Per-user limits (orders/minute, orders/hour, daily loss)
Cooling period after max loss

Payout Optimizer:

One-click optimization across all intervals and order types
3 built-in presets for common configurations

Addons & Integrations Manager

New unified page for all addons with details
Addon status, version, and configuration
Quick enable/disable toggles

System Updates

New system updates page
Extensions update management
License activation interface
License verification system
Security system to prevent unauthorized platform use

Licensing System (Reworked)

Get updates from new API without active support
Automated license verification
Improved update delivery

Maintenance Mode

Automatic maintenance page system that activates when the server is stopped:

Features:

Beautiful, crypto-themed maintenance page with animations
Automatically starts when you run pnpm stop
Automatically stops when you run pnpm start
Runs independently of Next.js (lightweight Node.js server)
Serves on both frontend (port 3000) and backend (port 4000)
Returns proper 503 status for API requests with JSON response
Auto-refreshes every 30 seconds to check if site is back

Maintenance Page Display:

Professional crypto trading platform design
Animated status bar showing system status
Progress tracker with maintenance steps
Floating particles and gradient background
Mobile responsive design

Usage:
bash

# Stop servers and show maintenance page
pnpm stop

# Start servers (automatically hides maintenance page)
pnpm start

# Manual maintenance control (if needed)
pnpm maintenance:start
pnpm maintenance:stop

Bug Fixes
Trading

Fixed race condition issue in copy trading
Fixed use of copy trading wallet in market orders
Fixed binary navigation where new markets replaced old ones instead of adding

Ecosystem

Fixed ecosystem section in landing page
Improved error handling for all blockchain master wallet fetching
Fixed NFT marketplace pausing process

UI/UX

Fixed help link in emails sending to non-existing page
Fixed affiliate URL generator
Improved affiliate conditions UI
Deploy new marketplace contract UI improvements
Mailwizard template creation page fully reworked

Performance

Cleaned public folder from all redundant old files and images
Improved ecosystem token creation design with detailed guidance

Technical Improvements
Chart Engine Support

New Chart Engine option for binary and trading pages
Settings to enable/disable Chart Engine vs TradingView
Full feature parity between chart providers

Exchange Provider

Reworked to use only enabled provider directly
No longer requires selecting provider first
Cleaner configuration interface

Chart Data Management (Admin)

New admin page for managing historical chart data cache at /admin/finance/exchange/chart:

Statistics & Overview:

View all enabled markets with chart data statistics
See candle counts, file sizes, and date ranges per interval
Gap detection showing missing data in chart history
Total cache size monitoring across all markets

Build Chart Data:

Fetch historical OHLCV data from exchange provider
Configurable historical days (1-365 days)
Rate limit control to respect exchange API limits
Select specific intervals to build (1m, 5m, 15m, 1h, 4h, 1d, etc.)
Background job execution with real-time progress tracking
Build for all markets or selected markets only

Clean Chart Data:

Delete cached chart data for selected markets
Clean specific intervals or all intervals at once
Clears both file cache and Redis cache
Bulk selection with select all option

Fix Chart Gaps:

Automatic gap detection in existing chart data
One-click gap filling per market/interval
Fetches missing candles from exchange to complete history
Rate-limited to avoid exchange API bans

Settings:

Configure default cache duration (days)
Set rate limit for API requests
Select default intervals for building
Exchange ban status monitoring with countdown

Code Quality

Complete translation of all strings in 90 locales
Improved type safety throughout
Better error handling with descriptive messages

Overview

Version 6.0.2 focuses on a complete redesign of the admin settings experience across all extensions, introduces a new interactive API documentation system, adds dynamic social link management, improves the notification center, and delivers important bug fixes for homepage stability and notification sounds.

Major New Features

Unified Admin Settings System

A completely redesigned settings system that provides a consistent, modern experience across all admin settings pages:

• Unified Settings Component: All extension settings pages now share a common, beautifully designed interface


• Tab-Based Organization: Settings are organized into logical tabs with smooth animations and visual indicators


• Field Type Support: Support for switches, text inputs, numbers, ranges, URLs, selects, file uploads, and custom components


• Quick Stats Badges: Each tab shows at-a-glance counts of toggles, selects, and other field types


• Conditional Fields: Settings can show/hide based on other setting values


• Real-Time Validation: Instant feedback on setting changes with unsaved changes tracking


• Responsive Design: Fully responsive layout that works on all screen sizes

New Interactive API Documentation

Replaced the old Swagger UI with a brand new, custom-built API documentation system:

• Modern Interface: Clean, intuitive interface with collapsible endpoint groups


• Interactive Playground: Test API endpoints directly from the documentation


• Code Generation: Auto-generated code examples in multiple languages:


• cURL


• JavaScript (Fetch)


• Python (Requests)


• PHP


• Go


• Ruby


• Schema Visualization: Interactive schema viewer showing request/response structures


• Search & Filter: Quick search to find endpoints by name, path, or description


• Method Badges: Color-coded badges for GET, POST, PUT, DELETE methods


• Copy to Clipboard: One-click copy for all code examples


• Dark Mode Support: Full dark mode support matching the platform theme

Dynamic Social Links Management

• Custom Social Links: Administrators can now add, edit, and remove social links from the footer


• Icon Library: Pre-built icons for popular platforms (Twitter, Facebook, Instagram, LinkedIn, Telegram, Discord, GitHub, Reddit, TikTok, YouTube)


• Custom Icons: Support for custom icon URLs for any platform


• Drag & Drop Ordering: Reorder social links with intuitive drag and drop


• Live Preview: See changes instantly in the footer preview

Extension Landing Page Footer

All extension landing pages now feature the main site footer (SiteFooter) for better navigation:

• Consistent Footer: Landing pages for all extensions (staking, affiliate, copy-trading, etc.) show the full site footer


• Subpage Footer: Non-landing pages within extensions show the standard dashboard footer


• Reusable Wrapper: New ExtensionLayoutWrapper component handles footer logic based on current path


• Custom Subpage Footers: Extensions can optionally provide their own custom footer for subpages (e.g., NFT's minimal footer)

Extension Settings Redesigned

All extension admin settings pages have been redesigned with the new unified system:

System Settings

• Modern tabbed interface with General, Features, Wallet, Social, and Logos tabs


• Logo field with preview and size recommendations


• Social links management integrated

Blog Settings

• Reorganized into General, Features, Display, Comments, and Notifications tabs


• Cleaner layout with better field groupings

Affiliate Settings

• New MLM levels editor with visual tier management


• Commission settings with percentage sliders


• Referral tracking configuration

AI Market Maker Settings

• Trading parameters with range sliders


• Risk management settings


• Emergency actions panel for quick interventions

Copy Trading Settings

• Leader and follower configuration tabs


• Commission and fee settings


• Risk management controls

E-commerce Settings

• Product display options


• Checkout configuration


• Inventory management settings

Gateway Settings

• Wallet types selector with currency configuration


• Fee and limit management


• Webhook retry settings

NFT Marketplace Settings

• Trading fees with percentage sliders


• Content moderation settings


• Verification requirements

P2P Trading Settings

• Minimum trade amounts by currency


• Payment method configuration


• Dispute resolution settings

Staking Settings

• Pool creation parameters


• Reward distribution settings


• Lock period configuration

Bug Fixes

Homepage Stability

• Fixed Scroll Animation Error: Resolved "Target ref is defined but not hydrated" error that occurred when navigating to the homepage


• Mobile App Section Fix: Fixed the same hydration issue in the mobile app section's parallax animations


• Smoother Transitions: Page transitions no longer cause animation-related errors

Notification Sound Glitch

• Fixed Audio Glitch on Page Load: Notification sound no longer makes a brief glitch sound when pages load


• Lazy Audio Loading: Sound files are now loaded only after user interaction, preventing autoplay issues


• Silent Unlock: Audio system unlocks silently without playing any audible sound


• Better Browser Compatibility: Improved handling for iOS Safari and other restrictive browsers

Settings Quick Stats

• Fixed Empty Badges: Settings tabs no longer show "0 toggles" or "0 selects" badges when there are no fields of that type


• Conditional Display: Badges only appear when there are actual fields to count

Rich Text Editor

• Simplified Editor Component: Streamlined the editor component for better performance


• Removed Quill Dependency: Editor now uses a lighter-weight implementation

Notification Page

• Filter Spacing: Fixed "1Active filter" text to properly show space between count and word

UI/UX Enhancements

Notification Center Redesign

The notification page has been completely revamped with modern UI patterns:

• Sticky Headers with IntersectionObserver: Date headers stick to the top when scrolling, with smooth transitions as new dates come into view


• Custom Tab System: Replaced standard tabs with custom Framer Motion animated tabs featuring layoutId for smooth indicator transitions


• Filter Chips: Modern filter chip interface for selecting notification types


• Improved Mobile Experience: Better responsive design with optimized spacing and touch targets


• Enhanced Visual Hierarchy: Clear separation between notification groups with improved typography

Footer Redesign

• Dynamic Content: Footer now dynamically shows/hides sections based on enabled extensions


• Social Links Integration: Custom social links from settings appear automatically


• Better Organization: Cleaner layout with improved navigation links


• Responsive Grid: Better mobile layout with proper stacking

Admin Settings Pages

• Consistent Design Language: All settings pages now share the same visual style


• Animated Transitions: Smooth tab transitions and field animations


• Better Error States: Clear error indicators and validation messages


• Loading States: Skeleton loaders while settings are being fetched

API Documentation Page

• Sidebar Navigation: Collapsible sidebar with endpoint grouping


• Sticky Headers: Endpoint headers stay visible while scrolling


• Response Examples: Formatted JSON response examples


• Parameter Tables: Clear tables showing required and optional parameters

Performance Improvements

Settings System

• Reduced Bundle Size: Removed redundant per-extension setting components


• Shared Components: Single set of reusable components for all settings pages


• Optimized Re-renders: Better memoization in settings forms

API Documentation

• Removed Swagger UI: Replaced heavy Swagger UI bundle with lightweight custom implementation


• On-Demand Loading: Documentation content loads as needed


• Cached OpenAPI Spec: API specification is cached to reduce server load

Notification System

• Lazy Audio Initialization: Audio element created without source until needed


• Throttled Playback: Prevents audio spam with 1-second minimum between sounds


• Memory Efficient: Audio resources properly cleaned up

Update Notes - Core 5.7.7
Update Notes

Important: Pre-Update Instructions
Before running the update, you MUST restart your VPS/server: 1. Restart your VPS (reboot the entire server) 2. After reboot, run pnpm install to update dependencies 3. Rebuild and start your application Failure to restart the server before updating may cause build failures or runtime errors due to cached processes and memory issues.
Security Fixes

Dependency Updates: Updated to Next.js 16.1.0-canary.15 to address Turbopack stability issues
Server External Packages: Added serverExternalPackages configuration to properly isolate server-only modules (ioredis, sharp, pino, pino-pretty)
Build Configuration: Improved Turbopack configuration to prevent worker_threads bundling issues

Changed
Frontend Build System

Next.js 16 Canary: Upgraded to Next.js 16.1.0-canary.15 for improved Turbopack stability
Turbopack Configuration: Updated next.config.js with proper server external packages to fix NftJsonAsset: cannot handle filepath worker_threads build error
Removed Deprecated Config: Cleaned up deprecated experimental.serverComponentsExternalPackages in favor of top-level serverExternalPackages

New Extension: Payment Gateway
This release introduces the Payment Gateway extension, enabling merchants to accept cryptocurrency payments from external websites and applications.
Key Features

Multi-Wallet Payment Support: Customers can pay using multiple wallets and currencies in a single transaction
Flexible Allocations: Split payments across FIAT, SPOT, and ECO wallet types
Real-time Exchange Rates: Automatic currency conversion with live market rates
Merchant Dashboard: Complete analytics, payment history, and payout management
API Integration: RESTful API with webhooks for seamless third-party integration
WooCommerce Plugin: Ready-to-use WordPress/WooCommerce integration
Test Mode: Full sandbox environment for development and testing

Merchant Features

Payment Management: View all incoming payments with detailed transaction history
Refund Processing: Issue full or partial refunds to customers
API Keys: Generate and manage API keys for integration
Payout Tracking: Monitor pending and completed payouts
Balance Overview: Real-time view of available and pending balances per currency

Admin Features

Merchant Management: Approve, suspend, or manage merchant accounts
Payment Oversight: Monitor all platform payments with filtering and search
Payout Approval: Review and approve merchant payout requests
Platform Analytics: Revenue tracking, transaction volumes, and fee collection
Global Settings: Configure fees, payout schedules, and payment limits

Technical Implementation

Allocation-Based Payments: Payments store allocations as JSON column for multi-wallet support
Gateway Balance Tracking: Dedicated gatewayMerchantBalance table tracks pending/available funds separately from wallet balances
Secure Fund Flow: Funds held in gateway balance until admin-approved payout
Webhook System: Real-time notifications for payment events (completed, refunded, failed)

Update Notes - Core 5.7.2
Update Notes
Added

Ecosystem Trading

• Market Data WebSocket: Implemented real-time trades and OHLCV (candlestick) data streaming


• Live trade history showing recent buy/sell transactions with prices and amounts


• Real-time candlestick charts with configurable intervals (1m, 5m, 1h, 1d, etc.)


• Automatic updates only when new data is available to reduce bandwidth


• Supports custom data limits for different chart requirements


• Properly handles high-volume trading data from Scylla database

NFT Marketplace

• Auction Enhancements: Dynamic minimum bid increment functionality


• Admins can configure minimum bid increments per auction


• Ensures fair bidding with customizable increment requirements


• Prevents bid sniping with proper increment enforcement


• Collection Watchers: Watchers count tracking


• Users can watch/unwatch NFT collections they're interested in


• Real-time watcher count display on collection pages


• Helps gauge collection popularity and community interest


• Withdrawal Tracking: Proper pending withdrawal status


• Clear status indicators for NFT withdrawal requests


• Accurate tracking throughout the withdrawal process


• Better user experience for NFT transfers


• Collection Deployment: Seamless frontend to backend connection


• Smooth NFT collection deployment workflow


• Proper error handling and status updates during deployment


• Smart contract deployment integration


• Marketplace Pause Status: Emergency pause functionality


• Admins can pause/unpause marketplace trading when needed


• Emergency stop for security incidents or maintenance


• Clear UI indication when marketplace is paused

Improved

Ecosystem Operations

• Ledger Network Filtering: Enhanced admin ledger view


• Filters transactions by configured network (mainnet/testnet)


• Admins only see network-relevant transactions based on environment settings


• Reduces clutter and improves data accuracy for multi-network setups


• Withdrawal Notifications: Admin alerts for transaction failures


• Critical notifications when blockchain withdrawal verification fails


• System and individual admin notifications with transaction details


• Enables immediate manual review and intervention

Payment Processing

• DLocal Integration Enhancements:


• Deposit Notifications: Users receive immediate in-app notifications for deposit success or failure


• Clear success messages with deposit details


• Failure notifications with error explanations


• Email notifications ready for integration


• Refund Handling: Automated wallet deduction with user and admin notifications


• Detects full and partial refunds from payment provider


• Automatically adjusts user wallet balance


• Prevents negative balances with safety checks


• Notifies users and admins with refund details


• Chargeback Protection: Critical fraud detection and prevention system


• Automatically detects chargebacks from payment provider


• Deducts chargeback amount from user wallet


• Sends critical alerts to all admins for immediate review


• Detailed logging for compliance and audit requirements


• Special handling for missing wallet scenarios


• Paysafe Admin Profit Recording: Fixed profit tracking for deposit fees


• Admin profit now properly recorded for Paysafe deposit fees


• Consistent tracking across all payment providers


• Accurate fee revenue reporting

User Management

• Investment History: Enabled duration column sorting


• Users can now sort investment history by duration


• Better data organization and easier filtering


• Improved portfolio management experience


• User Import: Welcome notifications for imported users


• Newly imported users receive personalized welcome messages


• In-app greeting with account details


• Better onboarding experience for bulk-imported users

Code Quality

• OTP Recovery Codes: Verified correct implementation


• Accepts both hyphenated (XXXX-XXXX-XXXX) and plain (XXXXXXXXXXXX) formats


• Generates exactly 12 unique recovery codes per user


• Proper normalization and validation working as designed


• Code Cleanup: Comprehensive code audit completed


• All commented code serves legitimate documentation purposes


• No dead or unnecessary code found

Fixed

Build System

• TypeScript Compilation: Fixed type mismatches preventing successful builds


• Resolved async/await pattern errors


• Fixed property name mismatches in data structures


• Backend now compiles without errors

Database

• MySQL Compatibility: Fixed JSON syntax in P2P offer expiry handling


• Corrected JSON parsing for MySQL/MariaDB compatibility


• Proper offer expiration processing

Assets

• Missing Cryptocurrency Image: Added FDUSD (First Digital USD) stablecoin image


• Prevents broken image errors in crypto listings


• Maintains visual consistency across all supported cryptocurrencies

Migration Notes

No database migrations required. All changes are backward compatible and do not require schema updates.

Future Integration Points

The following infrastructure is ready with clear integration markers:

Email Service Integration:

• Deposit success/failure notifications


• User import welcome emails


• Simply implement email service and follow the TODO comments in code

Security Monitoring Integration:

• Frontend error reporting (Sentry, DataDog, etc.)


• Optional external monitoring for production environments

Update Notes - Core 5.7.1
Update Notes
Fixed


Binary Options Trading
• Investment Return on Wins: Fixed critical issue where winning trades only returned profit without the original investment
• Users were losing their investment amount on every winning trade
• Example: $100 investment with 87% profit should return $187, but only returned $87
• Balance calculations now correctly return investment + profit on winning trades
• Applies to all trading modes (demo and real)
• Profit Percentage Configuration: Fixed hardcoded 88% profit being used instead of configured duration-specific percentages
• System was ignoring admin-configured profit percentages in binary_duration table
• All durations showed 88% profit regardless of settings
• Profit percentages now dynamically loaded from database per duration
• Admins can now customize profit percentages for each time duration (1min, 5min, 15min, etc.)
• Profit percentage properly stored with each order for historical accuracy




P2P Trading
• Database Schema: Fixed "Can't create table p2p_trades (errno: 150 'Foreign key constraint is incorrectly formed')" error
• Root cause: Type mismatch between paymentMethod field (VARCHAR) and payment method ID reference (UUID)
• Updated paymentMethod field to use UUID type for proper foreign key constraint
• Enables proper relationship between trades and payment methods




Migration Notes




Database Migration Required


IMPORTANT: This update requires dropping and recreating the p2p_trades table due to schema changes.

Steps to perform migration:

Backup your database before proceeding
Run the following SQL commands (or use phpMyAdmin):
``sql

SET FOREIGN_KEY_CHECKS = 0;

DROP TABLE IF EXISTS p2p_trades;

SET FOREIGN_KEY_CHECKS = 1;

`

Alternative (phpMyAdmin):
• Open phpMyAdmin and select your database
• Find the p2p_trades table in the table list and click "Drop"
• When the confirmation dialog appears, uncheck the "Enable foreign key checks" checkbox
• Click "Yes" to confirm the drop operation
• Repeat for p2p_disputes and p2p_reviews` tables
Restart your backend application
The tables will be recreated automatically with the correct schema


Note: This migration will delete all existing P2P trades, disputes, and reviews.

Update Notes - Core 5.6.9

**Critical Model References**: Fixed all incorrect and non-existent database model usage across the backend that could cause runtime crashes
- Fixed `models.walletTransaction` → `models.transaction` in staking system (4 occurrences)
- Fixed `models.kyc` → `models.kycApplication` in user export functionality
- Fixed `models.blockchainTransaction` references in 18 NFT-related files
- Fixed `models.nftIpfsUpload` crash in IPFS service with null check
- Fixed `models.nftMetadataBackup` crashes in metadata backup service (4 occurrences)
- All incorrectly referenced models now properly handled with null checks or correct model names

### Staking System

- **Transaction Recording**: Fixed staking position creation failing with "Cannot read properties of undefined (reading 'create')" error
- Root cause: Attempting to use non-existent `walletTransaction` model
- Now correctly uses `transaction` model with proper STAKING transaction types
- Affected endpoints:
- Staking position creation (`/staking/position`)
- Staking reward claims (`/staking/position/[id]/claim`)
- Admin bulk position updates (`/admin/staking/position/bulk`)
- **Audit Trail**: All staking operations now properly create transaction records for complete audit history
- **Metadata Format**: Fixed metadata not being stringified - now properly uses `JSON.stringify()`

### NFT Marketplace

- **Blockchain Transaction Tracking**: Fixed NFT operations not recording blockchain transactions
- Auction bids now record `NFT_AUCTION_BID` transactions
- Auction settlements record `NFT_AUCTION_SETTLE` transactions
- NFT purchases record `NFT_PURCHASE` transactions with full fee breakdown
- NFT transfers record `NFT_TRANSFER` transactions
- All transactions include blockchain details (transaction hash, gas, block numbers)
- **Admin Profit Recording**: Fixed NFT marketplace fees not being tracked as admin profits
- Offer confirmations now create both transaction and adminProfit records
- Marketplace fees properly linked to profit tracking system
- Supports multiple currencies with wallet-based tracking
- **Optional Features**: Services gracefully handle missing optional models (IPFS upload tracking, metadata backup)

### Payment Gateway Metadata

- **Metadata Stringification**: Fixed 19 payment gateway files with non-stringified metadata
- All metadata fields now properly use `JSON.stringify()` before database storage
- Prevents data corruption and ensures proper JSON parsing on retrieval

### ICO Vesting System

- **Vesting Release Model**: Created missing `icoTokenVestingRelease` model for tracking individual vesting releases
- Enables proper recording of each scheduled token release
- Tracks release status (PENDING, RELEASED, FAILED, CANCELLED)
- Records blockchain transaction hashes for on-chain releases
- Supports failure tracking with detailed error reasons

## Added

### Database Models

- **NFT Price History Model**: New `nftPriceHistory` model for tracking NFT sale prices over time
- Records sale price, currency, and USD conversion at time of sale
- Tracks sale type (DIRECT, AUCTION, OFFER)
- Links to buyer, seller, token, and collection
- Enables historical price analysis and floor price tracking
- Includes blockchain transaction hash reference

- **ICO Token Vesting Release Model**: New `icoTokenVestingRelease` model
- File: `backend/models/ext/ico/icoTokenVestingRelease.ts`
- Tracks individual scheduled releases within a vesting plan
- Fields:
- `vestingId` - Parent vesting record reference
- `releaseDate` - Scheduled release date
- `releaseAmount` - Token amount to release
- `percentage` - Percentage of total vesting
- `status` - PENDING | RELEASED | FAILED | CANCELLED
- `transactionHash` - On-chain transaction hash
- `releasedAt` - Actual release timestamp
- `failureReason` - Error details if failed
- Includes database indexes for efficient queries
- Properly associated with parent `icoTokenVesting` model

### Transaction Types

- **NFT Transaction Types**: Added 8 new transaction types to support NFT marketplace operations
- `NFT_PURCHASE` - Direct NFT purchases
- `NFT_SALE` - NFT sales (seller receiving payment)
- `NFT_MINT` - NFT minting operations
- `NFT_BURN` - NFT burning operations
- `NFT_TRANSFER` - Direct NFT transfers between users
- `NFT_AUCTION_BID` - Auction bid placements
- `NFT_AUCTION_SETTLE` - Auction settlements
- `NFT_OFFER` - Offer-based purchases
- **Admin Profit Types**: Added 3 NFT-related admin profit types
- `NFT_SALE` - Marketplace fees from direct sales
- `NFT_AUCTION` - Fees from auction settlements
- `NFT_OFFER` - Fees from offer acceptances

## Improved

### Transaction Recording

- **Wallet Integration**: All NFT marketplace transactions now properly link to user wallets
- Enables accurate balance tracking across all transaction types
- Supports multi-currency operations
- Gracefully handles cases where wallets don't exist yet

### Code Quality

- **Error Handling**: Enhanced error handling for optional model features
- IPFS upload tracking gracefully disabled if model not created
- Metadata backup service continues operation without model
- Gas history tracking properly guarded with null checks
- System backup functionality safely disabled when model unavailable

### Model Associations

- **ICO Vesting Relationships**: Enhanced `icoTokenVesting` model with complete associations
- `hasMany` relationship with `icoTokenVestingRelease` (as "releases")
- `belongsTo` relationship with `icoTransaction` (as "transaction")
- `belongsTo` relationship with `user` (as "user")
- `belongsTo` relationship with `icoTokenOffering` (as "offering")
- Enables efficient queries with proper eager loading

Update Notes - Core 5.6.8

Core 5.6.8 - Latest updates and improvements.