Skip to main content

OperatorFacet

Asset Tokenization Studio Team

OperatorFacet

Diamond facet that exposes operator management operations as selectable proxy functions.

Inherits Operator for the business logic and implements IStaticFunctionSelectors for the Diamond resolver pattern. The resolver key RESOLVER_KEY_OPERATOR identifies this facet within the diamond proxy.

Methods​

authorizeOperator​

function authorizeOperator(address _operator) external nonpayable

Authorises an operator for all partitions of msg.sender

Parameters​

NameTypeDescription
_operatoraddressAn address which is being authorised

getStaticFunctionSelectors​

function getStaticFunctionSelectors() external pure returns (bytes4[])

Gets all function selectors of a facet

Returns​

NameTypeDescription
_0bytes4[]Face functions selectors

getStaticInterfaceIds​

function getStaticInterfaceIds() external pure returns (bytes4[])

Gets all interfaces ids of a facet.

Returns​

NameTypeDescription
_0bytes4[]Face interface ids

getStaticResolverKey​

function getStaticResolverKey() external pure returns (bytes32 staticResolverKey_)

Gets the static resolver key

Returns​

NameTypeDescription
staticResolverKey_bytes32Static resolver key

initializeOperator​

function initializeOperator() external nonpayable

Initialises the operator capability on the token.

Callable once; subsequent calls revert with FacetAlreadyRegistered. Requires DEFAULT_ADMIN_ROLE. Called by the factory during deployment.

isOperator​

function isOperator(address _operator, address _tokenHolder) external view returns (bool)

Determines whether _operator is an operator for all partitions of _tokenHolder

Parameters​

NameTypeDescription
_operatoraddressThe operator to check
_tokenHolderaddressThe token holder to check

Returns​

NameTypeDescription
_0boolWhether the _operator is an operator for all partitions of _tokenHolder

revokeOperator​

function revokeOperator(address _operator) external nonpayable

Revokes authorisation of an operator previously given for all partitions of msg.sender

Parameters​

NameTypeDescription
_operatoraddressAn address which is being de-authorised

Events​

AuthorizedOperator​

event AuthorizedOperator(address indexed operator, address indexed tokenHolder)

Emitted when an operator is authorised to manage all partitions of a token holder.

Parameters​

NameTypeDescription
operator indexedaddressNewly authorised operator address.
tokenHolder indexedaddressToken holder who granted the authorisation.

OperatorInitialized​

event OperatorInitialized()

Emitted once when the operator capability is initialised on a token.

Fires exclusively from initializeOperator.

RevokedOperator​

event RevokedOperator(address indexed operator, address indexed tokenHolder)

Emitted when an operator's authorisation over all partitions of a token holder is revoked.

Parameters​

NameTypeDescription
operator indexedaddressOperator whose authorisation was revoked.
tokenHolder indexedaddressToken holder who revoked the authorisation.

Errors​

AccountHasNoRole​

error AccountHasNoRole(address account, bytes32 role)

Thrown when an account does not hold a required role.

Parameters​

NameTypeDescription
accountaddressThe account that lacks the role.
rolebytes32The 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​

NameTypeDescription
configIdbytes32Resolver-proxy configuration whose operational status was checked.
versionIduint256Configuration 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​

NameTypeDescription
facetIdbytes32Identifier of the offending facet.
lastVersionuint256Last 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).

UnrecognizedResolverProxyVersion​

error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)

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

Parameters​

NameTypeDescription
_resolverProxyVersionbytes8proxy version that is not compatible with the BLR.

WalletRecovered​

error WalletRecovered()

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