This file has been updated to 5.5.3 + All Add-ons

What's New in this Version:

## Fixed

### Cron Jobs
- **Fixed** Cron jobs not showing status updates in admin panel
- **Fixed** Fiat currency fetch timeout errors (increased from 5s to 30s)
- **Fixed** Missing API key validation for currency fetch
- **Fixed** Cron status broadcasts now properly sent via WebSocket
- **Fixed** OpenExchangeRates and ExchangeRate API timeout issues


## Improved

### Cron System
- **Improved** Added status broadcasts for running/completed/failed states
- **Improved** Increased timeout for external API calls (5s → 30s)
- **Improved** Better error messages and validation
- **Improved** Cron job monitoring continues running (as designed for production)

### Error Handling
- **Improved** Better null/undefined checks throughout codebase

This file has been updated to 5.5.5 + All Add-ons

What's New in this Version:

## Added

### Settings & Configuration
- **Added** WalletConnect setup documentation ([wallet-connect-setup.html](docs/content/core/wallet-connect-setup.html))
- **Added** Logo configuration improvements (light/dark mode support)
- **Added** Settings synchronization hooks ([use-settings-sync.ts](frontend/hooks/use-settings-sync.ts))

### Documentation
- **Added** Scylla/Cassandra setup guide with 14 step-by-step screenshots
- **Added** API port configuration guide
- **Added** Authenticator setup guide
- **Added** Root terminal access guide


## Improved

### ICO Module
- **Improved** Investment form validation and UX
- **Improved** ICO offer page with better error handling

### Internationalization
- **Improved** Updated translations across 115+ languages with new withdrawal UI strings

### Authentication & Middleware
- **Improved** Auth middleware with better session handling
- **Improved** Extension store management

### Frontend Components
- **Improved** Logo components with better light/dark mode support
- **Improved** Navbar logo rendering
- **Improved** Settings hooks refactored for better performance

This file has been updated to 5.5.7 + All Add-ons

What's New in this Version:

Critical Fixes

Withdrawal Balance Calculation

• Fixed NATIVE EVM token withdrawal fee calculation - Gas fees are now correctly paid FROM the withdrawal amount instead of being added on top

• Affected chains: ETH, BSC, POLYGON, FTM, OPTIMISM, ARBITRUM, BASE, CELO, RSK, AVAX

• Previously: totalToDeduct = withdrawAmount + platformFee + gasFee (incorrect)

• Now: totalToDeduct = withdrawAmount + platformFee (gas paid from withdrawal itself)

Max Withdrawal Calculation

• Added gas fee estimation for NATIVE EVM tokens in max withdrawal endpoint

• Max withdrawal now subtracts estimated gas fee to prevent "Insufficient funds" errors

• Formula: maxAmount = availableBalance - platformFee - estimatedGas

String Concatenation Bugs

• Fixed critical string concatenation issues in balance calculations (7 locations)

• Database stores balances as strings, causing concatenation instead of addition

• Example bug: "0.00689273" + "0.0001" resulted in "0.006892730.0001" instead of 0.00699273

• Added parseFloat() before all arithmetic operations on wallet balances

Floating-Point Precision Errors

• Added EVM chains to balance precision function

• Fixed precision errors like 0.000890629999999999 displaying instead of 0.00089063

• Added chains: BSC, ETH, POLYGON, ARBITRUM, OPTIMISM, BASE, AVAX, FTM, CELO, RSK (all with 8 decimal precision)

Gas Fee Reconciliation

• Implemented gas fee reconciliation for NATIVE EVM withdrawals

• Compares estimated vs actual gas used after transaction confirms

• Refunds difference if overestimated, deducts if underestimated

• Keeps database balance synchronized with on-chain balance

Private Ledger Integration

• Fixed withdrawal balance checks to consider private ledger

• For PERMIT tokens, now checks: availableBalance = wallet_data.balance - offchainDifference

• Prevents users from withdrawing admin fees collected in cross-token exchanges

• Applied in both max withdrawal and withdrawal validation

Monero (XMR) Deposit Processing

• Fixed XMR deposit deadlock issue

• Created processMoneroTransactionDirect method to handle deposits when wallet is already open

• Prevents "0/120 attempt" stalling on deposits

Technical Improvements

Balance Checking Logic

• Changed from checking wallet.balance (total across all chains) to wallet_data.balance (chain-specific available balance)

• Ensures users can only withdraw what's actually available on the specific blockchain

Gas Estimation

• Implemented proper gas estimation for NATIVE EVM tokens before withdrawal

• Uses 21000 gas limit for standard transfers

• Fetches current gas price from blockchain

• Falls back to conservative estimates if estimation fails

Private Ledger Logic

• offchainDifference > 0: Admin fees collected (reduces available balance)

• offchainDifference < 0: User credited from exchange (increases available balance)

• Only applies to PERMIT contract type tokens

This file has been updated to 5.5.9 + All Add-ons

What's New in this Version:

Important Note

• Before updating: Delete /frontend/middleware.ts if present to avoid build conflicts

Fixed

Trading Page - Ecosystem Markets

• Order Cancellation: Fixed "Failed to cancel order" error for Eco markets

• Batch Cancellation: Fixed "Failed to cancel all orders" error for Eco markets

• Order History: Fixed cancelled orders now appearing immediately in History tab without page reload

• Open Orders Display: Fixed new orders requiring page reload to appear in Open Orders tab - orders now appear instantly

• Order Book Prices: Fixed prices showing as 0.000000 for values below 0.01 (e.g., 0.001 now displays correctly)

• Total Calculations: Fixed Total column showing 0.00 for small price calculations

Payment Methods

• QR Code Support: Fixed QR Code option not appearing in Type dropdown when creating new deposit methods

Investment Management

• Duration Selection: Fixed duration saving error in AI Investment and Forex plans

• Menu Visibility: Fixed Investment Management section not appearing in Finance menu

Forex Trading

• Account Type Display: Fixed Forex account MT version always showing MT4 instead of selected MT5

Build System

• ⚠️ IMPORTANT: Before running pnpm updator, manually delete /frontend/middleware.ts file if it exists

• Next.js 16 Compatibility: Cleared middleware/proxy conflict causing build errors

Improved

Order Book Enhancements

• Amount Display: Improved amount column formatting to strip trailing zeros (e.g., 1.00000000 displays as "1")

• Price Grouping: Improved order book grouping with fine-grained aggregation levels supporting micro-cap tokens

• Aggregation Options: Expanded aggregation dropdown from 4 to 8 options for better flexibility

• Decimal Precision: Enhanced aggregation algorithm for floating-point precision

Trading Interface

• Smart Price Formatting: Prices now display with appropriate decimal places based on value magnitude

• Real-time Updates: Orders now appear instantly via WebSocket without requiring page refresh

• Better Precision: Support for micro-priced assets and meme coins with tiny prices

Added

Investment Features

• Duration Selection: Added multiselect duration field to AI Investment plans

• Forex Durations: Added multiselect duration field to Forex plans

• Multiple Durations: Investment and Forex plans can now select multiple durations when creating or editing

Payment Methods

• QR Code Fields: Added QR Code option to deposit method custom fields in Type dropdown

This file has been updated to 5.6.0 + All Add-ons

What's New in this Version:

No changelog available for this version.

This file has been updated to v5.6.8 + All Add-ons

What's New in this Version:

## Fixed

### Database Model Issues

- **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

@Mahmoud support!!

18 minutes ago, Abel Gebre said:

@Mahmoud support!!

Answered

Can you help me change the domain name in my license?