Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyperauth.dev/llms.txt

Use this file to discover all available pages before exploring further.

Creates a registration session for an identifier. Checks reserved identifiers, duplicate registrations, and per-IP registration limits before writing to D1. The route extracts the identifier from the request body, resolves the Vault Durable Object by name (env.VAULT.getByName(identifier)), and calls the corresponding RPC method on the DO instance.

Request body

FieldTypeRequiredDescription
identifierstringYesRegistration identifier (also accepts handle)
channelstringYesChannel type (also inferred as "handle" if only handle field is present)
didstringYesDID to associate

Response (200)

{ "ok": true, "identifier": "alice", "channel": "handle", "did": "did:new:0x..." }

Errors

CodeerrorCondition
400"Missing required fields: identifier, channel, did"Field absent
409"identifier_reserved"Identifier is in reserved list
409"identifier_taken"Identifier already registered
429"ip_limit_reached"IP has reached MAX_REGISTRATIONS_PER_IP (3)