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:
-p, --project-id <id>- Project ID-k, --api-key <key>- API key-u, --api-url <url>- API URL (default: https://api.sovereign.provenance)
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)