Developer Docs

CLI Tools

Command-line tools for sealing, verifying, and managing provenance from CI and local workflows.

CLI Reference

The SOVEREIGN\PROVENANCE CLI (sp) provides command-line tools for provenance management.

Installation

npm install -g sp-cli

Commands

sp init

Initialize SOVEREIGN\PROVENANCE in your project.

sp init --project-id <id> --api-key <key>

Options:

sp seal <path>

Seal a file and generate provenance proof.

sp seal ./file.png
sp seal ./file.png --license MIT --genesis

Options:

  • -l, --license <license> - License type
  • --genesis - Mark as Genesis origin

sp verify <path>

Verify a file against its provenance.

sp verify ./file.png
sp verify ./file.png --hash abc123...

Options:

  • -h, --hash <hash> - Expected hash to verify against

sp lineage show

Display provenance lineage graph.

sp lineage show --hash abc123...

sp genesis mark <path>

Mark artifact as Genesis origin.

sp genesis mark ./model.pt

sp docket export

Export provenance docket for compliance.

sp docket export --output docket.json

Options:

  • -o, --output <path> - Output path (default: docket.json)