ERC-7603: ERC-1155 多资产扩展

/// @title ERC-7603 上下文相关的多资产 Token，ERC-1155 执行
/// @dev 请参阅 https://eips.ethereum.org/EIPS/erc-7603

pragma solidity ^0.8.23;

interface IERC7603 /* is ERC165 */ {
    /**
     * @notice 用于通知监听器，资产对象已在 `assetId` 处初始化。
     * @param assetId 已初始化的资产的 ID
     */
    event AssetSet(uint64 assetId);

    /**
     * @notice 用于通知监听器，`assetId` 处的资产对象已添加到 Token 的资产数组中。
     * @param tokenId 接收新资产的 Token 的 ID
     * @param assetId 已添加到 Token 资产数组中的资产的 ID
     * @param replacesId 将被替换的资产的 ID
     */
    event AssetAddedToToken(
        uint256[] tokenId,
        uint64 indexed assetId,
        uint64 indexed replacesId
    );

    /**
     * @notice 用于通知监听器，Token 的优先级数组已重新排序。
     * @param tokenId 更新了资产优先级数组的 Token 的 ID
     */
    event AssetPrioritySet(uint256 indexed tokenId);

    /**
     * @notice 为给定的 Token 设置一个新的优先级数组。
     * @dev 优先级数组是一个非顺序的 `uint16` 列表，其中最低的值被认为是最高的优先级。
     * @dev 优先级 `0` 的值是一种特殊情况，等同于未初始化。
     * @dev 要求：
     *
     *  - `tokenId` 必须存在。
     *  - `priorities` 的长度必须等于资产数组的长度。
     * @dev 发出 {AssetPrioritySet} 事件。
     * @param tokenId 用于设置优先级的 Token 的 ID
     * @param priorities 资产的优先级数组。 priorities 数组中项目的顺序与数组中项目的顺序匹配
     *  数组中的项目顺序相匹配。
     */
    function setPriority(uint256 tokenId, uint64[] calldata priorities)
        external;

    /**
     * @notice 用于检索给定 Token 的资产的 ID。
     * @dev 资产数据通过引用存储，为了访问与 ID 对应的数据，调用
     *  `getAssetMetadata(tokenId, assetId)`。
     * @dev 您可以安全地获得 1 万个
     * @param tokenId 用于检索资产 ID 的 Token 的 ID
     * @return uint64[] 给定 Token 的资产 ID 数组
     */
    function getAssets(uint256 tokenId)
        external
        view
        returns (uint64[] memory);

    /**
     * @notice 用于检索给定 Token 资产的优先级。
     * @dev 资产优先级是一个非顺序的 uint16 值数组，其数组大小等于资产优先级。
     * @param tokenId 用于检索资产优先级的 Token 的 ID
     * @return uint16[] 给定 Token 资产的优先级数组
     */
    function getAssetPriorities(uint256 tokenId)
        external
        view
        returns (uint64[] memory);

    /**
     * @notice 用于获取指定 Token 的资产在给定索引处的资产元数据。
     * @dev 可以被覆盖以实现枚举、回退或其他自定义逻辑。
     * @param tokenId 从中检索资产元数据的 Token 的 ID
     * @param assetId 资产 ID，必须在资产数组中
     * @return string 属于 Token 资产数组中指定索引的资产的元数据
     */
    function getAssetMetadata(uint256 tokenId, uint64 assetId)
        external
        view
        returns (string memory);
}