ByteDarkLock-BDL 1.0.1

Symmetric encryption and descryption (ByteDarkLock).

ByteDarkLock (BDL)

ByteDarkLock is a Python module for advanced symmetric encryption and script obfuscation, designed to protect your logic and data easily.

Main Features

• Symmetric encryption with AES-256 (CFB mode) and Fernet (AES-128 + HMAC-SHA256).

• Optional HMAC authentication to detect tampering in AES.

• Key expiration (ttl) and scheduled unlock (unlock_at).

• One-time decryption (decrypt_once) to prevent replay attacks.

• Python script obfuscation:

  • Keeps import and from statements intact.
  • Removes docstrings and comments.
  • Renames internal identifiers.
  • Encodes literals in Base64.
  • Packages into exec(base64...) for maximum opacity.
  • Option to automatically compile to bytecode (.pyc) and remove the obfuscated .py.

Requirements

Dependencies are listed in requirements.py (or install manually):

cryptography>=3.4.7
Pillow>=8.1.0

Quick installation with pip:

pip install cryptography Pillow

Quick Start Guide

from BDL.ByteDarkLock import ByteDarkLock

# Initialize
bdl = ByteDarkLock()

# 1. Generate a Fernet key with a TTL of 3600s
meta = bdl.generate_key(
        key_id="my_key",
        mode="fernet",
        ttl=3600
)

# 2. Encrypt and decrypt
token = bdl.encrypt("Hello World", "my_key")
print("Encrypted:", token)

plain = bdl.decrypt(token, "my_key")
print("Decrypted:", plain)

# 3. One-time decryption
bdl.decrypt_once(token, "my_key")  # works once
# bdl.decrypt_once(token, "my_key")  # now fails

API Reference

Class ByteDarkLock

generate_key(key_id, mode='fernet', use_hmac=False, ttl=None, unlock_at=None) -> dict

Generates and stores a key.

• key_id (str): Unique identifier.
• mode ('fernet'|'aes'): Algorithm.
• use_hmac (bool): AES only.
• ttl (int): Lifetime in seconds.
• unlock_at (datetime|str): Unlock date/time.

Returns metadata with key, expires_at, created_at, etc.

encrypt(data, key_id) -> str

Encrypts data with the key key_id.

decrypt(token, key_id) -> str

Decrypts token with the key key_id.

decrypt_once(token, key_id) -> str

Like decrypt, but allows only one use.

timed_decrypt(token, key_id) -> str

Alias for decrypt (for future time-lock feature).

Contributions

1. Fork the repository.
2. Create a branch (git checkout -b feature/new-function).
3. Make your changes and commit (git commit -m 'Add xyz').
4. Submit a pull request.

License

This project is under the [MIT License].