🛄Token

Transfer one Token to multiple addresses in the same transaction through a Smart Contract.

Token distribution is a tool that allows one to send a Token to a list of wallets through a smart contract. One can use our official Smart Send Contract or generate a new contract for private use with its own branding.

Information

The MultiversX Smart Contracts limitation is 100 transfers for each transaction. For example, if you want to transfer a Token to 350 wallets, you will be asked to sign 4 transactions.

The Web Wallet is limited to 85 transfers (1 transaction). If you want to do more, you need to split your transfers in multiple chunks. It is recommended to wait like 2-3 minutes after you send each chunk.

Transfers

There are 3 ways you can transfer a Token. We try to cover as many data formats as possible, including, of course, our snapshot formats.

A visual example is shown at the bottom of the page.

1. Same Amount

Transfer same amount of one Token to a list of addresses.

1. Select the Token you would like to transfer

2. Pick Amount per wallet - e.g. 1.5 TOKEN (always use dot [.] as decimal amount)

3. Add a list of wallets manually or from a TXT/CSV (one address per line)

4. Select the Smart Send contract you would like to use

5. Click Validate transactions - This process will verify all the addresses and will show all the details about the transactions created

6. Click Send transactions - the transactions will be sent to your wallet waiting for signature

7. Sign the transactions with the wallet

8. DONE!

2. Custom Amount

Transfer a custom amount of one Token to a list of addresses.

1. Select the Token you would like to transfer

2. Add a list of transactions manually or from a TXT/CSV

   • Use format 'WALLET_ADDRESS AMOUNT' (space separated)

   • Amount should use dot [.] as decimal separator

   • One transaction per line

3. Select the Smart Send contract you would like to use

4. Click Validate transactions - This process will verify all the addresses with amounts and will show all the details about the transactions created

5. Click Send transactions - the transactions will be sent to your wallet waiting for signature

6. Sign the transactions with the wallet

7. DONE!

3. Per Unit

Transfer an amount of one Token multiplied by a NUMBER to a list of wallets

1. Select the Token you would like to transfer

2. Pick Amount per unit - e.g. 1.2 TOKEN (always use dot [.] as decimal amount)

3. Add a list of transactions manually or from a TXT/CSV

   • Use format 'WALLET_ADDRESS NUMBER' (space separated) - NUMBER will be multiplied by Amount per unit

   • Amount should use dot [.] as decimal separator

   • One transaction per line

4. Select the Smart Send contract you would like to use

5. Click Validate transactions - This process will verify all the addresses with amounts and will show all the details about the transactions created

6. Click Send transactions - the transactions will be sent to your wallet waiting for signature

7. Sign the transactions with the wallet

8. DONE!

Validation process is checking the following:

• all addresses are valid

• amounts are > 0.0 and use dot [.] as decimal separator

• you have enough TOKEN balance to satisfy all the transactions

• you have enough EGLD for the transaction fees

Errors are shown below the Validation button if found.

As a security validation the selected Smart Send contract Code Hash will be checked against the Smart Send source contract, if the hashes do no match it means your contract is not up to date or was changed by mistake. Take a look here how to upgrade your contract(s).

Example

The Same amount transfer is used in this example

• Amount per Wallet = 1.5

• List of random transactions (980 txs) (I used same address for all transactions in the example)

• Selected Remarkable Tools: Smart Send contract to be used to transfer the MTSDT-6f4219 token

1st step

Next step is to click Validate Transactions. After everything is validated and transactions are created, a modal will appear and show you all the details. You can scroll through transactions and validate each one of them.

2nd step

If Send Transactions is clicked, then all these transactions arrive to your wallet to be signed. If you sign and confirm, all transactions will be sent to the blockchain and be processed.