Metadata-Version: 2.4
Name: istampit-cli
Version: 1.0.1
Summary: iStampit CLI – Blockchain timestamp verification with OpenTimestamps
Author-email: "SinAI Inc." <hello@sinai.inc>
License: MIT
Project-URL: Homepage, https://iStampit.io
Project-URL: Repository, https://github.com/SinAi-Inc/istampit-cli
Project-URL: Documentation, https://github.com/SinAi-Inc/istampit-cli#readme
Project-URL: Tracker, https://github.com/SinAi-Inc/istampit-cli/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opentimestamps-client>=0.7.0
Dynamic: license-file

# iStampit CLI — Proof-of-Existence helper (OpenTimestamps)

![CodeQL](https://github.com/<org>/<repo>/actions/workflows/codeql.yml/badge.svg)
![Scorecard](https://github.com/<org>/<repo>/actions/workflows/scorecard.yml/badge.svg)

Thin CLI for hashing files, calling the OpenTimestamps client behind the scenes, and managing `.ots` receipts (stamp, verify, upgrade, info).

## Install

```bash
pip install istampit-cli  # (once published) or pipx install istampit-cli
```

## Usage

```bash
istampit stamp path/to/file.pdf          # creates file.pdf.ots
istampit verify path/to/file.pdf.ots     # verifies (uses cache/calendars)
istampit upgrade path/to/file.pdf.ots    # fetches attestations, writes upgraded proof
istampit info path/to/file.pdf.ots       # shows operations/attestations
```

Add `--json` for structured output.

## Exit Codes

- 0 success
- non‑zero failure (error already printed)

## License

MIT for wrapper code. OpenTimestamps libs under LGPL-3.0.
