# AirdropERC1155

O [Contrato AirdropERC1155](https://dexappbuilder.dexkit.com/forms/deploy/thirdweb/AirdropERC1155) pela Thirdweb oferece uma solução simplificada para distribuir NFTs ERC1155 a uma lista predefinida de destinatários. Ideal para cenários em que os destinatários não precisam reivindicar individualmente seu airdrop, este contrato agiliza o processo por meio de transferências eficientes de tokens.

## **Principais Recursos**

1. **Airdrop em Lote:** Permite a transferência simultânea de múltiplos NFTs ERC1155 para vários endereços de destinatários, aumentando a eficiência de distribuições em grande escala.
2. **Distribuição Flexível de Tokens:** Especifique o endereço da coleção de tokens (Edition), o endereço do proprietário e um array de endereços de destinatários com IDs de token e quantidades associadas, proporcionando flexibilidade nas configurações do airdrop.
3. **Processo Automatizado:** Os destinatários recebem automaticamente os NFTs ERC1155 através de um mecanismo de transferência, eliminando a necessidade de reivindicação manual.

## **Processo de Airdrop**

1. Especifique o endereço da Edition (contrato ERC-1155) a partir do qual os NFTs serão transferidos.
2. Forneça o endereço do proprietário dos NFTs para o processo de transferência.
3. Crie um array de objetos de destinatários com endereços dos destinatários, IDs de token e quantidades correspondentes.
4. Garanta que os proprietários dos tokens aprovem o contrato de airdrop chamando as funções necessárias relacionadas à aprovação no contrato ERC1155.

## **Casos de Uso**

1. **Ecossistemas de Jogos:**
   * **Caso de Uso:** Desenvolvedores de jogos podem fazer airdrops de ativos dentro do jogo para os jogadores, promovendo engajamento e melhorando a experiência geral de jogo.
2. **Eventos Tokenizados:**
   * **Caso de Uso:** Tokenize NFTs específicos de eventos e distribua-os aos participantes de forma contínua usando o contrato AirdropERC1155.
3. **Campanhas de Colecionáveis Digitais:**
   * **Caso de Uso:** Lance campanhas de colecionáveis digitais distribuindo NFTs ERC1155 únicos para um público-alvo, fomentando um senso de exclusividade.
4. **Recompensas Educacionais:**
   * **Caso de Uso:** Plataformas educacionais podem recompensar alunos com NFTs ERC1155 como certificados digitais, reconhecendo suas conquistas.
5. **Projetos de Arte Colaborativa:**
   * **Caso de Uso:** Projetos de arte colaborativa podem distribuir NFTs conjuntos aos colaboradores, fornecendo um mecanismo de distribuição automatizado e justo.
6. **Propriedade de Imóveis Virtuais:**
   * **Caso de Uso:** Plataformas que lidam com imóveis virtuais podem distribuir tokens ERC1155 que representam participações de propriedade a investidores por meio de airdrops.

## **Implantando este contrato**

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

<figure><img src="https://1903426557-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>

Durante a implantação, o contrato AirdropERC1155 requer os seguintes parâmetros:

1. **Metadados do Contrato:**
   * **Nome:** \[Insira o Nome do Contrato]
   * **Símbolo:** \[Insira o Símbolo do Contrato]
   * **Descrição:** \[Insira a Descrição do Contrato]
   * **Imagem:** \[Carregar Arquivo de Imagem]

## Usando o Contrato AirdropERC1155

<figure><img src="https://1903426557-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>

Uma vez implantado via DexContracts, o **AirdropERC1155** contrato fornece um painel para gerenciar a distribuição de NFTs ERC1155 (também conhecidos como editions) para múltiplos destinatários. Este contrato é ideal para distribuir ativos NFT fungíveis ou semifulngíveis em um processo em lote.

{% hint style="warning" %}
Observação: Este contrato **não** possui uma interface incorporável. A interação é tratada inteiramente a partir da interface administrativa.
{% endhint %}

### Aba Airdrop (Distribuição de NFT da Edition)

O fluxo de trabalho do airdrop é projetado para simplicidade e eficiência.

#### **Instruções passo a passo:**

<figure><img src="https://1903426557-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. **Acesse a Interface de Airdrop**\
   Clique **Gerenciar Contrato** após a implantação para abrir o painel.

<figure><img src="https://1903426557-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. **Selecione a Coleção Edition**\
   Clique **SELECIONAR** na caixa "Suas Editions" para escolher a coleção ERC1155 da qual os tokens serão transferidos.

<figure><img src="https://1903426557-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. **Selecione a Lista de Destinatários**\
   Clique **SELECIONAR** na caixa "Total recipients" para abrir o gerenciador de airdrop.

<figure><img src="https://1903426557-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. **Baixe o Modelo CSV**\
   Clique **EXPORTAR** para baixar o modelo CSV editável. O formato correto inclui três colunas:

```
CopyEditrecipient,tokenId,amount
```

5. **Prepare e Envie Seu Arquivo CSV**

* Use qualquer ferramenta de planilha para preencher os endereços dos destinatários, IDs de token e quantidades.
* Clique **IMPORTAR** para enviar seu arquivo.
* Os registros aparecerão na tabela com opções para revisar/editar.

Exemplo:

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

6. **Confirmar Airdrop**\
   Uma vez que todos os dados estejam corretos, clique **CONFIRMAR** para executar a transferência. Isso exigirá uma transação na blockchain.

{% hint style="warning" %}
**Importante:** Certifique-se de que o proprietário do token tenha concedido ao contrato AirdropERC1155 permissão para transferir NFTs usando `setApprovalForAll` no contrato ERC1155
{% endhint %}

### Aba de Metadados

<figure><img src="https://1903426557-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>

* **Campos Editáveis**: Nome, Descrição e Imagem.
* Esses campos ajudam a personalizar os metadados públicos do contrato.
* As alterações podem exigir uma transação na blockchain.

### Aba Admin

<figure><img src="https://1903426557-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>

Como os outros contratos de airdrop, `AirdropERC1155` suporta controle de acesso baseado em funções. As funções incluem:

* **Administrador** – Controle total sobre o gerenciamento de funções.
* **Transferir** – Pode executar transferências de tokens.
* **Minter / Criador** – Pode cunhar novas editions (se suportado).
* Funções adicionais: Pauser, Lister, Asset, Unwrap, Factory, Signer, Metadata, Revoke, Migration.

Atribua uma função inserindo o endereço e clicando **ADICIONAR**, seguido de **ATUALIZAR** para salvar as alterações.

## Notas sobre Implantação em Testnet

* Estes exemplos foram executados em **Testnet da BNB Smart Chain**, mas o contrato suporta qualquer rede compatível com EVM.
* Certifique-se de que tokens de testnet (como tBNB) estejam disponíveis para o gás.
* Confirme que sua carteira conectada tem direitos de aprovação para o contrato Edition selecionado.