Token Drop

Facilitate the issuance of new ERC20 tokens for a predetermined price.

Introducing Token Drop—an efficient mechanism for releasing your ERC20 tokens at predefined prices. This system enables you to establish the terms under which your users can claim their tokens. These terms include allowlists, release schedules, and claim limits.

Within the Token Drop contract, you can specify the cost of your tokens during each claim phase and set a maximum number of tokens available for release. Other users can then claim these tokens based on the conditions you've defined.

Practical Use Cases & Examples

The Token Drop contract is versatile and can serve various purposes:

• Cryptocurrency Launch: Use the Token Drop contract to launch your new cryptocurrency with a fixed price, like 1 MATIC per token.

• Restricted Access: Prioritize specific wallets by allowing them to claim your ERC20 tokens before making them available to the general public.

• Time-Limited Claims: Enable users to claim tokens until a certain date, fostering a sense of urgency and participation.

• Gradual Distribution: Implement a phased approach to token distribution by adjusting token prices and quantities over different claim phases.

• Community Engagement: Reward active participants by setting up token drops as incentives, encouraging ongoing engagement.

• Special Events: Tailor token drops for specific events or milestones, enhancing community bonding.

Deploying this contract

DexAppBuilderDexAppBuilder

Direct link

• Name: The name for this Token drop according to your idea.

• Symbol: This will be the ticker ($EXAMPLE) for this Token drop. Keep it short.

• Description: You can be creative here because this is the description that this contract will have for the purposes that you have arranged.

• Image: Upload your image for this contract.

• Sale Recipient: This address will receive all the tokens for each sale on the contract that we're about to deploy. The one by default is the connected wallet one. It can be changed for any other one.

• Recipient Address: For contracts involving primary sales, acquire supplementary fees for all primary sales occurring on this contract. (This is advantageous if you are deploying this contract on behalf of a third party and wish to levy fees for your services). If this contract serves as a marketplace, obtain a percentage from all secondary sales taking place within your contract.

• Platform fee percentage: for the supplementary fees above mentioned.

Using this contract

Modal indicating that your contract has been successfully deployed

Once this contract is deployed, the use of a pre-built UI by DexKit will be enabled on the frontend. To use this UI, we must follow the following sequence:

• In the informational modal for your token drop deployment, click the "Manage contract" button. This will take you to the administrative section of your contract.

• In the administrative section you will find several tabs

  1. Token: In this section, you can burn and transfer tokens from the contract. Initially, you won't be able to do this because the contract is empty (no tokens).

     
  2. Claim conditions: This section is the most important because you'll need to define the conditions under which your users can claim the tokens. Let's break this section down.

  

  Let's press the "Add claim condition" button to create our first condition.

  
• Name: First of all, we need to give this phase a name. We can use the words "Initial" or "Genesis" to represent the beginning.

• Start time: Choose the exact date for the start of this initial phase.

• Wait in seconds: This is a timeout in seconds that is applied at the exact moment the drop begins (date defined above). If you don't want to use this timeout, set it to 0.

• Total items to claim: Here you can define the total number of tokens that can be minted. This can be a fixed number or unlimited. Choose your preferred option.

• Total items to claim per wallet: Defines how many tokens each connected wallet can mint.

• Price: Here you can define the value of the tokens per unit.

• Search token: This is a drop-down list to define the token you'll receive in exchange for the tokens you mint. Check out the Importing Tokens documentation so you can add your favorite tokens and see them in this list.

• Add claim condition: You can continue defining conditions for future claims or simply continue with the initial phase. You can create more conditions in the future as needed.

Once you fill out the conditions, press the "Create claim conditions" button and accept the interaction with your wallet.

Once you've completed the first phase setup, you'll notice that the "Create claim conditions" button has changed to allowing you to make last-minute changes to your phase.

1. Metadata: In this section, you can modify your contract's metadata (name, description, and image). Keep in mind that this will cause an on-chain interaction.

1. Admin: This section will allow you to define administrators for this contract, who are those who can grant or revoke roles and modify settings in this contract. You can add as many as you need.

2. Transfer: As its name suggests, this section determines who can transfer tokens in the contract. By default, it includes the administrator address and the address 0x000000000000000000000000000000000000000000 (the default address), which makes token transfers unrestricted as long as the owner is the token. If, as an administrator, you want to stop token transfers, delete this address and only include those authorized for transfer.

Once you've made all the relevant changes in this section, let's proceed to add the visual component to your DApp's page where the drop modal will be located.

Steps to add the visual component

1. Go to the administrative section of your specific DApp. Once there, go to "Layout" → "Pages" → press the "+ New Page" button.

You can also add the component to your "Home" page if you prefer.

1. Let's give our drop page a name in the modal

   

   Hit on «Create»

2. Now click on your newly created page to add the component.

   

3. If you want to use curated section components, click "+Add section" or, if you want to go a step further and customize the entire page, including background and sorting components, press "Add custom section"

   

   For the sake of practicality for this example we will use the cured section.

4. From the list of sections, select DexGenerator contract. This will redirect you to the configuration for that section

1. Here you can select the contract we just deployed, from which we need to take the pre-built UI. Let's click on "DumpsterToken."

   

2. Now we can see the contract and the UI in detail. You can choose between the "Simple" and "Detailed" UI variants.

   

3. Once you've made your choice, click the "Save" button. This will return you to the page you created for the drop, where you'll see the added component.

   

   Click the "Save" button in the bottom right corner to send your changes to production.

4. Now let's take a look at the component. Click the Preview icon (the eye) and an embedded modal will open with a quick preview of your live component.

   

   The rest is up to you (in terms of design). Check out this documentation to learn how to create majestic pages with our predefined sections, or write your own code and make them even more amazing.