Skip to main content

Create an Airdrop

Overview​

This guide explains how to use the Pinksale Airdrop feature to distribute your project tokens to a specified list of wallet addresses. This is commonly used for rewarding communities, running contests, or distributing initial allocations. Reading this will help you:

  • Understand the Pinksale Airdrop creation process step-by-step.
  • Know how to input token details and required information (Title, Logo, Website), including using the AI Logo Generator.
  • Learn how to prepare and upload the list of recipient addresses and amounts.
  • Optionally configure a vesting schedule for the airdropped tokens using the specific parameters.
  • Understand the pre-requisites like excluding fees and finalizing your main presale pool.
  • Know how to start the airdrop distribution.
  • See how recipients can claim their airdropped tokens.

Disclaimer: Please be advised, that once you have committed tokens to the airdrop (by starting it), it cannot be cancelled or reconfigured to reduce the amount of tokens committed. Please ensure that you have correctly allocated the number of tokens and set up recipients accurately before starting the airdrop.

Step 1: Navigate to Airdrop Creation​

Go to https://www.pinksale.finance/airdrop/create

Create An Airdrop 1

Step 2: Input Token Address​

Connect your wallet. Paste your project's token address into the "Token address" field. The token name, symbol, and decimals should appear automatically. Verify they are correct and click "Next".

Create An Airdrop 2

Step 3: Input Airdrop Information​

Provide basic details for your airdrop event:

  • Airdrop Title (optional): A descriptive name for this airdrop (e.g., "Join my pinksale airdrop").
  • Logo: You need a logo. Options:
    • Use Pinksale AI Generator: Click "use AI" to generate a logo using AI.
    • Provide Logo URL: Paste a direct link to your own logo image by clicking "manually input". The URL must end with .png, .jpg, .jpeg, or .gif and be less than 2Mb.
  • Website: Your project's website URL.
  • Fill in other social media links as needed (Facebook, Twitter, Github, Telegram, Instagram, Discord, Reddit).
  • Add a description (optional).

Create An Airdrop 3

Click "Create New Airdrop".

Create An Airdrop 4

Confirm the transaction in your wallet (e.g., MetaMask) and pay the network fee.

Step 4: Airdrop Management Page​

You will be redirected to the management page for your newly created (but not yet started) airdrop.

Create An Airdrop 5

Step 5: Set Allocations (Recipients & Amounts)​

  • Prepare your list of recipient wallet addresses and the amount of tokens each should receive. The format is: Address,Amount on each new line.
    • Example: 
      0xA4D1AcB4156539617bF54768C3854fA8b60EDa21,1000
      0x7c2dc5B018fF8fCc236964D6aEd800Dc4d1C676A,500
      0x9aA1012A3D3Bd85C93B0ECb16175d11917399682,2000
  • Click the "Set Allocations" button on the management page.

Create An Airdrop 6

  • Paste your prepared list into the pop-up box.

Create An Airdrop 7

  • Click "Add Allocations".
  • Confirm the transaction in your wallet and pay the network fee.

Step 6: View Allocations​

After the transaction confirms, the added allocations will be displayed on the airdrop management page.

Step 7: (Optional) Set Vesting​

If you want recipients to claim their airdropped tokens over time instead of all at once, click "Set Vesting".

  • Configure the parameters in the pop-up. Below are some important parameters:
    • TGE release percent (%): The percentage of the first batch of airdrop tokens to be released. Please note that this is expressed in percentage, not number of tokens.
    • Cycle release percent (%): How many % of airdrop tokens will be released each cycle following the first TGE release percent batch. Please note this is expressed in percentage, not in number of tokens.
    • Cycle (minutes): How long, in minutes, between each batch of vested tokens is released.

Create An Airdrop 8

Example: An airdrop participant has 1000 tokens to be vested in total, 40% to be released at TGE, and 20% unlocks every month afterwards for a total of 3 cycles (30 minutes each cycle). Let's imagine that your presale on Pinksale ended on the 5th of January, your airdrop participant can claim 1000 x 40% = 400 tokens after your token has been listed. Every month afterwards on the 5th of February, March and April, he can claim the next batches, 1000 x 20% = 200 tokens each batch. In this case you would enter the following information:

  • TGE release percent (%): 40
  • Cycle release percent (%): 20
  • Cycle (minutes): 30

Click on "Set Vesting" when you are done inputting the numbers, then MetaMask will now ask you to confirm the transaction. It will also show you the fee that you are required to pay for that transaction. If you agree, then click on the "Confirm" button to finish the process.

Step 8: (Optional) Remove Allocations​

You can remove allocations by clicking on "Remove All Allocations" before starting the airdrop.

Step 9: Exclude Fees (If Applicable)​

CRITICAL STEP: Before starting the airdrop, you must exclude fees, dividends, max tx for the airdrop address (find this on your airdrop page) in your token contract if it has these features.

Step 10: Prerequisite: Finalize Presale​

You only can start the airdrop once you successfully finalized your main presale pool (if applicable).

Step 11: Start the Airdrop​

  • After your presale is finalized, go to your airdrop page via this link structure: https://www.pinksale.finance/#/airdrops/own -> "Created By You" -> "View Airdrop".

Create An Airdrop 9

  • Then click on "Start Airdrop".

Step 12: Confirm Start & Approve Tokens​

  • You will see how many tokens will be used for the airdrop here (total airdrop tokens + 1% fee).
  • Choose to Start Now or set a specific Start Time.

Create An Airdrop 10 Create An Airdrop 11

  • Click "Approve". Confirm the token spending approval transaction in your wallet and pay the gas fee.
  • After approval, click the final "Start" (or similar confirmation) button on the Pinksale page and confirm the last transaction in your wallet.

How Recipients Claim Airdrop Tokens​

Airdrop participants must manually claim their tokens:

  1. Navigate to Claims: Recipients go to https://www.pinksale.finance/#/airdrops/my, connect their wallet, and look under the "My Airdrops" section.

Create An Airdrop 12

  1. Check & Claim: Find the specific airdrop entry. Check the claimable tokens available based on the vesting schedule (if any) and click the "Claim" button.
  2. Confirm Transaction: Confirm the transaction in their wallet (e.g., MetaMask) and pay the network gas fee to receive the tokens.

(Link Analysis: All provided links appear structurally valid and relevant. No obvious duplicates or broken links detected.)

Q&A (FAQs)​

  • Q1: Can I edit the recipient list or amounts after clicking "Add Allocations"?

    • A: Check the current Pinksale UI for edit options before starting the airdrop. Historically, it might require removing all and re-uploading. Once started, allocations are locked.

  • Q2: Is vesting required for an airdrop?

    • A: No, setting a vesting schedule (Step 7) is optional. Without vesting, recipients can claim 100% once the airdrop starts.

  • Q3: What happens if my token has fees and I forget to exclude the airdrop address?

    • A: The "Start Airdrop" transaction or user claim transactions will likely fail because the fees interfere with the token transfers. Excluding the airdrop address is crucial.

  • Q4: Can I cancel the airdrop after clicking "Start Airdrop"?

    • A: No. As stated in the disclaimer, once started and tokens are committed, it cannot be cancelled or reduced. Double-check everything beforehand.

Troubleshooting​

  • Q: My "Create New Airdrop" or "Add Allocations" transaction failed.

    • A: Ensure enough native currency (BNB, ETH, etc.) for gas fees. Check input data validity (addresses, allocation format, Logo URL format).

  • Q: I get an error when trying to "Start Airdrop".

    • A: Verify your main presale (if related) is finalized. Confirm you excluded the airdrop address from fees/limits in your token contract (Step 9). Ensure the starting wallet holds enough project tokens (total allocation + 1% fee) and has approved spending.

  • Q: Recipients report they cannot claim their tokens.

    • A: Ensure the airdrop has started. If vested, check if the TGE/cycle date has passed. Confirm the recipient uses the correct whitelisted wallet address. Ensure they have enough native currency for gas fees.