CLI / oroc update sign

oroc update sign

Sign an update manifest and emit a detached manifest.sig file.

Usage#

oroc update sign (--keys=<file> | --private-key=<hex>) [options]

Options#

Option Description
--manifest=<path> path to the manifest JSON file to sign (default: manifest-name or ORO_UPDATE_MANIFEST_FILENAME)
--manifest-name=<name> manifest filename to use when --manifest is not provided
--keys=<file> JSON file containing a signing key (with "privateKey" or "secretKey" field)
--private-key=<hex> Ed25519 private key as a hex string
--key-id=<id> optional key identifier to embed in manifest.sig (default: "pk-1")
--out=<path> output path for manifest.sig (default: <manifest-without-extension>.sig, e.g. manifest.json -> manifest.sig)
--log-file=<path> mirror logs to a JSON file
-h, --help show help

Notes#

The signature file is JSON containing "schemaVersion", "algorithm", "keyId", and "signature" fields.

Clients verify manifest bytes against manifest.sig and the configured public key(s).

Advanced: set ORO_UPDATE_MANIFEST_FILENAME or pass '--manifest-name' to change the default manifest filename.

Examples#

oroc update sign --keys key.json --manifest manifest.json

sign manifest.json using the private key in key.json

oroc update sign --private-key <hex-private-key> --manifest manifest.json --out manifest.sig

sign a manifest using a raw hex private key

Source repository · Edit this page · View Markdown

Quick links

Type to search across the site. Use the up and down arrow keys to choose a result, Enter to open it, and Escape to close.