Overview#
Generate a new Curve25519 key pair for profile authentication and encryption.Generate Keys#
Endpoint: GET /generate-keysAuthentication: Not requiredResponse Fields#
| Field | Description |
|---|
private | Your private key (32 bytes, hex-encoded). Keep this secret. |
public | Your signed public key (version + key + BLAKE2b hash, hex-encoded) |
Use Case#
Use this endpoint to generate a cryptographically secure key pair when you don't have existing keys. The returned public key should be registered with your profile using the register public key endpoint. The private key must be stored securely on your system and never transmitted after initial generation.Save your private key immediately - it cannot be recovered if lost
The public key returned is already in the signed format required for registration
This endpoint generates keys server-side for convenience, but you can also generate keys client-side using the implementation shown in the overview