ControlList

Asset Tokenization Studio Team

ControlList

Abstract contract implementing control list management logic for a security token. Supports both whitelist and blacklist modes, set once at initialisation, to gate transfer access by address membership.

Implements IControlList. State is stored at STORAGE_LOCATION_CONTROL_LIST via ControlListStorageWrapper. All mutating functions after initialisation require ROLE_CONTROL_LIST and the token to be unpaused. Intended to be inherited exclusively by ControlListFacet.

Methods

addToControlList

function addToControlList(address _account) external nonpayable returns (bool success_)

Adds an address to the control list.

Requires ROLE_CONTROL_LIST and the token to be unpaused. Reverts with ListedAccount if the address is already present. Emits AddedToControlList.

Parameters

Name	Type	Description
_account	address	The address to add.

Returns

Name	Type	Description
success_	bool	True if the address was successfully added.

getControlListCount

function getControlListCount() external view returns (uint256 controlListCount_)

Returns the total number of addresses currently in the control list.

Returns

Name	Type	Description
controlListCount_	uint256	The number of entries in the control list.

getControlListMembers

function getControlListMembers(uint256 _pageIndex, uint256 _pageLength) external view returns (address[] members_)

Returns a paginated slice of the addresses in the control list.

_The list offset is computed as \_pageIndex _ \_pageLength. Returns an empty array when the offset meets or exceeds the list length.*

Parameters

Name	Type	Description
_pageIndex	uint256	Zero-based page index.
_pageLength	uint256	Maximum number of addresses to return per page.

Returns

Name	Type	Description
members_	address[]	Array of control list member addresses for the requested page.

getControlListType

function getControlListType() external view returns (bool)

Returns the operating mode of the control list.

Returns

Name	Type	Description
_0	bool	True if the control list is a whitelist, false if it is a blacklist.

initializeControlList

function initializeControlList(bool _isWhiteList) external nonpayable

One-time initialiser that sets the control list operating mode.

Can only be called once; subsequent calls revert via onlyFacetNotRegistered. The leading-underscore naming convention signals this is an initialiser function.

Parameters

Name	Type	Description
_isWhiteList	bool	true to operate as a whitelist (only listed addresses allowed), false to operate as a blacklist (listed addresses blocked).

isInControlList

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

Checks whether an address is present in the control list set.

Returns raw set membership regardless of the whitelist/blacklist mode. An address in the set is allowed in whitelist mode and blocked in blacklist mode.

Parameters

Name	Type	Description
_account	address	The address to query.

Returns

Name	Type	Description
_0	bool	True if _account is in the control list set, false otherwise.

removeFromControlList

function removeFromControlList(address _account) external nonpayable returns (bool success_)

Removes an address from the control list.

Requires ROLE_CONTROL_LIST and the token to be unpaused. Reverts with UnlistedAccount if the address is not present. Emits RemovedFromControlList.

Parameters

Name	Type	Description
_account	address	The address to remove.

Returns

Name	Type	Description
success_	bool	True if the address was successfully removed.

Events

AddedToControlList

event AddedToControlList(address indexed operator, address indexed account)

Emitted when an account is added to the control list.

Parameters

Name	Type	Description
operator indexed	address	Address of the caller who performed the addition.
account indexed	address	Address of the account that was added.

ControlListInitialized

event ControlListInitialized(bool isWhiteList)

Emitted once when the control list capability is initialised on a token.

Fires exclusively from initializeControlList after the storage write succeeds.

Parameters

Name	Type	Description
isWhiteList	bool	Whether the control list operates in whitelist mode.

RemovedFromControlList

event RemovedFromControlList(address indexed operator, address indexed account)

Emitted when an account is removed from the control list.

Parameters

Name	Type	Description
operator indexed	address	Address of the caller who performed the removal.
account indexed	address	Address of the account that was removed.

Errors

AccountHasNoRole

error AccountHasNoRole(address account, bytes32 role)

Thrown when an account does not hold a required role.

Parameters

Name	Type	Description
account	address	The account that lacks the role.
role	bytes32	The role that is not held.

AssetNotOperational

error AssetNotOperational(bytes32 configId, uint256 versionId)

Raised by InitializerStorageWrapper.checkOperational (and the related isConfigVersionOperational helper) when an operation is attempted on a configuration version that has not yet been marked operational.

Parameters

Name	Type	Description
configId	bytes32	Resolver-proxy configuration whose operational status was checked.
versionId	uint256	Configuration version whose operational status was checked.

Deactivated

error Deactivated()

Thrown when an operation guarded by onlyActivated is attempted on a token whose deactivation flag has already been set.

FacetAlreadyRegistered

error FacetAlreadyRegistered(bytes32 facetId, uint256 lastVersion)

Raised when an initialiser tries to register a facet that already has a non-zero last registered version (i.e. the facet is being re-initialised on a fresh install).

Parameters

Name	Type	Description
facetId	bytes32	Identifier of the offending facet.
lastVersion	uint256	Last version recorded for that facet at the time of the check.

IsPaused

error IsPaused()

Thrown when an operation that requires the token to be unpaused is attempted while the token is paused (own flag or any external pause contract).

ListedAccount

error ListedAccount(address account)

Thrown when attempting to add an address that is already present in the control list.

Parameters

Name	Type	Description
account	address	The duplicate address.

UnlistedAccount

error UnlistedAccount(address account)

Thrown when attempting to remove an address that is not present in the control list.

Parameters

Name	Type	Description
account	address	The address that was not found.

UnrecognizedResolverProxyVersion

error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)

Thrown when the provided proxy version does not match any BLR compatible standard.

Parameters

Name	Type	Description
_resolverProxyVersion	bytes8	proxy version that is not compatible with the BLR.

WalletRecovered

error WalletRecovered()

Thrown when attempting to recover a wallet that has already been recovered.