# AirdropERC1155

The [AirdropERC1155 contract](https://dexappbuilder.dexkit.com/forms/deploy/thirdweb/AirdropERC1155) 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**

{% embed url="<https://dexappbuilder.dexkit.com/forms/deploy/thirdweb/AirdropERC1155>" %}
Direct link
{% endembed %}

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FEgl8j5K9g23C8IV48qjw%2Fimage.png?alt=media&#x26;token=9093eed0-8bae-423d-851e-6a1c23145f87" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FqmcwP6O41sZtldKGIofH%2Fimage.png?alt=media&#x26;token=0ed531da-3257-441f-bd81-a04b647b58c4" alt=""><figcaption></figcaption></figure>

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.

{% hint style="warning" %}
Note: This contract does **not** have an embeddable UI. Interaction is handled entirely from the administrative interface.
{% endhint %}

### Airdrop Tab (Edition NFT Distribution)

The airdrop workflow is designed for simplicity and efficiency.

#### **Step-by-step Instructions:**

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FGQZMO1g7U9A5lO4dorp0%2Fimage.png?alt=media&#x26;token=7c1ca528-ab85-4343-8cb3-5f368dcbfa9c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FeoHRDOS3uSSQZB3Pk7oB%2Fimage.png?alt=media&#x26;token=4db56dbf-eb98-48d4-a0ec-1e9e85a006e1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FZpg9T9R5XpJxLfrZ9J8K%2Fimage.png?alt=media&#x26;token=58a5ee20-193d-4c1c-928e-d8ea7ff0055d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2Fp6LNbSAIKn2kzNOflKVw%2Fimage.png?alt=media&#x26;token=3e940399-0241-43d6-a5ee-29593979e1a1" alt=""><figcaption></figcaption></figure>

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

```
CopyEditrecipient,tokenId,amount
```

5. **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  
```

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

{% hint style="warning" %}
**Important:** Make sure the token owner has granted the AirdropERC1155 contract permission to transfer NFTs using `setApprovalForAll` on the ERC1155 contract
{% endhint %}

### Metadata Tab

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FTmUCKrmuVBNOsvWPwMYm%2Fimage.png?alt=media&#x26;token=a6a457d7-a116-43d4-bf30-e6f483391dd5" alt=""><figcaption></figcaption></figure>

* **Editable Fields**: Name, Description, and Image.
* These fields help personalize the contract's public metadata.
* Changes may require a blockchain transaction.

### Admin Tab

<figure><img src="https://1167648080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWrjgYUyO4ch1fBehrMEq%2Fuploads%2FG7paLh24WbYbleJMP5vq%2Fimage.png?alt=media&#x26;token=2f414271-6ef4-431b-85db-fba060525f72" alt=""><figcaption></figcaption></figure>

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.