https://github.com/xdevguild/esdt-and-egld-airdrop-scripts
Distribute EGLD and ESDT to list of wallets
https://github.com/xdevguild/esdt-and-egld-airdrop-scripts
egld esdt multiversx multiversx-sdk-core python
Last synced: about 2 months ago
JSON representation
Distribute EGLD and ESDT to list of wallets
- Host: GitHub
- URL: https://github.com/xdevguild/esdt-and-egld-airdrop-scripts
- Owner: xdevguild
- License: mit
- Created: 2022-05-21T20:23:38.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-27T22:00:59.000Z (almost 2 years ago)
- Last Synced: 2024-05-20T03:15:36.134Z (12 months ago)
- Topics: egld, esdt, multiversx, multiversx-sdk-core, python
- Language: Python
- Homepage:
- Size: 52.7 KB
- Stars: 4
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-multiversx-dev-resources - LKMEX airdrop - Python script that performs an airdrop of LKMEX to NFT holders (MultiversX community / SDKs and dev tools)
README
# ESDT and EGLD AIRDROP
Python scripts that performs an airdrop of classical ESDT tokens or EGLD to NFT holders.
There are two different scripts :
- "EGLDSender.py" performs an airdrop of EGLD tokens
- "ESDTSender.py" performs an airdrop of ESDT tokens
- "multipleEGLDSender.py" performs an airdrop of multiple ESDT tokens
## Requirements
[multiversx-sdk-core](https://pypi.org/project/multiversx-sdk-core/) needs to be installed.
[multiversx-sdk-wallet](https://pypi.org/project/multiversx-sdk-wallet/) needs to be installed.
[multiversx-sdk-network-providers](https://pypi.org/project/multiversx-sdk-network-providers/) needs to be installed.
Pandas as well.
All libraries versions are in the requirements file, and they can be installed with pip.
You need also need a [walletKey.pem](https://docs.multiversx.com/sdk-and-tools/sdk-py/deriving-the-wallet-pem-file/#__docusaurus/)
## Devnet & Testnet
In order to use the Devnet you need to:
Change this line:
```CHAIN = "mainnet"```
and use this gateway: ```"devnet"``` or ```"testnet"```
## CLI
In a terminal the command should look like :
```python3 EGLDSender.py --filename LIST_OF_HOLDER_ADDRESSES.csv --amount_airdrop EGLD_QUANTITY --pem PATH_TO.pem```
or
```python3 ESDTSender.py --filename LIST_OF_HOLDER_ADDRESSES.csv --amount_airdrop ESDT_QUANTITY --id ESDT_ID --pem PATH_TO.pem```
or
```python3 multipleESDTSender.py --filename LIST_OF_HOLDER_ADDRESSES.csv --amounts_airdrop ESDT_QUANTITY_1 ESDT_QUANTITY_N --ids ESDT_ID_1 ESDT_ID_N --decimals DECIMALS_1 DECIMALS_N --pem PATH_TO.pem```
For the EGLDSender command you can use ```--data MESSAGE TO SEND``` if you want to attach a message to the transaction
The CSV file should have two columns: "Address" and "Count" (for the number of NFTs hold). You can use [multiversX-nft-holders](https://github.com/xdevguild/multiversX-nft-holders) to get the CSV file for NFT collections.
An additional argument can be used `--weighted`. If set to true, the amount of tokens airdropped is function of the NFTs hold for each address. If
set to false (default), then the amount is the same for every address.
Note also that there is argument `--decimals` that is default to 18 for classical ESDT tokens, but can be changed if this is not the case.
## Improvements
There is a somewhat not accurate filter for smart contract addresses (supposedly filtering out marketplaces), by checking if the address has a minimum of 6 "q". However if you have an accurate list of marketplaces addresses, or for whatever reasons some of the holders have many "q" in the address you might need to update the code. So far the current version has always worked.