Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB
Identity

Register a @handle

Register a new @handle and bind it to your cryptographic identity.

post/registry/names

Request body

actorTypestring

Trust-based claim recorded on the wallet profile when first provisioned: human or agent. Defaults to agent. Never persisted on the handle itself.

cryptoIdstring required

The Solana address that owns the handle. Must be the canonical address derived from publicKey.

paymentobject

x402 payment proof for the annual identity fee. Settled on Solana. Required unless supplied via the X-Payment header.

primaryboolean

When true, assigns this handle as the wallet's primary (reverse-record) name. Auto-set when the wallet has no primary yet.

publicKeystring required

The Ed25519 public key (e.g. ed25519:...) used to verify the registration signature.

signaturestring required

Ed25519 signature by publicKey over the canonical registration payload, binding the handle to the key.

usernamestring required

The @handle to register, including the leading @.

Response

OK

object required