tencoinlib 0.1.0__tar.gz

tencoinlib-0.1.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: tencoinlib
+Version: 0.1.0
+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"
+
+# Tencoinlib
+
+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 tencoinlib

tencoinlib-0.1.0/README.md

@@ -0,0 +1,31 @@
+# Tencoinlib
+
+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 tencoinlib

tencoinlib-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tencoinlib"
+version = "0.1.0"
+description = "Official Python library for Tencoin – HD wallets, SegWit, BIP39, RPC client"
+readme = "README.md"
+authors = [{ name = "Tencoin Development Team" }]
+license = { text = "MIT" }
+keywords = ["tencoin", "blockchain", "cryptocurrency", "hd-wallet", "bip39", "segwit", "rpc"]
+classifiers = [
+    "Development Status :: 4 - Beta",                 
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "ecdsa>=0.18.0",
+    "requests>=2.28.0",
+    "bech32>=1.2.0",          
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov",
+    "black",
+    "ruff",
+]
+async = ["aiohttp>=3.8.0"]
+mnemonic = ["mnemonic>=0.20"]   
+
+[project.urls]
+Homepage = "https://tencoin.org"
+Repository = "https://github.com/tencoinorg/tencoin"
+Issues = "https://github.com/tencoinorg/tencoin/issues"
+Documentation = "https://tencoin-core.readthedocs.io"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["tencoinlib*"]

tencoinlib-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tencoinlib-0.1.0/tencoinlib/__init__.py

@@ -0,0 +1,68 @@
+# tencoin/tencoinlib/__init__.py
+"""
+tencoinlib - Official Python library for Tencoin
+"""
+
+from .constants import (
+    MAINNET_HRP,
+    TENOS_PER_TEC,
+    DUST_LIMIT,
+    DEFAULT_RPC_PORT,
+    COIN_TYPE,
+    DERIVATION_PATH,
+    DEFAULT_RPC_TOKEN
+)
+
+from .wallet import Wallet, WalletError
+from .rpc import RPCClient, RPCError
+from .transaction import (
+    Transaction, TxIn, TxOut, parse_transaction,
+    TransactionBuilder, TransactionBuilderError,
+    SegWitSigner, LegacySigner, TransactionSigner, SigningError,
+    FeeCalculator,
+    decode_address, address_to_script, is_valid_address,
+    get_address_type, AddressError
+)
+
+# Version
+__version__ = "0.1.0"
+
+__all__ = [
+    # Constants
+    "MAINNET_HRP",
+    "TENOS_PER_TEC",
+    "DUST_LIMIT",
+    "DEFAULT_RPC_PORT",
+    "DEFAULT_RPC_TOKEN",
+    "COIN_TYPE",
+    "DERIVATION_PATH",
+    
+    # Wallet
+    "Wallet",
+    "WalletError",
+    
+    # RPC
+    "RPCClient",
+    "RPCError",
+    
+    # Transaction
+    "Transaction",
+    "TxIn",
+    "TxOut",
+    "parse_transaction",
+    "TransactionBuilder",
+    "TransactionBuilderError",
+    "SegWitSigner",
+    "LegacySigner",
+    "TransactionSigner",
+    "SigningError",
+    "FeeCalculator",
+    "decode_address",
+    "address_to_script",
+    "is_valid_address",
+    "get_address_type",
+    "AddressError",
+    
+    # Version
+    "__version__",
+]

tencoinlib-0.1.0/tencoinlib/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

tencoinlib-0.1.0/tencoinlib/constants.py

@@ -0,0 +1,59 @@
+# tencoinlib/constants.py
+
+
+MAINNET_HRP = "tc"
+
+
+COIN_TYPE = 5353
+
+
+# BIP purposes
+BIP44_PURPOSE = 44  # Legacy P2PKH
+BIP49_PURPOSE = 49  # Nested SegWit (reserved for future use)
+BIP84_PURPOSE = 84  # Native SegWit (P2WPKH)
+
+
+# Default BIP84 derivation path for the primary SegWit address
+DERIVATION_PATH = f"m/{BIP84_PURPOSE}'/{COIN_TYPE}'/0'/0/0"
+
+
+BIP39_ENTROPY_BITS = 128  
+BIP39_CHECKSUM_BITS = 4   
+
+
+P2PKH_VERSION = 0x41      
+P2SH_VERSION = 0x32       
+P2WPKH_VERSION = 0        
+
+
+TENOS_PER_TEC = 100_000_000
+DUST_LIMIT = 546
+
+
+DEFAULT_RPC_PORT = 10111
+DEFAULT_P2P_PORT = 10110
+
+
+DEFAULT_RPC_TOKEN = ""
+
+
+DEFAULT_SEED_NODES = [
+    "seed.tencoin.org",
+]
+
+
+DEFAULT_FEE_RATE = 10  
+PRIORITY_FEE_RATE = 20
+ECONOMY_FEE_RATE = 5
+MIN_RELAY_FEE = 1000  
+
+
+MAINNET_MAGIC = b'\x0a\x0d\x0e\x10'
+TESTNET_MAGIC = b'\x0b\x11\x09\x07'
+
+
+OP_DUP = 0x76
+OP_HASH160 = 0xa9
+OP_EQUALVERIFY = 0x88
+OP_CHECKSIG = 0xac
+OP_EQUAL = 0x87