Crypoverse - Cryptocurrency Payment Gateway [BTC, LTC, ETH] v3.1.2

# Crypoverse - Crypto Payment Gateway - Changelog

## Version 3.1.2 (2025-12-15) - PRODUCTION RELEASE: Complete Structural Fix

### **FINAL FIX: "Rebuild" vs "Upgrade" Issue - ROOT CAUSE RESOLVED!**

**Issue #10: XenForo Shows Wrong Version After Installation** - **FIXED **
- **Root Cause**: Conflicting version sources and incorrect addon structure
- **Analysis**: Researched XenForo 2.x addon best practices and modern standards
- **Discovery**: XenForo works correctly with ONLY addon.json for version control
**Issue #6: Payment Provider Not Created on Fresh Installs (NEW INSTALLATIONS)**
- **Fixed** - Payment provider now properly registers during fresh installations
- **Fixed** - Improved installStep2() with comprehensive error handling and fallback mechanisms
- **Fixed** - Added upgrade3000800Step1() to recreate missing payment provider for existing installations
- **Cause** - installStep2() was not properly handling edge cases and missing error logging
- **Impact** - Fresh installations of v3.0.5+ were not creating the "Crypoverse" option in payment provider dropdown
- **Critical** - Without this fix, the addon appeared to install successfully but was completely non-functional

### What Was Wrong:
1. Had build.json (unnecessary file causing conflicts)
2. Had _data/addon_info.xml (not required for XenForo 2.x)
3. Had two hashes.json files (circular reference issue)
4. Used MD5 hashes (outdated)
5. Hash paths were relative to addon folder (incorrect)
6. Circular reference causing infinite hash changes

### The Fix (v3.1.2):
1. **DELETED**: build.json (conflicting version source)
2. **DELETED**: _data/addon_info.xml (not needed for XenForo 2)
3. **DELETED**: _data/hashes.json (circular reference issue)
4. **UPDATED**: hashes.json to use SHA-256 instead of MD5
5. **UPDATED**: Hash paths to be ZIP-relative: `src/addons/Crypoverseaddon/CryptoPayment/...`
6. **VERIFIED**: addon.json is now the SOLE source of version information
7. **CLEANED**: Removed all debug code from Setup.php
8. **FIXED**: Option phrases now display correctly (used dots instead of underscores)

### Why This Fixes Everything:
- XenForo reads version ONLY from addon.json (as designed)
- No conflicting version sources to cause confusion
- SHA-256 provides better file integrity validation
- ZIP-relative paths match XenForo's internal structure
- No circular references = no infinite hash changes
- Follows XenForo 2.x modern addon structure standards