访问控制

返回当前所有者的地址。

将合约的所有权转移到一个新的账户 (new_owner)。 只能由当前所有者调用。

触发一个 OwnershipTransferred 事件。

使合约没有所有者。将不再可能调用 assert_only_owner 函数。只能由当前所有者调用。

返回当前所有者的地址。

返回待定所有者的地址。

将合约的所有权转移给待定所有者。 只能由待定所有者调用。 将待定所有者重置为零地址。

触发一个 OwnershipTransferred 事件。

通过设置待定所有者来启动两步所有权转移过程。 允许将 new_owner 设置为零地址，这可以用于取消已启动的所有权转移。

只能由当前所有者调用。

触发一个 OwnershipTransferStarted 事件。

使合约没有所有者。将不再可能调用 assert_only_owner 函数。只能由当前所有者调用。

请参阅 transfer_ownership。

请参阅 renounce_ownership。

请参阅 pending_owner。

请参阅 accept_ownership。

请参阅 transfer_ownership。

请参阅 renounce_ownership。

初始化合约并将 owner 设置为初始所有者。

要求：

触发一个 OwnershipTransferred 事件。

如果被所有者以外的任何账户调用，则会 panic。

将合约的所有权转移到一个新的账户 (new_owner)。 没有访问限制的内部函数。

触发一个 OwnershipTransferred 事件。

在两步转移中设置一个新的待定所有者。

没有访问限制的内部函数。

触发一个 OwnershipTransferStarted 事件。

当待定所有者被更新时触发。

当所有权被转移时触发。

返回 account 是否能够扮演 role。

返回控制 role 的管理角色。参见 grant_role 和 revoke_role。

要更改角色的管理员，请使用 set_role_admin。

将 role 授予 account。

如果 account 尚未被授予 role，则触发一个 RoleGranted 事件。

要求：

从 account 撤销 role。

如果 account 已被授予 role，则触发一个 RoleRevoked 事件。

要求：

从调用账户撤销 role。

角色通常通过 grant_role 和 revoke_role 来管理。 此函数的 目的是提供一种机制，让账户在受到威胁时（例如当可信设备放错地方时）失去其权限。

如果调用账户已被授予 role，则触发一个 RoleRevoked 事件。

要求：

当 new_admin_role 被设置为 role 的管理角色时触发，替换 previous_admin_role

DEFAULT_ADMIN_ROLE 是所有角色的起始管理角色，尽管 RoleAdminChanged 没有发出信号表明这一点。

当 account 被授予 role 时触发。

sender 是发起合约调用的账户，一个拥有管理角色的账户 或如果从构造函数中调用 _grant_role 时的部署者地址。

当 account 被撤销 role 时触发。

sender 是发起合约调用的帐户：

返回账户对于给定角色的状态。 可能的状态有：

尝试使用指定的激活延迟将 role 授予 account。

要求：

可能会触发一个 RoleGrantedWithDelay 事件。

当 account 被授予具有延迟的 role 时触发。

sender 是发起合约调用的账户，一个拥有管理角色的账户 或如果从构造函数中调用 _grant_role_with_delay 时的部署者地址。

返回 account 是否可以扮演 role。

返回控制 role 的管理角色。参见 grant_role 和 revoke_role。

要更改角色的管理员，请使用 set_role_admin。

返回账户对于给定角色的状态。

可能的状态有：

将 role 授予 account。

如果 account 尚未被授予 role，则触发一个 RoleGranted 事件。

要求：

可能会触发一个 RoleGranted 事件。

尝试使用指定的激活延迟将 role 授予 account。

要求：

可能会触发一个 RoleGrantedWithDelay 事件。

从 account 撤销 role。

如果 account 已被授予 role，则触发一个 RoleRevoked 事件。

要求：

可能会触发一个 RoleRevoked 事件。

从调用账户撤销 role。

角色通常通过 grant_role 和 revoke_role 来管理。 此函数的 目的是提供一种机制，让账户在受到威胁时（例如当可信设备放错地方时）失去其权限。

如果调用账户已被撤销 role，则触发一个 RoleRevoked 事件。

要求：

可能会触发一个 RoleRevoked 事件。

请参考 ISRC5::supports_interface。

请参阅 has_role。

请参阅 get_role_admin。

请参阅 grant_role。

请参阅 revoke_role。

请参阅 renounce_role。

通过注册 IAccessControl 接口 ID 来初始化合约。

验证调用者是否可以扮演给定的角色。 否则会 panic。

试图将 role 授予给 account。如果 role 对于 account 已经生效，则该函数不执行任何操作。如果 role 已经被授予给 account，但由于时间延迟尚未激活，则延迟将被移除，并且 role 立即生效。

没有访问限制的内部函数。

可能会触发 RoleGranted 事件。

尝试使用指定的激活延迟将 role 授予给 account。

该角色将在给定的延迟过去后生效。如果该角色对于帐户已经处于活动状态 (Effective)，则该函数将 panic。如果角色已被授予但尚未激活（处于 Delayed 状态），则现有延迟将被新的 delay 覆盖。

没有访问限制的内部函数。

要求：

可能会触发 RoleGrantedWithDelay 事件。

从 account 撤销 role。

没有访问限制的内部函数。

可能会触发 RoleRevoked 事件。

参见 IAccessControl::RoleAdminChanged。

参见 IAccessControl::RoleGranted。

参见 IAccessControlWithDelay::RoleGrantedWithDelay。

参见 IAccessControl::RoleRevoked。

返回当前 DEFAULT_ADMIN_ROLE 持有者的地址。

返回一个 new_admin 和一个 accept_schedule 的元组。

在 accept_schedule 通过后，new_admin 将能够通过调用 accept_default_admin_transfer 接受 default_admin 角色，从而完成角色转移。

仅在 accept_schedule 中为零的值表示没有待处理的管理员转移。

注意：零地址 new_admin 意味着 default_admin 正在被放弃。

返回安排开始的 default_admin 转移的接受所需的延迟。

在调用 begin_default_admin_transfer 时，此延迟将添加到当前时间戳，以设置接受计划。

注意：如果已安排延迟更改，它将在计划通过后立即生效，从而使此函数返回新的延迟。

请参阅 change_default_admin_delay。

返回 new_delay 和 effect_schedule 的元组。

在通过 effect_schedule 之后，对于使用 begin_default_admin_transfer 启动的每个新的 default_admin 转移，new_delay 将立即生效。

仅在 effect_schedule 中为零的值表示没有待处理的延迟更改。

注意：仅对于 new_delay 为零的值意味着在效果计划之后，下一个 default_admin_delay 将为零。

通过设置计划在当前时间戳加上 default_admin_delay 之后接受的 pending_default_admin 来启动 default_admin 转移。

要求：

触发 DefaultAdminTransferScheduled 事件。

取消先前使用 begin_default_admin_transfer 启动的 default_admin 转移。

尚未接受的 pending_default_admin 也可以使用此函数取消。

要求：

可能会触发 DefaultAdminTransferCanceled 事件。

完成先前使用 begin_default_admin_transfer 启动的 default_admin 转移。

调用该函数后：

要求：

通过设置计划在当前时间戳加上 default_admin_delay 之后生效的 pending_default_admin_delay，来启动 default_admin_delay 更新。

此函数保证在此方法被调用的时间戳和 pending_default_admin_delay 效果计划之间完成的任何对 begin_default_admin_transfer 的调用都将使用在调用之前设置的当前 default_admin_delay。

pending_default_admin_delay 的效果计划的定义方式是，等到计划结束后，然后使用新延迟调用 begin_default_admin_transfer 将至少与另一个 default_admin 完成转移（包括接受）所花费的时间相同。

该计划是为两种情况设计的：

从未生效的 pending_default_admin_delay 将被取消，以支持新的计划更改。

要求：

触发 DefaultAdminDelayChangeScheduled 事件，并且可能会触发 DefaultAdminDelayChangeCanceled 事件。

取消计划的 default_admin_delay 更改。

要求：

可能会触发 DefaultAdminDelayChangeCanceled 事件。

增加 default_admin_delay（即使用 change_default_admin_delay 安排的）生效的最长时间（以秒为单位）。默认为 5 天。

当计划增加 default_admin_delay 时，它会在新的延迟过去后生效，目的是为还原任何意外更改（即使用毫秒而不是秒）留出足够的时间，这可能会锁定合约。但是，为了避免过多的计划，等待时间受此函数的限制，并且可以为自定义 default_admin_delay 增加计划覆盖它。

重要提示：在覆盖此值时，请确保添加合理的时间量，否则，存在设置较高的新延迟的风险，该延迟几乎立即生效，而无法在发生输入错误时进行人为干预（例如，设置毫秒而不是秒）。

当启动 default_admin 转移时触发。

设置 new_admin 作为下一个通过调用 accept_default_admin_transfer 成为 default_admin 的地址，该调用仅在 accept_schedule 通过后进行。

如果 pending_default_admin 从未被接受，则在重置该 pending_default_admin 时触发，无论其计划如何。

当启动 default_admin_delay 更改时触发。

在 effect_schedule 过去后，将 new_delay 设置为在默认管理员转移之间应用的下一个延迟。

返回当前 DEFAULT_ADMIN_ROLE 持有者的地址。

返回一个 new_admin 和一个 accept_schedule 的元组。

在 accept_schedule 通过后，new_admin 将能够通过调用 accept_default_admin_transfer 接受 default_admin 角色，从而完成角色转移。

仅在 accept_schedule 中为零的值表示没有待处理的管理员转移。

注意：零地址 new_admin 意味着 default_admin 正在被放弃。

返回安排开始的 default_admin 转移的接受所需的延迟。

在调用 begin_default_admin_transfer 时，此延迟将添加到当前时间戳，以设置接受计划。

注意：如果已安排延迟更改，它将在计划通过后立即生效，从而使此函数返回新的延迟。

请参阅 change_default_admin_delay。

返回 new_delay 和 effect_schedule 的元组。

在通过 effect_schedule 之后，对于使用 begin_default_admin_transfer 启动的每个新的 default_admin 转移，new_delay 将立即生效。

仅在 effect_schedule 中为零的值表示没有待处理的延迟更改。

注意：仅对于 new_delay 为零的值意味着在效果计划之后，下一个 default_admin_delay 将为零。

通过设置计划在当前时间戳加上 default_admin_delay 之后接受的 pending_default_admin 来启动 default_admin 转移。

要求：

触发 DefaultAdminTransferScheduled 事件。

取消先前使用 begin_default_admin_transfer 启动的 default_admin 转移。

尚未接受的 pending_default_admin 也可以使用此函数取消。

要求：

可能会触发 DefaultAdminTransferCanceled 事件。

完成先前使用 begin_default_admin_transfer 启动的 default_admin 转移。

调用该函数后：

要求：

通过设置计划在当前时间戳加上 default_admin_delay 之后生效的 pending_default_admin_delay，来启动 default_admin_delay 更新。

此函数保证在此方法被调用的时间戳和 pending_default_admin_delay 效果计划之间完成的任何对 begin_default_admin_transfer 的调用都将使用在调用之前设置的当前 default_admin_delay。

pending_default_admin_delay 的效果计划的定义方式是，等到计划结束后，然后使用新延迟调用 begin_default_admin_transfer 将至少与另一个 default_admin 完成转移（包括接受）所花费的时间相同。

该计划是为两种情况设计的：

从未生效的 pending_default_admin_delay 将被取消，以支持新的计划更改。

要求：

触发 DefaultAdminDelayChangeScheduled 事件，并且可能会触发 DefaultAdminDelayChangeCanceled 事件。

取消计划的 default_admin_delay 更改。

要求：

可能会触发 DefaultAdminDelayChangeCanceled 事件。

增加 default_admin_delay（即使用 change_default_admin_delay 安排的）生效的最长时间（以秒为单位）。默认为 5 天。

当计划增加 default_admin_delay 时，它会在新的延迟过去后生效，目的是为还原任何意外更改（即使用毫秒而不是秒）留出足够的时间，这可能会锁定合约。但是，为了避免过多的计划，等待时间受此函数的限制，并且可以为自定义 default_admin_delay 增加计划覆盖它。

重要提示[.contract-item]

参见 ISRC5::supports_interface。

参见 has_role。

参见 get_role_admin。

参见 grant_role。

参见 revoke_role。

参见 renounce_role。

通过注册 IAccessControl 接口 ID 并设置初始延迟和默认管理员来初始化合约。

要求：

验证调用者是否可以充当给定的角色。否则会panic。

返回账户是否可以充当给定的角色。

如果账户处于活动状态，并且 effective_from 时间早于或等于当前时间，则该账户可以充当该角色。

注意：如果 effective_from 时间点为 0，则该角色立即生效。 这与未使用延迟但使用单个布尔标志的实现向后兼容。

返回给定角色的账户状态。

可能的状态有：

返回是否已授予该账户给定的角色。

注意：如果设置了延迟但尚未过去，则该账户可能还不能充当该角色。使用 {is_role_effective} 检查账户是否可以充当该角色。

将 admin_role 设置为 role 的管理角色。

没有访问限制的内部函数。

要求：

发出 RoleAdminChanged 事件。

尝试将 role 授予 account。如果 role 已经对 account 生效，则该函数不执行任何操作。如果 role 已授予 account，但由于时间延迟尚未激活，则删除延迟，并且 role 立即生效。

没有访问限制的内部函数。

对于 DEFAULT_ADMIN_ROLE，只有在没有 default_admin 或以前放弃了该角色时才允许授予。

注意：通过另一种机制公开此函数可能会使 DEFAULT_ADMIN_ROLE 再次可分配。确保保证这是您的实现中的预期行为。

可能会发出 RoleGranted 事件。

尝试以指定的激活延迟将 role 授予 account。

该角色将在给定的延迟过去后生效。如果该角色已经对该账户处于激活状态（Effective），则该函数将出现panic。如果该角色已授予但尚未激活（处于 Delayed 状态），则现有延迟将被新的 delay 覆盖。

没有访问限制的内部函数。

要求：

可能会发出 RoleGrantedWithDelay 事件。

尝试从 account 撤销 role。如果 role 对 account 不生效，则该函数不执行任何操作。如果 role 已从 account 撤销，但由于时间延迟仍然有效，则删除延迟，并且 role 立即变为非活动状态。

没有访问限制的内部函数。

可能会发出 RoleRevoked 事件。

设置待处理管理员及其时间表的元组的 Setter。

可能会发出 {DefaultAdminTransferCanceled} 事件。

设置待处理延迟及其时间表的元组的 Setter。

可能会发出 {DefaultAdminDelayChangeCanceled} 事件。

返回在 new_delay 将 成为新的 default_admin_delay 之后要等待的秒数。

返回的值保证，如果减少延迟，则将在经过一段等待时间后生效，该等待时间符合先前设置的延迟。

参见 default_admin_delay_increase_wait。

当 new_admin_role 被设置为 role 的管理角色时发出，替换 previous_admin_role

DEFAULT_ADMIN_ROLE 是所有角色的起始管理员，尽管 未发出 RoleAdminChanged 来指示这一点。

当 account 被授予 role 时发出。

sender 是发起合约调用的账户，是具有管理角色的账户 或如果从构造函数调用 _grant_role，则是部署器地址。

当 role 被 account 撤销时发出。

sender 是发起合约调用的账户：

当 account 被授予具有延迟的 role 时发出。

sender 是发起合约调用的账户，是具有管理角色的账户 或如果从构造函数调用 _grant_role_with_delay，则是部署器地址。

当 default_admin 转移开始时发出。

通过仅在 accept_schedule 过去后调用 accept_default_admin_transfer 来将 new_admin 设置为下一个成为 default_admin 的地址。

当 pending_default_admin 被重置时发出，如果从 未接受过，无论其时间表如何。

当 default_admin_delay 更改开始时发出。

在 effect_schedule 过去后，将 new_delay 设置为应用于默认管理员转移之间的下一个延迟。

当 pending_default_admin_delay 被重置时发出，如果其时间表未通过。