Extensions Functions
These functions are common for any extensions build for ERC721 and ERC1155
Functions used to manage installed extensions
Registers an extension, allowing it to access the mint function, and ability to set a token’s metadata URI or a base URI for that extension. The token URI for tokens minted by this extension will be baseURI<tokenID>. When registering an extension you can specify a third boolean parameter of "true" for baseURIIdentical to specify the token URI for all tokens to be identical (will not increment with appended tokenId).
Permissions: Owner/Admin function callable by contract owner only.
function registerExtension(address extension, string calldata baseURI, bool baseURIIdentical)s, baseURI (string), baseURI (string)
function registerExtension(address extension, string calldata baseURI)
Blacklists an extension, preventing future registrations of the address. This function also destroys all references to metadata associated with tokens created by this extension, making them effectively useless.
Permissions: Owner/Admin function callable by contract owner only.
function blacklistExtension(address extension)
Functions used by extensions to set the metadata of tokens minted by the extension
Set the tokenURI for a specific token minted from this extension. Useful if you want to do something with a dynamic metadata server and need sequential numbering of tokens. Various methods defined below.
Permissions: Only callable by an extension and only on token minted by the extension
function setTokenURIExtension(uint256 tokenId, string calldata uri) external
function setTokenURIExtension(uint256[] memory tokenId, string[] calldata uri)
The powerful thing about Manifold Creator is the ability for extensions to fully override core functionality of NFT smart contracts. The following is a list of functionality extensions can override.
An extension can fully manage the token metadata logic by implementing the ICreatorExtensionTokenURI interface.
If an extension implements this interface then all metadata logic will be deferred to the extension's
tokenURI
function.An extension can control whether or not a token can be transferred. To do this, the extension must implement the IERC721CreatorExtensionApproveTransfer interface (for ERC721) or the IERC1155CreatorExtensionApproveTransfer interface (for ERC1155).
If an extension implements this interface, by default, all transfers will call the extension's
approveTransfer
function prior to every token transfer. An extension can enable/disable this by calling the setApproveTransferExtension function.An extension can receive a callback whenever a token is burned. To do this, the extension must implement the IERC721CreatorExtensionBurnable interface (for ERC721) or the IERC1155CreatorExtensionBurnable interface (for ERC1155).
If an extension implements this interface, every time a token is burned it will call the extension's
onBurn
function.An extension can define the royalties for any tokens they mint. To do this, the extension must implement the ICreatorExtensionRoyalties interface.
If an extension implements this interface, the Creator Contract will defer all royalty lookups to the extension for tokens minted by it.
These are functions used by extensions to mint NFTs. NFTs minted by the extension will adhere to the extension's overriding logic.
Mints a token from the extension. Also can set token URI or token data (immutable for a token) if desired.
Token Data is useful if you wish to store additional data needed by the extension at no additional cost (e.g. mint ordering data).
Permissions: Only callable by an installed extension
function mintExtension(address to) returns (uint256)
function mintExtension(address to, string calldata uri) returns (uint256)
function mintExtension(address to, uint80 data) returns (uint256)
Batch mints tokens from the extension. Also can set token URI or token data (immutable for a token) if desired.
Token Data is useful if you wish to store additional data needed by the extension at no additional cost (e.g. mint ordering data).
Permissions: Only callable by an installed extension
function mintExtensionBatch(address to, uint16 count) returns (uint256[] memory)
function mintExtensionBatch(address to, string[] calldata uris) returns (uint256[] memory)
function mintExtensionBatch(address to, uint80[] calldata data) returns (uint256[] memory)
Mints a completely new token with the given amount from an extension. If URI is empty, URI will fall back to the default URI configured.
Permissions: Only callable by an installed extension
function mintExtensionNew(address[] calldata to, uint256[] calldata amounts, string[] calldata uris) returns (uint256[] memory)
Mints more of an existing token from the extension. Requires that the original token already exist and that it is not a token from an extension.
Permissions: Only callable by an installed extension
function mintExtensionExisting(address[] calldata to, uint256[] calldata tokenIds, uint256[] calldata amounts)
Last modified 2mo ago