Whitelisting with Proof-of-ownership

4 min readJul 1, 2021

Creators and collection owners, in general, are always looking for ways to make NFT drops for humans and not for bots.

Currently, they have secure drops to help them achieve this goal.

To further help artists achieve their goals, we have added an extra filtering option to the secure drops: proof-of-ownership whitelisting.

But… What is it about?

Well, the concept is very simple. If a collector wants to participate in the drop they must own something required by the artist.

Creators can require buyers to hold four different types of things:

  • random NFTs from one or many collections
  • random NFTs from a specific schema in a collection
  • specific NFTs from one of many collections
  • a certain amount of a token

Let’s go through some examples.

As a very simple case, an artist could require that buyers hold at least 5 NFTs from his collection for people to participate in the drop. If someone wants to use multiple wallets to claim in this drop, he will have to own enough assets from the collection to fulfill the requirement with each wallet. Or take the time to move his assets from one wallet to the other to be able to claim the drop.

Another case could be two collections wanting to launch a collaboration. In that case, two whitelisting rules could be added, requiring buyers to hold at least 2 NFTs from each collection.

And it doesn’t stop there. Imagine that you have a game that has an in-game currency. You can even configure your drops so that only wallets holding at least a certain amount of the in-game currency can participate.

Proof of ownership whitelisting opens many possibilities.

Let’s dig a little bit into how to configure it.

Once you have configured a secure drop, you will see a “certificate” icon appearing at the bottom of your drop, next to the whitelist and key icons.

This might be a good moment to remind you that we strongly recommend using only one whitelisting mechanism at a time.

When pressing the icon, you will be redirected to the Proof-of-ownership whitelisting configuration screen.

The first step in the configuration is defining how whitelisting rules will be evaluated. There are two options: ‘All’ and ‘Any’. If you select ‘All’ the evaluation engine will require that all the rules you define are fulfilled. It acts like an AND operator.

If you select ‘Any’ as long as one rule is fulfilled the buyer will be allowed to claim. It acts like an OR operator.

Now that the rules evaluation mode is defined you can start adding rules. You can add up to 10 rules.

When configuring a rule, the first thing to decide is the type of whitelisting that you want to apply.

There are four options:

  • NFT(s) from collection
  • NFT(s) from template
  • NFT(s) from schema
  • Balance from token

Depending which option you select the configuration will be slightly different. Here I will outline the most important options.

There are two options to define the amount of NFTs that the wallet must hold:

  • At least
  • More than

The difference between ‘At least’ and ‘More than’ is that the former is equivalent to saying greater than or equal while the latter is equivalent to saying greater than.

Note: The maximum amount of NFTs to check within all the rules is 100. You must not exceed it.

Finally, depending on the type of whitelisting that you choose, you have to specify a collection, a collection and a schema, a template, or a token contract, the token precision and its symbol.

The first three options are very straightforward. Let’s focus on the third option for a moment.

Let’s say that you want to create a drop exclusively for those who hold more than a certain amount WAX. Then you will have to specify the WAX token contract, which is eosio.token. The precision of the token is 8 and the symbol WAX. When configuring this type of whitelisting you will have to do some research to identify the correct contract.

When people get to the drops and don’t fulfill the conditions, they will see a warning message.

It is your responsibility to explain the rules in your drop description as there is no other way for the buyer to know about the conditions.

And this is Proof-of-ownership whitelisting in a nutshell. We hope you find it useful!

If you have any questions or suggestions please join our Discord and we will be happy to chat with you!




Making tools to simplify managing collections on the WAX Blockchain.