Skip to main content

TokenERC1155

Methods​

DEFAULT_ADMIN_ROLE​

function DEFAULT_ADMIN_ROLE() external view returns (bytes32)

Returns​

NameTypeDescription
_0bytes32undefined

balanceOf​

function balanceOf(address account, uint256 id) external view returns (uint256)

See {IERC1155-balanceOf}. Requirements: - account cannot be the zero address.

Parameters​

NameTypeDescription
accountaddressundefined
iduint256undefined

Returns​

NameTypeDescription
_0uint256undefined

balanceOfBatch​

function balanceOfBatch(address[] accounts, uint256[] ids) external view returns (uint256[])

See {IERC1155-balanceOfBatch}. Requirements: - accounts and ids must have the same length.

Parameters​

NameTypeDescription
accountsaddress[]undefined
idsuint256[]undefined

Returns​

NameTypeDescription
_0uint256[]undefined

burn​

function burn(address account, uint256 id, uint256 value) external nonpayable

Lets a token owner burn the tokens they own (i.e. destroy for good)

Parameters​

NameTypeDescription
accountaddressundefined
iduint256undefined
valueuint256undefined

burnBatch​

function burnBatch(address account, uint256[] ids, uint256[] values) external nonpayable

Lets a token owner burn multiple tokens they own at once (i.e. destroy for good)

Parameters​

NameTypeDescription
accountaddressundefined
idsuint256[]undefined
valuesuint256[]undefined

contractType​

function contractType() external pure returns (bytes32)

Returns the module type of the contract.

Returns​

NameTypeDescription
_0bytes32undefined

contractURI​

function contractURI() external view returns (string)

Contract level metadata.

Returns​

NameTypeDescription
_0stringundefined

contractVersion​

function contractVersion() external pure returns (uint8)

Returns the version of the contract.

Returns​

NameTypeDescription
_0uint8undefined

getDefaultRoyaltyInfo​

function getDefaultRoyaltyInfo() external view returns (address, uint16)

Returns default royalty info.

Returns​

NameTypeDescription
_0addressundefined
_1uint16undefined

getFlatPlatformFeeInfo​

function getFlatPlatformFeeInfo() external view returns (address, uint256)

Returns the flat platform fee and recipient.

Returns​

NameTypeDescription
_0addressundefined
_1uint256undefined

getPlatformFeeInfo​

function getPlatformFeeInfo() external view returns (address, uint16)

Returns the platform fee bps and recipient.

Returns​

NameTypeDescription
_0addressundefined
_1uint16undefined

getPlatformFeeType​

function getPlatformFeeType() external view returns (enum TokenERC1155.PlatformFeeType)

Returns the platform fee type.

Returns​

NameTypeDescription
_0enum TokenERC1155.PlatformFeeTypeundefined

getRoleAdmin​

function getRoleAdmin(bytes32 role) external view returns (bytes32)

Returns the admin role that controls role. See {grantRole} and {revokeRole}. To change a role's admin, use {_setRoleAdmin}.

Parameters​

NameTypeDescription
rolebytes32undefined

Returns​

NameTypeDescription
_0bytes32undefined

getRoleMember​

function getRoleMember(bytes32 role, uint256 index) external view returns (address)

Returns one of the accounts that have role. index must be a value between 0 and {getRoleMemberCount}, non-inclusive. Role bearers are not sorted in any particular way, and their ordering may change at any point. WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure you perform all queries on the same block. See the following https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296 for more information.

Parameters​

NameTypeDescription
rolebytes32undefined
indexuint256undefined

Returns​

NameTypeDescription
_0addressundefined

getRoleMemberCount​

function getRoleMemberCount(bytes32 role) external view returns (uint256)

Returns the number of accounts that have role. Can be used together with {getRoleMember} to enumerate all bearers of a role.

Parameters​

NameTypeDescription
rolebytes32undefined

Returns​

NameTypeDescription
_0uint256undefined

getRoyaltyInfoForToken​

function getRoyaltyInfoForToken(uint256 _tokenId) external view returns (address, uint16)

Returns the royalty recipient for a particular token Id.

Parameters​

NameTypeDescription
_tokenIduint256undefined

Returns​

NameTypeDescription
_0addressundefined
_1uint16undefined

grantRole​

function grantRole(bytes32 role, address account) external nonpayable

Grants role to account. If account had not been already granted role, emits a {RoleGranted} event. Requirements: - the caller must have role's admin role. May emit a {RoleGranted} event.

Parameters​

NameTypeDescription
rolebytes32undefined
accountaddressundefined

hasRole​

function hasRole(bytes32 role, address account) external view returns (bool)

Returns true if account has been granted role.

Parameters​

NameTypeDescription
rolebytes32undefined
accountaddressundefined

Returns​

NameTypeDescription
_0boolundefined

initialize​

function initialize(address _defaultAdmin, string _name, string _symbol, string _contractURI, address[] _trustedForwarders, address _primarySaleRecipient, address _royaltyRecipient, uint128 _royaltyBps, uint128 _platformFeeBps, address _platformFeeRecipient) external nonpayable

Initializes the contract, like a constructor.

Parameters​

NameTypeDescription
_defaultAdminaddressundefined
_namestringundefined
_symbolstringundefined
_contractURIstringundefined
_trustedForwardersaddress[]undefined
_primarySaleRecipientaddressundefined
_royaltyRecipientaddressundefined
_royaltyBpsuint128undefined
_platformFeeBpsuint128undefined
_platformFeeRecipientaddressundefined

isApprovedForAll​

function isApprovedForAll(address account, address operator) external view returns (bool)

See {IERC1155-isApprovedForAll}.

Parameters​

NameTypeDescription
accountaddressundefined
operatoraddressundefined

Returns​

NameTypeDescription
_0boolundefined

isTrustedForwarder​

function isTrustedForwarder(address forwarder) external view returns (bool)

Parameters​

NameTypeDescription
forwarderaddressundefined

Returns​

NameTypeDescription
_0boolundefined

mintTo​

function mintTo(address _to, uint256 _tokenId, string _uri, uint256 _amount) external nonpayable

Lets an account with MINTER_ROLE mint an NFT.

Parameters​

NameTypeDescription
_toaddressundefined
_tokenIduint256undefined
_uristringundefined
_amountuint256undefined

mintWithSignature​

function mintWithSignature(ITokenERC1155.MintRequest _req, bytes _signature) external payable

Parameters​

NameTypeDescription
_reqITokenERC1155.MintRequestundefined
_signaturebytesundefined

multicall​

function multicall(bytes[] data) external nonpayable returns (bytes[] results)

Receives and executes a batch of function calls on this contract.

Parameters​

NameTypeDescription
databytes[]undefined

Returns​

NameTypeDescription
resultsbytes[]undefined

name​

function name() external view returns (string)

Returns​

NameTypeDescription
_0stringundefined

nextTokenIdToMint​

function nextTokenIdToMint() external view returns (uint256)

The next token ID of the NFT to mint.

Returns​

NameTypeDescription
_0uint256undefined

operatorRestriction​

function operatorRestriction() external view returns (bool)

Returns​

NameTypeDescription
_0boolundefined

owner​

function owner() external view returns (address)

Returns the address of the current owner.

Returns​

NameTypeDescription
_0addressundefined

platformFeeRecipient​

function platformFeeRecipient() external view returns (address)

The address that receives all primary sales value.

Returns​

NameTypeDescription
_0addressundefined

primarySaleRecipient​

function primarySaleRecipient() external view returns (address)

The address that receives all primary sales value.

Returns​

NameTypeDescription
_0addressundefined

renounceRole​

function renounceRole(bytes32 role, address account) external nonpayable

Revokes role from the calling account. Roles are often managed via {grantRole} and {revokeRole}: this function's purpose is to provide a mechanism for accounts to lose their privileges if they are compromised (such as when a trusted device is misplaced). If the calling account had been revoked role, emits a {RoleRevoked} event. Requirements: - the caller must be account. May emit a {RoleRevoked} event.

Parameters​

NameTypeDescription
rolebytes32undefined
accountaddressundefined

revokeRole​

function revokeRole(bytes32 role, address account) external nonpayable

Revokes role from account. If account had been granted role, emits a {RoleRevoked} event. Requirements: - the caller must have role's admin role. May emit a {RoleRevoked} event.

Parameters​

NameTypeDescription
rolebytes32undefined
accountaddressundefined

royaltyInfo​

function royaltyInfo(uint256 tokenId, uint256 salePrice) external view returns (address receiver, uint256 royaltyAmount)

See EIP-2981

Parameters​

NameTypeDescription
tokenIduint256undefined
salePriceuint256undefined

Returns​

NameTypeDescription
receiveraddressundefined
royaltyAmountuint256undefined

safeBatchTransferFrom​

function safeBatchTransferFrom(address from, address to, uint256[] ids, uint256[] amounts, bytes data) external nonpayable

See {IERC1155-safeBatchTransferFrom}.

Parameters​

NameTypeDescription
fromaddressundefined
toaddressundefined
idsuint256[]undefined
amountsuint256[]undefined
databytesundefined

safeTransferFrom​

function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes data) external nonpayable

See {IERC1155-safeTransferFrom}.

Parameters​

NameTypeDescription
fromaddressundefined
toaddressundefined
iduint256undefined
amountuint256undefined
databytesundefined

saleRecipientForToken​

function saleRecipientForToken(uint256) external view returns (address)

Token ID => the address of the recipient of primary sales.

Parameters​

NameTypeDescription
_0uint256undefined

Returns​

NameTypeDescription
_0addressundefined

setApprovalForAll​

function setApprovalForAll(address operator, bool approved) external nonpayable

See {ERC1155-setApprovalForAll}

Parameters​

NameTypeDescription
operatoraddressundefined
approvedboolundefined

setContractURI​

function setContractURI(string _uri) external nonpayable

Lets a module admin set the URI for contract-level metadata.

Parameters​

NameTypeDescription
_uristringundefined

setDefaultRoyaltyInfo​

function setDefaultRoyaltyInfo(address _royaltyRecipient, uint256 _royaltyBps) external nonpayable

Lets a module admin update the royalty bps and recipient.

Parameters​

NameTypeDescription
_royaltyRecipientaddressundefined
_royaltyBpsuint256undefined

setFlatPlatformFeeInfo​

function setFlatPlatformFeeInfo(address _platformFeeRecipient, uint256 _flatFee) external nonpayable

Lets a module admin set a flat fee on primary sales.

Parameters​

NameTypeDescription
_platformFeeRecipientaddressundefined
_flatFeeuint256undefined

setOperatorRestriction​

function setOperatorRestriction(bool _restriction) external nonpayable

Parameters​

NameTypeDescription
_restrictionboolundefined

setOwner​

function setOwner(address _newOwner) external nonpayable

Lets a module admin set a new owner for the contract. The new owner must be a module admin.

Parameters​

NameTypeDescription
_newOwneraddressundefined

setPlatformFeeInfo​

function setPlatformFeeInfo(address _platformFeeRecipient, uint256 _platformFeeBps) external nonpayable

Lets a module admin update the fees on primary sales.

Parameters​

NameTypeDescription
_platformFeeRecipientaddressundefined
_platformFeeBpsuint256undefined

setPlatformFeeType​

function setPlatformFeeType(enum TokenERC1155.PlatformFeeType _feeType) external nonpayable

Lets a module admin set a flat fee on primary sales.

Parameters​

NameTypeDescription
_feeTypeenum TokenERC1155.PlatformFeeTypeundefined

setPrimarySaleRecipient​

function setPrimarySaleRecipient(address _saleRecipient) external nonpayable

Lets a module admin set the default recipient of all primary sales.

Parameters​

NameTypeDescription
_saleRecipientaddressundefined

setRoyaltyInfoForToken​

function setRoyaltyInfoForToken(uint256 _tokenId, address _recipient, uint256 _bps) external nonpayable

Lets a module admin set the royalty recipient for a particular token Id.

Parameters​

NameTypeDescription
_tokenIduint256undefined
_recipientaddressundefined
_bpsuint256undefined

supportsInterface​

function supportsInterface(bytes4 interfaceId) external view returns (bool)

Parameters​

NameTypeDescription
interfaceIdbytes4undefined

Returns​

NameTypeDescription
_0boolundefined

symbol​

function symbol() external view returns (string)

Returns​

NameTypeDescription
_0stringundefined

totalSupply​

function totalSupply(uint256) external view returns (uint256)

Token ID => total circulating supply of tokens with that ID.

Parameters​

NameTypeDescription
_0uint256undefined

Returns​

NameTypeDescription
_0uint256undefined

uri​

function uri(uint256 _tokenId) external view returns (string)

Returns the URI for a tokenId

Parameters​

NameTypeDescription
_tokenIduint256undefined

Returns​

NameTypeDescription
_0stringundefined

verify​

function verify(ITokenERC1155.MintRequest _req, bytes _signature) external view returns (bool, address)

Parameters​

NameTypeDescription
_reqITokenERC1155.MintRequestundefined
_signaturebytesundefined

Returns​

NameTypeDescription
_0boolundefined
_1addressundefined

Events​

ApprovalForAll​

event ApprovalForAll(address indexed account, address indexed operator, bool approved)

Parameters​

NameTypeDescription
account indexedaddressundefined
operator indexedaddressundefined
approvedboolundefined

DefaultRoyalty​

event DefaultRoyalty(address indexed newRoyaltyRecipient, uint256 newRoyaltyBps)

Parameters​

NameTypeDescription
newRoyaltyRecipient indexedaddressundefined
newRoyaltyBpsuint256undefined

FlatPlatformFeeUpdated​

event FlatPlatformFeeUpdated(address platformFeeRecipient, uint256 flatFee)

Emitted when flat fee on primary sales is updated.

Parameters​

NameTypeDescription
platformFeeRecipientaddressundefined
flatFeeuint256undefined

Initialized​

event Initialized(uint8 version)

Parameters​

NameTypeDescription
versionuint8undefined

OperatorRestriction​

event OperatorRestriction(bool restriction)

Parameters​

NameTypeDescription
restrictionboolundefined

OwnerUpdated​

event OwnerUpdated(address indexed prevOwner, address indexed newOwner)

Parameters​

NameTypeDescription
prevOwner indexedaddressundefined
newOwner indexedaddressundefined

PlatformFeeInfoUpdated​

event PlatformFeeInfoUpdated(address indexed platformFeeRecipient, uint256 platformFeeBps)

Parameters​

NameTypeDescription
platformFeeRecipient indexedaddressundefined
platformFeeBpsuint256undefined

PlatformFeeTypeUpdated​

event PlatformFeeTypeUpdated(enum TokenERC1155.PlatformFeeType feeType)

Emitted when platform fee type is updated.

Parameters​

NameTypeDescription
feeTypeenum TokenERC1155.PlatformFeeTypeundefined

PrimarySaleRecipientUpdated​

event PrimarySaleRecipientUpdated(address indexed recipient)

Parameters​

NameTypeDescription
recipient indexedaddressundefined

RoleAdminChanged​

event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole)

Parameters​

NameTypeDescription
role indexedbytes32undefined
previousAdminRole indexedbytes32undefined
newAdminRole indexedbytes32undefined

RoleGranted​

event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender)

Parameters​

NameTypeDescription
role indexedbytes32undefined
account indexedaddressundefined
sender indexedaddressundefined

RoleRevoked​

event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender)

Parameters​

NameTypeDescription
role indexedbytes32undefined
account indexedaddressundefined
sender indexedaddressundefined

RoyaltyForToken​

event RoyaltyForToken(uint256 indexed tokenId, address indexed royaltyRecipient, uint256 royaltyBps)

Parameters​

NameTypeDescription
tokenId indexeduint256undefined
royaltyRecipient indexedaddressundefined
royaltyBpsuint256undefined

TokensMinted​

event TokensMinted(address indexed mintedTo, uint256 indexed tokenIdMinted, string uri, uint256 quantityMinted)

Parameters​

NameTypeDescription
mintedTo indexedaddressundefined
tokenIdMinted indexeduint256undefined
uristringundefined
quantityMinteduint256undefined

TokensMintedWithSignature​

event TokensMintedWithSignature(address indexed signer, address indexed mintedTo, uint256 indexed tokenIdMinted, ITokenERC1155.MintRequest mintRequest)

Parameters​

NameTypeDescription
signer indexedaddressundefined
mintedTo indexedaddressundefined
tokenIdMinted indexeduint256undefined
mintRequestITokenERC1155.MintRequestundefined

TransferBatch​

event TransferBatch(address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values)

Parameters​

NameTypeDescription
operator indexedaddressundefined
from indexedaddressundefined
to indexedaddressundefined
idsuint256[]undefined
valuesuint256[]undefined

TransferSingle​

event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value)

Parameters​

NameTypeDescription
operator indexedaddressundefined
from indexedaddressundefined
to indexedaddressundefined
iduint256undefined
valueuint256undefined

URI​

event URI(string value, uint256 indexed id)

Parameters​

NameTypeDescription
valuestringundefined
id indexeduint256undefined

Errors​

OperatorNotAllowed​

error OperatorNotAllowed(address operator)

Parameters​

NameTypeDescription
operatoraddressundefined