Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ekiden.fi/llms.txt

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

Root whitelist endpoints control whether a root account can authorize and onboard when whitelist enforcement is enabled.

​
Check Whitelist Status

GET /api/v1/authorize/whitelist/check?root_address=0x...
You can also check by public key: 
GET /api/v1/authorize/whitelist/check?root_public_key=0x...
Provide exactly one of root_address or root_public_key. Response: 
{
  "root_address": "0x...",
  "whitelisted": true
}
When whitelist enforcement is disabled, the backend treats roots as effectively whitelisted.

​
Add or Remove Entries

Administrative endpoints use root whitelist basic auth: 
PUT /api/v1/authorize/whitelist/{root_address}
DELETE /api/v1/authorize/whitelist/{root_address}
These endpoints are operational controls, not normal end-user integration endpoints. Do not expose them in client applications.

​
Root Account Lookup

Authenticated users can fetch their root account: 
GET /api/v1/user/root-account
Authorization: Bearer <jwt>
This is useful when a frontend or SDK needs to display the root address associated with the authenticated user.