ERC1155 Eligibility

Tying hat eligibility to specific ERC1155 NFT holdings


A Hats eligibility module that makes addresses eligible to wear a given hat only if they have a specified minimum balance for at least one of specific ERC1155 token(s), as identified by contract address and token ID(s). This eligibility module can be configurable to support both single-token criteria as well as multiple-token criteria, where the balance requirement is configurable for each token.

The module's code is open source and is available here.

Adding the module to a hat

  • Go to the tree that includes the hat you wish to create the module for

  • Select "Edit Tree"

  • Locate and select the hat

  • Open the "Revocation & Eligibility" section

  • Choose "Automatically" and then choose "Create new Module". This will open the module creation form

  • Choose "ERC1155 Eligibility" in the module type

  • Fill in the module-specific parameters

  • Choose "Deploy & Return" to deploy the module and return to the hat edit form. The module address will be automatically updated on the hat's eligibility property in the form. Once you deploy these changes, the hat's eligibility will be updated.

Viewing the hat's eligibility criteria

Once the module is attached to the hat, you can view the hat's updated eligibility criteria:

  • Select the hat

  • In the eligibility section, you can view:

    • The module's general description

    • The module's live parameters

      • Token address

      • Token IDs

      • Corresponding minimum balances

    • Useful links

      • The module's source code on GitHub

Last updated