Metadata-Version: 2.4
Name: cryptosecurekit
Version: 1.0.3
Summary: A production-quality cybersecurity-focused local cryptocurrency wallet toolkit.
Author: shaheelhassan
License: MIT
Classifier: Programming Language :: Python :: 3
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cryptography>=41.0.0
Requires-Dist: ecdsa>=0.18.0
Requires-Dist: pynacl>=1.5.0
Requires-Dist: pycryptodome>=3.18.0
Requires-Dist: click>=8.1.0
Requires-Dist: base58>=2.1.1
Requires-Dist: mnemonic>=0.20
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: hypothesis>=6.0.0; extra == "dev"
Dynamic: license-file

# CryptoSecureKit

A production-quality cybersecurity-focused local cryptocurrency wallet toolkit in Python.

> [!WARNING]
> **CRITICAL SECURITY NOTICE:** This library is intended for educational, reference, and auditing purposes only. It has **NOT** undergone independent professional security audits. **DO NOT** use this library to manage, generate, or store private keys representing real monetary value. Use at your own risk.

## Features

- **Offline-First & Local-Only:** Zero network calls or socket transmissions. Works entirely locally.
- **BIP-39 Mnemonics:** Securely generate and validate mnemonic phrases (12, 15, 18, 21, 24 words) and derive seeds using PBKDF2.
- **Hierarchical Deterministic Wallets:**
  - BIP-32 / BIP-44 key derivation for **secp256k1** chains.
  - SLIP-0010 hardened key derivation for **ed25519** chains.
- **Multi-Chain Adapters:**
  - **Bitcoin (BTC):** Base58Check (P2PKH) and Bech32 (P2WPKH) addresses.
  - **Ethereum (ETH):** Keccak-256 addresses with EIP-55 casing checksum.
  - **Solana (SOL):** ed25519 addresses encoded in Base58.
  - **Litecoin (LTC):** Base58Check addresses with LTC prefix version bytes.
- **Keystore Encryption:** Encrypt mnemonics or keys into secure JSON blobs using standard KDF (`scrypt`) and authenticated cipher (`AES-256-GCM`).
- **Deterministic Digital Signatures:**
  - RFC 6979 for secp256k1 (Bitcoin, Ethereum, Litecoin).
  - RFC 8032 for ed25519 (Solana).
- **Bulk Operations:** Safely generate large sets of keys or derive address ranges, with options for encrypted CSV/JSON exports.

---

## Installation

Install dependencies and the package locally:

```bash
pip install .
```

For development (including testing dependencies):

```bash
pip install -e ".[dev]"
```

---

## Quickstart

### Keypair Generation & Addressing
```python
from cryptosecurekit.keys import KeyPair
from cryptosecurekit.chains.registry import get_adapter

# Bitcoin
btc_adapter = get_adapter("btc")
seed = b"some very secure high entropy seed bytes here..."
keypair = btc_adapter.derive_keypair(seed, "m/44'/0'/0'/0/0")
print("Public Key:", keypair.public_key_hex)
print("Address:", btc_adapter.public_key_to_address(keypair.public_key_hex))
# Private key is redacted from print statements
print(keypair)  # Output: KeyPair(private_key_hex='***REDACTED***', public_key_hex='...')
```

For complete documentation, see the [docs/](docs/) directory.

---

## Authors, Developer & Credits

- **Developer:** shaheelhassan ([github@shaheelhassan](https://github.com/shaheelhassan))
- **Credits:** shaheelhassan
