diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 000000000..2e3005e71 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,150 @@ +# Changelog + +All notable changes to Pallectrum will be documented in this file. + +**Pallectrum** is a lightweight wallet client for the Palladium blockchain. +It is based on Electrum Bitcoin Wallet, adapted to support Palladium's network +and consensus rules. Palladium is a Bitcoin fork with custom parameters and features. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +--- + +## [Unreleased] + +### Added +- Palladium blockchain network parameters + - Genesis block configuration + - Network magic bytes + - Default network ports (mainnet, testnet) + - Block time and difficulty adjustment parameters +- Palladium address format support + - Bech32 address format + - Address validation for Palladium network +- Palladium Electrum server infrastructure + - Default server list for Palladium network + - Server discovery protocol adaptation + - SSL certificate handling for Palladium servers +- Consensus algorithm integration + - Difficulty retargeting algorithm + - Block reward schedule for Palladium + +### Changed +- Rebranding from Electrum to Pallectrum + - Application name and window titles + - Icon set and visual identity + - About dialog and version information + - Documentation and help texts +- Network connection logic to support Palladium blockchain +- Transaction validation rules for Palladium consensus +- Fee estimation adapted to Palladium network conditions + +### Security +- Will merge relevant security fixes from Electrum upstream as needed + +--- + +## [0.1.0] - 2025-11-20 + +### Initial Fork Release + +This is the initial fork of Electrum for the Palladium blockchain project. + +**Fork Information:** +- **Forked from**: Electrum v4.6.2 +- **Base commit**: [`d15598bcf034e21718e2cc1152c3ae965c5449df`](https://github.com/spesmilo/electrum/commit/d15598bcf034e21718e2cc1152c3ae965c5449df) +- **Original project**: [Electrum Bitcoin Wallet](https://github.com/spesmilo/electrum) +- **Fork date**: November 20, 2025 +- **Fork maintainer**: Davide Grilli + +### Added +- Initial fork of Electrum 4.6.2 codebase +- Pallectrum copyright and license information +- This CHANGELOG.md to document all modifications from upstream + +### Changed +- Updated `LICENCE` file with Pallectrum fork copyright + - Added: Copyright (C) 2025 Davide Grilli - Pallectrum Fork + - Maintained: Full attribution to Electrum developers and Thomas Voegtlin + - License: MIT License (preserved from upstream) + +--- + +## Upstream Synchronization + +This fork is based on Electrum and may periodically merge upstream changes for: +- **Security fixes**: Critical vulnerabilities will be merged immediately +- **Bug fixes**: Important bug fixes affecting wallet functionality +- **Performance improvements**: Optimizations that benefit Pallectrum users + +**Note**: Breaking changes or Bitcoin-specific features from upstream will be evaluated +case-by-case for compatibility with Palladium blockchain. + +**Upstream repository**: https://github.com/spesmilo/electrum +**Upstream releases**: https://github.com/spesmilo/electrum/releases + +### Upstream Merge History + +| Pallectrum Version | Based on Electrum | Upstream Commit | Merge Date | Notes | +|-------------------|-------------------|-----------------|------------|-------| +| 0.1.0 | 4.6.2 | [d15598b](https://github.com/spesmilo/electrum/commit/d15598bcf034e21718e2cc1152c3ae965c5449df) | 2025-11-20 | Initial fork | + +--- + +## Development Roadmap + +### Phase 1: Core Blockchain Integration (v0.2.0) +- [ ] Implement Palladium network parameters +- [ ] Add Palladium address format support +- [ ] Configure Palladium Electrum servers +- [ ] Test blockchain synchronization + +### Phase 2: UI/UX Customization (v0.3.0) +- [ ] Complete rebranding to Pallectrum +- [ ] Update icons and visual assets +- [ ] Localize help texts and documentation +- [ ] Test user workflows + +### Phase 3: Production Release (v1.0.0) +- [ ] Security audit +- [ ] Performance optimization +- [ ] Comprehensive testing (mainnet & testnet) +- [ ] Build distribution packages (Windows, macOS, Linux, Android) + +--- + +## Contributing + +Contributions to Pallectrum are welcome! For contributing guidelines, please refer +to the main README. + +For understanding upstream Electrum changes: +- [Electrum Release Notes](https://github.com/spesmilo/electrum/blob/master/RELEASE-NOTES) +- [Electrum Contributing Guide](https://github.com/spesmilo/electrum/blob/master/CONTRIBUTING.md) + +--- + +## Links + +- **Pallectrum Repository**: https://github.com/yourusername/pallectrum _(update with actual URL)_ +- **Palladium Blockchain**: _(add Palladium project URL)_ +- **Issue Tracker**: _(add issue tracker URL)_ +- **Documentation**: _(add docs URL when available)_ + +### Upstream Project Links +- **Electrum Website**: https://electrum.org/ +- **Electrum GitHub**: https://github.com/spesmilo/electrum +- **Electrum Documentation**: https://electrum.readthedocs.io/ + +--- + +## Version Comparison Links + +- [Unreleased changes](../../compare/v0.1.0...HEAD) +- [0.1.0 Release](../../releases/tag/v0.1.0) + +--- + +**Last Updated**: 2025-11-20 +**Maintained by**: Davide Grilli