This file has been updated to 5.5.2

What's New in this Version:

## Fixed
- **Fixed** BTC deposit amounts showing incorrect values (satoshi conversion issues)
- **Fixed** transaction fee calculation returning NaN errors
- **Fixed** corrupted wallet address JSON data preventing deposits
- **Fixed** WebSocket pending deposit notifications not reaching frontend for BTC
- **Fixed** transaction decimal precision in admin deposit/withdraw logs
- **Fixed** excessive logging in UTXO deposit monitoring

## Improved
- **Improved** UTXO blockchain provider system with flexible architecture
- **Improved** XMR deposit monitoring with global queue and batch processing
- **Improved** pending confirmation broadcasts to only update on changes

This file has been updated to 5.5.3

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

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

Does this $50 version include any liquidity provider plugin?

@Diego Garrido This is the price of the script only

This file has been updated to 5.5.7

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