mirror of openzeppelin-contracts
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
openzeppelin-contracts/contracts/token/ERC1155
github-actions[bot] 0034c30224
Merge release-v5.1 branch (#5266)
4 months ago
..
extensions Merge release-v5.1 branch (#5266) 4 months ago
utils Merge release-v5.1 branch (#5266) 4 months ago
ERC1155.sol Merge release-v5.1 branch (#5266) 4 months ago
IERC1155.sol Merge release-v5.1 branch (#5266) 4 months ago
IERC1155Receiver.sol Merge release-v5.1 branch (#5266) 4 months ago
README.adoc Create a ERC1363Utils helper similar to existing ERC721Utils and ERC1155Utils (#5133) 6 months ago

README.adoc

= ERC-1155

[.readme-notice]
NOTE: This document is better viewed at https://docs.openzeppelin.com/contracts/api/token/erc1155

This set of interfaces and contracts are all related to the https://eips.ethereum.org/EIPS/eip-1155[ERC-1155 Multi Token Standard].

The ERC consists of three interfaces which fulfill different roles, found here as {IERC1155}, {IERC1155MetadataURI} and {IERC1155Receiver}.

{ERC1155} implements the mandatory {IERC1155} interface, as well as the optional extension {IERC1155MetadataURI}, by relying on the substitution mechanism to use the same URI for all token types, dramatically reducing gas costs.

Additionally there are multiple custom extensions, including:

* designation of addresses that can pause token transfers for all users ({ERC1155Pausable}).
* destruction of own tokens ({ERC1155Burnable}).

NOTE: This core set of contracts is designed to be unopinionated, allowing developers to access the internal functions in ERC-1155 (such as <<ERC1155-_mint-address-uint256-uint256-bytes-,`_mint`>>) and expose them as external functions in the way they prefer.

== Core

{{IERC1155}}

{{IERC1155MetadataURI}}

{{ERC1155}}

{{IERC1155Receiver}}

== Extensions

{{ERC1155Pausable}}

{{ERC1155Burnable}}

{{ERC1155Supply}}

{{ERC1155URIStorage}}

== Utilities

{{ERC1155Holder}}

{{ERC1155Utils}}