shamir-ss 0.2.2

Shamir's Secret Sharing implementation using Cython

Shamir Secret Sharing (SSS)

Secure cryptographic implementation of Shamir's Secret Sharing scheme for splitting secrets into multiple shares. Designed for both short secrets and large text/data with automatic chunking.

Features

• 🔒 Cryptographic security using Mersenne prime modulus (2¹²⁷-1)
• 📦 CLI interface and Python API
• ✨ Automatic chunking for large secrets
• 🚀 Cython-optimized core implementation
• ✅ Hash-based secret integrity verification

Installation

pip install shamir_ss

Development

For developement see following guide

Python API

Example

from shamir_ss import generate_text_shares, reconstruct_text_secret

def main():
    secret = "My top secret"

    shares = generate_text_shares(secret, 3, 5)

    reconstructed = reconstruct_text_secret(shares[:3])
    print(reconstructed)

if __name__ == "__main__":
    main()

CLI Application

Features

• 🔐 Interactive secret input with hidden typing
• 📁 Multiple input formats (files/directories/text)
• 🛡️ SHA-256 hash verification
• 🔄 Automatic share validation

Usage

python -m shamir_ss <command> <...args>

Command list

shamir_ss --help         # Show all commands
shamir_ss split --help   # Split command help
shamir_ss combine --help # Combine command help
shamir_ss help           # Detailed usage examples

Examples

python -m shamir_ss split \
  --secret "My top secret" \
  -t 3 -n 5 \
  --output shares

Split secret to 5 shares with treshold 3 and put output to shares dir

python -m shamir_ss combine \
  -i shares

Reconstruct secret from shares dir w/o hash validation (will be prompted interactively)

shamir_ss combine --text

Reconstruct secret using interactive mode