IERC721.sol 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. // SPDX-License-Identifier: MIT
  2. pragma solidity ^0.8.0;
  3. import "../../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(address from, address to, uint256 tokenId) external;
  47. /**
  48. * @dev Transfers `tokenId` token from `from` to `to`.
  49. *
  50. * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
  51. *
  52. * Requirements:
  53. *
  54. * - `from` cannot be the zero address.
  55. * - `to` cannot be the zero address.
  56. * - `tokenId` token must be owned by `from`.
  57. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
  58. *
  59. * Emits a {Transfer} event.
  60. */
  61. function transferFrom(address from, address to, uint256 tokenId) external;
  62. /**
  63. * @dev Gives permission to `to` to transfer `tokenId` token to another account.
  64. * The approval is cleared when the token is transferred.
  65. *
  66. * Only a single account can be approved at a time, so approving the zero address clears previous approvals.
  67. *
  68. * Requirements:
  69. *
  70. * - The caller must own the token or be an approved operator.
  71. * - `tokenId` must exist.
  72. *
  73. * Emits an {Approval} event.
  74. */
  75. function approve(address to, uint256 tokenId) external;
  76. /**
  77. * @dev Returns the account approved for `tokenId` token.
  78. *
  79. * Requirements:
  80. *
  81. * - `tokenId` must exist.
  82. */
  83. function getApproved(uint256 tokenId) external view returns (address operator);
  84. /**
  85. * @dev Approve or remove `operator` as an operator for the caller.
  86. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
  87. *
  88. * Requirements:
  89. *
  90. * - The `operator` cannot be the caller.
  91. *
  92. * Emits an {ApprovalForAll} event.
  93. */
  94. function setApprovalForAll(address operator, bool _approved) external;
  95. /**
  96. * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
  97. *
  98. * See {setApprovalForAll}
  99. */
  100. function isApprovedForAll(address owner, address operator) external view returns (bool);
  101. /**
  102. * @dev Safely transfers `tokenId` token from `from` to `to`.
  103. *
  104. * Requirements:
  105. *
  106. * - `from` cannot be the zero address.
  107. * - `to` cannot be the zero address.
  108. * - `tokenId` token must exist and be owned by `from`.
  109. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
  110. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
  111. *
  112. * Emits a {Transfer} event.
  113. */
  114. function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
  115. }