Labelbase Release Notes - December 2025 – v2.3.0
Major Features
BIP-329 Extended Fields Support
Upgraded to python-bip329 v1.0.0, and complete implementation of BIP-329 additional fields for comprehensive transaction metadata:
- Transaction labels: height, time, fee, value, rate
- Address labels: keypath, heights
- Output/Input labels: spendable, keypath, value, fmv, height, time
- Pubkey labels: keypath
- Fields encrypted for maximum privacy
- Field visibility automatically adapts based on label type (audio hide)
- Frontend validation for JSON fields (rate, fmv, heights)
Currency Sync Tool
Seamlessly synchronize between legacy currency annotations and structured FMV fields:
- Detect currency values in label text (e.g., "CHF 615.00")
- Sync to/from structured FMV field with one click (Label Detail View)
- Automatic conflict detection and resolution
- Bulk sync operations for efficiency
- Collapsible card interface for easy review
Auto-Fill Missing Data
Intelligent bulk population of BIP-329 fields from blockchain data:
- Automatically fills height, time, and value from OutputStat records
- One-click fill for individual outputs from detail page
- Bulk operations with missing field detection
- Preview available data before applying
- Smart filtering shows only outputs with missing fields
UTXO Health Monitoring (VTER)
Fee efficiency visualization for smarter UTXO management:
- Color-coded treemap: 🟢 Healthy, 🟡 Warning,  🔴 High 
- Box size represents output value in satoshis
- Customizable fee rate and threshold settings in user profile
- Enhanced output details page with fee health status
- Helps identify UTXOs too expensive to spend right now
Type Filter Tabs
Improved label navigation with type-based filtering:
- Quick filter tabs: All, Transactions, Outputs, Inputs, Addresses, Pubkeys, XPubs
- Works seamlessly with existing hashtag filters
- Bookmarkable/shareable filtered views
- Full page reload approach for reliable state management
Infrastructure & Docker
Docker Improvements

Fixed critical Docker build issues
Updated to libpcre2-dev (from deprecated libpcre3-dev)
Hardened build process with better error handling
Added comprehensive development guide (DEVELOPMENT_GUIDE.md)
Added backup and migration guide (BACKUP_AND_MIGRATION_GUIDE.md)
Improved MySQL connection handling with configurable host/port
Better environment variable validation
Added backup_* to .gitignore for cleaner repos

UI/UX Enhancements
Interface Improvements

Consolidated output details page with BIP-329 fields
Status alerts for missing vs. complete field data
Enhanced popovers with fee health metrics in treemaps
Improved mobile responsiveness for new features
Clean admin interface for label management (DEBUG mode only)
Removed deprecated Chatwoot integration

Form & Validation

Dynamic field visibility based on label type (BIP-329 spec compliance)
Client-side validation for JSON fields (fmv, rate, heights)
Integer validation for height, fee, value fields
Graceful degradation for invalid optional fields during import/export
Clear help text and field descriptions

Developer Experience
Documentation

Comprehensive DEVELOPMENT_GUIDE.md with Docker workflows
BACKUP_AND_MIGRATION_GUIDE.md with automated scripts
Improved inline code comments
Better error messages and troubleshooting guides
Updated README with new features

Code Quality

PEP8 code formatting improvements
Fixed Dependabot security alerts
Improved database migrations
Better separation of concerns in views/models

Bug Fixes & Maintenance
Fixes

Resolved GitHub #101: Docker failing on fresh installs
Resolved GitHub #102: Build process issues
Fixed "Inclusion of functionality from untrusted source" vulnerability
Ensured Labelbase works offline (#91)
Fixed rare race conditions in OutputStat updates
Improved error handling in Samourai import

Dependencies

Django security updates
Updated cryptography packages
Upgraded bip329 library to 1.0.0
Updated urllib3 to >=2.6.0 for security
Database connector improvements

Database Changes
Migrations
Eight new BIP-329 field migrations:
- height (CharField, encrypted)
- time (CharField, encrypted)
- fee (CharField, encrypted)
- value (CharField, encrypted)
- rate (TextField, encrypted, JSON)
- keypath (CharField, encrypted)
- fmv (TextField, encrypted, JSON)
- heights (TextField, encrypted, JSON array)
User profile additions:
- my_fee (IntegerField) - Fee rate for transaction broadcasting
- my_fee_rate_threshold (IntegerField) - UTXO health threshold adjustment
API & Backend
New Views

CurrencySyncView - Currency synchronization interface
CurrencySyncActionView - Currency sync operations
FillMissingDataView - Missing data detection
FillMissingDataActionView - Bulk auto-fill operations
FillOutputFieldsActionView - Single output auto-fill
ProfileFeeUpdateView - Fee settings management

Enhanced Serializers

Updated LabelSerializer with BIP-329 field support
JSON validation for structured fields
Integer/string conversion for storage optimization
Backward compatibility maintained

Testing & QA
✅ Testing

Added comprehensive test cases for fee calculations
Bitcoin transaction size calculation utilities (tx_math.py)
Fee health status calculations with user-configurable thresholds
Extensive manual testing of upgrade paths

Upgrade Notes
Important: This release includes database migrations. Always backup before upgrading!
```bash
Recommended upgrade process (READ GUIDE!)
./backup-labelbase.sh
git pull origin master
source exports.sh && docker-compose up --build -d
docker-compose exec labelbase_django python manage.py migrate
```
See BACKUP_AND_MIGRATION_GUIDE.md for detailed upgrade instructions.