How to setup and launch your own airdrop

guides
saturn-toolkit

#1

Table Of Contents

  1. Requirements
    1.1 Before you proceed
  2. How to use airdrop-tool
    2.1 Check node.js has been installed
    2.2 Setting up your JSON Airdrop details file
    2.3 On Ethereum you will need a private node
  3. Launch your airdrop!

1. Requirements:

  1. You need to install node.js, the easiest way is to simple download their installer & follow the steps.
  2. Our airdrop tool is entirely command line based, which means you need to have access to a terminal:
       • If you are on Linux or macOS then probably this is nothing new for you.
       • For Windows users your default terminal is called “Windows Powershell” you can search for it in
        your start menu.
       • Altenatively, I recommend using Hyper as it supports any OS.
  3. You will need a list of wallets to use for your airdrop, if you do not have any you could always consider airdropping Saturn Network’s genesis block investors.

1.1 Before you proceed

  • Our Airdrop Tool will be making transactions for you so will need you to enter in your seed phrase or private key. Consider making a new wallet just for your airdropping needs.
  • If you are doing a token airdrop, then these tokens need to be in your wallet. You will also need some ETH or ETC in your wallet to pay for gas fees.
  • If you have created your wallet in Saturn Wallet or MetaMask, your tokens and coin need to be in Account 1.
  • If you have not already done so, follow our Asset Self Listing guide to submit your token’s logo and additional information: https://github.com/saturn-network/assets

2. How to use our airdrop tool?

We will now go through the correct steps you need to take to make sure your airdrop is setup and executed succesfully using our tool.

2.1 Checking that node.js has been installed & our tool will work

Launch your preferred terminal, and type in the following 3 commands pressing enter between each one:

node -v
npm -v
npx airdrop-tool -h

If everything has been installed correctly then your terminal should look something like this:

What to do if you received an error?
If you are Windows, navigate to Node.js in your Start Menu & click "Install Aditionnal Tools for Node.js" before trying again. For any other OS, please tryreinstalling node.js as outlined here.

2.2 Setting up your Airdrop JSON details file

This file is very important as it sets the wallet addresses to be included in your airdrop and also the amount of tokens or coin they will receive, so open up your favourite text editor and paste in the following & amend as necessary:

You need to save your file as “Your Filename”.json

[
  {
    "address": "WALLET_ADDRESS_ONE",
    "tokens": Amount of tokens/coin taking into account decimals.
  },
  {
    "address": "WALLET_ADDRESS_TWO",
    "tokens": 24934675001
  },
  {
    "address": "WALLET_ADDRESS_THREE",
    "tokens": 20017500004939
  }
]

Remember to take into account your token’s decimals when setting the amount, in the example above if your token has 8 decimals then 24934675001 equals 249.34675001 tokens and 20017500004939 equals 200175.00004939

You can enter in as many wallet addresses as you want, just remember after the last } there is no , before the closing bracket ]. What you can do to quickly make sure your JSON file is in a valid format is to paste it into a json validator like jsonlint.

2.3 For Ethereum You Need To Use A Private Node

If your airdrop is anything bigger than 10 wallets on Ethereum, you will need to use a private node for it to be successful. If you do not have one set up, you can register with infura.io and get one for free.

  1. Sign-up or login and click “Create Project.”
  2. Set up a name for your project.
  3. Copy down the endpoint which will look something like mainnet.infura.io/v3/XXXXXXXXXXXXXX as you will need it in the next section.

3. Launching Your Airdrop!

Now for the fun part, you should now be ready to launch your airdrop and announce it’s completion to your happy community! All in just a couple of minutes, magic? No it’s powered by Saturn Network.

Here is the main command you will need to type into your terminal broken down, remember if you are on Ethereum to include your rpcnode endpoint that you just created with infura:

npx airdrop-tool -c Chain -s Standard -m "Wallet 12 word seed phrase" -t token's contract address -j "Filepath for Airdrop.json" -n rpcnode(optional)

So for example, if I would like to airdrop Saturn Classic which is an ERC223 token on Ethereum Classic and therefore does not need a private node:

npx airdrop-tool -c ETC -s ERC223 -m "Saturn Network Airdrop Suite Tool Is Better Than Sliced Bread Itself Amen" -t 0xac55641cbb734bdf6510d1bbd62e240c2409040f -j "D:\Saturn Network\airdropSATURN.json"

If everything happened successfully then your terminal will display the following:

The bar will show you the progress of your airdrop on your terminal, here we can see my airdrop was very small to 4 wallets. It has marked down 4/4 100% which means that all four transactions have been submitted to the blockchain succesfully.

If you check the wallet address you are using in a blockchain explorer then you should see the transactions being made. Once a transaction is confirmed, it will appear on our website’s airdrop page for your users to claim.

Congratulations! You have succesfully airdropped your tokens, if you have any feedback for how our tool works please let us know here: Airdrop tool feedback & suggestions.

Help! Something went wrong?
Read the error output, though it may look scary in most cases it will tell you what went wrong. For example, it may indicate you do not have enough ETH or ETC to pay for the required gas fees. But if you can't figure it out, feel free to ask & we will be happy to assist you.

Happy Airdropping!


Airdrop Tool Guides
#2

This is the bomb! Fastest, Cheapest and Easiest way to airdrop to your communities!

thanks for this amazing tool guys!
Saturn to the moon!


#3

Wow, very well done team! You guys never fail to impress!