All Categories
Contracts
Airdrop Contract Troubleshooting

Airdrop Contract Troubleshooting

How to airdrop NFTs using the Airdrop contract

Last updated on December 11, 2022

Airdropping NFTs to your community is a popular form of providing utility for many NFT-based projects. Using the airdrop contracts, you can airdrop any type of ERC20, ERC721, or ERC1155 tokens.

To get started, here is a quick overview of how to airdrop NFTs.

  • deploy your NFT/token contract and mint tokens
  • deploy airdrop contract
  • approve the airdrop contract in your NFT contract approve or setApprovalForAll function. setApprovalForAll is recommended for airdropping large quantities of NFTs so you don’t have to approve each token ID individually.
  • enter the NFT/token parameters into your airdrop function in your Airdrop contract, and execute.
 
👉
Note: We recommend testing the airdrop contract with a small number of tokens on testnet before executing the full airdrop on mainnet.
 

If you are reaching an error after following these steps, please verify the following:

  • ensure that you have enough funds in your account to pay for gas fees
  • verify that the airdrop contract has been granted approval on the NFT contract. See the image below for an example.
      • setApprovalForAll function on the NFT contract. Enter your staking contract address as an operator and execute.
      setApprovalForAll function on the NFT contract. Enter your staking contract address as an operator and execute.
  • confirm the parameters you’re entering into your airdrop contract meet the required formatting. Some examples:
    • the recipients field requires ["brackets and quotes"] like this → ["0x...","0x...","0x..."]
    • the token ID field requires [brackets] like this → [0,1,2]

Common Airdrop Issues

The three most common issues we see when trying to airdrop are:

  1. NFTs aren’t minted/claimed
  1. Trying to airdrop too many NFTs at once
  1. Airdropping NFTs to invalid wallet addresses
 

NFTs aren’t minted/claimed

In order to airdrop NFTs, you first need to mint them to your wallet. Once you own (at least) the number of NFTs you want to airdrop, then you can perform the airdrop function.

 

Trying to airdrop too many NFTs at once

There are blockchain limitations for how many NFTs can be airdropped in a single transaction. The max is around 100 wallets per airdrop. Therefore, your CSV airdrop list should be split into separate files of max 100 addresses each.

 

Airdropping NFTs to invalid wallet addresses

If you are receiving the following error: execution reverted: ERC1155: transfer to non ERC1155Receiver implementer this means one (or more) of the addresses on your snapshot is not valid wallet address to receive the ERC1155 NFT. Please check your list to remove any addresses that aren’t wallets.

 

Can’t get this working? If you’ve followed the above and still have issues, contact our support team for help.

 
Did this answer your question?
😞
😐
🤩
Importing non-thirdweb contracts into the Dashboard Trouble Claiming from the Embed