Metadata-Version: 2.4
Name: tencoin-core
Version: 0.4.6
Summary: Official Python library for Tencoin – HD wallets, SegWit, BIP39, RPC client
Author: Tencoin Development Team
License: MIT
Project-URL: Homepage, https://tencoin.org
Project-URL: Repository, https://github.com/TenCoinOrg/TenCoin
Project-URL: Issues, https://github.com/TenCoinOrg/TenCoin/issues
Project-URL: Documentation, https://tencoin-core.readthedocs.io
Keywords: tencoin,blockchain,cryptocurrency,hd-wallet,bip39,segwit,rpc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: ecdsa>=0.18.0
Requires-Dist: requests>=2.28.0
Requires-Dist: bech32>=1.2.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Provides-Extra: async
Requires-Dist: aiohttp>=3.8.0; extra == "async"
Provides-Extra: mnemonic
Requires-Dist: mnemonic>=0.20; extra == "mnemonic"

# Tencoin Core

Official Python library for Tencoin – HD wallets, transactions, and RPC client.

## Features

- **HD Wallets**: BIP-39 (seed phrases) + BIP-84 (SegWit native addresses)
- **Full BIP-32 Support**: Standard xprv/xpub extended keys with master/account-level derivation
- **Watch-Only Wallets**: Create wallets directly from xpub (no seed/private key required)
- **Multiple Address Types**: 
  - **SegWit v0** (P2WPKH): Native SegWit addresses (`tc1q...`)
  - **Legacy P2PKH**: Pay-to-pubkey-hash addresses (`T...`)
  - **Legacy P2SH**: Pay-to-script-hash addresses (`M...`)
  - **P2WSH**: SegWit script addresses (`tc1q...` with 32-byte program)
- **Custom Scripts**: Support for multisig and custom redeem/witness scripts
- **Transaction Signing**: Automatic detection and signing for SegWit (BIP-143) and Legacy (P2PKH/P2SH) inputs
  - **Key Derivation**:
  - **BIP-84 (P2WPKH)**: `m/84'/5353'/0'/0/0` for native SegWit addresses
  - **BIP-44 (P2PKH)**: `m/44'/5353'/0'/0/0` for legacy P2PKH addresses
  - Additional custom BIP-32 paths supported via the BIP-32 API
- **Seed Phrases**: 12–24 word English mnemonics (full BIP-39 compliance)
- **Wallet Recovery**: From mnemonic phrases – compatible with standard BIP-39 implementations
- **Full BIP-39 Compatibility**: Mnemonics generated by other standard libraries (e.g., bip-utils, Electrum, MetaMask, Ian Coleman's tool) are validated and recovered
- **Secure Seed Generation**: PBKDF2-HMAC-SHA512 with official 2048-word English wordlist



## Installation

```bash
pip install tencoin-core
