Metadata-Version: 2.4
Name: saltminer
Version: 0.1.2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Security
Summary: Identify and audit password hashes, offline.
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# saltminer

Identify and audit password hashes — offline.

`saltminer` is the Python interface to the Saltminer engine (written in Rust).
Give it a hash string and it tells you what algorithm most likely produced it,
and whether that choice is still considered secure under current OWASP guidance.

## Install

    pip install saltminer

## Usage

    import saltminer

    saltminer.identify("5f4dcc3b5aa765d61d8327deb882cf99")
    # [('MD5', 'medium', '32 hex chars — most likely at this length'),
    #  ('NTLM', 'low', '32 hex chars — also possible at this length'), ...]

    saltminer.audit("$2b$04$abcdefghijklmnopqrstuv")
    # ('bcrypt', 'WeakParams', 'cost 4 is below the minimum of 10')

`identify()` returns a list of (algorithm, confidence, reason) tuples.
`audit()` returns an (algorithm, verdict, detail) tuple, or None for formats
it does not rate.

## Links

Source, CLI, and desktop GUI: https://github.com/DebanganMALI/Salt-miner

Released under the MIT License.

