Search…
Example Module

NFTXEligibility

This is a contract is intended to be inherited and overridden when creating an eligibility module. The functions outlined will be called throughout the NFTX vault journey and this abstract contract provides a number of helper functions.

Public Methods

The following are a collection of understood functions that should be defined in your implementation.

name

function name() public pure virtual returns (string)
Defines the constant name of the eligibility module.
Try to keep the naming convention of the eligibility module short, but desciptive as this will be displayed to end users looking to implement it.
Name
Type
Description
[0]
string
The name of the eligibility module

finalized

function finalized() public view virtual returns (bool)
If the eligibility has been finalized then it can no longer be updated, meaning the processing logic can no longer be modified and it is safe to use.
Name
Type
Description
[0]
bool
If the eligibility module is finalized

targetAsset

function targetAsset() public pure virtual returns (address)
Allows the module to define an asset that is targetted. This can be subsequently used for internal calls to reference the token address being queried.
This is not a required field, and can just return address(0) if no subsequent use is needed.
Name
Type
Description
[0]
address
The address of the asset being referenced by the module

__NFTXEligibility_init_bytes

function __NFTXEligibility_init_bytes(bytes initData) public virtual
Called when initialising the eligibility module, allowing configuring data to be passed and initial module contract setup to be performed.
If no further configuration is required, then we can just omit providing the bytes with an attribute name and ignore any calculation.
Name
Type
Description
initData
bytes
This allows for abi encoded bytes to be decoded when initialised and allow the module implementation to vary based on the vault's requirements.

checkIsEligible

function checkIsEligible(uint256 tokenId) external view virtual returns (bool)
Checks if a tokenId is eligible to be received by the vault.
Name
Type
Description
tokenId
uint256
A tokenId to check the eligibility of
Name
Type
Description
[0]
bool
True if the tokenId is eligible to be received by the module's logic for the vault, and False if it is not.

checkEligible

function checkEligible(uint256[] tokenIds) external view virtual returns (bool[])
Checks if an array of tokenIds are eligible to be received by the vault.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds to check the eligibility of
Name
Type
Description
[0]
bool[]
True if the tokenId is eligible to be received by the module's logic for the vault, and False if it is not. The array of booleans will follow the same order as the tokenIds were passed.

checkAllEligible

function checkAllEligible(uint256[] tokenIds) external view virtual returns (bool)
Checks if all tokenIds in an array are eligible to be received by the vault.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds to check the eligibility of
Name
Type
Description
[0]
bool
True if all tokenIds are eligible to be received by the module's logic for the vault, and False if any are not.

checkAllIneligible

function checkAllIneligible(uint256[] tokenIds) external view virtual returns (bool)
Checks if all provided NFTs are NOT eligible. This is needed for mint requesting where all NFTs provided must be ineligible.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds to check the eligibility of
Name
Type
Description
[0]
bool
True if none tokenIds are eligible to be received by the module's logic for the vault, and False if any are.

beforeMintHook

function beforeMintHook(uint256[] tokenIds) external virtual
Called before tokenIds are minted into the NFTX vault.
This function is not currently implemented in the NFTX Vault.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds

afterMintHook

function afterMintHook(uint256[] tokenIds) external virtual
Called after tokenIds have been minted into the NFTX vault.
This function is not currently implemented in the NFTX Vault.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds

beforeRedeemHook

function beforeRedeemHook(uint256[] tokenIds) external virtual
Called before tokenIds are redeemed from the NFTX vault.
This function is not currently implemented in the NFTX Vault.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds

afterRedeemHook

function afterRedeemHook(uint256[] tokenIds) external virtual
Called after tokenIds are redeemed from the NFTX vault.
Name
Type
Description
tokenIds
uint256[]
An array of tokenIds

_checkIfEligible

function _checkIfEligible(uint256 _tokenId) internal view virtual returns (bool)
Contains logic to determine if a tokenId is eligible to be handled by the NFTX vault.
This is the minimum required logic to be processed in order to create a functioning eligibility module.
Name
Type
Description
_tokenId
uint256
A tokenId to check the eligibility of
Name
Type
Description
[0]
bool
A boolean representation of the eligibility of the tokenId