AllowlistV1

Kiln

Allowlist (v1)

This contract handles the list of allowed recipients.All accounts have an uint256 value associated with their addresses whereeach bit represents a right in the system. The DENY_MASK defined the maskused to identify if the denied bit is on, preventing users from interactingwith the system

Methods

acceptAdmin

function acceptAdmin() external nonpayable

Accept the transfer of ownership

Only callable by the pending admin. Resets the pending admin if succesful.

allow

function allow(address[] _accounts, uint256[] _permissions) external nonpayable

Sets the allowlisting status for one or more accounts

The permission value is overridden and not updated

Parameters

getAdmin

function getAdmin() external view returns (address)

Retrieves the current admin address

Returns

getAllower

function getAllower() external view returns (address)

Retrieves the allower address

Returns

getPendingAdmin

function getPendingAdmin() external view returns (address)

Retrieve the current pending admin address

Returns

getPermissions

function getPermissions(address _account) external view returns (uint256)

This method retrieves the raw permission value

Parameters

Returns

hasPermission

function hasPermission(address _account, uint256 _mask) external view returns (bool)

This method returns true if the user has the expected permission ignoring any deny list membership

Parameters

Returns

initAllowlistV1

function initAllowlistV1(address _admin, address _allower) external nonpayable

Initializes the allowlist

Parameters

isAllowed

function isAllowed(address _account, uint256 _mask) external view returns (bool)

This method returns true if the user has the expected permission and is not in the deny list

Parameters

Returns

isDenied

function isDenied(address _account) external view returns (bool)

This method returns true if the user is in the deny list

Parameters

Returns

onlyAllowed

function onlyAllowed(address _account, uint256 _mask) external view

This method should be used as a modifier and is expected to revert if the user hasn't got the required permission or if the user is in the deny list.

Parameters

proposeAdmin

function proposeAdmin(address _newAdmin) external nonpayable

Proposes a new address as admin

This security prevents setting an invalid address as an admin. The pendingadmin has to claim its ownership of the contract, and prove that the newaddress is able to perform regular transactions.

Parameters

setAllower

function setAllower(address _newAllowerAddress) external nonpayable

Changes the allower address

Parameters

Events

Initialize

event Initialize(uint256 version, bytes cdata)

Emitted when the contract is properly initialized

Parameters

SetAdmin

event SetAdmin(address indexed admin)

The admin address changed

Parameters

SetAllower

event SetAllower(address indexed allower)

The stored allower address has been changed

Parameters

SetAllowlistPermissions

event SetAllowlistPermissions(address[] accounts, uint256[] permissions)

The permissions of several accounts have changed

Parameters

SetPendingAdmin

event SetPendingAdmin(address indexed pendingAdmin)

The pending admin address changed

Parameters

Errors

Denied

error Denied(address _account)

The account is denied access

Parameters

InvalidAlloweeCount

error InvalidAlloweeCount()

The provided accounts list is empty

InvalidInitialization

error InvalidInitialization(uint256 version, uint256 expectedVersion)

An error occured during the initialization

Parameters

InvalidZeroAddress

error InvalidZeroAddress()

The address is zero

MismatchedAlloweeAndStatusCount

error MismatchedAlloweeAndStatusCount()

The provided accounts and permissions list have different lengths

Unauthorized

error Unauthorized(address caller)

The operator is unauthorized for the caller

Parameters