NFT721 V2

airdropMint

  /** IMint */
  //Mints a new NFT to a specified owner without requiring the owner to initiate the mint.
  function airdropMint(
    address _owner,
    uint256 _variationId
  ) external payable

  /** IMintURI */
  //Mints an NFT to a specified owner with a unique URI, validated by a signature.
  function airdropMint(
    address owner,
    bytes calldata _signature,
    string calldata _uri,
    bytes calldata _salt
  ) external payable

  /** IMintURIWhitelist */
  //Mints an NFT to a specified owner with a unique URI, validated by a signature and Merkle proof.
  function airdropMint(
    address _owner,
    bytes32[] calldata _merkleProof,
    bytes calldata _signature,
    string calldata _uri,
    bytes calldata _salt
  ) external payable

  /** IMintWhitelist */
  //Airdrops an NFT with a specified variation ID to a given owner, validated by Merkle proof.
  function airdropMint(
    address _owner,
    bytes32[] calldata _merkleProof,
    uint256 _variationId
  ) external payable

Parameters:

Name	Type	Description
_owner	address	The address of the recipient of the minted NFT.
_variationId	uint256	The ID of the token variation to mint.
_signature	bytes	The signature for verification.
_uri	string	The URI for the NFT.
_salt	bytes	The salt used in signature verification.
_merkleProof	bytes32[]	An array representing the Merkle proof for whitelist verification.

airdropBatchMint

  /** IMint */
  //Mints a new NFT to a specified owner without requiring the owner to initiate the mint.
  function airdropBatchMint(
    address[] memory _owners,
    uint256[] calldata _variationIds
  ) external payable
  /** IMintURI */
  //Mints multiple NFTs to specified owners, each with unique URIs and validated by signatures, in a batch process.
  function airdropBatchMint(
    address[] memory owners,
    bytes[] calldata _signatures,
    string[] calldata _uris,
    bytes[] calldata _salts
  ) external payable

  /** IMintURIWhitelist */
  //Mints multiple NFTs to specified owners, each with unique URIs, signatures, and Merkle proofs, in a batch process.
  function airdropBatchMint(
    address[] memory _owners,
    bytes32[][] calldata _merkleProofs,
    bytes[] calldata _signatures,
    string[] calldata _uris,
    bytes[] calldata _salts
  ) external payable

  /** IMintWhitelist */
  //Airdrops multiple NFTs with specified variation IDs to given owners, validated by respective Merkle proofs.
  function airdropBatchMint(
    address[] memory _owners,
    bytes32[][] calldata _merkleProofs,
    uint256[] calldata _variationIds
  ) external payable

Parameters:

Name	Type	Description
_owners	address[]	An array of addresses for the NFT recipients.
_variationIds	uint256[]	An array of variation IDs corresponding to each NFT being minted.
_signatures	bytes[]	An array of signatures for verification.
_uris	string[]	An array of URIs for each NFT.
_salts	bytes[]	An array of salts used in signature verification.
_merkleProofs	bytes32[][]	An array representing the Merkle proof for whitelist verification.

airdropSubscriptionMint

  /** IMint */
  //Mints a new NFT with an associated subscription to a specified owner.
  function airdropSubscriptionMint(
    uint256 _entityId,
    address _owner,
    uint256 _variationId,
    bool _directUpdateEnabled
  ) external payable

  /** IMintURI */
  //Mints an NFT with a subscription to a specified owner, with a unique URI, validated by a signature.
  function airdropSubscriptionMint(
    uint256 _entityId,
    address _owner,
    bytes calldata _signature,
    string calldata _uri,
    bytes calldata _salt,
    bool _directUpdateEnabled
  ) external payable

  /** IMintURIWhitelist */
  //Mints an NFT with a subscription to a specified owner, with a unique URI, validated by a signature and Merkle proof.
  function airdropSubscriptionMint(
    uint256 _entityId,
    address _owner,
    bytes32[] calldata _merkleProof,
    bytes calldata _signature,
    string calldata _uri,
    bytes calldata _salt,
    bool _directUpdateEnabled
  ) external payable

  /** IMintWhitelist */
  //Airdrops an NFT with a specified variation ID to a given owner and subscribes it to an entity, validated by Merkle proof.
  function airdropSubscriptionMint(
    uint256 _entityId,
    address _owner,
    bytes32[] calldata _merkleProof,
    uint256 _variationId,
    bool _directUpdateEnabled
  ) external payable

Parameters:

Name	Type	Description
_entityId	address	The ID of the entity for the subscription.
_owner	address	The address of the recipient of the minted NFT.
_variationId	uint256	The ID of the token variation to mint.
_signature	bytes	The signature for verification.
_uri	string	The URI for the NFT.
_salt	bytes	The salt used in signature verification.
_merkleProof	bytes32[]	An array representing the Merkle proof for whitelist verification.
_directUpdateEnabled	bool	A flag indicating whether direct updates are enabled for the entity slot.

airdropBatchSubscriptionMint

  /** IMint */
  //Mints multiple NFTs with associated subscriptions to specified owners in a single transaction.
  function airdropBatchSubscriptionMint(
    uint256 _entityId,
    address[] calldata _owners,
    uint256[] calldata _variationIds,
    bool[] calldata _directUpdateEnableds
  ) external payable

  /** IMintURI */
  //Mints multiple NFTs with subscriptions to specified owners, each with unique URIs and validated by signatures, in a batch process.
  function airdropBatchSubscriptionMint(
    uint256 _entityId,
    address[] calldata _owners,
    bytes[] calldata _signatures,
    string[] calldata _uris,
    bytes[] calldata _salts,
    bool[] calldata _directUpdateEnableds
  ) external payable

  /** IMintURIWhitelist */
  //Mints multiple NFTs with subscriptions to specified owners, each with unique URIs, signatures, and Merkle proofs, in a batch process.
  function airdropBatchSubscriptionMint(
    uint256 _entityId,
    address[] calldata _owners,
    bytes32[][] calldata _merkleProofs,
    bytes[] calldata _signatures,
    string[] calldata _uris,
    bytes[] calldata _salts,
    bool[] calldata _directUpdateEnableds
  ) external payable

  /** IMintWhitelist */
  //Airdrops an NFT with a specified variation ID to a given owner and subscribes it to an entity, validated by Merkle proof.
  function airdropSubscriptionMint(
    uint256 _entityId,
    address _owner,
    bytes32[] calldata _merkleProof,
    uint256 _variationId,
    bool _directUpdateEnabled
  ) external payable

Parameters:

Name	Type	Description
_entityId	address	The ID of the entity for the subscription.
_owners	address	An array of recipient addresses for the minted NFTs.
_variationIds	uint256	An array of variation IDs corresponding to each NFT being minted.
_signatures	bytes[]	An array of signatures for verification.
_uris	string[]	An array of URIs for each NFT.
_salts	bytes[]	An array of salts used in signature verification.
_merkleProofs	bytes32[][]	An array representing the Merkle proof for whitelist verification.
_directUpdateEnableds	bool	An array of flags indicating whether direct updates are enabled for each entity slot.

subscriptionMint

  /** IMint */
  //Mints a new NFT with an associated subscription to the sender.
  function subscriptionMint(
    uint256 _variationId,
    uint256 _entityId,
    bool _directUpdateEnabled
  ) external payable

  /** IMintURI */
  //Mints an NFT with a subscription to the sender, with a unique URI, validated by a signature.
  function subscriptionMint(
    bytes calldata _signature,
    string calldata _uri,
    bytes calldata _salt,
    uint256 _entityId,
    bool _directUpdateEnabled
  ) external payable

  /** IMintURIWhitelist */
  //Mints an NFT with a subscription to the sender, with a unique URI, validated by a signature and Merkle proof.
  function subscriptionMint(
    uint256 _entityId,
    bytes32[] calldata _merkleProof,
    bytes calldata _signature,
    string calldata _uri,
    bytes calldata _salt,
    bool _directUpdateEnabled
  ) external payable

  /** IMintWhitelist */
  //Mints an NFT with a specified variation ID to the sender's address and subscribes it to an entity, validated by Merkle proof.
  function subscriptionMint(
    bytes32[] calldata _merkleProof,
    uint256 _variationId,
    uint256 _entityId,
    bool _directUpdateEnabled
  ) external payable

Parameters:

Name	Type	Description
_variationId	uint256	The variation ID of the NFT to be minted.
_entityId	uint256	The ID of the entity for the subscription.
_signature	bytes	The signature for verification.
_uri	string	The URI for the NFT.
_salt	bytes	The salt used in signature verification.
_merkleProof	bytes32[]	An array representing the Merkle proof for whitelist verification.
_directUpdateEnabled	bool	A flag indicating whether direct updates are enabled for the entity slot.

+++++++++++++++++++++++++

mint

  function mint(uint256 _variationId) external payable

Mints a new token with the specified variation ID.

Parameters:

Name	Type	Description
_variationId	uint256	The ID of the token variation to mint.

mintBatch

  function mintBatch(uint256[] calldata _variationIds) external payable

Mints new tokens with the specified variation IDs.

Parameters:

Name	Type	Description
_variationIds	uint256[]	The IDs of the token variations to mint.

subscribeToEntity

  function subscribeToEntity(
    address _owner,
    uint256 _tokenId,
    uint256 _entityId,
    string calldata _entityDefaultUri
  ) external

Adds a single URI slot to a single non-fungible token (NFT) and initializes the added slot with the given entity's default URI. So that, token owner subscribes to the entity.Entity owner can change the URI of the slot. The added slot's initial state will be pre-filled with the entity's default URI.

Parameters:

Name	Type	Description
_owner	address	The address of the token owner.
_tokenId	uint256	The ID of the token to which the slot will be added.
_entityId	uint256	The ID of the slot's entity.
_entityDefaultUri	string	The entity's default URI that will be set to the added slot.

subscribeToEntities

  function subscribeToEntities(
    address _owner,
    uint256 _tokenId,
    uint256[] calldata _entityIds,
    string[] calldata _entityDefaultUris
  ) external

Adds multiple URI slots to a single token in a batch operation. So that, token owner subscribes to the entity.Entity owner can change the URI of the slot. Slots' initial state will be pre-filled with the given default URI values.

Parameters:

Name	Type	Description
_owner	address	The address of the token owner.
_tokenId	uint256	The ID of the token to which the slots will be added.
_entityIds	uint256[]	An array of IDs for the slots that will be added.
_entityDefaultUris	string[]	An array of default URI values for the added slots.

updateURISlot

  function updateURISlot(
    address _owner,
    uint256 _entityId,
    uint256 _tokenId,
    string calldata _updatedUri
  ) external

Updates the URI of a token's entity slot.

Parameters:

Name	Type	Description
_owner	address	The address of the token owner.
_entityId	uint256	The ID of the entity slot.
_tokenId	uint256	The ID of the token.
_updatedUri	string	The updated URI for the entity slot.

directUpdateURISlot

 function directUpdateURISlot(
    uint256 _entityId,
    uint256 _tokenId,
    string calldata _updatedUri
  ) external

Updates the URI of a token's entity slot without checking the owner.Only the Subscribed entity owner can change the URI of the slot.

Parameters:

Name	Type	Description
_entityId	address	The ID of the subscribed entity.
_tokenId	uint256	The ID of the NFT.
_updatedUri	string	The updated URI for the entity slot.

directUpdateURISlots

 function directUpdateURISlots(
    uint256 _entityId,
    uint256[] calldata _tokenIds,
    string[] calldata _updatedUris
  ) external

Updates the URI of a token's entity slot without checking the owner.Only the Subscribed entity owner can change the URI of the slot.

Parameters:

Name	Type	Description
_entityId	address	The ID of the subscribed entity.
_tokenIds	uint256[]	The IDs of the entity slot.
_updatedUris	string[]	The updated URI for the entity slot.

transferTokenEntityURI

 function transferTokenEntityURI(
    address _owner,
    uint256 _tokenId,
    uint256 _entityId,
    string calldata _transferredUri
  ) external

Updates the URI of a token's entity slot.

Parameters:

Name	Type	Description
_owner	address	The address of the token owner.
_tokenId	uint256	The ID of the token.
_entityId	uint256	The ID of the entity slot.
_transferredUri	string	The new URI for the entity slot.

resetSlotToDefault

  function resetSlotToDefault(
    address _owner,
    uint256 _tokenId,
    uint256 _entityId,
    string calldata _entityDefaultUri
  ) external

Resets the URI of a token's entity slot to its default value.

Parameters:

Name	Type	Description
_owner	address	The address of the token owner.
_tokenId	uint256	The ID of the token.
_entityId	uint256	The ID of the entity slot.
_entityDefaultUri	string	The default URI for the entity slot.

transferOwnership

  function transferOwnership(address newOwner) public override;

Transfers the ownership of the collection to a new owner.

Parameters:

Name	Type	Description
_owner	address	The address of the new owner.

transferCollectionOwnership

 function transferCollectionOwnership(address newOwner) external;

Transfers the ownership of the collection to a new account.

Parameters:

Name	Type	Description
newOwner	address	The address of the new owner.

withdraw

  function withdraw() external

Allows owners to withdraw their funds from the contract.

protocolWithdraw

  function protocolWithdraw() external

Allows authorized parties to withdraw funds from the contract.

tokenEntityURI

 function tokenEntityURI(uint256 _tokenId, uint256 _entityId) external view returns (string memory)

Returns the entity URI for the given token ID and entity ID.

Parameters:

Name	Type	Description
_tokenId	address	The ID of the token whose entity URI is to be returned.
_entityId	address	The ID of the entity associated with the given token.

Return Values:

Type	Description
string	The URI of the given token's entity slot.

getCollectionInfo

function getCollectionInfo()
    external
    view
    returns (
      uint256 entityId,
      uint64 collectionId,
      uint8 mintType,
      uint8 mintPerAccountLimit,
      bool isWhitelisted,
      bool isFree,
      uint256 templateId,
      uint256 mintCount,
      uint256 totalSupply,
      uint256 mintPrice,
      string[] memory collectionURIs,
      address verifier
    )

Returns the information about the collection.

Return Values:

Name	Type	Description
entityId	uint256	The ID of the entity.
collectionId	uint64	The ID of the collection.
mintType	uint8	The type of minting.
mintPerAccountLimit	uint8	The maximum number of mints per account.
isWhitelisted	bool	A flag indicating if the collection is whitelisted.
isFree	bool	A flag indicating if the collection is free.
templateId	uint256	The ID of the template.
mintCount	uint256	The number of mints.
totalSupply	uint256	The total supply of tokens.
mintPrice	uint256	The price of minting.
collectionURIs	string[]	An array of collection URIs.
verifier	address	The address of the verifier.

Return Values:

Type	Description
string	The URI of the given token's entity slot.

getRoyaltyInfo

  function getRoyaltyInfo()
    external
    view
    returns (
      uint256 royalty,
      uint256 withdrawnAmountByOwner,
      uint256 withdrawnAmountByProtocol,
      uint256 savedAmountOwner,
      uint256 totalWithdrawn
    )

Returns information about the royalty configuration and amounts.

Return Values:

Name	Type	Description
royalty	uint256	The royalty percentage set for the protocol.
withdrawnAmountByOwner	uint256	The total amount withdrawn by the owner.
withdrawnAmountByProtocol	uint256	The total amount withdrawn by the protocol.
savedAmountOwner	uint256	The amount saved by the owner.
totalWithdrawn	uint256	The total amount withdrawn overall.

getTokenSubscriptionInfo

function getTokenSubscriptionInfo(
    uint256 _tokenId,
    uint256 _entityId
  ) external view returns (
    bool isSubscribed,
    string memory uri,
    bool directUpdateEnabled
  )

Retrieves subscription information for a specific token and entity.

Parameters:

Name	Type	Description
_tokenId	uint256	The ID of the token.
_entityId	uint256	The ID of the slot's entity.

Return Values:

Name	Type	Description
isSubscribed	bool	A boolean value indicating whether the entity is subscribed to the token (true = subscribed, false = not subscribed).
uri	string	A string representing the URI associated with the subscription, typically pointing to relevant resources or metadata. owner.
directUpdateEnabled	bool	A boolean flag indicating if direct updates are enabled for this subscription.

getProtocolBalance

function getProtocolBalance() external view returns (uint256)

Returns the balance of the protocol.

Return Values:

Type	Description
uint256	The balance of the protocol after deducting the owner's saved amount and calculating the royalty.

getOwnerBalance

 function getOwnerBalance() external view returns (uint256)

Returns the balance of the owner.

Return Values:

Type	Description
uint256	The balance of the owner after deducting the owner's saved amount and calculating the royalty.

getProtocolRoyalty

 function getProtocolRoyalty() external view returns (uint256)

Returns the royalty percentage set for the protocol.

Return Values:

Type	Description
uint256	The royalty percentage for the protocol.