docs(README): Remove version references, remove PyQt mentions, update wallet_util steps, simplify contributing section

This commit is contained in:
2026-04-09 11:47:10 +00:00
parent 9c91cc8019
commit 6fb82dc8d0

View File

@@ -13,7 +13,7 @@
- Download the latest `bal-electrum-plugin-vX.X.X.zip` file
2. **Install in Electrum**
- Open Electrum Bitcoin wallet version **4.7.2 or later**
- Open Electrum Bitcoin wallet
- Go to **Tools → Plugins**
- Click **Add**
- Select the downloaded `.zip` file
@@ -135,10 +135,15 @@ bal-electrum-plugin/
- **⚠️ Emergency tools only**: For fixing wallet database issues
- **Purpose**: Handle compatibility across different Electrum walletdb versions
- **Usage**: Advanced users only, requires manual installation
- **Installation**: Copy files to Electrum's plugin directory and load Electrum's virtualenv
- **Files**:
- `bal_wallet_utils.py`: Core wallet database utilities
- `bal_wallet_utils_qt.py`: Qt-specific wallet utilities
- **Installation Steps**:
1. Copy `wallet_util/` files to Electrum's plugin directory
2. Load Electrum's virtualenv
3. Run `./bal_wallet_utils_qt.py`
- **Risk**: Advanced operations that can affect wallet data
- **Documentation**: Limited to inline code comments
**Normal operation does NOT require wallet_util/ files.**
### Main Interface (qt.py)
- **User-friendly wizards**: Step-by-step setup interface
@@ -224,8 +229,7 @@ Executor: "Charlie Executor" (fee: 0.02 BTC fixed)
## 🛠️ Development
### Prerequisites
- **Electrum Bitcoin wallet**: Version **4.7.2 or later**
- **Python**: 3.7+
- Electrum Bitcoin wallet
### Setup Development Environment
@@ -247,7 +251,7 @@ zip -r bal-electrum-plugin-dev.zip bal_electrum_plugin/
- **Installation Steps**:
1. Copy `wallet_util/` files to Electrum's plugin directory
2. Load Electrum's virtualenv
3. Restart Electrum
3. Run `./bal_wallet_utils_qt.py`
- **Risk**: Advanced operations that can affect wallet data
- **Documentation**: Limited to inline code comments
@@ -269,7 +273,7 @@ zip -r bal-electrum-plugin-dev.zip bal_electrum_plugin/
### Running the Plugin
The plugin uses Electrum's existing virtualenv. No additional dependencies needed.
The plugin uses Electrum's existing virtualenv.
---
@@ -278,7 +282,6 @@ The plugin uses Electrum's existing virtualenv. No additional dependencies neede
### Common Issues
#### Plugin Not Showing in Electrum
- ✅ Verify Electrum version is **4.7.2 or later**
- ✅ Check zip contains `bal_electrum_plugin/` directory at root
- ✅ Verify directory structure inside zip is correct
- ✅ Restart Electrum completely after installation
@@ -320,6 +323,7 @@ The plugin uses Electrum's existing virtualenv. No additional dependencies neede
#### wallet_util/ Not Working
- ✅ Copy files to Electrum's plugin directory
- ✅ Load Electrum's virtualenv before using
- ✅ Run `./bal_wallet_utils_qt.py`
- ✅ Only use for emergency wallet fixes
- ✅ Backup wallet before using wallet utilities
@@ -327,44 +331,7 @@ The plugin uses Electrum's existing virtualenv. No additional dependencies neede
## 🤝 Contributing
We welcome contributions! Please follow these guidelines:
1. **Fork the repository** on Gitea
2. **Create feature branch**: `git checkout -b feature/your-feature`
3. **Follow PEP 8** style guide strictly
4. **Write clear commit messages** following Conventional Commits
5. **Update documentation** for new features
6. **Open Pull Request** to `main` branch
### Development Workflow
```bash
# Fork repository on Gitea
# Clone your fork
git clone https://bitcoin-after.life/gitea/YOUR_USERNAME/bal-electrum-plugin.git
cd bal-electrum-plugin
# Add upstream remote
git remote add upstream https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin.git
# Create feature branch
git checkout -b feature/your-feature-name
# Make changes to bal_electrum_plugin/ files
# ...
# Test in Electrum 4.7.2+
# Commit changes with clear message
git add .
git commit -m "feat(heirs): add percentage validation for heir distribution"
# Push to your fork
git push origin feature/your-feature-name
# Open Pull Request on Gitea
```
Thanks for considering contributing!
---
@@ -378,7 +345,7 @@ MIT License - see [LICENSE](LICENSE) for details.
- **Repository**: [https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin](https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin)
- **Releases**: [https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/releases](https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/releases)
- **Issues**: [https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/issues](https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/issues)
- **Issues**: [https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/issues](https://bitcoin-after.like/bitcoinafterlife/bal-electrum-plugin/issues)
- **Discussions**: [https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/discussions](https://bitcoin-after.life/gitea/bitcoinafterlife/bal-electrum-plugin/discussions)
---
@@ -388,5 +355,3 @@ MIT License - see [LICENSE](LICENSE) for details.
**🔒 Security**: Never share your seed phrase or private keys. This plugin only creates transactions, it doesn't store your keys.
**💡 Note**: The executor fee is a fixed BTC amount included in the transaction output. The executor is financially incentivized to broadcast the transaction and ensure it confirms on the Bitcoin network.
**📋 Requirements**: Electrum 4.7.2+ only. No additional dependencies or configuration sections needed.