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:

pip install .

For development (including testing dependencies):

pip install -e ".[dev]"

Quickstart

Keypair Generation & Addressing

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/ directory.

Authors, Developer & Credits

• Developer: shaheelhassan (github@shaheelhassan)
• Credits: shaheelhassan