IAccessControl

Developer note: External interface of AccessControl declared to support ERC165 detection.

Events

RoleAdminChanged

event RoleAdminChanged(bytes32 role, bytes32 previousAdminRole, bytes32 newAdminRole)

*Developer note: Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`

`DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite {RoleAdminChanged} not being emitted signaling this.

Available since v3.1.*

Name	Type	Description

RoleGranted

event RoleGranted(bytes32 role, address account, address sender)

*Developer note: Emitted when `account` is granted `role`.

`sender` is the account that originated the contract call, an admin role bearer except when using {AccessControl-_setupRole}.*

Name	Type	Description

RoleRevoked

event RoleRevoked(bytes32 role, address account, address sender)

*Developer note: Emitted when `account` is revoked `role`.

`sender` is the account that originated the contract call:

• if using `revokeRole`, it is the admin role bearer

• if using `renounceRole`, it is the role bearer (i.e. `account`)*

Name	Type	Description

Functions

hasRole

function hasRole(bytes32 role, address account) external view returns (bool) view external

Developer note: Returns `true` if `account` has been granted `role`.

Name	Type	Description

Returns:

Name	Type	Description

getRoleAdmin

function getRoleAdmin(bytes32 role) external view returns (bytes32) view external

*Developer note: Returns the admin role that controls `role`. See {grantRole} and {revokeRole}.

To change a role's admin, use {AccessControl-_setRoleAdmin}.*

Name	Type	Description

Returns:

Name	Type	Description

grantRole

function grantRole(bytes32 role, address account) external external

*Developer note: Grants `role` to `account`.

If `account` had not been already granted `role`, emits a {RoleGranted} event.

Requirements:

• the caller must have ``role``'s admin role.*

Name	Type	Description

revokeRole

function revokeRole(bytes32 role, address account) external external

*Developer note: Revokes `role` from `account`.

If `account` had been granted `role`, emits a {RoleRevoked} event.

Requirements:

• the caller must have ``role``'s admin role.*

Name	Type	Description

renounceRole

function renounceRole(bytes32 role, address account) external external

*Developer note: Revokes `role` from the calling account.

Roles are often managed via {grantRole} and {revokeRole}: this function's purpose is to provide a mechanism for accounts to lose their privileges if they are compromised (such as when a trusted device is misplaced).

If the calling account had been granted `role`, emits a {RoleRevoked} event.

Requirements:

• the caller must be `account`.*

Name	Type	Description