Skip to content

The private names of the institution's people (operator request directory.read)

POST
/v1/issuers/{id}/directory/read
curl --request POST \
--url https://api.hardstate.net/v1/issuers/example/directory/read \
--header 'Content-Type: application/json' \
--data '{ "request": { "op": "billing.checkout", "issuer": "example", "key": "example", "ts": "2026-04-15T12:00:00Z", "nonce": "example", "params": {} }, "sig": { "kind": "passkey", "authenticatorData": "example", "clientDataJSON": "example", "signature": "example" } }'

The log never carries names: a person’s key has a public code and a salted holder commitment. The names live in a private directory that any of the institution’s people (or a session of theirs) can read with a signed operator request. Never public.

id
required
string
/^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/
Media typeapplication/json

Not a log event: an admin’s instruction to the operator. The signed hash is sha256(“hardstate/operator/v1” ‖ JCS(request)); accepted within 5 minutes of ts, once per nonce, from a live admin key of the issuer.

object
request
required
object
op
required
Allowed values: billing.checkout billing.invoice billing.portal anchor.express
issuer
required
string
key
required

The signing admin key id

string
ts
required
string format: date-time
nonce
required

16 random bytes

string
params
object
sig
required
One of:
object
kind
required
Allowed value: passkey
authenticatorData
required
string
clientDataJSON
required
string
signature
required
string

{ issuer, entries: [{ keyId, code, name }] }

Not signed by one of the institution’s live keys

HardState is a Zevlat Intelligence venture. © 2026 Zevlat Intelligence.