Access Lists

What are Access Lists?

Access Lists are a feature that enables you to determine who is allowed to mint your NFTs. For example, you could create an access list for just members of your Discord community. You could create an access list for just a group of friends. You can even create multiple access lists which can be attached to your smart contract to offer access to your collection in phases e.g. priority mint access, early access, then open up access to the public.

📘

Note: At this point in time, only ERC-721a tokens are compatible with Access Lists.

HyperMint Access Lists

HyperMint's access lists contains the essential functions of listing who has access to mint your NFT collection, and more including:

  • Allowing select groups of addresses to purchase tokens outside of the public buying window
  • Specifying a different price for certain groups to buy your tokens
  • Adjusting limits on the number of tokens allowed to be bought by various groups

How to Setup an Access List

To start setting one up, there are two ways you can create and manage your access list.

  • Self Hosted (hosted by you)
  • Managed Access Lists (hosted by HyperMint)

This page will cover how to use managed access lists via the HyperMint dashboard. For learning how to upload your own self hosted access list externally, visit here for more information.

Access List Types

HyperMint supports two types of access list: Address & Token Owner Snapshots/Token Gating.

Address access lists allow you to provide a static list addresses who are part of the access list and eventually minting on a contract.

Token Owner Snapshot access lists work in a similar way by creating a static list of addresses but can be automatically created from any deployed NFT contract. Once details of the contract have been provided, HyperMint will fetch all unique token owners for the collection to generate the list. The source contract can be one deployed using HyperMint (by selecting it within the create dialog) or an existing contract by providing it's address and token type.

While the current token owners will be collected on creation, you may refresh the snapshot at any time (e.g. a day before your mint) and can download a list of owners directly from the access list page.

Multiple access lists of different types can be added to a single contract giving you the control to create any community drop experience you desire.

📘

Collections created directly on OpenSea are not currently supported as OpenSea uses single contracts to host multiple collections

Creating an Access List

To create a new access list click on the "Access Lists" tab from the left hand navigation bar. You can then select the "Create" button at the top right of the screen. Give it a friendly name and then press the "Create" button:

You can create the list using the following methods:

  • Address List: providing a list of wallet addresses directly
  • Token Owners Live: allow all current owner wallets of a collection to be on the access list and requires an existing HyperMint collection or NFT contract address to be entered
  • Token Owners Snapshot: take a snapshot of all owners of a collection on a specified date and time and add those wallet addresses to the access lists; requires an existing HyperMint collection or NFT contract address to be entered

This access list will then need to be attached to a contract to make it active and allow its associated members to buy your NFTs from the presale window you defined.

Attaching an Access List to a Contract

From the Minting Logistics tab of the ERC-721a contract, you can add or create Access Lists to the contract.

You can now press the "Link Access List" button to attach the access list you created in the previous steps. Use the plus button to select the access list(s) you want to attach to the contract. You'll then notice it appear in this Access Lists pane and has a button you can use to unlink it from the contract if need be.​

📘

This toggle cannot be changed after the contract is deployed so please ensure you are happy with the access list approach before launching your contract.

Congratulations, your Access Lists are created!

Feedback

Something not quite right, unclear or can't find what you are looking for? Please let us know at [email protected] and we will get back to you as soon as we can.