Roles
✅ Validado on-chain (Sepolia, ERC-4337)
Suite token — grant/revoke/renounce (OZ AccessControl master-mode self-bootstrap) + grant_roles/handover (Solady) validados on-chain.
Gerada automaticamente do spec OpenAPI da API (fonte de verdade). 9 endpoint(s).
List roles
GET /v1/tokens/{id}/roles
List all roles on the token contract
Auth: api-key
Path params: id
Respostas: 200, 401
Grant role
POST /v1/tokens/{id}/roles
Grant a role to an address on the token contract
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Revoke role
DELETE /v1/tokens/{id}/roles
Revoke a role from an address on the token contract
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 200, 400, 401
Get address roles
GET /v1/tokens/{id}/roles/{address}
Get all roles assigned to a specific address
Auth: api-key
Path params: id, address
Respostas: 200, 401, 404
Get role admin
GET /v1/tokens/{id}/roles/admin
Get the admin role for a specific role
Auth: api-key
Path params: id
Respostas: 200, 401
Check role
GET /v1/tokens/{id}/roles/check
Check if an address has a specific role on the token contract
Auth: api-key
Path params: id
Respostas: 200, 401, 404
Check any role (Solady)
GET /v1/tokens/{id}/roles/check_any
Check if an address has ANY of the specified roles (bitmap OR check, Solady only)
Auth: api-key
Path params: id
Respostas: 200, 400, 401
Renounce role
POST /v1/tokens/{id}/roles/renounce
Renounce a role from your own address
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get Solady roles bitmap
GET /v1/tokens/{id}/roles/solady/{address}
Get the full roles bitmap and decoded role names for a Solady token address
Auth: api-key
Path params: id, address
Respostas: 200, 400, 401