Role Topology
Fetches the full role topology for a smart contract — the hierarchy of roles, their holders, and relationships. Always fetches fresh on-chain data.Returns
- Roots — Top-level roles (e.g., DEFAULT_ADMIN_ROLE)
- Nodes — All role nodes with holder edges embedded
- Resolved At — Block number at which roles were resolved
Example Queries
Parameters
| Parameter | Required | Description |
|---|---|---|
contractAddress | Yes | The contract address (0x…) |
blockchain | No | ethereum (default) or base |
Use Cases
Security auditing
Security auditing
Check who holds privileged roles like owner, admin, pauser, or upgrader before interacting with a protocol.
Governance research
Governance research
Map out the permission structure of a DAO or multisig-controlled protocol.
Pre-integration checks
Pre-integration checks
Before integrating with a contract, verify that the role hierarchy matches what the protocol claims.
Related Tools
- Contract overview → Contract Metadata
- Check upgrades → Diff Versions
- See usage → Latest Transactions
Next Steps
Contract Metadata
Fetch contract details
Diff Versions
Compare contract versions