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 the API key’s remaining transfer 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

Business verification has a full CLI flow:

hevn kyb status              # show the KYB graph and what is still missing
hevn kyb fill                # interactive walkthrough: company, people, documents
hevn kyb company             # create or update the company entity
hevn kyb person add          # add an owner/director (list / set / remove also available)
hevn kyb upload              # upload a document for an entity
hevn kyb submit              # submit the graph for review
hevn kyb share [e-mail]   # share a KYB link with a teammate

kyb status is the entry point: it prints the company entity, people, documents, and the exact fields the submission gate still requires.

Status

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

hevn status

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