Airdrop

The Airdrop template is an audited, ready-to-deploy, airdrop smart contract for ERC-20, ERC-721, ERC-1155, or native tokens. The airdrop is performed by “pushing tokens,” which happens when the contract owner transfers tokens to the receivers’ addresses. Receivers do not need to take any action and do not incur a gas fee.

The following are common use cases for the Airdrop template:

• Bulk token distribution: Automatically distribute tokens to users in bulk. For example, project teams or token issuers can reward their community members, early adopters, and participants in specific campaigns by distributing tokens directly to their blockchain addresses.
• Marketing and promotion: Increase awareness and engagement with a project or token. When a project distributes tokens to a large number of users, this attracts attention and incentivizes users to explore and participate in the project's ecosystem.
• Community building and engagement: Foster a strong and active community around a project. Distribute tokens to community members to incentivize them to stay engaged, participate in discussions, provide feedback, and contribute to the overall growth and success of the project.

Deployment parameters

The Airdrop template creates a customized airdrop smart contract to distribute ERC-20, ERC-721, ERC-1155, or native tokens to multiple users. To create a contract using this template, provide the following parameter values when deploying a smart contract template. To deploy a template, send a POST request to the /templates/{id}/deploy endpoint.

Template ID: 13e322f2-18dc-4f57-8eed-4bddfc50f85e

Template deployment parameters

Common functions

This section lists the most commonly used functions on the Airdrop template, their respective parameters, and potential failure scenarios. These functions include:

• setOwner [write]
• airdropERC1155 [write]
• airdropERC721 [write]
• airdropERC20 [write]
• owner [read]

setOwner [write]

The setOwner function sets the owner of the smart contract or transfers ownership from the existing owner to a new owner.

Parameters

Failure scenarios

• The setOwner function fails if it is called by a non-admin.

airdropERC1155 [write]

The airdropERC1155 function allows the owner of this address to send ERC-1155 tokens to a list of recipients.

Parameters

Failure scenarios

The airdropERC1155 function fails if:

• It is called by a non-admin
• It contains incorrect token information, such as an invalid token ID
• The Airdrop contract is not approved for what’s being transferred, which means it is not authorized to transfer assets on the airdropper's behalf
• Airdropping to a contract without a receive function

Example

The following sample code shows the new owner address and contents when sending a POST request to the /developer/transactions/contractExecution endpoint:

"abiParameters": [
    "0x2B5AD5c4795c026514f8317c7a215E218DcCD6cF",
    [
        ["0x4CCeBa2d7D2B4fdcE4304d3e09a1fea9fbEb1528", 0, 10],
        ["0xf4e2B0fcbd0DC4b326d8A52B718A7bb43BdBd072", 0, 10],
    ]
]

airdropERC721 [write]

The airdropERC721 function allows the owner of this address to send ERC-20 tokens to a list of recipients.

Parameters

Failure scenarios

The airdropERC721 function fails if:

• It is called by a non-admin
• It contains incorrect token information, such as an invalid token ID
• The Airdrop contract is not approved for what’s being transferred, which means it is not authorized to transfer assets on the airdropper's behalf
• Airdropping to a contract without a receive function

Example

The following sample code shows the token address and contents when sending a POST request to the /developer/transactions/contractExecution endpoint:

"abiParameters": [
    "0x2B5AD5c4795c026514f8317c7a215E218DcCD6cF",
    [
        ["0x4CCeBa2d7D2B4fdcE4304d3e09a1fea9fbEb1528", 0],
        ["0xf4e2B0fcbd0DC4b326d8A52B718A7bb43BdBd072", 1],
    ]
]

airdropERC20 [write]

The airdropERC20 function allows the owner of this address to send NFTs to a list of recipients.

Parameters

Failure scenarios

The airdropERC20 function fails if:

• It is called by a non-admin
• The Airdrop contract is not approved for what’s being transferred, which means it is not authorized to transfer assets on the airdropper's behalf
• Airdropping to a contract without a receive function

Example

The following sample code shows the token address and contents when sending a POST request to the /developer/transactions/contractExecution endpoint:

"abiParameters": [
    "0x2B5AD5c4795c026514f8317c7a215E218DcCD6cF",
    "0xd41c057fd1c78805AAC12B0A94a405c0461A6FBb",
    [
        [
        "0x4CCeBa2d7D2B4fdcE4304d3e09a1fea9fbEb1528",
        100
        ]
    ]
]

owner [read]

The owner function retrieves the address of the current owner.

Example

The following sample code shows the owner function when sending a POST request to the /contracts/query endpoint:

"abiFunctionSignature": "owner()"