forked from DecentralizedClimateFoundation/DCIPs
73 lines
3.6 KiB
Solidity
73 lines
3.6 KiB
Solidity
// SPDX-License-Identifier: CC0-1.0
|
|
pragma solidity ^0.8.16;
|
|
|
|
import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
|
|
|
|
import {IERC721BinderErrors} from "./IERC721BinderErrors.sol";
|
|
|
|
/// @dev Note: the ERC-165 identifier for this interface is 0x2ac2d2bc.
|
|
interface IERC721Binder is IERC165, IERC721BinderErrors {
|
|
|
|
/// @notice Handles the binding of an IERC721Bindable-compliant NFT.
|
|
/// @dev An IERC721Bindable-compliant smart contract MUST call this function
|
|
/// at the end of a `bind` after delegating ownership to the asset owner.
|
|
/// The function MUST revert if `to` is not the asset owner of `bindId` or
|
|
/// if asset `bindId` is not a valid asset. The function MUST revert if it
|
|
/// rejects the bind. If accepting the bind, the function MUST return
|
|
/// `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
|
|
/// Caller MUST revert the transaction if the above value is not returned.
|
|
/// Note: The contract address of the binding NFT is `msg.sender`.
|
|
/// @param operator The address responsible for initiating the bind.
|
|
/// @param from The address which owns the unbound NFT.
|
|
/// @param to The address which owns the asset being bound to.
|
|
/// @param tokenId The identifier of the NFT being bound.
|
|
/// @param bindId The identifier of the asset being bound to.
|
|
/// @param data Additional data sent along with no specified format.
|
|
/// @return `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
|
|
function onERC721Bind(
|
|
address operator,
|
|
address from,
|
|
address to,
|
|
uint256 tokenId,
|
|
uint256 bindId,
|
|
bytes calldata data
|
|
) external returns (bytes4);
|
|
|
|
/// @notice Handles the unbinding of an IERC721Bindable-compliant NFT.
|
|
/// @dev An IERC721Bindable-compliant smart contract MUST call this function
|
|
/// at the end of an `unbind` after revoking delegated asset ownership.
|
|
/// The function MUST revert if `from` is not the asset owner of `bindId`
|
|
/// or if `bindId` is not a valid asset. The function MUST revert if it
|
|
/// rejects the unbind. If accepting the unbind, the function MUST return
|
|
/// `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
|
|
/// Caller MUST revert the transaction if the above value is not returned.
|
|
/// Note: The contract address of the unbinding NFT is `msg.sender`.
|
|
/// @param from The address which owns the asset the NFT is bound to.
|
|
/// @param to The address which will own the NFT once unbound.
|
|
/// @param tokenId The identifier of the NFT being unbound.
|
|
/// @param bindId The identifier of the asset being unbound from.
|
|
/// @param data Additional data with no specified format.
|
|
/// @return `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
|
|
function onERC721Unbind(
|
|
address operator,
|
|
address from,
|
|
address to,
|
|
uint256 tokenId,
|
|
uint256 bindId,
|
|
bytes calldata data
|
|
) external returns (bytes4);
|
|
|
|
/// @notice Gets the owner address of the asset represented by id `bindId`.
|
|
/// @dev Queries for assets assigned to the zero address MUST throw.
|
|
/// @param bindId The identifier of the asset whose owner is being queried.
|
|
/// @return The address of the owner of the asset.
|
|
function ownerOf(uint256 bindId) external view returns (address);
|
|
|
|
/// @notice Checks if an operator can act on behalf of an asset owner.
|
|
/// @param owner The address that owns an asset.
|
|
/// @param operator The address that acts on behalf of owner `owner`.
|
|
/// @return True if `operator` can act on behalf of `owner`, else False.
|
|
function isApprovedForAll(address owner, address operator) external view returns (bool);
|
|
|
|
}
|