ERC-5050: 具有模块化环境的交互式 NFT

pragma solidity ^0.8.0;

/// @param _address 交互对象的地址
/// @param tokenId 正在交互的代币（可选）
struct Object {
    address _address;
    uint256 _tokenId;
}

/// @param selector 操作字符串的 bytes4(keccack256()) 编码
/// @param user 发送者的地址
/// @param from 启动对象
/// @param to 接收对象
/// @param state 状态控制器合约
/// @param data 没有指定格式的额外数据
struct Action {
    bytes4 selector;
    address user;
    Object from;
    Object to;
    address state;
    bytes data;
}

/// @title EIP-5050 具有模块化环境的交互式 NFT
interface IERC5050Sender {
    /// @notice 向目标地址发送操作
    /// @dev 操作的 `fromContract` 自动设置为 `address(this)`，
    /// 并且 `from` 参数设置为 `msg.sender`。
    /// @param action 要发送的操作
    function sendAction(Action memory action) external payable;

    /// @notice 根据操作的哈希和 nonce 检查操作是否有效
    /// @dev 当操作通过所有三个可能的合约时
    /// (`fromContract`、`to` 和 `state`)，`state` 合约使用基于 nonce 的操作哈希
    /// 通过启动 `fromContract` 来验证操作。
    /// 此哈希在启动操作处理之前，计算后保存到 `fromContract` 上的存储中。
    /// `state` 合约计算哈希并验证该哈希和 `fromContract` 的 nonce。
    /// @param _hash 要验证的哈希
    /// @param _nonce 要验证的 nonce
    function isValid(bytes32 _hash, uint256 _nonce) external returns (bool);

    /// @notice 检索可以发送的操作列表。
    /// @dev 供链下应用程序使用，以查询兼容的合约，
    /// 并以人类可读的形式宣传功能。
    function sendableActions() external view returns (string[] memory);

    /// @notice 更改或重申操作的批准地址
    /// @dev 零地址表示没有批准的地址。
    ///  除非 `msg.sender` 是 `_account`，或者是 `_account` 的授权
    ///  运营者，否则会抛出异常
    /// @param _account 要批准的帐户操作对的帐户
    /// @param _action 要批准的帐户操作对的操作
    /// @param _approved 新批准的帐户操作控制器
    function approveForAction(
        address _account,
        bytes4 _action,
        address _approved
    ) external returns (bool);

    /// @notice 启用或禁用第三方（“运营者”）代表 `msg.sender` 执行
    ///  所有操作的批准
    /// @dev 发出 ApprovalForAll 事件。合约必须允许
    ///  每个所有者有无限数量的运营者。
    /// @param _operator 要添加到授权运营者集合的地址
    /// @param _approved 如果运营者已批准则为 True，如果撤销批准则为 false
    function setApprovalForAllActions(address _operator, bool _approved)
        external;

    /// @notice 获取帐户操作对的批准地址
    /// @dev 如果 `_tokenId` 不是有效的 NFT，则会抛出异常。
    /// @param _account 要查找批准地址的帐户操作的帐户
    /// @param _action 要查找批准地址的帐户操作的操作
    /// @return 此帐户操作的批准地址，如果没有，则为零地址
    function getApprovedForAction(address _account, bytes4 _action)
        external
        view
        returns (address);

    /// @notice 查询地址是否是另一个地址的授权运营者
    /// @param _account 代表其执行操作的地址
    /// @param _operator 代表帐户执行操作的地址
    /// @return 如果 `_operator` 是 `_account` 的批准运营者，则为 True，否则为 false
    function isApprovedForAllActions(address _account, address _operator)
        external
        view
        returns (bool);

    /// @dev 当发送操作时，会发出此事件 (`sendAction()`)
    event SendAction(
        bytes4 indexed name,
        address _from,
        address indexed _fromContract,
        uint256 _tokenId,
        address indexed _to,
        uint256 _toTokenId,
        address _state,
        bytes _data
    );

    /// @dev 当帐户操作对的批准地址
    ///  被更改或重申时，会发出此事件。零地址表示没有
    ///  批准的地址。
    event ApprovalForAction(
        address indexed _account,
        bytes4 indexed _action,
        address indexed _approved
    );

    /// @dev 当为帐户启用或禁用运营者时，会发出此事件。
    ///  运营者可以代表帐户执行所有操作。
    event ApprovalForAllActions(
        address indexed _account,
        address indexed _operator,
        bool _approved
    );
}

interface IERC5050Receiver {
    /// @notice 处理操作
    /// @dev `to` 合约和 `state` 合约都通过
    /// `onActionReceived()` 调用。
    /// @param action 要处理的操作
    function onActionReceived(Action calldata action, uint256 _nonce)
        external
        payable;

    /// @notice 检索可以接收的操作列表。
    /// @dev 供链下应用程序使用，以查询兼容的合约，
    /// 并以人类可读的形式宣传功能。
    function receivableActions() external view returns (string[] memory);

    /// @dev 当收到有效操作时，会发出此事件。
    event ActionReceived(
        bytes4 indexed name,
        address _from,
        address indexed _fromContract,
        uint256 _tokenId,
        address indexed _to,
        uint256 _toTokenId,
        address _state,
        bytes _data
    );
}

pragma solidity ^0.8.0;

/// @title EIP-5050 具有模块化环境的交互式 NFT
interface IERC5050Interactive {
    function interfaceURI(bytes4 _action) external view returns (string);
}

pragma solidity ^0.8.0;

/// @title EIP-5050 操作控制器
interface IControllable {
    
    /// @notice 启用或禁用第三方（“控制器”）的批准，以强制
    ///  处理给定操作，而不执行 EIP-5050 有效性检查。
    /// @dev 发出 ControllerApproval 事件。合约必须允许
    ///  每个操作有无限数量的控制器。
    /// @param _controller 要添加到授权控制器集合的地址
    /// @param _action 要为其批准/不批准控制器的操作的选择器
    /// @param _approved 如果批准了控制器，则为 True，如果撤消批准，则为 false
    function setControllerApproval(address _controller, bytes4 _action, bool _approved)
        external;

    /// @notice 启用或禁用第三方（“控制器”）的批准，以强制
    ///  操作处理，而不执行 EIP-5050 有效性检查。 
    /// @dev 发出 ControllerApproval 事件。合约必须允许
    ///  每个操作有无限数量的控制器。
    /// @param _controller 要添加到授权控制器集合的地址
    /// @param _approved 如果批准了控制器，则为 True，如果撤消批准，则为 false
    function setControllerApprovalForAll(address _controller, bool _approved)
        external;

    /// @notice 查询地址是否是给定操作的授权控制器。
    /// @param _controller 可以强制操作处理的受信任第三方地址
    /// @param _action 要查询的操作选择器
    /// @return 如果 `_controller` 是 `_account` 的批准运营者，则为 True，否则为 false
    function isApprovedController(address _controller, bytes4 _action)
        external
        view
        returns (bool);
    
    /// @dev 当为给定
    ///  操作启用或禁用控制器时，会发出此事件。控制器可以强制在发出事件的合约上进行 `action` 处理，
    ///  绕过标准的 EIP-5050 有效性检查。
    event ControllerApproval(
        address indexed _controller,
        bytes4 indexed _action,
        bool _approved
    );
    
    /// @dev 当为所有操作启用或禁用控制器时，会发出此事件。
    ///  禁用控制器的所有操作批准不会覆盖显式操作
    ///  操作批准。针对所有操作批准的控制器可以强制对发出事件的合约进行任何操作的操作处理。
    event ControllerApprovalForAll(
        address indexed _controller,
        bool _approved
    );
}