AirdropERC1155

Airdrop ERC1155 NFTs to a list of recipients.

The AirdropERC1155 contract by Thirdweb offers a seamless solution for distributing ERC1155 NFTs to a predefined list of recipients. Ideal for scenarios where recipients do not need to individually claim their airdrop, this contract streamlines the process through efficient token transfers.

Key Features

  1. Batch Airdropping: Allows for the simultaneous transfer of multiple ERC1155 NFTs to various recipient addresses, enhancing the efficiency of large-scale distributions.

  2. Flexible Token Distribution: Specify the token collection (Edition) address, owner address, and an array of recipient addresses with associated token IDs and amounts, providing flexibility in airdrop configurations.

  3. Automated Process: Recipients automatically receive the ERC1155 NFTs through a transfer mechanism, eliminating the need for manual claiming.

Airdrop Process

  1. Specify the Edition (ERC-1155 contract) address from which NFTs will be transferred.

  2. Provide the owner address of the NFTs for the transfer process.

  3. Create an array of recipient objects with recipient addresses, token IDs, and corresponding amounts.

  4. Ensure token owners approve the airdrop contract by calling the necessary approval-related functions on the ERC1155 contract.

Use Cases

  1. Gaming Ecosystems:

    • Use Case: Game developers can airdrop in-game assets to players, promoting engagement and enhancing the overall gaming experience.

  2. Tokenized Events:

    • Use Case: Tokenize event-specific NFTs and distribute them to attendees seamlessly using the AirdropERC1155 contract.

  3. Digital Collectibles Campaigns:

    • Use Case: Launch digital collectibles campaigns by distributing unique ERC1155 NFTs to a targeted audience, fostering a sense of exclusivity.

  4. Educational Rewards:

    • Use Case: Educational platforms can reward students with ERC1155 NFTs as digital certificates, recognizing their achievements.

  5. Collaborative Art Projects:

    • Use Case: Collaborative art projects can distribute joint NFTs to contributors, providing an automated and fair distribution mechanism.

  6. Virtual Real Estate Ownership:

    • Use Case: Platforms dealing with virtual real estate can distribute ERC1155 tokens representing ownership shares to investors through airdrops.

Deploying this contract

During deployment, the AirdropERC1155 contract requires the following parameters:

  1. Contract Metadata:

    • Name: [Enter Contract Name]

    • Symbol: [Enter Contract Symbol]

    • Description: [Enter Contract Description]

    • Image: [Upload Image File]

Using the AirdropERC1155 Contract

Once deployed via DexContracts, the AirdropERC1155 contract provides a dashboard to manage the distribution of ERC1155 NFTs (also known as editions) to multiple recipients. This contract is ideal for distributing fungible or semi-fungible NFT assets in a batch process.

Note: This contract does not have an embeddable UI. Interaction is handled entirely from the administrative interface.

Airdrop Tab (Edition NFT Distribution)

The airdrop workflow is designed for simplicity and efficiency.

Step-by-step Instructions:

  1. Access the Airdrop Interface Click Manage Contract after deployment to open the dashboard.

  1. Select Edition Collection Click SELECT in the "Your Editions" box to pick the ERC1155 collection from which tokens will be transferred.

  1. Select Recipient List Click SELECT in the "Total recipients" box to open the airdrop manager.

  1. Download the CSV Template Click EXPORT to download the editable CSV template. The correct format includes three columns:

CopyEditrecipient,tokenId,amount

  1. Prepare and Upload Your CSV File

  • Use any spreadsheet tool to fill in the recipient addresses, token IDs, and amounts.

  • Click IMPORT to upload your file.

  • Records will appear in the table with options to review/edit.

Example:

CopyEdit0x1234...abcd, 1, 10  
0xabcd...5678, 3, 5

  1. Confirm Airdrop Once all data is correct, click CONFIRM to execute the transfer. This will require a blockchain transaction.

Important: Make sure the token owner has granted the AirdropERC1155 contract permission to transfer NFTs using setApprovalForAll on the ERC1155 contract

Metadata Tab

  • Editable Fields: Name, Description, and Image.

  • These fields help personalize the contract's public metadata.

  • Changes may require a blockchain transaction.

Admin Tab

Like the other airdrop contracts, AirdropERC1155 supports role-based access control. Roles include:

  • Admin – Full control over role management.

  • Transfer – Can execute token transfers.

  • Minter / Creator – Can mint new editions (if supported).

  • Additional roles: Pauser, Lister, Asset, Unwrap, Factory, Signer, Metadata, Revoke, Migration.

Assign a role by entering the address and clicking ADD, followed by UPDATE to save changes.

Testnet Deployment Notes

  • These examples were run on BNB Smart Chain Testnet, but the contract supports any EVM-compatible network.

  • Ensure testnet tokens (like tBNB) are available for gas.

  • Confirm that your connected wallet has approval rights for the selected Edition contract.

Last updated