IERC721.sol 4.3 KB

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