d9fa59f30a
* Make holder fns public * Add context, remove msg.sender from check * Fix location of Holder arguments * Add beforeTransfer hook * Minor test improvements * Add ERC1155Burnable and tests * Add ERC1155Pausable * Add ERC1155PresetMinterPauser.sol * Add uri constructors * Improved revert reasons * Initial docs improvements * Add missing docs * Improve acceptance checks revert reasons * Apply suggestions from code review Co-authored-by: Francisco Giordano <frangio.1@gmail.com> * Remove note about 1155 preset uri in mint * Add rquirements to balanceOfBatch * Add note about URI and uri * Fix list in docs * Fix lint errors * Use natural sorting for API titles * Fix doc references * Escape {id} references to remove docgen warnings * Added intro docs, fixed links * Apply suggestions from code review Co-authored-by: Francisco Giordano <frangio.1@gmail.com> * Add changelog entry Co-authored-by: Francisco Giordano <frangio.1@gmail.com>
37 lines
1.3 KiB
Plaintext
37 lines
1.3 KiB
Plaintext
= ERC 721
|
|
|
|
This set of interfaces, contracts, and utilities are all related to the https://eips.ethereum.org/EIPS/eip-721[ERC721 Non-Fungible Token Standard].
|
|
|
|
TIP: For a walkthrough on how to create an ERC721 token read our xref:ROOT:erc721.adoc[ERC721 guide].
|
|
|
|
The EIP consists of three interfaces, found here as {IERC721}, {IERC721Metadata}, and {IERC721Enumerable}. Only the first one is required in a contract to be ERC721 compliant. However, all three are implemented in {ERC721}.
|
|
|
|
Additionally, {IERC721Receiver} can be used to prevent tokens from becoming forever locked in contracts. Imagine sending an in-game item to an exchange address that can't send it back!. When using <<IERC721-safeTransferFrom,`safeTransferFrom`>>, the token contract checks to see that the receiver is an {IERC721Receiver}, which implies that it knows how to handle {ERC721} tokens. If you're writing a contract that needs to receive {ERC721} tokens, you'll want to include this interface.
|
|
|
|
Additionally there are multiple custom extensions, including:
|
|
|
|
* designation of addresses that can pause token transfers for all users ({ERC721Pausable}).
|
|
* destruction of own tokens ({ERC721Burnable}).
|
|
|
|
== Core
|
|
|
|
{{IERC721}}
|
|
|
|
{{IERC721Metadata}}
|
|
|
|
{{IERC721Enumerable}}
|
|
|
|
{{ERC721}}
|
|
|
|
{{IERC721Receiver}}
|
|
|
|
== Extensions
|
|
|
|
{{ERC721Pausable}}
|
|
|
|
{{ERC721Burnable}}
|
|
|
|
== Convenience
|
|
|
|
{{ERC721Holder}}
|