CLI Reference

The BaseID CLI provides command-line access to key generation, DID operations, credential signing and verification, and demo servers.

Installation

cargo install baseid-cli

Key Generation

# Generate an Ed25519 key pair (default)
baseid key generate --type ed25519

# Generate a P-256 key pair with JSON output
baseid key generate --type p256 --output json

# Save to file
baseid key generate --type ed25519 --output json > key.json

DID Operations

# Create a did:key from an Ed25519 key
baseid did create --method key --type ed25519

# Resolve any DID to its document
baseid did resolve did:key:z6Mk...

# Create a did:web configuration
baseid did create --method web --domain example.com

Credential Operations

# Sign a Verifiable Credential
baseid credential sign --key key.json --input vc.json

# Verify a JWT credential
baseid credential verify --jwt eyJ...

# Verify from a file
baseid credential verify --input signed-vc.jwt

SD-JWT Operations

# Create an SD-JWT with selective disclosure
baseid sd-jwt issue --key key.json --input claims.json --sd family_name --sd given_name

# Present with selected disclosures
baseid sd-jwt present --input sd-jwt.txt --disclose family_name

# Verify an SD-JWT presentation
baseid sd-jwt verify --input presentation.txt

Demo Servers

# Start a demo issuer server
baseid demo issuer --port 3000

# Accept a credential offer from the demo issuer
baseid demo accept-offer '{"credential_issuer":"http://localhost:3000",...}'

# Start a demo verifier server
baseid demo verifier --port 3001

Global Options

Flag	Description
--output json	Output in JSON format
--output text	Output in human-readable text (default)
--verbose	Enable verbose logging
--help	Show help for any command