From 8d1adb0d44a7381826071112788e8c90a1fa7890 Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Wed, 26 Nov 2025 17:25:40 +0100
Subject: [PATCH] Update changelog and README with recent changes and
 development notes

---
 CHANGELOG.md |  6 ++++
 README.md    | 78 ++++++++++++++++++++++++++++++++++++++++++++++++----
 2 files changed, 78 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4057c6b8c..5303b38d6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -169,6 +169,8 @@ This is the initial fork of Electrum for the Palladium blockchain project.
 - **QR codes**: Generate correct palladium: URIs
 - **Network status**: Shows "Palladium" instead of "Bitcoin"
 - **Update check**: Disabled automatic update prompts on startup
+- **Terms of Use wizard**: Fixed presplash image layout with proper sizing and edge-to-edge display
+- **Watch-only wallet warning**: Replaced "Bitcoin" with "Palladium"
 
 ### Security
 - Checkpoint-based validation provides security for blocks with LWMA difficulty
@@ -180,6 +182,10 @@ This is the initial fork of Electrum for the Palladium blockchain project.
 - References to bitcoin.org and electrum.org in user-facing text
 - Automatic update checking (to avoid confusion with Electrum updates)
 
+### Development Notes
+
+- Development supported by Claude 4.5 Sonnet (Anthropic AI) for code analysis, debugging, and documentation assistance
+
 ---
 
 ## Upstream Synchronization
diff --git a/README.md b/README.md
index a53021b09..fd266a19d 100644
--- a/README.md
+++ b/README.md
@@ -47,14 +47,76 @@ The easiest way to run Pallectrum is to download the pre-built binaries:
 
 If you want to run Pallectrum from source, you'll need Python 3.10 or higher.
 
-#### Quick Start (Linux/macOS)
+#### Windows
+
+**Prerequisites:**
+
+- Python 3.10+ installed from [python.org](https://www.python.org/downloads/)
+
+**Setup with Virtual Environment:**
+
+```powershell
+# Clone repository
+git clone https://github.com/palladium-coin/pallectrum.git
+cd pallectrum
+
+# Create and activate virtual environment
+python -m venv env
+env\Scripts\Activate.ps1
+
+# Upgrade pip and install dependencies
+python -m pip install --upgrade pip
+pip install -e ".[gui,crypto]"
+
+# Copy libsecp256k1 DLL (if needed)
+copy libsecp256k1*.dll env\Lib\site-packages\electrum_ecc\
+
+# Run with Qt GUI
+python run_electrum
+```
+
+##### Optional: QML GUI on Windows (simulates Android interface)
+
+```powershell
+pip install ".[qml_gui]"
+python run_electrum gui -g qml
+```
+
+#### Linux (Ubuntu/Debian)
+
+**Install Prerequisites:**
 
 ```bash
-$ sudo apt-get install libsecp256k1-dev python3-pyqt6
-$ git clone https://github.com/palladium-coin/pallectrum.git
-$ cd pallectrum
-$ python3 -m pip install --user -e .
-$ ./run_electrum
+# System packages
+sudo apt update
+sudo apt install -y python3-venv python3-pip build-essential python3-dev
+sudo apt install -y libffi-dev libssl-dev libsecp256k1-dev
+```
+
+**Setup with Virtual Environment:**
+
+```bash
+# Clone repository
+git clone https://github.com/palladium-coin/pallectrum.git
+cd pallectrum
+
+# Create and activate virtual environment
+python3 -m venv env
+source env/bin/activate
+
+# Upgrade pip and install dependencies
+python3 -m pip install --upgrade pip
+pip install -e ".[gui,crypto]"
+
+# Run with Qt GUI
+python run_electrum
+```
+
+##### Optional: QML GUI on Linux (simulates Android interface)
+
+```bash
+pip install ".[qml_gui]"
+python run_electrum gui -g qml
 ```
 
 For detailed installation instructions, including dependencies and platform-specific notes, see the [original Electrum documentation](README-ELECTRUM.md#getting-started).
@@ -124,6 +186,10 @@ For Pallectrum-specific issues:
 For general Electrum-related questions:
 - Original project: https://github.com/spesmilo/electrum
 
+### Development Notes
+
+Development of Pallectrum was supported by **Claude 4.5 Sonnet** (Anthropic AI) for code analysis, debugging, refactoring, and documentation assistance.
+
 
 ## Licence