slip-plate 0.1.2

A seed plate scanner and parser tool

SLIP-PLATE - Shamir DEK Plates

SLIP-PLATE is a Python tool designed to split Data Encryption Keys (DEKs) (128/192/256-bit) using Shamir's Secret Sharing and render them as OneKey-style physical plates with built-in checksums.

Installation

You can now install SLIP-PLATE directly from PyPI:

pip install slip-plate

This will automatically install the necessary dependencies (cryptography and pyshamir) and register the slip-plate command in your terminal.

Usage

After installation, you can run the tool from anywhere using the slip-plate command:

slip-plate --dek-size 256 --parts 3 --threshold 2

Arguments

• --dek-size: Size of the DEK in bits (128, 192, or 256). Default: 256.
• --parts: Total number of Shamir shares to create. Default: 3.
• --threshold: Minimum number of shares required to reconstruct the key. Default: 2.

Example Output

The tool generates ANSI-rendered plates for your terminal:

=== KEK Share 1 ===
     2 1     │         │        
     0 0 5 2 │ 1       │        
     4 2 1 5 │ 2 6 3 1 │        
     8 4 2 6 │ 8 4 2 6 │ 8 4 2 1
    ─────────────────────────────
 1 | ○ ● ● ● │ ● ○ ○ ● │ ● ● ○ ○ │
 2 | ○ ○ ● ○ │ ○ ○ ○ ○ │ ○ ○ ● ○ │
 . | . . . . | . . . . | . . . . |
 . | . . . . | . . . . | . . . . |
 . | . . . . | . . . . | . . . . |
11 | ○ ○ ○ ● │ ● ● ● ○ │ ○ ○ ● ○ │
12 | ● ● ○ ○ │ ● ● ○ ● │ ● ○ ○ ○ │
    ─────────────────────────────

Dots (…) represent truncated rows for brevity.

Security Model

• Offline Storage: Plates are intended to be generated once and stored physically (e.g., punched into metal).
• Ephemeral Memory: DEKs are reconstructed from a quorum of shares only during active operations and are not persisted digitally.
• Unique Nonces: Encryption uses unique nonces per session, embedded in the ciphertext.
• Minimal Footprint: Designed to ensure no DEK is stored on disk in an unencrypted state.

Development & Testing

If you want to contribute or run tests from the source code:

1. Clone the repository:

   git clone https://github.com/avra911/slip-plate.git
   cd slip-plate
   

2. Install in editable mode:

   pip install -e .
   

3. Run tests:

   pip install pytest
   pytest -q
   

Notes and Caveats

• Research Tool: This is a demo/research tool. Review the code and cryptographic implementations before use in production environments.
• Physical Security: Treat printed/punched plates as high-security assets.
• Checksums: The built-in checksum helps detect transcription errors but does not replace proper key management procedures.

---

Contributions are welcome! Feel free to open a PR or an issue on GitHub.