Common functions include code found in both ERC721 and ERC1155 Creator Contracts. These functions exist for either ERC721 or ERC1155 implementations. Implementation details can be found in the following smart contract files:
Administrative Functions
Functions for adding and removing contract admins and transferring contract ownership. Admin controls are implemented via .
getAdmins
Gets list of admins on the contract that have access to performing Owner/Admin functions.
Permissions: Public function callable by anyone.
function getAdmins() view returns (address[] memory admins)
approveAdmin
Adds wallet address as an Admin on the contract for performing Owner/Admin functions.
Permissions: Owner/Admin function callable by contract owner only.
function approveAdmin(address admin)
revokeAdmin
Removes wallet address as an Admin on the contract from performing Owner/Admin functions.
Permissions: Owner/Admin function callable by contract owner or admin only.
function revokeAdmin(address admin)
isAdmin
Admin lookup via wallet address.
Permissions: Public function callable by anyone.
function isAdmin(address admin) view returns (bool)
transferOwnership
Transfers ownership of the contract to a specified wallet address. Owner/Admin function callable by contract owner or admin only.
Permissions: Callable by contract owner only
function transferOwnership(address newOwner)
setApproveTransfer
The token was NOT minted by an extension or;
The token was minted by an extension that does not have approve transfer callbacks enabled, or did not implement approve transfer callbacks
Permissions: Owner/Admin function callable by contract owner only.
getApproveTransfer
Gets the address of the contract that is checked for transfer approvals. Returns 0x0000000000000000000000000000000000000000 if no contract is configured.
Permissions: Public function callable by anyone.
Token Owner Functions
burn
Burns (destroys) a token or tokens. The token creator extension is notified when this occurs.
Permissions: Public function only callable by token owner.
function burn(address account, uint256[] memory tokenIds, uint256[] memory amounts)
safeTransferFrom
Permissions: Public function callable by token owner only
Input Parameters: from address, to address, tokenId
function safeTransferFrom(address _from, address _to, uint256 _tokenId)
Metadata Functions
setBaseTokenURI
Sets the base URI for any tokens created without an extension. Once set, the metadata URI will be base_uri/<tokenId> by default.
Permissions: Owner/Admin function callable by contract owner only.
function setBaseTokenURI(string calldata uri)
setTokenURIPrefix
Sets a prefix for all tokens minted without an extension. If configured, and a token has a URI set, tokenURI will return <prefixURI><tokenURI>.
Permissions: Owner/Admin function callable by contract owner only.
function setTokenURIPrefix(string calldata prefix)
setTokenURI
Sets a specific metadata URI for a given token created without an extension.Methods included for taking in both singular token values and arrays of multiple tokens/strings.
Permissions: Owner/Admin function callable by contract owner only.
function setTokenURI(uint256 tokenId, string calldata uri)
function setTokenURI(uint256[] memory tokenIds, string[] calldata uris)
Royalty Functions
Functions for querying or setting royalties on a contract or specific token.
getFeeRecipients
Permissions: Public function callable by anyone.
function getFeeRecipients(uint256 id) public view
returns (address payable[] memory)
getFeeBps
Permissions: Public function callable by anyone.
function getFeeBps(uint256 id) public view
returns (uint[] memory)
getFees
Gets royalty recipient and royalty percentage for a given tokenId. Standard interface identifier for Foundation royalties. Public function callable by anyone.
Permissions: Public function callable by anyone.
function getFees(unit256) public view
returns (address[], unit256[])
getRoyalties
Gets royalty recipient and royalty percentage for a given tokenId. Public function callable by anyone.
Permissions: Public function callable by anyone.
function getRoyalties(uint256 tokenId) view
returns (address payable[] memory, uint256[] memory)
royaltyInfo
Permissions: Public function callable by anyone.
function royaltyInfo(uint256 tokenId, uint256 value) view
returns (address, uint256)
setRoyalties
Sets default royalties for all tokens on a contract. You can also use the same function specifying a particular tokenID to set royalties for that singular token.
Permissions: Owner/Admin function callable by contract owner only.
function setRoyalties(address payable[] calldata receivers, uint256[] calldata basisPoints)
function setRoyalties(uint256 tokenId, address payable[] calldata receivers, uint256[] calldata basisPoints)
Set the address of a contract that implements the approveTransfer function of and/or . If configured, it will call the contract's approveTransfer function to see whether or not a token can be transferred as long as
This functionality is useful if you want to enforce on transfer rules, such as the .
Set to the 0x0000000000000000000000000000000000000000 address to disable.
Transfers ownership of a specific NFT from one address to another. When using safeTransferFrom the token contract checks to see that the receiver address is an , which implies that it knows how to handle ERC721 tokens (unlike the standard transferFrom function).
When implementing transfers within your contracts its best practice to always use the safeTransferFrom function (rather than transferFrom) to ensure events set to trigger upon retrieval are successful (ensures receiver knows how to handle the tokens it is about to receive as an or Receiver).
Metadata functions can add or modify a Token's URI, or Uniform Resource Identifier. This URI specifies the endpoint with information representing the NFT including its media and attributes, conforming to the . This JSON is often hosted on decentralized protocols like , like we use within Manifold Studio.
Gets royalty recipients for a given tokenId. Standard interface identifier for .
Gets royalty percentage (bps) for a given tokenId.Standard interface identifier for . Public function callable by anyone.
Gets royalty configuration (receiver and royalty amount) for a given token provided tokenID and salePrice. Supports the same interface as other marketplace platforms such as Rarible or Foundation (). Public function callable by anyone.