Account and profile

Inspect the active HEVN account, update profile fields, and manage KYC status.

Account summary

Show the active account:

hevn account get

Introspect the active API key, owning app, scopes, balance, and spend limit:

hevn whoami
hevn whoami --yaml

List account state, auth state, balances, and MCP allowance:

hevn account list --yaml

profile is an alias for account, so these commands are equivalent:

hevn account get
hevn profile get

Update profile

Update identity or address fields:

hevn profile set \
  --first-name Ada \
  --last-name Lovelace \
  --street-address "1 Example Street" \
  --city London \
  --country GB \
  --zip SW1A1AA

Business accounts can set an entity name:

hevn profile set --entity-name "Example Ltd"

At least one profile field is required.

KYC

Get a KYC link or status:

hevn account kyc
hevn account kyc --status
hevn account kyc --provider align --status

The default provider is swipelux. Supported provider values are passed through to the HEVN backend.

KYB

There is no dedicated KYB flow in the CLI today. KYB endpoints are present in the REST OpenAPI schema for direct API integrations, but hevn currently exposes profile/KYC commands only.

Status

Use the top-level status command for a compact health check:

hevn status

Use --json or --yaml when integrating account status into automation.