Metadata-Version: 2.4
Name: minimal-ecash-sender
Version: 1.0.0
Summary: Minimal eCash (XEC) Electrum ABC/Fulcrum client: build, sign, and broadcast P2PKH transactions from a wallet with BIP39 mnemonic.
Author-email: xecdev <ecashinformer@gmail.com>
License: MIT License
Project-URL: Homepage, https://github.com/xecdev/minimal-ecash-sender
Project-URL: Issues, https://github.com/xecdev/minimal-ecash-sender/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bip-utils>=2.9.3
Requires-Dist: ecdsa>=0.18.0
Requires-Dist: ecashaddress>=1.0.2
Requires-Dist: base58>=2.1.1
Dynamic: license-file

# minimal-ecash-sender

Minimal **eCash (XEC)** Electrum ABC/Fulcrum client.

- Builds, signs, and broadcasts **P2PKH** transactions (`SIGHASH_ALL|FORKID`)
- Derives from a **BIP39 mnemonic** (default path: `m/44'/1899'/0'/0/0`)
- Uses TLS by default with these auto-trusted servers (port **50002**):
  - `electrum.bitcoinabc.org`
  - `fulcrum.pepipierre.fr`
  - `electrum.bytesofman.com`

---

## Install

```bash
pip install minimal-ecash-sender
```

## Library Usage

```python
from minimal_ecash_sender.core import send_xec

txid, raw_hex = send_xec(
    mnemonic="twelve words ...",
    to_addr="ecash:qq5teh...",
    amount_atoms=1234,              # 12.34 XEC = 1234 atoms (satoshi)
    servers=None,                   # use defaults
    fee_per_byte=1,
    derivation_path="m/44'/1899'/0'/0/0", #Cashtab wallet's derivation path
    timeout=25,
)
print(txid, raw_hex)
```
### Flags

- `--server host:port`  Repeatable; if omitted, defaults are used (TLS 50002)
- `--ssl`  Only needed when you pass custom servers and want TLS
- `--insecure`  Disable TLS verification (testing only)
- `--ca PATH`  Custom CA bundle (PEM)
- `--fingerprint HEX`  Pin server by SHA-256 fingerprint
- `--timeout INT`  Request timeout (default: 25)
- `--mnemonic "..."`  BIP39 mnemonic
- `--to ecash:...`  Destination eCash **P2PKH** address
- `--amount-xec DECIMAL`  Send in XEC (note: **1 XEC = 100 atoms**)
- `--amount-atoms INT`  Send in atoms
- `--path "m/44'/1899'/0'/0/0"`  Derivation path
- `--fee-per-byte INT`  Atoms/byte (default: 1)
---

## Notes

- Only **P2PKH** is supported.
- Default fee rate is **1 atom/byte**; adjust with `--fee-per-byte` if needed.

## LICENSE
- See `LICENSE`.

