|
|
|
@ -6,48 +6,119 @@ import "../../introspection/IERC165.sol"; |
|
|
|
|
* @dev Required interface of an ERC721 compliant contract. |
|
|
|
|
*/ |
|
|
|
|
interface IERC721 is IERC165 { |
|
|
|
|
/** |
|
|
|
|
* @dev Emitted when `tokenId` token is transfered from `from` to `to`. |
|
|
|
|
*/ |
|
|
|
|
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. |
|
|
|
|
*/ |
|
|
|
|
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets. |
|
|
|
|
*/ |
|
|
|
|
event ApprovalForAll(address indexed owner, address indexed operator, bool approved); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Returns the number of NFTs in ``owner``'s account. |
|
|
|
|
* @dev Returns the number of tokens in ``owner``'s account. |
|
|
|
|
*/ |
|
|
|
|
function balanceOf(address owner) external view returns (uint256 balance); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Returns the owner of the NFT specified by `tokenId`. |
|
|
|
|
* @dev Returns the owner of the `tokenId` token. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* |
|
|
|
|
* - `tokenId` must exist. |
|
|
|
|
*/ |
|
|
|
|
function ownerOf(uint256 tokenId) external view returns (address owner); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to |
|
|
|
|
* another (`to`). |
|
|
|
|
* |
|
|
|
|
* |
|
|
|
|
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients |
|
|
|
|
* are aware of the ERC721 protocol to prevent tokens from being forever locked. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* |
|
|
|
|
* - `from`, `to` cannot be zero. |
|
|
|
|
* - `tokenId` must be owned by `from`. |
|
|
|
|
* - If the caller is not `from`, it must be have been allowed to move this |
|
|
|
|
* NFT by either {approve} or {setApprovalForAll}. |
|
|
|
|
* - `tokenId` token must exist and be owned by `from`. |
|
|
|
|
* - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}. |
|
|
|
|
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. |
|
|
|
|
* |
|
|
|
|
* Emits a {Transfer} event. |
|
|
|
|
*/ |
|
|
|
|
function safeTransferFrom(address from, address to, uint256 tokenId) external; |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Transfers a specific NFT (`tokenId`) from one account (`from`) to |
|
|
|
|
* another (`to`). |
|
|
|
|
* @dev Transfers `tokenId` token from `from` to `to`. |
|
|
|
|
* |
|
|
|
|
* WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* - If the caller is not `from`, it must be approved to move this NFT by |
|
|
|
|
* either {approve} or {setApprovalForAll}. |
|
|
|
|
* |
|
|
|
|
* - `from`, `to` cannot be zero. |
|
|
|
|
* - `tokenId` token must be owned by `from`. |
|
|
|
|
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. |
|
|
|
|
* |
|
|
|
|
* Emits a {Transfer} event. |
|
|
|
|
*/ |
|
|
|
|
function transferFrom(address from, address to, uint256 tokenId) external; |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Gives permission to `to` to transfer `tokenId` token to another account. |
|
|
|
|
* The approval is cleared when the token is transferred. |
|
|
|
|
* |
|
|
|
|
* Only a single account can be approved at a time, so approving the zero address clears previous approvals. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* |
|
|
|
|
* - The caller must own the token or be an approved operator. |
|
|
|
|
* - `tokenId` must exist. |
|
|
|
|
* |
|
|
|
|
* Emits an {Approval} event. |
|
|
|
|
*/ |
|
|
|
|
function approve(address to, uint256 tokenId) external; |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Returns the account approved for `tokenId` token. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* |
|
|
|
|
* - `tokenId` must exist. |
|
|
|
|
*/ |
|
|
|
|
function getApproved(uint256 tokenId) external view returns (address operator); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Approve or remove `operator` as an operator for the caller. |
|
|
|
|
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* |
|
|
|
|
* - The `operator` cannot be the caller. |
|
|
|
|
* |
|
|
|
|
* Emits an {ApprovalForAll} event. |
|
|
|
|
*/ |
|
|
|
|
function setApprovalForAll(address operator, bool _approved) external; |
|
|
|
|
function isApprovedForAll(address owner, address operator) external view returns (bool); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. |
|
|
|
|
* |
|
|
|
|
* See {setApprovalForAll} |
|
|
|
|
*/ |
|
|
|
|
function isApprovedForAll(address owner, address operator) external view returns (bool); |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* @dev Safely transfers `tokenId` token from `from` to `to`. |
|
|
|
|
* |
|
|
|
|
* Requirements: |
|
|
|
|
* |
|
|
|
|
* - `from`, `to` cannot be zero. |
|
|
|
|
* - `tokenId` token must exist and be owned by `from`. |
|
|
|
|
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. |
|
|
|
|
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. |
|
|
|
|
* |
|
|
|
|
* Emits a {Transfer} event. |
|
|
|
|
*/ |
|
|
|
|
function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external; |
|
|
|
|
} |
|
|
|
|