Updates token holder extension to match erc-7590.

Author: steven2308

contracts/RMRK/extension/tokenHolder/IERC7590.sol

@@ -0,0 +1,89 @@
+// SPDX-License-Identifier: Apache-2.0
+
+pragma solidity ^0.8.21;
+
+import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+interface IERC7590 is IERC165 {
+    /**
+     * @notice Used to notify listeners that the token received ERC-20 tokens.
+     * @param erc20Contract The address of the ERC-20 smart contract
+     * @param toTokenId The ID of the token receiving the ERC-20 tokens
+     * @param from The address of the account from which the tokens are being transferred
+     * @param amount The number of ERC-20 tokens received
+     */
+    event ReceivedERC20(
+        address indexed erc20Contract,
+        uint256 indexed toTokenId,
+        address indexed from,
+        uint256 amount
+    );
+
+    /**
+     * @notice Used to notify the listeners that the ERC-20 tokens have been transferred.
+     * @param erc20Contract The address of the ERC-20 smart contract
+     * @param fromTokenId The ID of the token from which the ERC-20 tokens have been transferred
+     * @param to The address receiving the ERC-20 tokens
+     * @param amount The number of ERC-20 tokens transferred
+     */
+    event TransferredERC20(
+        address indexed erc20Contract,
+        uint256 indexed fromTokenId,
+        address indexed to,
+        uint256 amount
+    );
+
+    /**
+     * @notice Used to retrieve the given token's specific ERC-20 balance
+     * @param erc20Contract The address of the ERC-20 smart contract
+     * @param tokenId The ID of the token being checked for ERC-20 balance
+     * @return The amount of the specified ERC-20 tokens owned by a given token
+     */
+    function balanceOfERC20(
+        address erc20Contract,
+        uint256 tokenId
+    ) external view returns (uint256);
+
+    /**
+     * @notice Transfer ERC-20 tokens from a specific token.
+     * @dev The balance MUST be transferred from this smart contract.
+     * @dev Implementers should validate that the `msg.sender` is either the token owner or approved to manage it before calling this.
+     * @dev Must increase the transfer-out-nonce for the tokenId
+     * @param erc20Contract The address of the ERC-20 smart contract
+     * @param tokenId The ID of the token to transfer the ERC-20 tokens from
+     * @param amount The number of ERC-20 tokens to transfer
+     * @param data Additional data with no specified format, to allow for custom logic
+     */
+    function transferHeldERC20FromToken(
+        address erc20Contract,
+        uint256 tokenId,
+        address to,
+        uint256 amount,
+        bytes memory data
+    ) external;
+
+    /**
+     * @notice Transfer ERC-20 tokens to a specific token.
+     * @dev The ERC-20 smart contract must have approval for this contract to transfer the ERC-20 tokens.
+     * @dev The balance MUST be transferred from the `msg.sender`.
+     * @param erc20Contract The address of the ERC-20 smart contract
+     * @param tokenId The ID of the token to transfer ERC-20 tokens to
+     * @param amount The number of ERC-20 tokens to transfer
+     * @param data Additional data with no specified format, to allow for custom logic
+     */
+    function transferERC20ToToken(
+        address erc20Contract,
+        uint256 tokenId,
+        uint256 amount,
+        bytes memory data
+    ) external;
+
+    /**
+     * @notice Nonce increased every time an ERC20 token is transferred out of a token
+     * @param tokenId The ID of the token to check the nonce for
+     * @return The nonce of the token
+     */
+    function erc20TransferOutNonce(
+        uint256 tokenId
+    ) external view returns (uint256);
+}