IERC721.sol 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142
  1. // SPDX-License-Identifier: MIT
  2. pragma solidity ^0.8.0;
  3. import "../../utils/introspection/IERC165.sol";
  4. /**
  5. * @dev Required interface of an ERC721 compliant contract.
  6. */
  7. interface IERC721 is IERC165 {
  8. /**
  9. * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
  10. */
  11. event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
  12. /**
  13. * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
  14. */
  15. event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
  16. /**
  17. * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
  18. */
  19. event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
  20. /**
  21. * @dev Returns the number of tokens in ``owner``'s account.
  22. */
  23. function balanceOf(address owner) external view returns (uint256 balance);
  24. /**
  25. * @dev Returns the owner of the `tokenId` token.
  26. *
  27. * Requirements:
  28. *
  29. * - `tokenId` must exist.
  30. */
  31. function ownerOf(uint256 tokenId) external view returns (address owner);
  32. /**
  33. * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
  34. * are aware of the ERC721 protocol to prevent tokens from being forever locked.
  35. *
  36. * Requirements:
  37. *
  38. * - `from` cannot be the zero address.
  39. * - `to` cannot be the zero address.
  40. * - `tokenId` token must exist and be owned by `from`.
  41. * - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
  42. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
  43. *
  44. * Emits a {Transfer} event.
  45. */
  46. function safeTransferFrom(
  47. address from,
  48. address to,
  49. uint256 tokenId
  50. ) external;
  51. /**
  52. * @dev Transfers `tokenId` token from `from` to `to`.
  53. *
  54. * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
  55. *
  56. * Requirements:
  57. *
  58. * - `from` cannot be the zero address.
  59. * - `to` cannot be the zero address.
  60. * - `tokenId` token must be owned by `from`.
  61. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
  62. *
  63. * Emits a {Transfer} event.
  64. */
  65. function transferFrom(
  66. address from,
  67. address to,
  68. uint256 tokenId
  69. ) external;
  70. /**
  71. * @dev Gives permission to `to` to transfer `tokenId` token to another account.
  72. * The approval is cleared when the token is transferred.
  73. *
  74. * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
  75. *
  76. * Requirements:
  77. *
  78. * - The caller must own the token or be an approved operator.
  79. * - `tokenId` must exist.
  80. *
  81. * Emits an {Approval} event.
  82. */
  83. function approve(address to, uint256 tokenId) external;
  84. /**
  85. * @dev Returns the account approved for `tokenId` token.
  86. *
  87. * Requirements:
  88. *
  89. * - `tokenId` must exist.
  90. */
  91. function getApproved(uint256 tokenId) external view returns (address operator);
  92. /**
  93. * @dev Approve or remove `operator` as an operator for the caller.
  94. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
  95. *
  96. * Requirements:
  97. *
  98. * - The `operator` cannot be the caller.
  99. *
  100. * Emits an {ApprovalForAll} event.
  101. */
  102. function setApprovalForAll(address operator, bool _approved) external;
  103. /**
  104. * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
  105. *
  106. * See {setApprovalForAll}
  107. */
  108. function isApprovedForAll(address owner, address operator) external view returns (bool);
  109. /**
  110. * @dev Safely transfers `tokenId` token from `from` to `to`.
  111. *
  112. * Requirements:
  113. *
  114. * - `from` cannot be the zero address.
  115. * - `to` cannot be the zero address.
  116. * - `tokenId` token must exist and be owned by `from`.
  117. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
  118. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
  119. *
  120. * Emits a {Transfer} event.
  121. */
  122. function safeTransferFrom(
  123. address from,
  124. address to,
  125. uint256 tokenId,
  126. bytes calldata data
  127. ) external;
  128. }