diff --git a/.github/workflows/build-lint-test.yml b/.github/workflows/build-lint-test.yml
index 2a247ad01..4e01a0779 100644
--- a/.github/workflows/build-lint-test.yml
+++ b/.github/workflows/build-lint-test.yml
@@ -106,9 +106,11 @@ jobs:
path: |
artifacts
node_modules
+ dist
types
contracts.ts
packages/**/types
+ packages/**/dist
key: ${{ github.run_id }}
- name: Use Node.js v20
diff --git a/contracts/Imports.sol b/contracts/Imports.sol
index afd3ebea6..cc63c6749 100644
--- a/contracts/Imports.sol
+++ b/contracts/Imports.sol
@@ -35,3 +35,6 @@ import {
import {
UniversalProfilePostDeploymentModule
} from "@lukso/lsp23-contracts/contracts/modules/UniversalProfilePostDeploymentModule.sol";
+import {
+ IPostDeploymentModule
+} from "@lukso/lsp23-contracts/contracts/IPostDeploymentModule.sol";
diff --git a/docs/contracts/@lukso/lsp23-contracts/contracts/IPostDeploymentModule.md b/docs/contracts/@lukso/lsp23-contracts/contracts/IPostDeploymentModule.md
new file mode 100644
index 000000000..d3f02a12b
--- /dev/null
+++ b/docs/contracts/@lukso/lsp23-contracts/contracts/IPostDeploymentModule.md
@@ -0,0 +1,53 @@
+
+
+
+# IPostDeploymentModule
+
+:::info Standard Specifications
+
+[`LSP-23-LinkedContractsFactory`](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md)
+
+:::
+:::info Solidity implementation
+
+[`IPostDeploymentModule.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/IPostDeploymentModule.sol)
+
+:::
+
+## Public Methods
+
+Public methods are accessible externally from users, allowing interaction with this function from dApps or other smart contracts.
+When marked as 'public', a method can be called both externally and internally, on the other hand, when marked as 'external', a method can only be called externally.
+
+### executePostDeployment
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#executepostdeployment)
+- Solidity implementation: [`IPostDeploymentModule.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/IPostDeploymentModule.sol)
+- Function signature: `executePostDeployment(address,address,bytes)`
+- Function selector: `0x28c4d14e`
+
+:::
+
+```solidity
+function executePostDeployment(
+ address primaryContract,
+ address secondaryContract,
+ bytes calldataToPostDeploymentModule
+) external nonpayable;
+```
+
+_This function can be used to perform any additional setup or configuration after the primary and secondary contracts have been deployed._
+
+Executes post-deployment logic for the primary and secondary contracts.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------------- | :-------: | -------------------------------------------------------- |
+| `primaryContract` | `address` | The address of the deployed primary contract. |
+| `secondaryContract` | `address` | The address of the deployed secondary contract. |
+| `calldataToPostDeploymentModule` | `bytes` | Calldata to be passed for the post-deployment execution. |
+
+
diff --git a/docs/contracts/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.md b/docs/contracts/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.md
new file mode 100644
index 000000000..864523823
--- /dev/null
+++ b/docs/contracts/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.md
@@ -0,0 +1,403 @@
+
+
+
+# LSP23LinkedContractsFactory
+
+:::info Standard Specifications
+
+[`LSP-23-LinkedContractsFactory`](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md)
+
+:::
+:::info Solidity implementation
+
+[`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+
+:::
+
+## Public Methods
+
+Public methods are accessible externally from users, allowing interaction with this function from dApps or other smart contracts.
+When marked as 'public', a method can be called both externally and internally, on the other hand, when marked as 'external', a method can only be called externally.
+
+### computeAddresses
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#computeaddresses)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Function signature: `computeAddresses(ILSP23LinkedContractsFactory.PrimaryContractDeployment,ILSP23LinkedContractsFactory.SecondaryContractDeployment,address,bytes)`
+- Function selector: `0xdecfb0b9`
+
+:::
+
+```solidity
+function computeAddresses(
+ ILSP23LinkedContractsFactory.PrimaryContractDeployment primaryContractDeployment,
+ ILSP23LinkedContractsFactory.SecondaryContractDeployment secondaryContractDeployment,
+ address postDeploymentModule,
+ bytes postDeploymentModuleCalldata
+)
+ external
+ view
+ returns (address primaryContractAddress, address secondaryContractAddress);
+```
+
+Computes the addresses of a primary contract and a secondary linked contract
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------------------------ | :--------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `primaryContractDeployment` | `ILSP23LinkedContractsFactory.PrimaryContractDeployment` | Contains the needed parameter to deploy the primary contract. (`salt`, `fundingAmount`, `creationBytecode`) |
+| `secondaryContractDeployment` | `ILSP23LinkedContractsFactory.SecondaryContractDeployment` | Contains the needed parameter to deploy the secondary contract. (`fundingAmount`, `creationBytecode`, `addPrimaryContractAddress`, `extraConstructorParams`) |
+| `postDeploymentModule` | `address` | The optional module to be executed after deployment |
+| `postDeploymentModuleCalldata` | `bytes` | The data to be passed to the post deployment module |
+
+#### Returns
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ----------------------------------------------- |
+| `primaryContractAddress` | `address` | The address of the deployed primary contract. |
+| `secondaryContractAddress` | `address` | The address of the deployed secondary contract. |
+
+
+
+### computeERC1167Addresses
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#computeerc1167addresses)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Function signature: `computeERC1167Addresses(ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit,ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit,address,bytes)`
+- Function selector: `0x8da85898`
+
+:::
+
+```solidity
+function computeERC1167Addresses(
+ ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit primaryContractDeploymentInit,
+ ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit secondaryContractDeploymentInit,
+ address postDeploymentModule,
+ bytes postDeploymentModuleCalldata
+)
+ external
+ view
+ returns (address primaryContractAddress, address secondaryContractAddress);
+```
+
+Computes the addresses of a primary and a secondary linked contracts ERC1167 proxies to be created
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------------------------- | :------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `primaryContractDeploymentInit` | `ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit` | Contains the needed parameters to deploy a primary proxy contract. (`salt`, `fundingAmount`, `implementationContract`, `initializationCalldata`) |
+| `secondaryContractDeploymentInit` | `ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit` | Contains the needed parameters to deploy the secondary proxy contract. (`fundingAmount`, `implementationContract`, `initializationCalldata`, `addPrimaryContractAddress`, `extraInitializationParams`) |
+| `postDeploymentModule` | `address` | The optional module to be executed after deployment. |
+| `postDeploymentModuleCalldata` | `bytes` | The data to be passed to the post deployment module. |
+
+#### Returns
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ---------------------------------------------------- |
+| `primaryContractAddress` | `address` | The address of the deployed primary contract proxy |
+| `secondaryContractAddress` | `address` | The address of the deployed secondary contract proxy |
+
+
+
+### deployContracts
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#deploycontracts)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Function signature: `deployContracts(ILSP23LinkedContractsFactory.PrimaryContractDeployment,ILSP23LinkedContractsFactory.SecondaryContractDeployment,address,bytes)`
+- Function selector: `0xf830c0ab`
+
+:::
+
+```solidity
+function deployContracts(
+ ILSP23LinkedContractsFactory.PrimaryContractDeployment primaryContractDeployment,
+ ILSP23LinkedContractsFactory.SecondaryContractDeployment secondaryContractDeployment,
+ address postDeploymentModule,
+ bytes postDeploymentModuleCalldata
+)
+ external
+ payable
+ returns (address primaryContractAddress, address secondaryContractAddress);
+```
+
+_Contracts deployed. Contract Address: `primaryContractAddress`. Primary Contract Address: `primaryContractAddress`_
+
+Deploys a primary and a secondary linked contract.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------------------------ | :--------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `primaryContractDeployment` | `ILSP23LinkedContractsFactory.PrimaryContractDeployment` | Contains the needed parameter to deploy a contract. (`salt`, `fundingAmount`, `creationBytecode`) |
+| `secondaryContractDeployment` | `ILSP23LinkedContractsFactory.SecondaryContractDeployment` | Contains the needed parameter to deploy the secondary contract. (`fundingAmount`, `creationBytecode`, `addPrimaryContractAddress`, `extraConstructorParams`) |
+| `postDeploymentModule` | `address` | The optional module to be executed after deployment |
+| `postDeploymentModuleCalldata` | `bytes` | The data to be passed to the post deployment module |
+
+#### Returns
+
+| Name | Type | Description |
+| -------------------------- | :-------: | -------------------------------------- |
+| `primaryContractAddress` | `address` | The address of the primary contract. |
+| `secondaryContractAddress` | `address` | The address of the secondary contract. |
+
+
+
+### deployERC1167Proxies
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#deployerc1167proxies)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Function signature: `deployERC1167Proxies(ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit,ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit,address,bytes)`
+- Function selector: `0x17c042c4`
+
+:::
+
+```solidity
+function deployERC1167Proxies(
+ ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit primaryContractDeploymentInit,
+ ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit secondaryContractDeploymentInit,
+ address postDeploymentModule,
+ bytes postDeploymentModuleCalldata
+)
+ external
+ payable
+ returns (address primaryContractAddress, address secondaryContractAddress);
+```
+
+_Contract proxies deployed. Primary Proxy Address: `primaryContractAddress`. Secondary Contract Proxy Address: `secondaryContractAddress`_
+
+Deploys ERC1167 proxies of a primary contract and a secondary linked contract
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------------------------- | :------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `primaryContractDeploymentInit` | `ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit` | Contains the needed parameters to deploy a proxy contract. (`salt`, `fundingAmount`, `implementationContract`, `initializationCalldata`) |
+| `secondaryContractDeploymentInit` | `ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit` | Contains the needed parameters to deploy the secondary proxy contract. (`fundingAmount`, `implementationContract`, `initializationCalldata`, `addPrimaryContractAddress`, `extraInitializationParams`) |
+| `postDeploymentModule` | `address` | The optional module to be executed after deployment. |
+| `postDeploymentModuleCalldata` | `bytes` | The data to be passed to the post deployment module. |
+
+#### Returns
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ---------------------------------------------------- |
+| `primaryContractAddress` | `address` | The address of the deployed primary contract proxy |
+| `secondaryContractAddress` | `address` | The address of the deployed secondary contract proxy |
+
+
+
+## Internal Methods
+
+Any method labeled as `internal` serves as utility function within the contract. They can be used when writing solidity contracts that inherit from this contract. These methods can be extended or modified by overriding their internal behavior to suit specific needs.
+
+Internal functions cannot be called externally, whether from other smart contracts, dApp interfaces, or backend services. Their restricted accessibility ensures that they remain exclusively available within the context of the current contract, promoting controlled and encapsulated usage of these internal utilities.
+
+### \_deployPrimaryContract
+
+```solidity
+function _deployPrimaryContract(struct ILSP23LinkedContractsFactory.PrimaryContractDeployment primaryContractDeployment, struct ILSP23LinkedContractsFactory.SecondaryContractDeployment secondaryContractDeployment, address postDeploymentModule, bytes postDeploymentModuleCalldata) internal nonpayable returns (address primaryContractAddress);
+```
+
+
+
+### \_deploySecondaryContract
+
+```solidity
+function _deploySecondaryContract(struct ILSP23LinkedContractsFactory.SecondaryContractDeployment secondaryContractDeployment, address primaryContractAddress) internal nonpayable returns (address secondaryContractAddress);
+```
+
+
+
+### \_deployAndInitializePrimaryContractProxy
+
+```solidity
+function _deployAndInitializePrimaryContractProxy(struct ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit primaryContractDeploymentInit, struct ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit secondaryContractDeploymentInit, address postDeploymentModule, bytes postDeploymentModuleCalldata) internal nonpayable returns (address primaryContractAddress);
+```
+
+
+
+### \_deployAndInitializeSecondaryContractProxy
+
+```solidity
+function _deployAndInitializeSecondaryContractProxy(struct ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit secondaryContractDeploymentInit, address primaryContractAddress) internal nonpayable returns (address secondaryContractAddress);
+```
+
+
+
+### \_generatePrimaryContractSalt
+
+```solidity
+function _generatePrimaryContractSalt(struct ILSP23LinkedContractsFactory.PrimaryContractDeployment primaryContractDeployment, struct ILSP23LinkedContractsFactory.SecondaryContractDeployment secondaryContractDeployment, address postDeploymentModule, bytes postDeploymentModuleCalldata) internal pure returns (bytes32 primaryContractGeneratedSalt);
+```
+
+
+
+### \_generatePrimaryContractProxySalt
+
+```solidity
+function _generatePrimaryContractProxySalt(struct ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit primaryContractDeploymentInit, struct ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit secondaryContractDeploymentInit, address postDeploymentModule, bytes postDeploymentModuleCalldata) internal pure returns (bytes32 primaryContractProxyGeneratedSalt);
+```
+
+
+
+## Events
+
+### DeployedContracts
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#deployedcontracts)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Event signature: `DeployedContracts(address,address,ILSP23LinkedContractsFactory.PrimaryContractDeployment,ILSP23LinkedContractsFactory.SecondaryContractDeployment,address,bytes)`
+- Event topic hash: `0x1ea27dabd8fd1508e844ab51c2fd3d9081f2684346857f9187da6d4a1aa7d3e6`
+
+:::
+
+```solidity
+event DeployedContracts(
+ address indexed primaryContract,
+ address indexed secondaryContract,
+ ILSP23LinkedContractsFactory.PrimaryContractDeployment primaryContractDeployment,
+ ILSP23LinkedContractsFactory.SecondaryContractDeployment secondaryContractDeployment,
+ address postDeploymentModule,
+ bytes postDeploymentModuleCalldata
+);
+```
+
+Emitted when a primary and secondary contract are deployed.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------------------------- | :--------------------------------------------------------: | ------------------------------------------------------ |
+| `primaryContract` **`indexed`** | `address` | Address of the deployed primary contract. |
+| `secondaryContract` **`indexed`** | `address` | Address of the deployed secondary contract. |
+| `primaryContractDeployment` | `ILSP23LinkedContractsFactory.PrimaryContractDeployment` | Parameters used for the primary contract deployment. |
+| `secondaryContractDeployment` | `ILSP23LinkedContractsFactory.SecondaryContractDeployment` | Parameters used for the secondary contract deployment. |
+| `postDeploymentModule` | `address` | Address of the post-deployment module. |
+| `postDeploymentModuleCalldata` | `bytes` | Calldata passed to the post-deployment module. |
+
+
+
+### DeployedERC1167Proxies
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#deployederc1167proxies)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Event signature: `DeployedERC1167Proxies(address,address,ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit,ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit,address,bytes)`
+- Event topic hash: `0xb03dbe7a02c063899f863d542410b5b038c8f537045be3a26e7144e0074e1c7b`
+
+:::
+
+```solidity
+event DeployedERC1167Proxies(
+ address indexed primaryContract,
+ address indexed secondaryContract,
+ ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit primaryContractDeploymentInit,
+ ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit secondaryContractDeploymentInit,
+ address postDeploymentModule,
+ bytes postDeploymentModuleCalldata
+);
+```
+
+Emitted when proxies of a primary and secondary contract are deployed.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------------------------- | :------------------------------------------------------------: | ------------------------------------------------------------ |
+| `primaryContract` **`indexed`** | `address` | Address of the deployed primary contract proxy. |
+| `secondaryContract` **`indexed`** | `address` | Address of the deployed secondary contract proxy. |
+| `primaryContractDeploymentInit` | `ILSP23LinkedContractsFactory.PrimaryContractDeploymentInit` | Parameters used for the primary contract proxy deployment. |
+| `secondaryContractDeploymentInit` | `ILSP23LinkedContractsFactory.SecondaryContractDeploymentInit` | Parameters used for the secondary contract proxy deployment. |
+| `postDeploymentModule` | `address` | Address of the post-deployment module. |
+| `postDeploymentModuleCalldata` | `bytes` | Calldata passed to the post-deployment module. |
+
+
+
+## Errors
+
+### InvalidValueSum
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#invalidvaluesum)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Error signature: `InvalidValueSum()`
+- Error hash: `0x2fd9ca91`
+
+:::
+
+```solidity
+error InvalidValueSum();
+```
+
+_Invalid value sent._
+
+Reverts when the `msg.value` sent is not equal to the sum of value used for the deployment of the contract & its owner contract.
+
+
+
+### PrimaryContractProxyInitFailureError
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#primarycontractproxyinitfailureerror)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Error signature: `PrimaryContractProxyInitFailureError(bytes)`
+- Error hash: `0x4364b6ee`
+
+:::
+
+```solidity
+error PrimaryContractProxyInitFailureError(bytes errorData);
+```
+
+_Failed to deploy & initialize the Primary Contract Proxy. Error: `errorData`._
+
+Reverts when the deployment & intialization of the contract has failed.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-----: | ----------------------------------------------------------------------------- |
+| `errorData` | `bytes` | Potentially information about why the deployment & intialization have failed. |
+
+
+
+### SecondaryContractProxyInitFailureError
+
+:::note References
+
+- Specification details: [**LSP-23-LinkedContractsFactory**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-23-LinkedContractsFactory.md#secondarycontractproxyinitfailureerror)
+- Solidity implementation: [`LSP23LinkedContractsFactory.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp23-contracts/contracts/LSP23LinkedContractsFactory.sol)
+- Error signature: `SecondaryContractProxyInitFailureError(bytes)`
+- Error hash: `0x9654a854`
+
+:::
+
+```solidity
+error SecondaryContractProxyInitFailureError(bytes errorData);
+```
+
+_Failed to deploy & initialize the Secondary Contract Proxy. Error: `errorData`._
+
+Reverts when the deployment & intialization of the secondary contract has failed.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-----: | ----------------------------------------------------------------------------- |
+| `errorData` | `bytes` | Potentially information about why the deployment & intialization have failed. |
+
+
diff --git a/docs/contracts/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.md b/docs/contracts/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.md
new file mode 100644
index 000000000..b7b6c971e
--- /dev/null
+++ b/docs/contracts/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.md
@@ -0,0 +1,1933 @@
+
+
+
+# LSP7Mintable
+
+:::info Standard Specifications
+
+[`LSP-7-DigitalAsset`](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md)
+
+:::
+:::info Solidity implementation
+
+[`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+
+:::
+
+> LSP7DigitalAsset deployable preset contract with a public [`mint`](#mint) function callable only by the contract [`owner`](#owner).
+
+## Public Methods
+
+Public methods are accessible externally from users, allowing interaction with this function from dApps or other smart contracts.
+When marked as 'public', a method can be called both externally and internally, on the other hand, when marked as 'external', a method can only be called externally.
+
+### constructor
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#constructor)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+
+:::
+
+```solidity
+constructor(
+ string name_,
+ string symbol_,
+ address newOwner_,
+ uint256 lsp4TokenType_,
+ bool isNonDivisible_
+);
+```
+
+_Deploying a `LSP7Mintable` token contract with: token name = `name_`, token symbol = `symbol_`, and address `newOwner_` as the token contract owner._
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------- | :-------: | ---------------------------------------------------------------------------------------------------- |
+| `name_` | `string` | The name of the token. |
+| `symbol_` | `string` | The symbol of the token. |
+| `newOwner_` | `address` | The owner of the token contract. |
+| `lsp4TokenType_` | `uint256` | The type of token this digital asset contract represents (`0` = Token, `1` = NFT, `2` = Collection). |
+| `isNonDivisible_` | `bool` | Specify if the LSP7 token is a fungible or non-fungible token. |
+
+
+
+### fallback
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#fallback)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+
+:::
+
+```solidity
+fallback(bytes calldata callData) external payable returns (bytes memory);
+```
+
+_The `fallback` function was called with the following amount of native tokens: `msg.value`; and the following calldata: `callData`._
+
+Achieves the goal of [LSP-17-ContractExtension] standard by extending the contract to handle calls of functions that do not exist natively,
+forwarding the function call to the extension address mapped to the function being called.
+This function is executed when:
+
+- Sending data of length less than 4 bytes to the contract.
+
+- The first 4 bytes of the calldata do not match any publicly callable functions from the contract ABI.
+
+- Receiving native tokens
+
+1. If the data is equal or longer than 4 bytes, the [ERC-725Y] storage is queried with the following data key: [_LSP17_EXTENSION_PREFIX] + `bytes4(msg.sig)` (Check [LSP-2-ERC725YJSONSchema] for encoding the data key)
+
+- If there is no address stored under the following data key, revert with [`NoExtensionFoundForFunctionSelector(bytes4)`](#noextensionfoundforfunctionselector). The data key relative to `bytes4(0)` is an exception, where no reverts occurs if there is no extension address stored under. This exception is made to allow users to send random data (graffiti) to the account and to be able to react on it.
+
+- If there is an address, forward the `msg.data` to the extension using the CALL opcode, appending 52 bytes (20 bytes of `msg.sender` and 32 bytes of `msg.value`). Return what the calls returns, or revert if the call failed.
+
+2. If the data sent to this function is of length less than 4 bytes (not a function selector), revert.
+
+
+
+### receive
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#receive)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+
+:::
+
+```solidity
+receive() external payable;
+```
+
+_LSP7 contract cannot receive native tokens._
+
+Reverts whenever someone tries to send native tokens to a LSP7 contract.
+
+
+
+### authorizeOperator
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#authorizeoperator)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `authorizeOperator(address,uint256,bytes)`
+- Function selector: `0xb49506fd`
+
+:::
+
+:::danger
+
+To avoid front-running and Allowance Double-Spend Exploit when increasing or decreasing the authorized amount of an operator, it is advised to use the [`increaseAllowance`](#increaseallowance) and [`decreaseAllowance`](#decreaseallowance) functions. For more information, see: https://docs.google.com/document/d/1YLPtQxZu1UAvO9cZ1O2RPXBbT0mooh4DYKjA_jp-RLM/
+
+:::
+
+```solidity
+function authorizeOperator(
+ address operator,
+ uint256 amount,
+ bytes operatorNotificationData
+) external nonpayable;
+```
+
+Sets an `amount` of tokens that an `operator` has access from the caller's balance (allowance). See [`authorizedAmountFor`](#authorizedamountfor). Notify the operator based on the LSP1-UniversalReceiver standard
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ------------------------------------------------------ |
+| `operator` | `address` | The address to authorize as an operator. |
+| `amount` | `uint256` | The allowance amount of tokens operator has access to. |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### authorizedAmountFor
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#authorizedamountfor)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `authorizedAmountFor(address,address)`
+- Function selector: `0x65aeaa95`
+
+:::
+
+```solidity
+function authorizedAmountFor(
+ address operator,
+ address tokenOwner
+) external view returns (uint256);
+```
+
+Get the amount of tokens `operator` address has access to from `tokenOwner`. Operators can send and burn tokens on behalf of their owners.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ---------------------------------------------------------- |
+| `operator` | `address` | The operator's address to query the authorized amount for. |
+| `tokenOwner` | `address` | The token owner that `operator` has allowance on. |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | --------------------------------------------------------------------------------------- |
+| `0` | `uint256` | The amount of tokens the `operator`'s address has access on the `tokenOwner`'s balance. |
+
+
+
+### balanceOf
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#balanceof)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `balanceOf(address)`
+- Function selector: `0x70a08231`
+
+:::
+
+```solidity
+function balanceOf(address tokenOwner) external view returns (uint256);
+```
+
+Get the number of tokens owned by `tokenOwner`. If the token is divisible (the [`decimals`](#decimals) function returns `18`), the amount returned should be divided by 1e18 to get a better picture of the actual balance of the `tokenOwner`. _Example:_ `balanceOf(someAddress) -> 42_000_000_000_000_000_000 / 1e18 = 42 tokens`
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | --------------------------------------------------------- |
+| `tokenOwner` | `address` | The address of the token holder to query the balance for. |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ------------------------------------------- |
+| `0` | `uint256` | The amount of tokens owned by `tokenOwner`. |
+
+
+
+### batchCalls
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#batchcalls)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `batchCalls(bytes[])`
+- Function selector: `0x6963d438`
+
+:::
+
+:::info
+
+It's not possible to send value along the functions call due to the use of `delegatecall`.
+
+:::
+
+```solidity
+function batchCalls(bytes[] data) external nonpayable returns (bytes[] results);
+```
+
+_Executing the following batch of abi-encoded function calls on the contract: `data`._
+
+Allows a caller to batch different function calls in one call. Perform a `delegatecall` on self, to call different functions with preserving the context.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------ | :-------: | -------------------------------------------------------------------- |
+| `data` | `bytes[]` | An array of ABI encoded function calls to be called on the contract. |
+
+#### Returns
+
+| Name | Type | Description |
+| --------- | :-------: | ---------------------------------------------------------------- |
+| `results` | `bytes[]` | An array of abi-encoded data returned by the functions executed. |
+
+
+
+### decimals
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#decimals)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `decimals()`
+- Function selector: `0x313ce567`
+
+:::
+
+```solidity
+function decimals() external view returns (uint8);
+```
+
+Returns the number of decimals used to get its user representation. If the asset contract has been set to be non-divisible via the `isNonDivisible_` parameter in the `constructor`, the decimals returned wiil be `0`. Otherwise `18` is the common value.
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-----: | ----------------------------------------------------------------------- |
+| `0` | `uint8` | the number of decimals. If `0` is returned, the asset is non-divisible. |
+
+
+
+### decreaseAllowance
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#decreaseallowance)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `decreaseAllowance(address,uint256,bytes)`
+- Function selector: `0x7b204c4e`
+
+:::
+
+```solidity
+function decreaseAllowance(
+ address operator,
+ uint256 subtractedAmount,
+ bytes operatorNotificationData
+) external nonpayable;
+```
+
+_Decrease the allowance of `operator` by -`subtractedAmount`_
+
+Atomically decreases the allowance granted to `operator` by the caller. This is an alternative approach to [`authorizeOperator`](#authorizeoperator) that can be used as a mitigation for the double spending allowance problem. Notify the operator based on the LSP1-UniversalReceiver standard
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ------------------------------------------------------ |
+| `operator` | `address` | The operator to decrease allowance for `msg.sender` |
+| `subtractedAmount` | `uint256` | The amount to decrease by in the operator's allowance. |
+| `operatorNotificationData` | `bytes` | - |
+
+
+
+### getData
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#getdata)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `getData(bytes32)`
+- Function selector: `0x54f6127f`
+
+:::
+
+```solidity
+function getData(bytes32 dataKey) external view returns (bytes dataValue);
+```
+
+_Reading the ERC725Y storage for data key `dataKey` returned the following value: `dataValue`._
+
+Get in the ERC725Y storage the bytes data stored at a specific data key `dataKey`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | --------------------------------------------- |
+| `dataKey` | `bytes32` | The data key for which to retrieve the value. |
+
+#### Returns
+
+| Name | Type | Description |
+| ----------- | :-----: | ---------------------------------------------------- |
+| `dataValue` | `bytes` | The bytes value stored under the specified data key. |
+
+
+
+### getDataBatch
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#getdatabatch)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `getDataBatch(bytes32[])`
+- Function selector: `0xdedff9c6`
+
+:::
+
+```solidity
+function getDataBatch(
+ bytes32[] dataKeys
+) external view returns (bytes[] dataValues);
+```
+
+_Reading the ERC725Y storage for data keys `dataKeys` returned the following values: `dataValues`._
+
+Get in the ERC725Y storage the bytes data stored at multiple data keys `dataKeys`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :---------: | ------------------------------------------ |
+| `dataKeys` | `bytes32[]` | The array of keys which values to retrieve |
+
+#### Returns
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------------------------------------- |
+| `dataValues` | `bytes[]` | The array of data stored at multiple keys |
+
+
+
+### getOperatorsOf
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#getoperatorsof)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `getOperatorsOf(address)`
+- Function selector: `0xd72fc29a`
+
+:::
+
+```solidity
+function getOperatorsOf(address tokenOwner) external view returns (address[]);
+```
+
+Returns all `operator` addresses that are allowed to transfer or burn on behalf of `tokenOwner`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------------------------------------- |
+| `tokenOwner` | `address` | The token owner to get the operators for. |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :---------: | ----------------------------------------------------------------------------------- |
+| `0` | `address[]` | An array of operators allowed to transfer or burn tokens on behalf of `tokenOwner`. |
+
+
+
+### increaseAllowance
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#increaseallowance)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `increaseAllowance(address,uint256,bytes)`
+- Function selector: `0x2bc1da82`
+
+:::
+
+```solidity
+function increaseAllowance(
+ address operator,
+ uint256 addedAmount,
+ bytes operatorNotificationData
+) external nonpayable;
+```
+
+_Increase the allowance of `operator` by +`addedAmount`_
+
+Atomically increases the allowance granted to `operator` by the caller. This is an alternative approach to [`authorizeOperator`](#authorizeoperator) that can be used as a mitigation for the double spending allowance problem. Notify the operator based on the LSP1-UniversalReceiver standard
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ----------------------------------------------------------------------- |
+| `operator` | `address` | The operator to increase the allowance for `msg.sender` |
+| `addedAmount` | `uint256` | The additional amount to add on top of the current operator's allowance |
+| `operatorNotificationData` | `bytes` | - |
+
+
+
+### mint
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#mint)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `mint(address,uint256,bool,bytes)`
+- Function selector: `0x7580d920`
+
+:::
+
+```solidity
+function mint(
+ address to,
+ uint256 amount,
+ bool force,
+ bytes data
+) external nonpayable;
+```
+
+Public [`_mint`](#_mint) function only callable by the [`owner`](#owner).
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | ----------- |
+| `to` | `address` | - |
+| `amount` | `uint256` | - |
+| `force` | `bool` | - |
+| `data` | `bytes` | - |
+
+
+
+### owner
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#owner)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `owner()`
+- Function selector: `0x8da5cb5b`
+
+:::
+
+```solidity
+function owner() external view returns (address);
+```
+
+Returns the address of the current owner.
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ----------- |
+| `0` | `address` | - |
+
+
+
+### renounceOwnership
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#renounceownership)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `renounceOwnership()`
+- Function selector: `0x715018a6`
+
+:::
+
+```solidity
+function renounceOwnership() external nonpayable;
+```
+
+Leaves the contract without owner. It will not be possible to call `onlyOwner` functions anymore. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.
+
+
+
+### revokeOperator
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#revokeoperator)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `revokeOperator(address,bool,bytes)`
+- Function selector: `0x4521748e`
+
+:::
+
+```solidity
+function revokeOperator(
+ address operator,
+ bool notify,
+ bytes operatorNotificationData
+) external nonpayable;
+```
+
+Removes the `operator` address as an operator of callers tokens, disallowing it to send any amount of tokens on behalf of the token owner (the caller of the function `msg.sender`). See also [`authorizedAmountFor`](#authorizedamountfor).
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | --------------------------------------------------------- |
+| `operator` | `address` | The address to revoke as an operator. |
+| `notify` | `bool` | Boolean indicating whether to notify the operator or not. |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### setData
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#setdata)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `setData(bytes32,bytes)`
+- Function selector: `0x7f23690c`
+
+:::
+
+:::caution Warning
+
+**Note for developers:** despite the fact that this function is set as `payable`, if the function is not intended to receive value (= native tokens), **an additional check should be implemented to ensure that `msg.value` sent was equal to 0**.
+
+:::
+
+```solidity
+function setData(bytes32 dataKey, bytes dataValue) external payable;
+```
+
+_Setting the following data key value pair in the ERC725Y storage. Data key: `dataKey`, data value: `dataValue`._
+
+Sets a single bytes value `dataValue` in the ERC725Y storage for a specific data key `dataKey`. The function is marked as payable to enable flexibility on child contracts. For instance to implement a fee mechanism for setting specific data.
+
+
+
+**Requirements:**
+
+- SHOULD only be callable by the [`owner`](#owner).
+
+
+
+
+
+**Emitted events:**
+
+- [`DataChanged`](#datachanged) event.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-------: | ------------------------------------------ |
+| `dataKey` | `bytes32` | The data key for which to set a new value. |
+| `dataValue` | `bytes` | The new bytes value to set. |
+
+
+
+### setDataBatch
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#setdatabatch)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `setDataBatch(bytes32[],bytes[])`
+- Function selector: `0x97902421`
+
+:::
+
+:::caution Warning
+
+**Note for developers:** despite the fact that this function is set as `payable`, if the function is not intended to receive value (= native tokens), **an additional check should be implemented to ensure that `msg.value` sent was equal to 0**.
+
+:::
+
+```solidity
+function setDataBatch(bytes32[] dataKeys, bytes[] dataValues) external payable;
+```
+
+_Setting the following data key value pairs in the ERC725Y storage. Data keys: `dataKeys`, data values: `dataValues`._
+
+Batch data setting function that behaves the same as [`setData`](#setdata) but allowing to set multiple data key/value pairs in the ERC725Y storage in the same transaction.
+
+
+
+**Requirements:**
+
+- SHOULD only be callable by the [`owner`](#owner) of the contract.
+
+
+
+
+
+**Emitted events:**
+
+- [`DataChanged`](#datachanged) event **for each data key/value pair set**.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :---------: | ---------------------------------------------------- |
+| `dataKeys` | `bytes32[]` | An array of data keys to set bytes values for. |
+| `dataValues` | `bytes[]` | An array of bytes values to set for each `dataKeys`. |
+
+
+
+### supportsInterface
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#supportsinterface)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `supportsInterface(bytes4)`
+- Function selector: `0x01ffc9a7`
+
+:::
+
+```solidity
+function supportsInterface(bytes4 interfaceId) external view returns (bool);
+```
+
+Returns true if this contract implements the interface defined by `interfaceId`. See the corresponding https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] to learn more about how these ids are created. This function call must use less than 30 000 gas.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------- | :------: | ----------- |
+| `interfaceId` | `bytes4` | - |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :----: | ----------- |
+| `0` | `bool` | - |
+
+
+
+### totalSupply
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#totalsupply)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `totalSupply()`
+- Function selector: `0x18160ddd`
+
+:::
+
+```solidity
+function totalSupply() external view returns (uint256);
+```
+
+Returns the number of existing tokens that have been minted in this contract.
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ------------------------------ |
+| `0` | `uint256` | The number of existing tokens. |
+
+
+
+### transfer
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#transfer)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `transfer(address,address,uint256,bool,bytes)`
+- Function selector: `0x760d9bba`
+
+:::
+
+```solidity
+function transfer(
+ address from,
+ address to,
+ uint256 amount,
+ bool force,
+ bytes data
+) external nonpayable;
+```
+
+Transfers an `amount` of tokens from the `from` address to the `to` address and notify both sender and recipients via the LSP1 [`universalReceiver(...)`](#`universalreceiver) function. If the tokens are transferred by an operator on behalf of a token holder, the allowance for the operator will be decreased by `amount` once the token transfer has been completed (See [`authorizedAmountFor`](#authorizedamountfor)).
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address` | The sender address. |
+| `to` | `address` | The recipient address. |
+| `amount` | `uint256` | The amount of tokens to transfer. |
+| `force` | `bool` | When set to `true`, the `to` address CAN be any address. When set to `false`, the `to` address MUST be a contract that supports the LSP1 UniversalReceiver standard. |
+| `data` | `bytes` | Any additional data the caller wants included in the emitted event, and sent in the hooks of the `from` and `to` addresses. |
+
+
+
+### transferBatch
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#transferbatch)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `transferBatch(address[],address[],uint256[],bool[],bytes[])`
+- Function selector: `0x2d7667c9`
+
+:::
+
+```solidity
+function transferBatch(
+ address[] from,
+ address[] to,
+ uint256[] amount,
+ bool[] force,
+ bytes[] data
+) external nonpayable;
+```
+
+Same as [`transfer(...)`](#`transfer) but transfer multiple tokens based on the arrays of `from`, `to`, `amount`.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :---------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address[]` | An array of sending addresses. |
+| `to` | `address[]` | An array of receiving addresses. |
+| `amount` | `uint256[]` | An array of amount of tokens to transfer for each `from -> to` transfer. |
+| `force` | `bool[]` | For each transfer, when set to `true`, the `to` address CAN be any address. When set to `false`, the `to` address MUST be a contract that supports the LSP1 UniversalReceiver standard. |
+| `data` | `bytes[]` | An array of additional data the caller wants included in the emitted event, and sent in the hooks to `from` and `to` addresses. |
+
+
+
+### transferOwnership
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#transferownership)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Function signature: `transferOwnership(address)`
+- Function selector: `0xf2fde38b`
+
+:::
+
+```solidity
+function transferOwnership(address newOwner) external nonpayable;
+```
+
+Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ----------- |
+| `newOwner` | `address` | - |
+
+
+
+## Internal Methods
+
+Any method labeled as `internal` serves as utility function within the contract. They can be used when writing solidity contracts that inherit from this contract. These methods can be extended or modified by overriding their internal behavior to suit specific needs.
+
+Internal functions cannot be called externally, whether from other smart contracts, dApp interfaces, or backend services. Their restricted accessibility ensures that they remain exclusively available within the context of the current contract, promoting controlled and encapsulated usage of these internal utilities.
+
+### \_checkOwner
+
+```solidity
+function _checkOwner() internal view;
+```
+
+Throws if the sender is not the owner.
+
+
+
+### \_setOwner
+
+```solidity
+function _setOwner(address newOwner) internal nonpayable;
+```
+
+Changes the owner if `newOwner` and oldOwner are different
+This pattern is useful in inheritance.
+
+
+
+### \_getData
+
+```solidity
+function _getData(bytes32 dataKey) internal view returns (bytes dataValue);
+```
+
+Read the value stored under a specific `dataKey` inside the underlying ERC725Y storage,
+represented as a mapping of `bytes32` data keys mapped to their `bytes` data values.
+
+```solidity
+mapping(bytes32 => bytes) _store
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ----------------------------------------------------------------------- |
+| `dataKey` | `bytes32` | A bytes32 data key to read the associated `bytes` value from the store. |
+
+#### Returns
+
+| Name | Type | Description |
+| ----------- | :-----: | ----------------------------------------------------------------------------- |
+| `dataValue` | `bytes` | The `bytes` value associated with the given `dataKey` in the ERC725Y storage. |
+
+
+
+### \_setData
+
+```solidity
+function _setData(bytes32 dataKey, bytes dataValue) internal nonpayable;
+```
+
+The ERC725Y data keys `LSP4TokenName` and `LSP4TokenSymbol` cannot be changed
+via this function once the digital asset contract has been deployed.
+
+
+
+### \_updateOperator
+
+```solidity
+function _updateOperator(
+ address tokenOwner,
+ address operator,
+ uint256 allowance,
+ bool notified,
+ bytes operatorNotificationData
+) internal nonpayable;
+```
+
+Changes token `amount` the `operator` has access to from `tokenOwner` tokens.
+If the amount is zero the operator is removed from the list of operators, otherwise he is added to the list of operators.
+If the amount is zero then the operator is being revoked, otherwise the operator amount is being modified.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ----------------------------------------------------------------------------------------------------------------------- |
+| `tokenOwner` | `address` | The address that will give `operator` an allowance for on its balance. |
+| `operator` | `address` | @param operatorNotificationData The data to send to the universalReceiver function of the operator in case of notifying |
+| `allowance` | `uint256` | The maximum amount of token that `operator` can spend from the `tokenOwner`'s balance. |
+| `notified` | `bool` | Boolean indicating whether the operator has been notified about the change of allowance |
+| `operatorNotificationData` | `bytes` | The data to send to the universalReceiver function of the operator in case of notifying |
+
+
+
+### \_mint
+
+:::info
+
+Any logic in the:
+
+- [`_beforeTokenTransfer`](#_beforetokentransfer) function will run before updating the balances.
+
+- [`_afterTokenTransfer`](#_aftertokentransfer) function will run after updating the balances, **but before notifying the recipient via LSP1**.
+
+:::
+
+```solidity
+function _mint(
+ address to,
+ uint256 amount,
+ bool force,
+ bytes data
+) internal nonpayable;
+```
+
+Mints `amount` of tokens and transfers it to `to`.
+
+
+
+**Emitted events:**
+
+- [`Transfer`](#transfer) event with `address(0)` as `from`.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `to` | `address` | The address to mint tokens for. |
+| `amount` | `uint256` | The amount of tokens to mint. |
+| `force` | `bool` | A boolean that describe if transfer to a `to` address that does not support LSP1 is allowed or not. |
+| `data` | `bytes` | Additional data the caller wants included in the emitted [`Transfer`](#transfer) event, and sent in the LSP1 hook to the `to` address. |
+
+
+
+### \_burn
+
+:::info
+
+Any logic in the:
+
+- [`_beforeTokenTransfer`](#_beforetokentransfer) function will run before updating the balances.
+
+- [`_afterTokenTransfer`](#_aftertokentransfer) function will run after updating the balances, **but before notifying the sender via LSP1**.
+
+:::
+
+:::tip Hint
+
+In dApps, you can know which address is burning tokens by listening for the `Transfer` event and filter with the zero address as `to`.
+
+:::
+
+```solidity
+function _burn(address from, uint256 amount, bytes data) internal nonpayable;
+```
+
+Burns (= destroys) `amount` of tokens, decrease the `from` balance. This is done by sending them to the zero address.
+Both the sender and recipient will be notified of the token transfer through the LSP1 [`universalReceiver`](#universalreceiver)
+function, if they are contracts that support the LSP1 interface. Their `universalReceiver` function will receive
+all the parameters in the calldata packed encoded.
+
+
+
+**Emitted events:**
+
+- [`Transfer`](#transfer) event with `address(0)` as the `to` address
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | ------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address` | The address to burn tokens from its balance. |
+| `amount` | `uint256` | The amount of tokens to burn. |
+| `data` | `bytes` | Additional data the caller wants included in the emitted event, and sent in the LSP1 hook to the `from` and `to` address. |
+
+
+
+### \_spendAllowance
+
+```solidity
+function _spendAllowance(
+ address operator,
+ address tokenOwner,
+ uint256 amountToSpend
+) internal nonpayable;
+```
+
+Spend `amountToSpend` from the `operator`'s authorized on behalf of the `tokenOwner`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ------------------------------------------------------------------- |
+| `operator` | `address` | The address of the operator to decrease the allowance of. |
+| `tokenOwner` | `address` | The address that granted an allowance on its balance to `operator`. |
+| `amountToSpend` | `uint256` | The amount of tokens to substract in allowance of `operator`. |
+
+
+
+### \_transfer
+
+:::info
+
+Any logic in the:
+
+- [`_beforeTokenTransfer`](#_beforetokentransfer) function will run before updating the balances.
+
+- [`_afterTokenTransfer`](#_aftertokentransfer) function will run after updating the balances, **but before notifying the sender/recipient via LSP1**.
+
+:::
+
+```solidity
+function _transfer(
+ address from,
+ address to,
+ uint256 amount,
+ bool force,
+ bytes data
+) internal nonpayable;
+```
+
+Transfer tokens from `from` to `to` by decreasing the balance of `from` by `-amount` and increasing the balance
+of `to` by `+amount`.
+Both the sender and recipient will be notified of the token transfer through the LSP1 [`universalReceiver`](#universalreceiver)
+function, if they are contracts that support the LSP1 interface. Their `universalReceiver` function will receive
+all the parameters in the calldata packed encoded.
+
+
+
+**Emitted events:**
+
+- [`Transfer`](#transfer) event.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | ------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address` | The address to decrease the balance. |
+| `to` | `address` | The address to increase the balance. |
+| `amount` | `uint256` | The amount of tokens to transfer from `from` to `to`. |
+| `force` | `bool` | A boolean that describe if transfer to a `to` address that does not support LSP1 is allowed or not. |
+| `data` | `bytes` | Additional data the caller wants included in the emitted event, and sent in the LSP1 hook to the `from` and `to` address. |
+
+
+
+### \_beforeTokenTransfer
+
+```solidity
+function _beforeTokenTransfer(
+ address from,
+ address to,
+ uint256 amount,
+ bytes data
+) internal nonpayable;
+```
+
+Hook that is called before any token transfer, including minting and burning.
+Allows to run custom logic before updating balances and notifiying sender/recipient by overriding this function.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | ------------------------------------ |
+| `from` | `address` | The sender address |
+| `to` | `address` | The recipient address |
+| `amount` | `uint256` | The amount of token to transfer |
+| `data` | `bytes` | The data sent alongside the transfer |
+
+
+
+### \_afterTokenTransfer
+
+```solidity
+function _afterTokenTransfer(
+ address from,
+ address to,
+ uint256 amount,
+ bytes data
+) internal nonpayable;
+```
+
+Hook that is called after any token transfer, including minting and burning.
+Allows to run custom logic after updating balances, but **before notifiying sender/recipient** by overriding this function.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------- | :-------: | ------------------------------------ |
+| `from` | `address` | The sender address |
+| `to` | `address` | The recipient address |
+| `amount` | `uint256` | The amount of token to transfer |
+| `data` | `bytes` | The data sent alongside the transfer |
+
+
+
+### \_notifyTokenOperator
+
+```solidity
+function _notifyTokenOperator(
+ address operator,
+ bytes lsp1Data
+) internal nonpayable;
+```
+
+Attempt to notify the operator `operator` about the `amount` tokens being authorized with.
+This is done by calling its [`universalReceiver`](#universalreceiver) function with the `_TYPEID_LSP7_TOKENOPERATOR` as typeId, if `operator` is a contract that supports the LSP1 interface.
+If `operator` is an EOA or a contract that does not support the LSP1 interface, nothing will happen and no notification will be sent.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ------------------------------------------------------------------------------ |
+| `operator` | `address` | The address to call the [`universalReceiver`](#universalreceiver) function on. |
+| `lsp1Data` | `bytes` | the data to be sent to the `operator` address in the `universalReceiver` call. |
+
+
+
+### \_notifyTokenSender
+
+```solidity
+function _notifyTokenSender(address from, bytes lsp1Data) internal nonpayable;
+```
+
+Attempt to notify the token sender `from` about the `amount` of tokens being transferred.
+This is done by calling its [`universalReceiver`](#universalreceiver) function with the `_TYPEID_LSP7_TOKENSSENDER` as typeId, if `from` is a contract that supports the LSP1 interface.
+If `from` is an EOA or a contract that does not support the LSP1 interface, nothing will happen and no notification will be sent.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ------------------------------------------------------------------------------ |
+| `from` | `address` | The address to call the [`universalReceiver`](#universalreceiver) function on. |
+| `lsp1Data` | `bytes` | the data to be sent to the `from` address in the `universalReceiver` call. |
+
+
+
+### \_notifyTokenReceiver
+
+```solidity
+function _notifyTokenReceiver(
+ address to,
+ bool force,
+ bytes lsp1Data
+) internal nonpayable;
+```
+
+Attempt to notify the token receiver `to` about the `amount` tokens being received.
+This is done by calling its [`universalReceiver`](#universalreceiver) function with the `_TYPEID_LSP7_TOKENSRECIPIENT` as typeId, if `to` is a contract that supports the LSP1 interface.
+If `to` is is an EOA or a contract that does not support the LSP1 interface, the behaviour will depend on the `force` boolean flag.
+
+- if `force` is set to `true`, nothing will happen and no notification will be sent.
+
+- if `force` is set to `false, the transaction will revert.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | --------------------------------------------------------------------------------------------------- |
+| `to` | `address` | The address to call the [`universalReceiver`](#universalreceiver) function on. |
+| `force` | `bool` | A boolean that describe if transfer to a `to` address that does not support LSP1 is allowed or not. |
+| `lsp1Data` | `bytes` | The data to be sent to the `to` address in the `universalReceiver(...)` call. |
+
+
+
+### \_supportsInterfaceInERC165Extension
+
+```solidity
+function _supportsInterfaceInERC165Extension(
+ bytes4 interfaceId
+) internal view returns (bool);
+```
+
+Returns whether the interfaceId being checked is supported in the extension of the
+[`supportsInterface`](#supportsinterface) selector.
+To be used by extendable contracts wishing to extend the ERC165 interfaceIds originally
+supported by reading whether the interfaceId queried is supported in the `supportsInterface`
+extension if the extension is set, if not it returns false.
+
+
+
+### \_getExtensionAndForwardValue
+
+```solidity
+function _getExtensionAndForwardValue(
+ bytes4 functionSelector
+) internal view returns (address, bool);
+```
+
+Returns the extension address stored under the following data key:
+
+- [`_LSP17_EXTENSION_PREFIX`](#_lsp17_extension_prefix) + `` (Check [LSP2-ERC725YJSONSchema] for encoding the data key).
+
+- If no extension is stored, returns the address(0).
+
+- we do not check that payable bool as in lsp7 standard we will always forward the value to the extension
+
+
+
+### \_fallbackLSP17Extendable
+
+:::info
+
+The LSP7 Token contract should not hold any native tokens. Any native tokens received by the contract
+will be forwarded to the extension address mapped to the selector from `msg.sig`.
+
+:::
+
+```solidity
+function _fallbackLSP17Extendable(
+ bytes callData
+) internal nonpayable returns (bytes);
+```
+
+Forwards the call with the received value to an extension mapped to a function selector.
+Calls [`_getExtensionAndForwardValue`](#_getextensionandforwardvalue) to get the address of the extension mapped to the function selector being
+called on the account. If there is no extension, the address(0) will be returned.
+Forwards the value if the extension is payable.
+Reverts if there is no extension for the function being called.
+If there is an extension for the function selector being called, it calls the extension with the
+CALL opcode, passing the [`msg.data`](#msg.data) appended with the 20 bytes of the [`msg.sender`](#msg.sender) and
+32 bytes of the [`msg.value`](#msg.value)
+
+
+
+## Events
+
+### DataChanged
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#datachanged)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Event signature: `DataChanged(bytes32,bytes)`
+- Event topic hash: `0xece574603820d07bc9b91f2a932baadf4628aabcb8afba49776529c14a6104b2`
+
+:::
+
+```solidity
+event DataChanged(bytes32 indexed dataKey, bytes dataValue);
+```
+
+_The following data key/value pair has been changed in the ERC725Y storage: Data key: `dataKey`, data value: `dataValue`._
+
+Emitted when data at a specific `dataKey` was changed to a new value `dataValue`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------------- | :-------: | -------------------------------------------- |
+| `dataKey` **`indexed`** | `bytes32` | The data key for which a bytes value is set. |
+| `dataValue` | `bytes` | The value to set for the given data key. |
+
+
+
+### OperatorAuthorizationChanged
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#operatorauthorizationchanged)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Event signature: `OperatorAuthorizationChanged(address,address,uint256,bytes)`
+- Event topic hash: `0xf772a43bfdf4729b196e3fb54a818b91a2ca6c49d10b2e16278752f9f515c25d`
+
+:::
+
+```solidity
+event OperatorAuthorizationChanged(
+ address indexed operator,
+ address indexed tokenOwner,
+ uint256 indexed amount,
+ bytes operatorNotificationData
+);
+```
+
+Emitted when `tokenOwner` enables `operator` for `amount` tokens.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ----------------------------------------------------------------------- |
+| `operator` **`indexed`** | `address` | The address authorized as an operator |
+| `tokenOwner` **`indexed`** | `address` | The token owner |
+| `amount` **`indexed`** | `uint256` | The amount of tokens `operator` address has access to from `tokenOwner` |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### OperatorRevoked
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#operatorrevoked)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Event signature: `OperatorRevoked(address,address,bool,bytes)`
+- Event topic hash: `0x0ebf5762d8855cbe012d2ca42fb33a81175e17c8a8751f8859931ba453bd4167`
+
+:::
+
+```solidity
+event OperatorRevoked(
+ address indexed operator,
+ address indexed tokenOwner,
+ bool indexed notified,
+ bytes operatorNotificationData
+);
+```
+
+Emitted when `tokenOwner` disables `operator` for `amount` tokens and set its [`authorizedAmountFor(...)`](#`authorizedamountfor) to `0`.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ------------------------------------------------------------- |
+| `operator` **`indexed`** | `address` | The address revoked from operating |
+| `tokenOwner` **`indexed`** | `address` | The token owner |
+| `notified` **`indexed`** | `bool` | Bool indicating whether the operator has been notified or not |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### OwnershipTransferred
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#ownershiptransferred)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Event signature: `OwnershipTransferred(address,address)`
+- Event topic hash: `0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0`
+
+:::
+
+```solidity
+event OwnershipTransferred(
+ address indexed previousOwner,
+ address indexed newOwner
+);
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------------------- | :-------: | ----------- |
+| `previousOwner` **`indexed`** | `address` | - |
+| `newOwner` **`indexed`** | `address` | - |
+
+
+
+### Transfer
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#transfer)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Event signature: `Transfer(address,address,address,uint256,bool,bytes)`
+- Event topic hash: `0x3997e418d2cef0b3b0e907b1e39605c3f7d32dbd061e82ea5b4a770d46a160a6`
+
+:::
+
+```solidity
+event Transfer(
+ address indexed operator,
+ address indexed from,
+ address indexed to,
+ uint256 amount,
+ bool force,
+ bytes data
+);
+```
+
+Emitted when the `from` transferred successfully `amount` of tokens to `to`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------------------ | :-------: | ---------------------------------------------------------------------------------------------------------------------------- |
+| `operator` **`indexed`** | `address` | The address of the operator that executed the transfer. |
+| `from` **`indexed`** | `address` | The address which tokens were sent from (balance decreased by `-amount`). |
+| `to` **`indexed`** | `address` | The address that received the tokens (balance increased by `+amount`). |
+| `amount` | `uint256` | The amount of tokens transferred. |
+| `force` | `bool` | if the transferred enforced the `to` recipient address to be a contract that implements the LSP1 standard or not. |
+| `data` | `bytes` | Any additional data included by the caller during the transfer, and sent in the LSP1 hooks to the `from` and `to` addresses. |
+
+
+
+## Errors
+
+### ERC725Y_DataKeysValuesEmptyArray
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#erc725y_datakeysvaluesemptyarray)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `ERC725Y_DataKeysValuesEmptyArray()`
+- Error hash: `0x97da5f95`
+
+:::
+
+```solidity
+error ERC725Y_DataKeysValuesEmptyArray();
+```
+
+Reverts when one of the array parameter provided to [`setDataBatch`](#setdatabatch) function is an empty array.
+
+
+
+### ERC725Y_DataKeysValuesLengthMismatch
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#erc725y_datakeysvalueslengthmismatch)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `ERC725Y_DataKeysValuesLengthMismatch()`
+- Error hash: `0x3bcc8979`
+
+:::
+
+```solidity
+error ERC725Y_DataKeysValuesLengthMismatch();
+```
+
+Reverts when there is not the same number of elements in the `datakeys` and `dataValues` array parameters provided when calling the [`setDataBatch`](#setdatabatch) function.
+
+
+
+### ERC725Y_MsgValueDisallowed
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#erc725y_msgvaluedisallowed)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `ERC725Y_MsgValueDisallowed()`
+- Error hash: `0xf36ba737`
+
+:::
+
+```solidity
+error ERC725Y_MsgValueDisallowed();
+```
+
+Reverts when sending value to the [`setData`](#setdata) or [`setDataBatch`](#setdatabatch) function.
+
+
+
+### InvalidExtensionAddress
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#invalidextensionaddress)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `InvalidExtensionAddress(bytes)`
+- Error hash: `0x42bfe79f`
+
+:::
+
+```solidity
+error InvalidExtensionAddress(bytes storedData);
+```
+
+reverts when the bytes retrieved from the LSP17 data key is not a valid address (not 20 bytes)
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-----: | ----------- |
+| `storedData` | `bytes` | - |
+
+
+
+### InvalidFunctionSelector
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#invalidfunctionselector)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `InvalidFunctionSelector(bytes)`
+- Error hash: `0xe5099ee3`
+
+:::
+
+```solidity
+error InvalidFunctionSelector(bytes data);
+```
+
+reverts when the contract is called with a function selector not valid (less than 4 bytes of data)
+
+#### Parameters
+
+| Name | Type | Description |
+| ------ | :-----: | ----------- |
+| `data` | `bytes` | - |
+
+
+
+### LSP4TokenNameNotEditable
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp4tokennamenoteditable)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP4TokenNameNotEditable()`
+- Error hash: `0x85c169bd`
+
+:::
+
+```solidity
+error LSP4TokenNameNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP4TokenName` after the digital asset contract has been deployed / initialized. The `LSP4TokenName` data key is located inside the ERC725Y data key-value store of the digital asset contract. It can be set only once inside the constructor/initializer when the digital asset contract is being deployed / initialized.
+
+
+
+### LSP4TokenSymbolNotEditable
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp4tokensymbolnoteditable)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP4TokenSymbolNotEditable()`
+- Error hash: `0x76755b38`
+
+:::
+
+```solidity
+error LSP4TokenSymbolNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP4TokenSymbol` after the digital asset contract has been deployed / initialized. The `LSP4TokenSymbol` data key is located inside the ERC725Y data key-value store of the digital asset contract. It can be set only once inside the constructor/initializer when the digital asset contract is being deployed / initialized.
+
+
+
+### LSP4TokenTypeNotEditable
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp4tokentypenoteditable)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP4TokenTypeNotEditable()`
+- Error hash: `0x4ef6d7fb`
+
+:::
+
+```solidity
+error LSP4TokenTypeNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP4TokenType` after the digital asset contract has been deployed / initialized. The `LSP4TokenType` data key is located inside the ERC725Y data key-value store of the digital asset contract. It can be set only once inside the constructor / initializer when the digital asset contract is being deployed / initialized.
+
+
+
+### LSP7AmountExceedsAuthorizedAmount
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7amountexceedsauthorizedamount)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7AmountExceedsAuthorizedAmount(address,uint256,address,uint256)`
+- Error hash: `0xf3a6b691`
+
+:::
+
+```solidity
+error LSP7AmountExceedsAuthorizedAmount(
+ address tokenOwner,
+ uint256 authorizedAmount,
+ address operator,
+ uint256 amount
+);
+```
+
+reverts when `operator` of `tokenOwner` send an `amount` of tokens larger than the `authorizedAmount`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------------ | :-------: | ----------- |
+| `tokenOwner` | `address` | - |
+| `authorizedAmount` | `uint256` | - |
+| `operator` | `address` | - |
+| `amount` | `uint256` | - |
+
+
+
+### LSP7AmountExceedsBalance
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7amountexceedsbalance)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7AmountExceedsBalance(uint256,address,uint256)`
+- Error hash: `0x08d47949`
+
+:::
+
+```solidity
+error LSP7AmountExceedsBalance(
+ uint256 balance,
+ address tokenOwner,
+ uint256 amount
+);
+```
+
+reverts when sending an `amount` of tokens larger than the current `balance` of the `tokenOwner`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------- |
+| `balance` | `uint256` | - |
+| `tokenOwner` | `address` | - |
+| `amount` | `uint256` | - |
+
+
+
+### LSP7BatchCallFailed
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7batchcallfailed)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7BatchCallFailed(uint256)`
+- Error hash: `0xb774c284`
+
+:::
+
+```solidity
+error LSP7BatchCallFailed(uint256 callIndex);
+```
+
+_Batch call failed._
+
+Reverts when a batch call failed.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-------: | ----------- |
+| `callIndex` | `uint256` | - |
+
+
+
+### LSP7CannotSendToSelf
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7cannotsendtoself)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7CannotSendToSelf()`
+- Error hash: `0xb9afb000`
+
+:::
+
+```solidity
+error LSP7CannotSendToSelf();
+```
+
+reverts when specifying the same address for `from` or `to` in a token transfer.
+
+
+
+### LSP7CannotSendWithAddressZero
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7cannotsendwithaddresszero)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7CannotSendWithAddressZero()`
+- Error hash: `0xd2d5ec30`
+
+:::
+
+```solidity
+error LSP7CannotSendWithAddressZero();
+```
+
+reverts when trying to:
+
+- mint tokens to the zero address.
+
+- burn tokens from the zero address.
+
+- transfer tokens from or to the zero address.
+
+
+
+### LSP7CannotUseAddressZeroAsOperator
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7cannotuseaddresszeroasoperator)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7CannotUseAddressZeroAsOperator()`
+- Error hash: `0x6355e766`
+
+:::
+
+```solidity
+error LSP7CannotUseAddressZeroAsOperator();
+```
+
+reverts when trying to set the zero address as an operator.
+
+
+
+### LSP7DecreasedAllowanceBelowZero
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7decreasedallowancebelowzero)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7DecreasedAllowanceBelowZero()`
+- Error hash: `0x0ef76c35`
+
+:::
+
+```solidity
+error LSP7DecreasedAllowanceBelowZero();
+```
+
+Reverts when trying to decrease an operator's allowance to more than its current allowance.
+
+
+
+### LSP7InvalidTransferBatch
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7invalidtransferbatch)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7InvalidTransferBatch()`
+- Error hash: `0x263eee8d`
+
+:::
+
+```solidity
+error LSP7InvalidTransferBatch();
+```
+
+reverts when the array parameters used in [`transferBatch`](#transferbatch) have different lengths.
+
+
+
+### LSP7NotifyTokenReceiverContractMissingLSP1Interface
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7notifytokenreceivercontractmissinglsp1interface)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7NotifyTokenReceiverContractMissingLSP1Interface(address)`
+- Error hash: `0xa608fbb6`
+
+:::
+
+```solidity
+error LSP7NotifyTokenReceiverContractMissingLSP1Interface(
+ address tokenReceiver
+);
+```
+
+reverts if the `tokenReceiver` does not implement LSP1 when minting or transferring tokens with `bool force` set as `false`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ----------- |
+| `tokenReceiver` | `address` | - |
+
+
+
+### LSP7NotifyTokenReceiverIsEOA
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7notifytokenreceiveriseoa)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7NotifyTokenReceiverIsEOA(address)`
+- Error hash: `0x26c247f4`
+
+:::
+
+```solidity
+error LSP7NotifyTokenReceiverIsEOA(address tokenReceiver);
+```
+
+reverts if the `tokenReceiver` is an EOA when minting or transferring tokens with `bool force` set as `false`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ----------- |
+| `tokenReceiver` | `address` | - |
+
+
+
+### LSP7TokenContractCannotHoldValue
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7tokencontractcannotholdvalue)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7TokenContractCannotHoldValue()`
+- Error hash: `0x388f5adc`
+
+:::
+
+```solidity
+error LSP7TokenContractCannotHoldValue();
+```
+
+_LSP7 contract cannot receive native tokens._
+
+Error occurs when sending native tokens to the LSP7 contract without sending any data. E.g. Sending value without passing a bytes4 function selector to call a LSP17 Extension.
+
+
+
+### LSP7TokenOwnerCannotBeOperator
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#lsp7tokenownercannotbeoperator)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `LSP7TokenOwnerCannotBeOperator()`
+- Error hash: `0xdab75047`
+
+:::
+
+```solidity
+error LSP7TokenOwnerCannotBeOperator();
+```
+
+reverts when trying to authorize or revoke the token's owner as an operator.
+
+
+
+### NoExtensionFoundForFunctionSelector
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#noextensionfoundforfunctionselector)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `NoExtensionFoundForFunctionSelector(bytes4)`
+- Error hash: `0xbb370b2b`
+
+:::
+
+```solidity
+error NoExtensionFoundForFunctionSelector(bytes4 functionSelector);
+```
+
+reverts when there is no extension for the function selector being called with
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------------ | :------: | ----------- |
+| `functionSelector` | `bytes4` | - |
+
+
+
+### OperatorAllowanceCannotBeIncreasedFromZero
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#operatorallowancecannotbeincreasedfromzero)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `OperatorAllowanceCannotBeIncreasedFromZero(address)`
+- Error hash: `0xcba6e977`
+
+:::
+
+```solidity
+error OperatorAllowanceCannotBeIncreasedFromZero(address operator);
+```
+
+Reverts when token owner call [`increaseAllowance`](#increaseallowance) for an operator that does not have any allowance
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ----------- |
+| `operator` | `address` | - |
+
+
+
+### OwnableCallerNotTheOwner
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#ownablecallernottheowner)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `OwnableCallerNotTheOwner(address)`
+- Error hash: `0xbf1169c5`
+
+:::
+
+```solidity
+error OwnableCallerNotTheOwner(address callerAddress);
+```
+
+Reverts when only the owner is allowed to call the function.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ---------------------------------------- |
+| `callerAddress` | `address` | The address that tried to make the call. |
+
+
+
+### OwnableCannotSetZeroAddressAsOwner
+
+:::note References
+
+- Specification details: [**LSP-7-DigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-7-DigitalAsset.md#ownablecannotsetzeroaddressasowner)
+- Solidity implementation: [`LSP7Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp7-contracts/contracts/presets/LSP7Mintable.sol)
+- Error signature: `OwnableCannotSetZeroAddressAsOwner()`
+- Error hash: `0x1ad8836c`
+
+:::
+
+```solidity
+error OwnableCannotSetZeroAddressAsOwner();
+```
+
+Reverts when trying to set `address(0)` as the contract owner when deploying the contract, initializing it or transferring ownership of the contract.
+
+
diff --git a/docs/contracts/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.md b/docs/contracts/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.md
new file mode 100644
index 000000000..6fa649ce3
--- /dev/null
+++ b/docs/contracts/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.md
@@ -0,0 +1,2283 @@
+
+
+
+# LSP8Mintable
+
+:::info Standard Specifications
+
+[`LSP-8-IdentifiableDigitalAsset`](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md)
+
+:::
+:::info Solidity implementation
+
+[`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+
+:::
+
+> LSP8IdentifiableDigitalAsset deployable preset contract with a public [`mint`](#mint) function callable only by the contract [`owner`](#owner).
+
+## Public Methods
+
+Public methods are accessible externally from users, allowing interaction with this function from dApps or other smart contracts.
+When marked as 'public', a method can be called both externally and internally, on the other hand, when marked as 'external', a method can only be called externally.
+
+### constructor
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#constructor)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+
+:::
+
+```solidity
+constructor(
+ string name_,
+ string symbol_,
+ address newOwner_,
+ uint256 lsp4TokenType_,
+ uint256 lsp8TokenIdFormat_
+);
+```
+
+_Deploying a `LSP8Mintable` token contract with: token name = `name_`, token symbol = `symbol_`, and address `newOwner_` as the token contract owner._
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------- | :-------: | ---------------------------------------------------------------------------------------------------- |
+| `name_` | `string` | The name of the token. |
+| `symbol_` | `string` | The symbol of the token. |
+| `newOwner_` | `address` | The owner of the token contract. |
+| `lsp4TokenType_` | `uint256` | The type of token this digital asset contract represents (`0` = Token, `1` = NFT, `2` = Collection). |
+| `lsp8TokenIdFormat_` | `uint256` | The format of tokenIds (= NFTs) that this contract will create. |
+
+
+
+### fallback
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#fallback)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+
+:::
+
+```solidity
+fallback(bytes calldata callData) external payable returns (bytes memory);
+```
+
+_The `fallback` function was called with the following amount of native tokens: `msg.value`; and the following calldata: `callData`._
+
+Achieves the goal of [LSP-17-ContractExtension] standard by extending the contract to handle calls of functions that do not exist natively,
+forwarding the function call to the extension address mapped to the function being called.
+This function is executed when:
+
+- Sending data of length less than 4 bytes to the contract.
+
+- The first 4 bytes of the calldata do not match any publicly callable functions from the contract ABI.
+
+- Receiving native tokens
+
+1. If the data is equal or longer than 4 bytes, the [ERC-725Y] storage is queried with the following data key: [_LSP17_EXTENSION_PREFIX] + `bytes4(msg.sig)` (Check [LSP-2-ERC725YJSONSchema] for encoding the data key)
+
+- If there is no address stored under the following data key, revert with [`NoExtensionFoundForFunctionSelector(bytes4)`](#noextensionfoundforfunctionselector). The data key relative to `bytes4(0)` is an exception, where no reverts occurs if there is no extension address stored under. This exception is made to allow users to send random data (graffiti) to the account and to be able to react on it.
+
+- If there is an address, forward the `msg.data` to the extension using the CALL opcode, appending 52 bytes (20 bytes of `msg.sender` and 32 bytes of `msg.value`). Return what the calls returns, or revert if the call failed.
+
+2. If the data sent to this function is of length less than 4 bytes (not a function selector), revert.
+
+
+
+### receive
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#receive)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+
+:::
+
+```solidity
+receive() external payable;
+```
+
+_LSP8 contract cannot receive native tokens._
+
+Reverts whenever someone tries to send native tokens to a LSP8 contract.
+
+
+
+### authorizeOperator
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#authorizeoperator)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `authorizeOperator(address,bytes32,bytes)`
+- Function selector: `0x86a10ddd`
+
+:::
+
+```solidity
+function authorizeOperator(
+ address operator,
+ bytes32 tokenId,
+ bytes operatorNotificationData
+) external nonpayable;
+```
+
+Allow an `operator` address to transfer or burn a specific `tokenId` on behalf of its token owner. See [`isOperatorFor`](#isoperatorfor). Notify the operator based on the LSP1-UniversalReceiver standard
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ----------------------------------------------- |
+| `operator` | `address` | The address to authorize as an operator. |
+| `tokenId` | `bytes32` | The token ID operator has access to. |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### balanceOf
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#balanceof)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `balanceOf(address)`
+- Function selector: `0x70a08231`
+
+:::
+
+```solidity
+function balanceOf(address tokenOwner) external view returns (uint256);
+```
+
+Get the number of token IDs owned by `tokenOwner`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------------------- |
+| `tokenOwner` | `address` | The address to query \* |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ----------------------------------------------------- |
+| `0` | `uint256` | The total number of token IDs that `tokenOwner` owns. |
+
+
+
+### batchCalls
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#batchcalls)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `batchCalls(bytes[])`
+- Function selector: `0x6963d438`
+
+:::
+
+:::info
+
+It's not possible to send value along the functions call due to the use of `delegatecall`.
+
+:::
+
+```solidity
+function batchCalls(bytes[] data) external nonpayable returns (bytes[] results);
+```
+
+_Executing the following batch of abi-encoded function calls on the contract: `data`._
+
+Allows a caller to batch different function calls in one call. Perform a `delegatecall` on self, to call different functions with preserving the context.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------ | :-------: | -------------------------------------------------------------------- |
+| `data` | `bytes[]` | An array of ABI encoded function calls to be called on the contract. |
+
+#### Returns
+
+| Name | Type | Description |
+| --------- | :-------: | ---------------------------------------------------------------- |
+| `results` | `bytes[]` | An array of abi-encoded data returned by the functions executed. |
+
+
+
+### getData
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#getdata)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `getData(bytes32)`
+- Function selector: `0x54f6127f`
+
+:::
+
+```solidity
+function getData(bytes32 dataKey) external view returns (bytes dataValue);
+```
+
+_Reading the ERC725Y storage for data key `dataKey` returned the following value: `dataValue`._
+
+Get in the ERC725Y storage the bytes data stored at a specific data key `dataKey`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | --------------------------------------------- |
+| `dataKey` | `bytes32` | The data key for which to retrieve the value. |
+
+#### Returns
+
+| Name | Type | Description |
+| ----------- | :-----: | ---------------------------------------------------- |
+| `dataValue` | `bytes` | The bytes value stored under the specified data key. |
+
+
+
+### getDataBatch
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#getdatabatch)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `getDataBatch(bytes32[])`
+- Function selector: `0xdedff9c6`
+
+:::
+
+```solidity
+function getDataBatch(
+ bytes32[] dataKeys
+) external view returns (bytes[] dataValues);
+```
+
+_Reading the ERC725Y storage for data keys `dataKeys` returned the following values: `dataValues`._
+
+Get in the ERC725Y storage the bytes data stored at multiple data keys `dataKeys`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :---------: | ------------------------------------------ |
+| `dataKeys` | `bytes32[]` | The array of keys which values to retrieve |
+
+#### Returns
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------------------------------------- |
+| `dataValues` | `bytes[]` | The array of data stored at multiple keys |
+
+
+
+### getDataBatchForTokenIds
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#getdatabatchfortokenids)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `getDataBatchForTokenIds(bytes32[],bytes32[])`
+- Function selector: `0x1d26fce6`
+
+:::
+
+```solidity
+function getDataBatchForTokenIds(
+ bytes32[] tokenIds,
+ bytes32[] dataKeys
+) external view returns (bytes[] dataValues);
+```
+
+_Retrieves data in batch for multiple `tokenId` and `dataKey` pairs._
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :---------: | ----------------------------------------------------- |
+| `tokenIds` | `bytes32[]` | An array of token IDs. |
+| `dataKeys` | `bytes32[]` | An array of data keys corresponding to the token IDs. |
+
+#### Returns
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------------------------------------------------------------- |
+| `dataValues` | `bytes[]` | An array of data values for each pair of `tokenId` and `dataKey`. |
+
+
+
+### getDataForTokenId
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#getdatafortokenid)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `getDataForTokenId(bytes32,bytes32)`
+- Function selector: `0x16e023b3`
+
+:::
+
+```solidity
+function getDataForTokenId(
+ bytes32 tokenId,
+ bytes32 dataKey
+) external view returns (bytes dataValue);
+```
+
+_Retrieves data for a specific `tokenId` and `dataKey`._
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ---------------------------------- |
+| `tokenId` | `bytes32` | The unique identifier for a token. |
+| `dataKey` | `bytes32` | The key for the data to retrieve. |
+
+#### Returns
+
+| Name | Type | Description |
+| ----------- | :-----: | ----------------------------------------------------------------- |
+| `dataValue` | `bytes` | The data value associated with the given `tokenId` and `dataKey`. |
+
+
+
+### getOperatorsOf
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#getoperatorsof)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `getOperatorsOf(bytes32)`
+- Function selector: `0x49a6078d`
+
+:::
+
+```solidity
+function getOperatorsOf(bytes32 tokenId) external view returns (address[]);
+```
+
+Returns all `operator` addresses that are allowed to transfer or burn a specific `tokenId` on behalf of its owner.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | -------------------------------------- |
+| `tokenId` | `bytes32` | The token ID to get the operators for. |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :---------: | ------------------------------------------------------------------------------------------------------------ |
+| `0` | `address[]` | An array of operators allowed to transfer or burn a specific `tokenId`. Requirements - `tokenId` must exist. |
+
+
+
+### isOperatorFor
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#isoperatorfor)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `isOperatorFor(address,bytes32)`
+- Function selector: `0x2a3654a4`
+
+:::
+
+```solidity
+function isOperatorFor(
+ address operator,
+ bytes32 tokenId
+) external view returns (bool);
+```
+
+Returns whether `operator` address is an operator for a given `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ------------------------------------------------------------- |
+| `operator` | `address` | The address to query operator status for. |
+| `tokenId` | `bytes32` | The token ID to check if `operator` is allowed to operate on. |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :----: | --------------------------------------------------------------------- |
+| `0` | `bool` | `true` if `operator` is an operator for `tokenId`, `false` otherwise. |
+
+
+
+### mint
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#mint)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `mint(address,bytes32,bool,bytes)`
+- Function selector: `0xaf255b61`
+
+:::
+
+```solidity
+function mint(
+ address to,
+ bytes32 tokenId,
+ bool force,
+ bytes data
+) external nonpayable;
+```
+
+_Minting tokenId `tokenId` for address `to` with the additional data `data` (Note: allow non-LSP1 recipient is set to `force`)._
+
+Public [`_mint`](#_mint) function only callable by the [`owner`](#owner).
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ------------------------------------------------------------------------------------------------------------------------------ |
+| `to` | `address` | The address that will receive the minted `tokenId`. |
+| `tokenId` | `bytes32` | The tokenId to mint. |
+| `force` | `bool` | Set to `false` to ensure that you are minting for a recipient that implements LSP1, `false` otherwise for forcing the minting. |
+| `data` | `bytes` | Any addition data to be sent alongside the minting. |
+
+
+
+### owner
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#owner)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `owner()`
+- Function selector: `0x8da5cb5b`
+
+:::
+
+```solidity
+function owner() external view returns (address);
+```
+
+Returns the address of the current owner.
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ----------- |
+| `0` | `address` | - |
+
+
+
+### renounceOwnership
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#renounceownership)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `renounceOwnership()`
+- Function selector: `0x715018a6`
+
+:::
+
+```solidity
+function renounceOwnership() external nonpayable;
+```
+
+Leaves the contract without owner. It will not be possible to call `onlyOwner` functions anymore. Can only be called by the current owner. NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.
+
+
+
+### revokeOperator
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#revokeoperator)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `revokeOperator(address,bytes32,bool,bytes)`
+- Function selector: `0xdb8c9663`
+
+:::
+
+```solidity
+function revokeOperator(
+ address operator,
+ bytes32 tokenId,
+ bool notify,
+ bytes operatorNotificationData
+) external nonpayable;
+```
+
+Remove access of `operator` for a given `tokenId`, disallowing it to transfer `tokenId` on behalf of its owner. See also [`isOperatorFor`](#isoperatorfor).
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | -------------------------------------------------------- |
+| `operator` | `address` | The address to revoke as an operator. |
+| `tokenId` | `bytes32` | The tokenId `operator` is revoked from operating on. |
+| `notify` | `bool` | Boolean indicating whether to notify the operator or not |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### setData
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#setdata)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `setData(bytes32,bytes)`
+- Function selector: `0x7f23690c`
+
+:::
+
+:::caution Warning
+
+**Note for developers:** despite the fact that this function is set as `payable`, if the function is not intended to receive value (= native tokens), **an additional check should be implemented to ensure that `msg.value` sent was equal to 0**.
+
+:::
+
+```solidity
+function setData(bytes32 dataKey, bytes dataValue) external payable;
+```
+
+_Setting the following data key value pair in the ERC725Y storage. Data key: `dataKey`, data value: `dataValue`._
+
+Sets a single bytes value `dataValue` in the ERC725Y storage for a specific data key `dataKey`. The function is marked as payable to enable flexibility on child contracts. For instance to implement a fee mechanism for setting specific data.
+
+
+
+**Requirements:**
+
+- SHOULD only be callable by the [`owner`](#owner).
+
+
+
+
+
+**Emitted events:**
+
+- [`DataChanged`](#datachanged) event.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-------: | ------------------------------------------ |
+| `dataKey` | `bytes32` | The data key for which to set a new value. |
+| `dataValue` | `bytes` | The new bytes value to set. |
+
+
+
+### setDataBatch
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#setdatabatch)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `setDataBatch(bytes32[],bytes[])`
+- Function selector: `0x97902421`
+
+:::
+
+:::caution Warning
+
+**Note for developers:** despite the fact that this function is set as `payable`, if the function is not intended to receive value (= native tokens), **an additional check should be implemented to ensure that `msg.value` sent was equal to 0**.
+
+:::
+
+```solidity
+function setDataBatch(bytes32[] dataKeys, bytes[] dataValues) external payable;
+```
+
+_Setting the following data key value pairs in the ERC725Y storage. Data keys: `dataKeys`, data values: `dataValues`._
+
+Batch data setting function that behaves the same as [`setData`](#setdata) but allowing to set multiple data key/value pairs in the ERC725Y storage in the same transaction.
+
+
+
+**Requirements:**
+
+- SHOULD only be callable by the [`owner`](#owner) of the contract.
+
+
+
+
+
+**Emitted events:**
+
+- [`DataChanged`](#datachanged) event **for each data key/value pair set**.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :---------: | ---------------------------------------------------- |
+| `dataKeys` | `bytes32[]` | An array of data keys to set bytes values for. |
+| `dataValues` | `bytes[]` | An array of bytes values to set for each `dataKeys`. |
+
+
+
+### setDataBatchForTokenIds
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#setdatabatchfortokenids)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `setDataBatchForTokenIds(bytes32[],bytes32[],bytes[])`
+- Function selector: `0xbe9f0e6f`
+
+:::
+
+```solidity
+function setDataBatchForTokenIds(
+ bytes32[] tokenIds,
+ bytes32[] dataKeys,
+ bytes[] dataValues
+) external nonpayable;
+```
+
+_Sets data in batch for multiple `tokenId` and `dataKey` pairs._
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :---------: | ----------------------------------------------------- |
+| `tokenIds` | `bytes32[]` | An array of token IDs. |
+| `dataKeys` | `bytes32[]` | An array of data keys corresponding to the token IDs. |
+| `dataValues` | `bytes[]` | An array of values to set for the given data keys. |
+
+
+
+### setDataForTokenId
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#setdatafortokenid)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `setDataForTokenId(bytes32,bytes32,bytes)`
+- Function selector: `0xd6c1407c`
+
+:::
+
+```solidity
+function setDataForTokenId(
+ bytes32 tokenId,
+ bytes32 dataKey,
+ bytes dataValue
+) external nonpayable;
+```
+
+_Sets data for a specific `tokenId` and `dataKey`._
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-------: | ---------------------------------------- |
+| `tokenId` | `bytes32` | The unique identifier for a token. |
+| `dataKey` | `bytes32` | The key for the data to set. |
+| `dataValue` | `bytes` | The value to set for the given data key. |
+
+
+
+### supportsInterface
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#supportsinterface)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `supportsInterface(bytes4)`
+- Function selector: `0x01ffc9a7`
+
+:::
+
+```solidity
+function supportsInterface(bytes4 interfaceId) external view returns (bool);
+```
+
+Returns true if this contract implements the interface defined by `interfaceId`. See the corresponding https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] to learn more about how these ids are created. This function call must use less than 30 000 gas.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------- | :------: | ----------- |
+| `interfaceId` | `bytes4` | - |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :----: | ----------- |
+| `0` | `bool` | - |
+
+
+
+### tokenIdsOf
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#tokenidsof)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `tokenIdsOf(address)`
+- Function selector: `0xa3b261f2`
+
+:::
+
+```solidity
+function tokenIdsOf(address tokenOwner) external view returns (bytes32[]);
+```
+
+Returns the list of token IDs that the `tokenOwner` address owns.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ---------------------------------------------------------- |
+| `tokenOwner` | `address` | The address that we want to get the list of token IDs for. |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :---------: | ------------------------------------------------------- |
+| `0` | `bytes32[]` | An array of `bytes32[] tokenIds` owned by `tokenOwner`. |
+
+
+
+### tokenOwnerOf
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#tokenownerof)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `tokenOwnerOf(bytes32)`
+- Function selector: `0x217b2270`
+
+:::
+
+```solidity
+function tokenOwnerOf(bytes32 tokenId) external view returns (address);
+```
+
+Returns the list of `tokenIds` for the `tokenOwner` address.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | -------------------------------------------- |
+| `tokenId` | `bytes32` | tokenOwner The address to query owned tokens |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ----------------------------------------- |
+| `0` | `address` | The owner address of the given `tokenId`. |
+
+
+
+### totalSupply
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#totalsupply)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `totalSupply()`
+- Function selector: `0x18160ddd`
+
+:::
+
+```solidity
+function totalSupply() external view returns (uint256);
+```
+
+Returns the number of existing tokens that have been minted in this contract.
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :-------: | ------------------------------ |
+| `0` | `uint256` | The number of existing tokens. |
+
+
+
+### transfer
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#transfer)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `transfer(address,address,bytes32,bool,bytes)`
+- Function selector: `0x511b6952`
+
+:::
+
+```solidity
+function transfer(
+ address from,
+ address to,
+ bytes32 tokenId,
+ bool force,
+ bytes data
+) external nonpayable;
+```
+
+Transfer a given `tokenId` token from the `from` address to the `to` address. If operators are set for a specific `tokenId`, all the operators are revoked after the tokenId have been transferred. The `force` parameter MUST be set to `true` when transferring tokens to Externally Owned Accounts (EOAs) or contracts that do not implement the LSP1 standard.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address` | The address that owns the given `tokenId`. |
+| `to` | `address` | The address that will receive the `tokenId`. |
+| `tokenId` | `bytes32` | The token ID to transfer. |
+| `force` | `bool` | When set to `true`, the `to` address CAN be any addres. When set to `false`, the `to` address MUST be a contract that supports the LSP1 UniversalReceiver standard. |
+| `data` | `bytes` | Any additional data the caller wants included in the emitted event, and sent in the hooks of the `from` and `to` addresses. |
+
+
+
+### transferBatch
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#transferbatch)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `transferBatch(address[],address[],bytes32[],bool[],bytes[])`
+- Function selector: `0x7e87632c`
+
+:::
+
+```solidity
+function transferBatch(
+ address[] from,
+ address[] to,
+ bytes32[] tokenId,
+ bool[] force,
+ bytes[] data
+) external nonpayable;
+```
+
+Transfers multiple tokens at once based on the arrays of `from`, `to` and `tokenId`. If any transfer fails, the whole call will revert.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :---------: | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address[]` | An array of sending addresses. |
+| `to` | `address[]` | An array of recipient addresses. |
+| `tokenId` | `bytes32[]` | An array of token IDs to transfer. |
+| `force` | `bool[]` | When set to `true`, `to` may be any address. When set to `false`, `to` must be a contract that supports the LSP1 standard and not revert. |
+| `data` | `bytes[]` | Any additional data the caller wants included in the emitted event, and sent in the hooks to the `from` and `to` addresses. |
+
+
+
+### transferOwnership
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#transferownership)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Function signature: `transferOwnership(address)`
+- Function selector: `0xf2fde38b`
+
+:::
+
+```solidity
+function transferOwnership(address newOwner) external nonpayable;
+```
+
+Transfers ownership of the contract to a new account (`newOwner`). Can only be called by the current owner.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ----------- |
+| `newOwner` | `address` | - |
+
+
+
+## Internal Methods
+
+Any method labeled as `internal` serves as utility function within the contract. They can be used when writing solidity contracts that inherit from this contract. These methods can be extended or modified by overriding their internal behavior to suit specific needs.
+
+Internal functions cannot be called externally, whether from other smart contracts, dApp interfaces, or backend services. Their restricted accessibility ensures that they remain exclusively available within the context of the current contract, promoting controlled and encapsulated usage of these internal utilities.
+
+### \_checkOwner
+
+```solidity
+function _checkOwner() internal view;
+```
+
+Throws if the sender is not the owner.
+
+
+
+### \_setOwner
+
+```solidity
+function _setOwner(address newOwner) internal nonpayable;
+```
+
+Changes the owner if `newOwner` and oldOwner are different
+This pattern is useful in inheritance.
+
+
+
+### \_getData
+
+```solidity
+function _getData(bytes32 dataKey) internal view returns (bytes dataValue);
+```
+
+Read the value stored under a specific `dataKey` inside the underlying ERC725Y storage,
+represented as a mapping of `bytes32` data keys mapped to their `bytes` data values.
+
+```solidity
+mapping(bytes32 => bytes) _store
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ----------------------------------------------------------------------- |
+| `dataKey` | `bytes32` | A bytes32 data key to read the associated `bytes` value from the store. |
+
+#### Returns
+
+| Name | Type | Description |
+| ----------- | :-----: | ----------------------------------------------------------------------------- |
+| `dataValue` | `bytes` | The `bytes` value associated with the given `dataKey` in the ERC725Y storage. |
+
+
+
+### \_setData
+
+```solidity
+function _setData(bytes32 dataKey, bytes dataValue) internal nonpayable;
+```
+
+The ERC725Y data key `_LSP8_TOKENID_FORMAT_KEY` cannot be changed
+once the identifiable digital asset contract has been deployed.
+
+
+
+### \_isOperatorOrOwner
+
+```solidity
+function _isOperatorOrOwner(
+ address caller,
+ bytes32 tokenId
+) internal view returns (bool);
+```
+
+verifies if the `caller` is operator or owner for the `tokenId`
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | :----: | -------------------------------------------- |
+| `0` | `bool` | true if `caller` is either operator or owner |
+
+
+
+### \_revokeOperator
+
+```solidity
+function _revokeOperator(
+ address operator,
+ address tokenOwner,
+ bytes32 tokenId,
+ bool notified,
+ bytes operatorNotificationData
+) internal nonpayable;
+```
+
+removes `operator` from the list of operators for the `tokenId`
+
+
+
+### \_clearOperators
+
+```solidity
+function _clearOperators(
+ address tokenOwner,
+ bytes32 tokenId
+) internal nonpayable;
+```
+
+revoke all the current operators for a specific `tokenId` token which belongs to `tokenOwner`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ------------------------------------------------- |
+| `tokenOwner` | `address` | The address that is the owner of the `tokenId`. |
+| `tokenId` | `bytes32` | The token to remove the associated operators for. |
+
+
+
+### \_exists
+
+```solidity
+function _exists(bytes32 tokenId) internal view returns (bool);
+```
+
+Returns whether `tokenId` exists.
+Tokens start existing when they are minted ([`_mint`](#_mint)), and stop existing when they are burned ([`_burn`](#_burn)).
+
+
+
+### \_existsOrError
+
+```solidity
+function _existsOrError(bytes32 tokenId) internal view;
+```
+
+When `tokenId` does not exist then revert with an error.
+
+
+
+### \_mint
+
+:::info
+
+Any logic in the:
+
+- [`_beforeTokenTransfer`](#_beforetokentransfer) function will run before updating the balances and ownership of `tokenId`s.
+
+- [`_afterTokenTransfer`](#_aftertokentransfer) function will run after updating the balances and ownership of `tokenId`s, **but before notifying the recipient via LSP1**.
+
+:::
+
+```solidity
+function _mint(
+ address to,
+ bytes32 tokenId,
+ bool force,
+ bytes data
+) internal nonpayable;
+```
+
+Create `tokenId` by minting it and transfers it to `to`.
+
+
+
+**Emitted events:**
+
+- [`Transfer`](#transfer) event with `address(0)` as `from` address.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | -------------------------------------------------------------------------------------------------------------------------- |
+| `to` | `address` | @param tokenId The token ID to create (= mint). |
+| `tokenId` | `bytes32` | The token ID to create (= mint). |
+| `force` | `bool` | When set to `true`, `to` may be any address. When set to `false`, `to` must be a contract that supports the LSP1 standard. |
+| `data` | `bytes` | Any additional data the caller wants included in the emitted event, and sent in the hook of the `to` address. |
+
+
+
+### \_burn
+
+:::info
+
+Any logic in the:
+
+- [`_beforeTokenTransfer`](#_beforetokentransfer) function will run before updating the balances and ownership of `tokenId`s.
+
+- [`_afterTokenTransfer`](#_aftertokentransfer) function will run after updating the balances and ownership of `tokenId`s, **but before notifying the sender via LSP1**.
+
+:::
+
+:::tip Hint
+
+In dApps, you can know which addresses are burning tokens by listening for the `Transfer` event and filter with the zero address as `to`.
+
+:::
+
+```solidity
+function _burn(bytes32 tokenId, bytes data) internal nonpayable;
+```
+
+Burn a specific `tokenId`, removing the `tokenId` from the [`tokenIdsOf`](#tokenidsof) the caller and decreasing its [`balanceOf`](#balanceof) by -1.
+This will also clear all the operators allowed to transfer the `tokenId`.
+The owner of the `tokenId` will be notified about the `tokenId` being transferred through its LSP1 [`universalReceiver`](#universalreceiver)
+function, if it is a contract that supports the LSP1 interface. Its [`universalReceiver`](#universalreceiver) function will receive
+all the parameters in the calldata packed encoded.
+
+
+
+**Emitted events:**
+
+- [`Transfer`](#transfer) event with `address(0)` as the `to` address.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | --------------------------------------------------------------------------------------------------------------------------- |
+| `tokenId` | `bytes32` | The token to burn. |
+| `data` | `bytes` | Any additional data the caller wants included in the emitted event, and sent in the LSP1 hook on the token owner's address. |
+
+
+
+### \_transfer
+
+:::info
+
+Any logic in the:
+
+- [`_beforeTokenTransfer`](#_beforetokentransfer) function will run before updating the balances and ownership of `tokenId`s.
+
+- [`_afterTokenTransfer`](#_aftertokentransfer) function will run after updating the balances and ownership of `tokenId`s, **but before notifying the sender/recipient via LSP1**.
+
+:::
+
+:::danger
+
+This internal function does not check if the sender is authorized or not to operate on the `tokenId`.
+
+:::
+
+```solidity
+function _transfer(
+ address from,
+ address to,
+ bytes32 tokenId,
+ bool force,
+ bytes data
+) internal nonpayable;
+```
+
+Change the owner of the `tokenId` from `from` to `to`.
+Both the sender and recipient will be notified of the `tokenId` being transferred through their LSP1 [`universalReceiver`](#universalreceiver)
+function, if they are contracts that support the LSP1 interface. Their `universalReceiver` function will receive
+all the parameters in the calldata packed encoded.
+
+
+
+**Emitted events:**
+
+- [`Transfer`](#transfer) event.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | -------------------------------------------------------------------------------------------------------------------------- |
+| `from` | `address` | The sender address. |
+| `to` | `address` | @param tokenId The token to transfer. |
+| `tokenId` | `bytes32` | The token to transfer. |
+| `force` | `bool` | When set to `true`, `to` may be any address. When set to `false`, `to` must be a contract that supports the LSP1 standard. |
+| `data` | `bytes` | Additional data the caller wants included in the emitted event, and sent in the hooks to `from` and `to` addresses. |
+
+
+
+### \_setDataForTokenId
+
+```solidity
+function _setDataForTokenId(
+ bytes32 tokenId,
+ bytes32 dataKey,
+ bytes dataValue
+) internal nonpayable;
+```
+
+Sets data for a specific `tokenId` and `dataKey` in the ERC725Y storage
+The ERC725Y data key is the hash of the `tokenId` and `dataKey` concatenated
+
+
+
+**Emitted events:**
+
+- [`TokenIdDataChanged`](#tokeniddatachanged) event.
+
+
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-------: | ---------------------------------------- |
+| `tokenId` | `bytes32` | The unique identifier for a token. |
+| `dataKey` | `bytes32` | The key for the data to set. |
+| `dataValue` | `bytes` | The value to set for the given data key. |
+
+
+
+### \_getDataForTokenId
+
+```solidity
+function _getDataForTokenId(
+ bytes32 tokenId,
+ bytes32 dataKey
+) internal view returns (bytes dataValues);
+```
+
+Retrieves data for a specific `tokenId` and `dataKey` from the ERC725Y storage
+The ERC725Y data key is the hash of the `tokenId` and `dataKey` concatenated
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ---------------------------------- |
+| `tokenId` | `bytes32` | The unique identifier for a token. |
+| `dataKey` | `bytes32` | The key for the data to retrieve. |
+
+#### Returns
+
+| Name | Type | Description |
+| ------------ | :-----: | ----------------------------------------------------------------- |
+| `dataValues` | `bytes` | The data value associated with the given `tokenId` and `dataKey`. |
+
+
+
+### \_beforeTokenTransfer
+
+```solidity
+function _beforeTokenTransfer(
+ address from,
+ address to,
+ bytes32 tokenId,
+ bytes data
+) internal nonpayable;
+```
+
+Hook that is called before any token transfer, including minting and burning.
+Allows to run custom logic before updating balances and notifiying sender/recipient by overriding this function.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | -------------------------------------- |
+| `from` | `address` | The sender address |
+| `to` | `address` | @param tokenId The tokenId to transfer |
+| `tokenId` | `bytes32` | The tokenId to transfer |
+| `data` | `bytes` | The data sent alongside the transfer |
+
+
+
+### \_afterTokenTransfer
+
+```solidity
+function _afterTokenTransfer(
+ address from,
+ address to,
+ bytes32 tokenId,
+ bytes data
+) internal nonpayable;
+```
+
+Hook that is called after any token transfer, including minting and burning.
+Allows to run custom logic after updating balances, but **before notifiying sender/recipient via LSP1** by overriding this function.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | -------------------------------------- |
+| `from` | `address` | The sender address |
+| `to` | `address` | @param tokenId The tokenId to transfer |
+| `tokenId` | `bytes32` | The tokenId to transfer |
+| `data` | `bytes` | The data sent alongside the transfer |
+
+
+
+### \_notifyTokenOperator
+
+```solidity
+function _notifyTokenOperator(
+ address operator,
+ bytes lsp1Data
+) internal nonpayable;
+```
+
+Attempt to notify the operator `operator` about the `tokenId` being authorized.
+This is done by calling its [`universalReceiver`](#universalreceiver) function with the `_TYPEID_LSP8_TOKENOPERATOR` as typeId, if `operator` is a contract that supports the LSP1 interface.
+If `operator` is an EOA or a contract that does not support the LSP1 interface, nothing will happen and no notification will be sent.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ------------------------------------------------------------------------------ |
+| `operator` | `address` | The address to call the [`universalReceiver`](#universalreceiver) function on. |
+| `lsp1Data` | `bytes` | the data to be sent to the `operator` address in the `universalReceiver` call. |
+
+
+
+### \_notifyTokenSender
+
+```solidity
+function _notifyTokenSender(address from, bytes lsp1Data) internal nonpayable;
+```
+
+Attempt to notify the token sender `from` about the `tokenId` being transferred.
+This is done by calling its [`universalReceiver`](#universalreceiver) function with the `_TYPEID_LSP8_TOKENSSENDER` as typeId, if `from` is a contract that supports the LSP1 interface.
+If `from` is an EOA or a contract that does not support the LSP1 interface, nothing will happen and no notification will be sent.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ------------------------------------------------------------------------------ |
+| `from` | `address` | The address to call the [`universalReceiver`](#universalreceiver) function on. |
+| `lsp1Data` | `bytes` | the data to be sent to the `from` address in the `universalReceiver` call. |
+
+
+
+### \_notifyTokenReceiver
+
+```solidity
+function _notifyTokenReceiver(
+ address to,
+ bool force,
+ bytes lsp1Data
+) internal nonpayable;
+```
+
+Attempt to notify the token receiver `to` about the `tokenId` being received.
+This is done by calling its [`universalReceiver`](#universalreceiver) function with the `_TYPEID_LSP8_TOKENSRECIPIENT` as typeId, if `to` is a contract that supports the LSP1 interface.
+If `to` is is an EOA or a contract that does not support the LSP1 interface, the behaviour will depend on the `force` boolean flag.
+
+- if `force` is set to `true`, nothing will happen and no notification will be sent.
+
+- if `force` is set to `false, the transaction will revert.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | --------------------------------------------------------------------------------------------------- |
+| `to` | `address` | The address to call the [`universalReceiver`](#universalreceiver) function on. |
+| `force` | `bool` | A boolean that describe if transfer to a `to` address that does not support LSP1 is allowed or not. |
+| `lsp1Data` | `bytes` | The data to be sent to the `to` address in the `universalReceiver(...)` call. |
+
+
+
+### \_supportsInterfaceInERC165Extension
+
+```solidity
+function _supportsInterfaceInERC165Extension(
+ bytes4 interfaceId
+) internal view returns (bool);
+```
+
+Returns whether the interfaceId being checked is supported in the extension of the
+[`supportsInterface`](#supportsinterface) selector.
+To be used by extendable contracts wishing to extend the ERC165 interfaceIds originally
+supported by reading whether the interfaceId queried is supported in the `supportsInterface`
+extension if the extension is set, if not it returns false.
+
+
+
+### \_getExtensionAndForwardValue
+
+```solidity
+function _getExtensionAndForwardValue(
+ bytes4 functionSelector
+) internal view returns (address, bool);
+```
+
+Returns the extension address stored under the following data key:
+
+- [`_LSP17_EXTENSION_PREFIX`](#_lsp17_extension_prefix) + `` (Check [LSP2-ERC725YJSONSchema] for encoding the data key).
+
+- If no extension is stored, returns the address(0).
+
+
+
+### \_fallbackLSP17Extendable
+
+:::info
+
+The LSP8 Token contract should not hold any native tokens. Any native tokens received by the contract
+will be forwarded to the extension address mapped to the selector from `msg.sig`.
+
+:::
+
+```solidity
+function _fallbackLSP17Extendable(
+ bytes callData
+) internal nonpayable returns (bytes);
+```
+
+Forwards the call with the received value to an extension mapped to a function selector.
+Calls [`_getExtensionAndForwardValue`](#_getextensionandforwardvalue) to get the address of the extension mapped to the function selector being
+called on the account. If there is no extension, the address(0) will be returned.
+We will always forward the value to the extension, as the LSP8 contract is not supposed to hold any native tokens.
+Reverts if there is no extension for the function being called.
+If there is an extension for the function selector being called, it calls the extension with the
+CALL opcode, passing the [`msg.data`](#msg.data) appended with the 20 bytes of the [`msg.sender`](#msg.sender) and
+32 bytes of the [`msg.value`](#msg.value)
+
+
+
+## Events
+
+### DataChanged
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#datachanged)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Event signature: `DataChanged(bytes32,bytes)`
+- Event topic hash: `0xece574603820d07bc9b91f2a932baadf4628aabcb8afba49776529c14a6104b2`
+
+:::
+
+```solidity
+event DataChanged(bytes32 indexed dataKey, bytes dataValue);
+```
+
+_The following data key/value pair has been changed in the ERC725Y storage: Data key: `dataKey`, data value: `dataValue`._
+
+Emitted when data at a specific `dataKey` was changed to a new value `dataValue`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------------- | :-------: | -------------------------------------------- |
+| `dataKey` **`indexed`** | `bytes32` | The data key for which a bytes value is set. |
+| `dataValue` | `bytes` | The value to set for the given data key. |
+
+
+
+### OperatorAuthorizationChanged
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#operatorauthorizationchanged)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Event signature: `OperatorAuthorizationChanged(address,address,bytes32,bytes)`
+- Event topic hash: `0x1b1b58aa2ec0cec2228b2d37124556d41f5a1f7b12f089171f896cc236671215`
+
+:::
+
+```solidity
+event OperatorAuthorizationChanged(
+ address indexed operator,
+ address indexed tokenOwner,
+ bytes32 indexed tokenId,
+ bytes operatorNotificationData
+);
+```
+
+Emitted when `tokenOwner` enables `operator` to transfer or burn the `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | -------------------------------------------------------------------- |
+| `operator` **`indexed`** | `address` | The address authorized as an operator. |
+| `tokenOwner` **`indexed`** | `address` | The owner of the `tokenId`. |
+| `tokenId` **`indexed`** | `bytes32` | The tokenId `operator` address has access on behalf of `tokenOwner`. |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### OperatorRevoked
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#operatorrevoked)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Event signature: `OperatorRevoked(address,address,bytes32,bool,bytes)`
+- Event topic hash: `0xc78cd419d6136f9f1c1c6aec1d3fae098cffaf8bc86314a8f2685e32fe574e3c`
+
+:::
+
+```solidity
+event OperatorRevoked(
+ address indexed operator,
+ address indexed tokenOwner,
+ bytes32 indexed tokenId,
+ bool notified,
+ bytes operatorNotificationData
+);
+```
+
+Emitted when `tokenOwner` disables `operator` to transfer or burn `tokenId` on its behalf.
+
+#### Parameters
+
+| Name | Type | Description |
+| -------------------------- | :-------: | ---------------------------------------------------------------------------------- |
+| `operator` **`indexed`** | `address` | The address revoked from the operator array ([`getOperatorsOf`](#getoperatorsof)). |
+| `tokenOwner` **`indexed`** | `address` | The owner of the `tokenId`. |
+| `tokenId` **`indexed`** | `bytes32` | The tokenId `operator` is revoked from operating on. |
+| `notified` | `bool` | Bool indicating whether the operator has been notified or not |
+| `operatorNotificationData` | `bytes` | The data to notify the operator about via LSP1. |
+
+
+
+### OwnershipTransferred
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#ownershiptransferred)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Event signature: `OwnershipTransferred(address,address)`
+- Event topic hash: `0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0`
+
+:::
+
+```solidity
+event OwnershipTransferred(
+ address indexed previousOwner,
+ address indexed newOwner
+);
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------------------- | :-------: | ----------- |
+| `previousOwner` **`indexed`** | `address` | - |
+| `newOwner` **`indexed`** | `address` | - |
+
+
+
+### TokenIdDataChanged
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#tokeniddatachanged)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Event signature: `TokenIdDataChanged(bytes32,bytes32,bytes)`
+- Event topic hash: `0xa6e4251f855f750545fe414f120db91c76b88def14d120969e5bb2d3f05debbb`
+
+:::
+
+```solidity
+event TokenIdDataChanged(
+ bytes32 indexed tokenId,
+ bytes32 indexed dataKey,
+ bytes dataValue
+);
+```
+
+Emitted when setting data for `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------------- | :-------: | -------------------------------------------- |
+| `tokenId` **`indexed`** | `bytes32` | The tokenId which data is set for. |
+| `dataKey` **`indexed`** | `bytes32` | The data key for which a bytes value is set. |
+| `dataValue` | `bytes` | The value to set for the given data key. |
+
+
+
+### Transfer
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#transfer)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Event signature: `Transfer(address,address,address,bytes32,bool,bytes)`
+- Event topic hash: `0xb333c813a7426a7a11e2b190cad52c44119421594b47f6f32ace6d8c7207b2bf`
+
+:::
+
+```solidity
+event Transfer(
+ address operator,
+ address indexed from,
+ address indexed to,
+ bytes32 indexed tokenId,
+ bool force,
+ bytes data
+);
+```
+
+Emitted when `tokenId` token is transferred from the `from` to the `to` address.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------------------- | :-------: | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `operator` | `address` | The address of operator that sent the `tokenId` |
+| `from` **`indexed`** | `address` | The previous owner of the `tokenId` |
+| `to` **`indexed`** | `address` | The new owner of `tokenId` |
+| `tokenId` **`indexed`** | `bytes32` | The tokenId that was transferred |
+| `force` | `bool` | If the token transfer enforces the `to` recipient address to be a contract that implements the LSP1 standard or not. |
+| `data` | `bytes` | Any additional data the caller included by the caller during the transfer, and sent in the hooks to the `from` and `to` addresses. |
+
+
+
+## Errors
+
+### ERC725Y_DataKeysValuesEmptyArray
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#erc725y_datakeysvaluesemptyarray)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `ERC725Y_DataKeysValuesEmptyArray()`
+- Error hash: `0x97da5f95`
+
+:::
+
+```solidity
+error ERC725Y_DataKeysValuesEmptyArray();
+```
+
+Reverts when one of the array parameter provided to [`setDataBatch`](#setdatabatch) function is an empty array.
+
+
+
+### ERC725Y_DataKeysValuesLengthMismatch
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#erc725y_datakeysvalueslengthmismatch)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `ERC725Y_DataKeysValuesLengthMismatch()`
+- Error hash: `0x3bcc8979`
+
+:::
+
+```solidity
+error ERC725Y_DataKeysValuesLengthMismatch();
+```
+
+Reverts when there is not the same number of elements in the `datakeys` and `dataValues` array parameters provided when calling the [`setDataBatch`](#setdatabatch) function.
+
+
+
+### ERC725Y_MsgValueDisallowed
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#erc725y_msgvaluedisallowed)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `ERC725Y_MsgValueDisallowed()`
+- Error hash: `0xf36ba737`
+
+:::
+
+```solidity
+error ERC725Y_MsgValueDisallowed();
+```
+
+Reverts when sending value to the [`setData`](#setdata) or [`setDataBatch`](#setdatabatch) function.
+
+
+
+### InvalidExtensionAddress
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#invalidextensionaddress)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `InvalidExtensionAddress(bytes)`
+- Error hash: `0x42bfe79f`
+
+:::
+
+```solidity
+error InvalidExtensionAddress(bytes storedData);
+```
+
+reverts when the bytes retrieved from the LSP17 data key is not a valid address (not 20 bytes)
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-----: | ----------- |
+| `storedData` | `bytes` | - |
+
+
+
+### InvalidFunctionSelector
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#invalidfunctionselector)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `InvalidFunctionSelector(bytes)`
+- Error hash: `0xe5099ee3`
+
+:::
+
+```solidity
+error InvalidFunctionSelector(bytes data);
+```
+
+reverts when the contract is called with a function selector not valid (less than 4 bytes of data)
+
+#### Parameters
+
+| Name | Type | Description |
+| ------ | :-----: | ----------- |
+| `data` | `bytes` | - |
+
+
+
+### LSP4TokenNameNotEditable
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp4tokennamenoteditable)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP4TokenNameNotEditable()`
+- Error hash: `0x85c169bd`
+
+:::
+
+```solidity
+error LSP4TokenNameNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP4TokenName` after the digital asset contract has been deployed / initialized. The `LSP4TokenName` data key is located inside the ERC725Y data key-value store of the digital asset contract. It can be set only once inside the constructor/initializer when the digital asset contract is being deployed / initialized.
+
+
+
+### LSP4TokenSymbolNotEditable
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp4tokensymbolnoteditable)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP4TokenSymbolNotEditable()`
+- Error hash: `0x76755b38`
+
+:::
+
+```solidity
+error LSP4TokenSymbolNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP4TokenSymbol` after the digital asset contract has been deployed / initialized. The `LSP4TokenSymbol` data key is located inside the ERC725Y data key-value store of the digital asset contract. It can be set only once inside the constructor/initializer when the digital asset contract is being deployed / initialized.
+
+
+
+### LSP4TokenTypeNotEditable
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp4tokentypenoteditable)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP4TokenTypeNotEditable()`
+- Error hash: `0x4ef6d7fb`
+
+:::
+
+```solidity
+error LSP4TokenTypeNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP4TokenType` after the digital asset contract has been deployed / initialized. The `LSP4TokenType` data key is located inside the ERC725Y data key-value store of the digital asset contract. It can be set only once inside the constructor / initializer when the digital asset contract is being deployed / initialized.
+
+
+
+### LSP8BatchCallFailed
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8batchcallfailed)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8BatchCallFailed(uint256)`
+- Error hash: `0x234eb819`
+
+:::
+
+```solidity
+error LSP8BatchCallFailed(uint256 callIndex);
+```
+
+_Batch call failed._
+
+Reverts when a batch call failed.
+
+#### Parameters
+
+| Name | Type | Description |
+| ----------- | :-------: | ----------- |
+| `callIndex` | `uint256` | - |
+
+
+
+### LSP8CannotSendToAddressZero
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8cannotsendtoaddresszero)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8CannotSendToAddressZero()`
+- Error hash: `0x24ecef4d`
+
+:::
+
+```solidity
+error LSP8CannotSendToAddressZero();
+```
+
+Reverts when trying to send token to the zero address.
+
+
+
+### LSP8CannotSendToSelf
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8cannotsendtoself)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8CannotSendToSelf()`
+- Error hash: `0x5d67d6c1`
+
+:::
+
+```solidity
+error LSP8CannotSendToSelf();
+```
+
+Reverts when specifying the same address for `from` and `to` in a token transfer.
+
+
+
+### LSP8CannotUseAddressZeroAsOperator
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8cannotuseaddresszeroasoperator)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8CannotUseAddressZeroAsOperator()`
+- Error hash: `0x9577b8b3`
+
+:::
+
+```solidity
+error LSP8CannotUseAddressZeroAsOperator();
+```
+
+Reverts when trying to set the zero address as an operator.
+
+
+
+### LSP8InvalidTransferBatch
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8invalidtransferbatch)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8InvalidTransferBatch()`
+- Error hash: `0x93a83119`
+
+:::
+
+```solidity
+error LSP8InvalidTransferBatch();
+```
+
+Reverts when the parameters used for `transferBatch` have different lengths.
+
+
+
+### LSP8NonExistentTokenId
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8nonexistenttokenid)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8NonExistentTokenId(bytes32)`
+- Error hash: `0xae8f9a36`
+
+:::
+
+```solidity
+error LSP8NonExistentTokenId(bytes32 tokenId);
+```
+
+Reverts when `tokenId` has not been minted.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ----------- |
+| `tokenId` | `bytes32` | - |
+
+
+
+### LSP8NonExistingOperator
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8nonexistingoperator)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8NonExistingOperator(address,bytes32)`
+- Error hash: `0x4aa31a8c`
+
+:::
+
+```solidity
+error LSP8NonExistingOperator(address operator, bytes32 tokenId);
+```
+
+Reverts when `operator` is not an operator for the `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ----------- |
+| `operator` | `address` | - |
+| `tokenId` | `bytes32` | - |
+
+
+
+### LSP8NotTokenOperator
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8nottokenoperator)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8NotTokenOperator(bytes32,address)`
+- Error hash: `0x1294d2a9`
+
+:::
+
+```solidity
+error LSP8NotTokenOperator(bytes32 tokenId, address caller);
+```
+
+Reverts when `caller` is not an allowed operator for `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ----------- |
+| `tokenId` | `bytes32` | - |
+| `caller` | `address` | - |
+
+
+
+### LSP8NotTokenOwner
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8nottokenowner)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8NotTokenOwner(address,bytes32,address)`
+- Error hash: `0x5b271ea2`
+
+:::
+
+```solidity
+error LSP8NotTokenOwner(address tokenOwner, bytes32 tokenId, address caller);
+```
+
+Reverts when `caller` is not the `tokenOwner` of the `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------ | :-------: | ----------- |
+| `tokenOwner` | `address` | - |
+| `tokenId` | `bytes32` | - |
+| `caller` | `address` | - |
+
+
+
+### LSP8NotifyTokenReceiverContractMissingLSP1Interface
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8notifytokenreceivercontractmissinglsp1interface)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8NotifyTokenReceiverContractMissingLSP1Interface(address)`
+- Error hash: `0x4349776d`
+
+:::
+
+```solidity
+error LSP8NotifyTokenReceiverContractMissingLSP1Interface(
+ address tokenReceiver
+);
+```
+
+Reverts if the `tokenReceiver` does not implement LSP1 when minting or transferring tokens with `bool force` set as `false`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ----------- |
+| `tokenReceiver` | `address` | - |
+
+
+
+### LSP8NotifyTokenReceiverIsEOA
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8notifytokenreceiveriseoa)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8NotifyTokenReceiverIsEOA(address)`
+- Error hash: `0x03173137`
+
+:::
+
+```solidity
+error LSP8NotifyTokenReceiverIsEOA(address tokenReceiver);
+```
+
+Reverts if the `tokenReceiver` is an EOA when minting or transferring tokens with `bool force` set as `false`.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ----------- |
+| `tokenReceiver` | `address` | - |
+
+
+
+### LSP8OperatorAlreadyAuthorized
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8operatoralreadyauthorized)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8OperatorAlreadyAuthorized(address,bytes32)`
+- Error hash: `0xa7626b68`
+
+:::
+
+```solidity
+error LSP8OperatorAlreadyAuthorized(address operator, bytes32 tokenId);
+```
+
+Reverts when `operator` is already authorized for the `tokenId`.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ----------- |
+| `operator` | `address` | - |
+| `tokenId` | `bytes32` | - |
+
+
+
+### LSP8TokenContractCannotHoldValue
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokencontractcannotholdvalue)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenContractCannotHoldValue()`
+- Error hash: `0x61f49442`
+
+:::
+
+```solidity
+error LSP8TokenContractCannotHoldValue();
+```
+
+_LSP8 contract cannot receive native tokens._
+
+Error occurs when sending native tokens to the LSP8 contract without sending any data. E.g. Sending value without passing a bytes4 function selector to call a LSP17 Extension.
+
+
+
+### LSP8TokenIdAlreadyMinted
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokenidalreadyminted)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenIdAlreadyMinted(bytes32)`
+- Error hash: `0x34c7b511`
+
+:::
+
+```solidity
+error LSP8TokenIdAlreadyMinted(bytes32 tokenId);
+```
+
+Reverts when `tokenId` has already been minted.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------- | :-------: | ----------- |
+| `tokenId` | `bytes32` | - |
+
+
+
+### LSP8TokenIdFormatNotEditable
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokenidformatnoteditable)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenIdFormatNotEditable()`
+- Error hash: `0x3664800a`
+
+:::
+
+```solidity
+error LSP8TokenIdFormatNotEditable();
+```
+
+Reverts when trying to edit the data key `LSP8TokenIdFormat` after the identifiable digital asset contract has been deployed. The `LSP8TokenIdFormat` data key is located inside the ERC725Y Data key-value store of the identifiable digital asset contract. It can be set only once inside the constructor/initializer when the identifiable digital asset contract is being deployed.
+
+
+
+### LSP8TokenIdsDataEmptyArray
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokenidsdataemptyarray)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenIdsDataEmptyArray()`
+- Error hash: `0x80c98305`
+
+:::
+
+```solidity
+error LSP8TokenIdsDataEmptyArray();
+```
+
+Reverts when empty arrays is passed to the function
+
+
+
+### LSP8TokenIdsDataLengthMismatch
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokenidsdatalengthmismatch)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenIdsDataLengthMismatch()`
+- Error hash: `0x2fa71dfe`
+
+:::
+
+```solidity
+error LSP8TokenIdsDataLengthMismatch();
+```
+
+Reverts when the length of the token IDs data arrays is not equal
+
+
+
+### LSP8TokenOwnerCannotBeOperator
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokenownercannotbeoperator)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenOwnerCannotBeOperator()`
+- Error hash: `0x89fdad62`
+
+:::
+
+```solidity
+error LSP8TokenOwnerCannotBeOperator();
+```
+
+Reverts when trying to authorize or revoke the token's owner as an operator.
+
+
+
+### LSP8TokenOwnerChanged
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#lsp8tokenownerchanged)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `LSP8TokenOwnerChanged(bytes32,address,address)`
+- Error hash: `0x5a9c31d3`
+
+:::
+
+```solidity
+error LSP8TokenOwnerChanged(
+ bytes32 tokenId,
+ address oldOwner,
+ address newOwner
+);
+```
+
+Reverts when the token owner changed inside the [`_beforeTokenTransfer`](#_beforetokentransfer) hook.
+
+#### Parameters
+
+| Name | Type | Description |
+| ---------- | :-------: | ----------- |
+| `tokenId` | `bytes32` | - |
+| `oldOwner` | `address` | - |
+| `newOwner` | `address` | - |
+
+
+
+### NoExtensionFoundForFunctionSelector
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#noextensionfoundforfunctionselector)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `NoExtensionFoundForFunctionSelector(bytes4)`
+- Error hash: `0xbb370b2b`
+
+:::
+
+```solidity
+error NoExtensionFoundForFunctionSelector(bytes4 functionSelector);
+```
+
+reverts when there is no extension for the function selector being called with
+
+#### Parameters
+
+| Name | Type | Description |
+| ------------------ | :------: | ----------- |
+| `functionSelector` | `bytes4` | - |
+
+
+
+### OwnableCallerNotTheOwner
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#ownablecallernottheowner)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `OwnableCallerNotTheOwner(address)`
+- Error hash: `0xbf1169c5`
+
+:::
+
+```solidity
+error OwnableCallerNotTheOwner(address callerAddress);
+```
+
+Reverts when only the owner is allowed to call the function.
+
+#### Parameters
+
+| Name | Type | Description |
+| --------------- | :-------: | ---------------------------------------- |
+| `callerAddress` | `address` | The address that tried to make the call. |
+
+
+
+### OwnableCannotSetZeroAddressAsOwner
+
+:::note References
+
+- Specification details: [**LSP-8-IdentifiableDigitalAsset**](https://github.com/lukso-network/LIPs/blob/main/LSPs/LSP-8-IdentifiableDigitalAsset.md#ownablecannotsetzeroaddressasowner)
+- Solidity implementation: [`LSP8Mintable.sol`](https://github.com/lukso-network/lsp-smart-contracts/blob/develop/@lukso/lsp8-contracts/contracts/presets/LSP8Mintable.sol)
+- Error signature: `OwnableCannotSetZeroAddressAsOwner()`
+- Error hash: `0x1ad8836c`
+
+:::
+
+```solidity
+error OwnableCannotSetZeroAddressAsOwner();
+```
+
+Reverts when trying to set `address(0)` as the contract owner when deploying the contract, initializing it or transferring ownership of the contract.
+
+
diff --git a/dodoc/config.ts b/dodoc/config.ts
index b6664f507..bc3f31bac 100644
--- a/dodoc/config.ts
+++ b/dodoc/config.ts
@@ -201,6 +201,10 @@ const specs = {
specsName: 'LSP-20-CallVerification',
specsLink: `${SPECS_BASE_URI}/LSP-20-CallVerification.md`,
},
+ LSP23LinkedContractsFactory: {
+ specsName: 'LSP-23-LinkedContractsFactory',
+ specsLink: `${SPECS_BASE_URI}/LSP-23-LinkedContractsFactory.md`,
+ },
LSP25ExecuteRelayCall: {
specsName: 'LSP-25-ExecuteRelayCall',
specsLink: `${SPECS_BASE_URI}/LSP-25-ExecuteRelayCall.md`,
@@ -404,8 +408,12 @@ const generateContractSpecsDetails = (contractName: string) => {
return specs['LSP10ReceivedVaults'];
} else if (lspN && lspN[0] === 'LSP17') {
return specs['LSP17ContractExtension'];
+ } else if (lspN && lspN[0] === 'LSP23') {
+ return specs['LSP23LinkedContractsFactory'];
} else if (lspN && lspN[0] === 'LSP25') {
return specs['LSP25ExecuteRelayCall'];
+ } else if (contractName === 'IPostDeploymentModule') {
+ return specs['LSP23LinkedContractsFactory'];
} else {
console.error(`Specs for '${contractName}' not found.`);
}
diff --git a/packages/lsp23-contracts/hardhat.config.ts b/packages/lsp23-contracts/hardhat.config.ts
index d818a205d..8de2a6bcc 100644
--- a/packages/lsp23-contracts/hardhat.config.ts
+++ b/packages/lsp23-contracts/hardhat.config.ts
@@ -107,7 +107,7 @@ const config: HardhatUserConfig = {
},
packager: {
// What contracts to keep the artifacts and the bindings for.
- contracts: [],
+ contracts: ['IPostDeploymentModule'],
// Whether to include the TypeChain factories or not.
// If this is enabled, you need to run the TypeChain files through the TypeScript compiler before shipping to the registry.
includeFactories: true,