davide/purple-electrumwallet
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: rename tecnichal-data.md to technical-data.md (fix typo)

Browse Source
This commit is contained in:
Davide Grilli
2026-05-06 14:26:37 +02:00
parent 12881fc477
commit b193282766
2 changed files with 27 additions and 1074 deletions
Download Patch File Download Diff File Expand all files Collapse all files
technical-data.md
+26 -25
View File
@@ -302,12 +302,6 @@ XPUB_HEADERS = {
## 6. ElectrumX Server
| Component | Version |
|-----------|---------|
| ElectrumX (`e-x`) | **1.18.0** — [spesmilo/electrumx](https://github.com/spesmilo/electrumx) |
| Python (container) | **3.13.5** |
| Base Docker image | `lukechilds/electrumx:latest` (unpinned) |
### 6.1 Coin Definition (`coins_btcp.py`)
Drop-in patch for `electrumx/lib/coins.py`. Place as
@@ -410,7 +404,15 @@ For `servers.json`, replace `your-server.example.com` with a real DNS name or
public IP. The current file only documents the format; it does not configure a
real public server.
### 6.2 Docker Patch Snippet
### 6.2 Tested Component Versions
| Component | Version |
|-----------|---------|
| ElectrumX (`e-x`) | **1.18.0** — [spesmilo/electrumx](https://github.com/spesmilo/electrumx) |
| Python (container) | **3.13.5** |
| Base Docker image | `lukechilds/electrumx:latest` (unpinned) |
### 6.3 Docker Patch Snippet
```dockerfile
COPY electrumx-patch/coins_btcp.py /tmp/coins_btcp.py
@@ -437,7 +439,7 @@ print('>> Patched ElectrumX with BitcoinPurple coin classes')
PATCH
```
### 6.3 Environment Variables
### 6.4 Environment Variables
```env
# ── Identity ──────────────────────────────────────────────────────────────────
@@ -485,7 +487,7 @@ ulimits:
hard: 1048576
```
### 6.4 ZMQ Notification Ports
### 6.5 ZMQ Notification Ports
These are recommended local ports if you enable ZMQ notifications. BitcoinPurple
Core does not assign default ZMQ bind ports; the port only exists if you set the
@@ -525,7 +527,7 @@ Modelled after the `AbstractNet` interface (see `pallectrum` for a working examp
| `BOLT11_HRP` | `"btcp"` | `"tbtcp"` | LN invoice prefix |
| `GENESIS` | `000003823f…c015` | `000002fdc3…d998` | full hashes in §2.5 / §3 |
| `DEFAULT_PORTS` | `{'t':'50001','s':'50002'}` | `{'t':'60001','s':'60002'}` | |
| `BIP44_COIN_TYPE` | `0` | `1` | il core usa `0` (Bitcoin) in mainnet e `1` in testnet/regtest — vedere nota |
| `BIP44_COIN_TYPE` | `13496` (provisional — not SLIP-0044 registered) | `1` | matches BTCP P2P port; update when registered |
| `LN_REALM_BYTE` | `0` | `1` | LN DNS realm byte; unused while `LN_DNS_SEEDS=[]` |
| `LN_DNS_SEEDS` | `[]` | `[]` | no LN seeds configured |
| `SKIP_POW_DIFFICULTY_VALIDATION` | `False` only after BTCP retarget support | `False` only after BTCP retarget support | see §7.7 |
@@ -533,15 +535,14 @@ Modelled after the `AbstractNet` interface (see `pallectrum` for a working examp
| `COINBASE_MATURITY` | `100` | `100` | blocks before coinbase is spendable |
| `BLOCK_HEIGHT_FIRST_LIGHTNING_CHANNELS` | `0` | `0` | allowed from genesis if LN is enabled |
> **BIP44 coin type:** The Bitcoin Purple Core wallet (`src/wallet/scriptpubkeyman.cpp`)
> uses `coin_type = 0` on mainnet and `coin_type = 1` on testnet/regtest — the same
> values as Bitcoin. The resulting mainnet derivation paths are `m/44'/0'/0'/0/*`
> (BIP44 P2PKH), `m/49'/0'/0'/0/*` (BIP49 P2WPKH-P2SH), `m/84'/0'/0'/0/*`
> (BIP84 P2WPKH), and `m/86'/0'/0'/0/*` (BIP86 P2TR). BitcoinPurple has no
> registered SLIP-0044 entry; index `183` is already assigned to Bitcoin Private.
> Until an official coin type is registered, any Electrum or LND fork targeting
> BTCP should use `coin_type = 0` for mainnet and `1` for testnet to stay
> consistent with the core wallet.
> **BIP44 coin type:** BitcoinPurple has no SLIP-0044 entry. `BTCP` at index
> `183` is already assigned to Bitcoin Private, so do not reuse it for
> BitcoinPurple. In Electrum constants, store the non-hardened index
> (`0 <= value < 0x80000000`); wallet derivation code adds the hardened bit when
> building paths such as `m/44'/COIN_TYPE'/0'`. Use one project-wide provisional
> integer until an official SLIP-0044 slot is registered. The `13496` value below
> is a project-local placeholder chosen to match the BTCP P2P port, not a
> registered SLIP-0044 value.
### 7.2 `constants.py` Class Definitions
@@ -569,8 +570,8 @@ class BitcoinPurple(AbstractNet):
COINBASE_MATURITY = 100 # consensus/consensus.h:19
POW_TARGET_SPACING = 60 # 60-second blocks
# BIP44 coin type — matches Bitcoin Purple Core (src/wallet/scriptpubkeyman.cpp)
BIP44_COIN_TYPE = 0 # same as Bitcoin mainnet; no SLIP-0044 entry registered
# BIP44 coin type — not registered in SLIP-0044
BIP44_COIN_TYPE = 13496 # provisional private constant; update when registered
# Lightning. Height 0 means "allowed from genesis" in Electrum.
BLOCK_HEIGHT_FIRST_LIGHTNING_CHANNELS = 0
@@ -638,8 +639,8 @@ class BitcoinPurpleTestnet(BitcoinPurple):
### 7.3 Derivation Paths (BIP44 / 49 / 84 / 86)
Standard HD paths for each script type. The Bitcoin Purple Core wallet uses
`COIN_TYPE = 0` on mainnet and `1` on testnet/regtest (see §7.1 note).
Standard HD paths for each script type. Replace `COIN_TYPE` with the registered
value (TBD — see §7.1 note).
| BIP | Script type | Path template | xpub/xprv prefix |
|-----|-------------|---------------|-----------------|
@@ -777,7 +778,7 @@ Files that must be added or changed in an Electrum fork:
| `electrum/chains/bitcoinpurple/checkpoints.json` | Generate from a synced BTCP node |
| header chain verifier | Use 120-block retarget and BTCP `powLimit` |
| address module | Accept Base58 versions 56/55 and Bech32 HRP `btcp` |
| transaction/wallet formats | Use `coin_type = 0` (mainnet) / `1` (testnet), matching Bitcoin Purple Core |
| transaction/wallet formats | Use BTCP provisional BIP44 coin type consistently |
| Lightning invoice parser | Accept `lnbtcp` / `lntbtcp` BOLT11 prefixes if LN is enabled |
| UI/network selector | Expose BitcoinPurple mainnet/testnet names and datadirs |
@@ -927,7 +928,7 @@ fork needs equivalent new `chaincfg` / chain registry parameters.
| Address params | P2PKH 56, P2SH 55, Bech32 `btcp`, WIF 183 |
| Chain hash | same §8.1 wire value |
| Invoice HRP | `btcp` |
| Coin type | `0` (mainnet) / `1` (testnet) — matches Bitcoin Purple Core wallet |
| Coin type | use the same provisional Electrum value until SLIP-0044 registration |
| Timeout defaults | use §8.3 scaled block counts |
| Fee estimator | ensure targets are interpreted as 1-minute BTCP blocks |
tecnichal-data.md
-1048
View File
File diff suppressed because it is too large Load Diff