Cryptography Resources

A simple repo showcasing the power and accessibility of cryptography for generating secure wallet seeds.

• Cryptography Resources
  • Security Certification
  • Setup
  • Quick Start
  • Features
    • BIP39 Mnemonic Generation
    • Chain-Specific Key Derivation
  • Testing
  • Resources

Security Certification

This tool's randomness quality is automatically validated on every commit:

Test	Description	Status
Entropy Source	Uses Python secrets module (CSPRNG)	✅ Verified
Chi-Square	Uniform byte distribution	✅ Verified
Monobit	Balanced bit distribution	✅ Verified
Runs Test	No detectable patterns	✅ Verified
Collision	No duplicate outputs	✅ Verified
Shannon Entropy	≥7.9 bits/byte	✅ Verified

⚠️ For cold storage: Always generate seeds on an air-gapped machine.

Setup

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

# For Solana support
uv sync --extra solana

Quick Start

Mac/Linux:

make help              # Show all commands
make quick             # Petty cash wallet (auto-clears screen)
make secure            # Cold storage (security checklist)

Windows (or any platform):

uv run python tasks.py help      # Show all commands
uv run python tasks.py quick     # Petty cash wallet
uv run python tasks.py secure    # Cold storage

Features

BIP39 Mnemonic Generation

File	Description
secure_mnemonic_generate.py	Recommended - Secure generator with auto-clearing display
mnemonic_generator.py	Basic generator (no security features)

# Secure mode (cold storage - use on air-gapped machine!)
 make secure
# ^ Note the leading space to avoid shell history

# Quick mode (petty cash / hot wallets)
make quick

# Basic mode (no security features)
make mnemonic

Chain-Specific Key Derivation

make eth      # Ethereum wallet
make btc      # Bitcoin keys  
make solana   # Solana keys

Testing

Run the test suite to verify functionality and randomness quality:

# Functionality tests
make test

# Entropy validation suite (statistical randomness tests)
make test-entropy

# All tests
make test-all

Or cross-platform:

uv run python tasks.py test
uv run python tasks.py test-entropy

Resources

• trezor/python-mnemonic - The mnemonic library used
• mnemonic python package
• BIP-0039 Specification
• Security Review - Detailed security analysis