BatchController
Asset Tokenization Studio Team
BatchController
Abstract implementation of controller-only batch transfer operations.
Shares the access-control/role semantics of IERC1644.controllerTransfer: the caller must hold either the controller or the agent role, the token must be controllable and operating in single-partition mode. Emits one ControllerTransfer event per transferred element so downstream indexers observe the same event stream as the single-shot path.
Methods
batchForcedTransfer
function batchForcedTransfer(address[] _fromList, address[] _toList, uint256[] _amounts) external nonpayable
Batch forced transfer of tokens from multiple source addresses to multiple destinations.
Restricted to accounts holding the controller or agent role. Requires the token to be controllable and operating in single-partition mode. Emits one IController.ControllerTransfer event per element.
Parameters
| Name | Type | Description |
|---|---|---|
| _fromList | address[] | Source addresses to debit. |
| _toList | address[] | Destination addresses to credit. |
| _amounts | uint256[] | Amounts to transfer, positionally aligned with _fromList and _toList. |
initializeBatchController
function initializeBatchController() external nonpayable
Initialises the batch controller capability on the token.
Callable once; subsequent calls revert with FacetAlreadyRegistered. Requires DEFAULT_ADMIN_ROLE. Called by the factory during deployment.
Events
BatchControllerInitialized
event BatchControllerInitialized()
Emitted once when the batch controller capability is initialised on a token.
Fires exclusively from initializeBatchController after the storage write succeeds.
ControllerTransfer
event ControllerTransfer(address controller, address indexed from, address indexed to, uint256 value, bytes data, bytes operatorData)
Emitted when an authorised controller transfers tokens between two holders.
Parameters
| Name | Type | Description |
|---|---|---|
| controller | address | The address of the controller that initiated the transfer. |
from indexed | address | The address tokens are transferred from. |
to indexed | address | The address tokens are transferred to. |
| value | uint256 | The amount of tokens transferred. |
| data | bytes | Optional data attached to the transfer for validation. |
| operatorData | bytes | Optional data attached by the controller for event attribution. |
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. |
AccountHasNoRoles
error AccountHasNoRoles(address account, bytes32[] roles)
Thrown when an account does not hold any of the specified roles.
Parameters
| Name | Type | Description |
|---|---|---|
| account | address | The account that lacks the roles. |
| roles | bytes32[] | The roles that are 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. |
InputAmountsArrayLengthMismatch
error InputAmountsArrayLengthMismatch()
Thrown when the lengths of two input amount arrays do not match.
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).
NotAllowedInMultiPartitionMode
error NotAllowedInMultiPartitionMode()
Thrown when a single-partition operation is attempted on a multi-partition token.
TokenIsNotControllable
error TokenIsNotControllable()
Thrown when an operation requires the token to be controllable but it is not.
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.
ZeroValue
error ZeroValue()
Thrown when a zero token amount is supplied to an operation that requires a positive value.