Problem:

Previously in Ethereum Network, additional tools were required in order to transfer many ERC20 tokens at once. Many people still do this manually, one transaction at a time. This process is time consuming and prone to an error.

Solution:

This Dapp allows a user to send thousands of token transfers in a very effecient way by batching them in groups of 145 token transfers per Ethereum transaction. This automation saves time by automatically generating transactions to MetaMask. Finally, this tool allows a user to maintain security of their account by delegating the trust of their private keys to a secure MetaMask wallet.

How to use:

1. Install Metamask.
2. Make sure you have an account in MetaMask which has a token balance.
3. Make sure your MetaMask is pointed to the network that you would like to use.
4. Make sure your MetaMask account is unlocked.
5. Go to https://jnoodle.github.io/bulkTokenTransfer
6. Wait for the full page to load.
7. Select a token from the dropdown that you would like to send.
8. Provide either JSON or CSV text in the textarea (see example below).
9. Click next.
10. If everything looks good, click next once again.
11. Wait for MetaMask to generate an approval transaction.
12. Once the approval transaction is mined, MetaMask will generate as many transactions as needed for your token transfers (145 addresses per tx).
13. Done!

You can test this tool on any test network, if you want to make sure that everything will work as expected.

Contracts deployed:
Mainnet, Rinkeby, Kovan, Ropsten, Sokol, CORE-POA, BSC Mainnet/Testnet:
ProxyStorage: 0xa5025faba6e70b84f74e9b1113e5f7f4e7f4859f

Example JSON:

[
  {"0xCBA5018De6b2b6F89d84A1F5A68953f07554765e":"12"},
  {"0xa6Bf70bd230867c870eF13631D7EFf1AE8Ab85c9":"1123.45645"},
  {"0x00b5F428905DEA1a67940093fFeaCeee58cA91Ae":"1.049"},
  {"0x00fC79F38bAf0dE21E1fee5AC4648Bc885c1d774":"14546"}
]

Example CSV:

0x476Bb28Bc6D0e9De04dB5E19912C392F9a76535d,0.001
0x68A2558632D2CF5DC9809Ac7f2771e2Eb722218f,0.002
0x703f9037088A93853163aEaaEd650f3e66aD7A4e,0.003
0x651a603a6af9A97ea7b663e3C1CDF2E46e8bd376,0.004


0xCBA5018De6b2b6F89d84A1F5A68953f07554765e,12
0xa6Bf70bd230867c870eF13631D7EFf1AE8Ab85c9,1123.45645
0x00b5F428905DEA1a67940093fFeaCeee58cA91Ae,1.049
0x00fC79F38bAf0dE21E1fee5AC4648Bc885c1d774,14546

Proof of work:
https://etherscan.io/tx/0x2fd09c03609f3f34a326983f1c685ea1bcb87dfcaabc12932dbe38d2c453f2c8
https://kovan.etherscan.io/tx/0x755b84a8a61fd82c1410f6bbbb452c94ddf12fac5b1daaa1496671bcd6e21882

How to setup dev environment

1. git clone [email protected]:jnoodle/bulkTokenTransfer.git
2. cd contracts
3. I used node -v v12.16.1
4. npm install
5. deploy YardAirDrop contract OR use existing deployed version: 0xa5025faba6e70b84f74e9b1113e5f7f4e7f4859f currenty deployed on Kovan, Rinkeby, Ropsten, POA-network, POA-Sokol, Mainnet, BSC Mainnet/Testnet Instructions on how to deploy it is listed below.
6. cd ..
7. npm install
8. cp .env.example .env
9. open .env file and provide an address of multisender contract
10. npm run start

Contract Deployment

There are 2 ways to deploy the contracts: Upgradable and non-upgradable way. Non-upgrdable:

• cd contracts
• npm run flatten
• take flats/UpgradebleStormSender_flat.sol and deploy it using https://remix.ethereum.org/
  • select solidity 0.4.23 version in settings
• once deployed, call initialize function with parameter address of owner's contract

Disclaimer

This tool is not affiliated with https://poa.network This is a personal project of Roman Storm.

He is not responsible for any loss from transactions derived by MultiSender. Some of the underlying JavaScript libraries and Ethereum tools that were used are under active development. The website and smart contract has been thoroughly tested, there is always the possibility something unexpected happens resulting in losses of Ethereum and/or tokens.

Any ERC20 tokens you transfer to the Multisender will be sent out to the addresses that you provided.

The smart contract source code can be audited by anyone in this repository.

I encourage you to assess its security before using the Mutlisender Dapp.

Testing

docker run -dit --name my-apache-app -p 8081:80 -v "$PWD":/usr/local/apache2/htdocs/ -v "$PWD/my-httpd.conf":/usr/local/apache2/conf/httpd.conf httpd:2.4