{"id":13408714,"url":"https://github.com/xdevguild/esdt-and-egld-airdrop-scripts","last_synced_at":"2025-03-14T13:31:55.586Z","repository":{"id":80941220,"uuid":"494887294","full_name":"xdevguild/esdt-and-egld-airdrop-scripts","owner":"xdevguild","description":"Distribute EGLD and ESDT to list of wallets","archived":false,"fork":false,"pushed_at":"2023-06-27T22:00:59.000Z","size":54,"stargazers_count":4,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-05-20T03:15:36.134Z","etag":null,"topics":["egld","esdt","multiversx","multiversx-sdk-core","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xdevguild.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-21T20:23:38.000Z","updated_at":"2024-07-30T22:50:51.280Z","dependencies_parsed_at":null,"dependency_job_id":"ecdbca87-a039-470e-a73a-54683ed11285","html_url":"https://github.com/xdevguild/esdt-and-egld-airdrop-scripts","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdevguild%2Fesdt-and-egld-airdrop-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdevguild%2Fesdt-and-egld-airdrop-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdevguild%2Fesdt-and-egld-airdrop-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdevguild%2Fesdt-and-egld-airdrop-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xdevguild","download_url":"https://codeload.github.com/xdevguild/esdt-and-egld-airdrop-scripts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243584415,"owners_count":20314755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["egld","esdt","multiversx","multiversx-sdk-core","python"],"created_at":"2024-07-30T20:00:54.767Z","updated_at":"2025-03-14T13:31:55.575Z","avatar_url":"https://github.com/xdevguild.png","language":"Python","funding_links":[],"categories":["MultiversX community"],"sub_categories":["SDKs and dev tools"],"readme":"# ESDT and EGLD AIRDROP\nPython scripts that performs an airdrop of classical ESDT tokens or EGLD to NFT holders. \n\nThere are two different scripts : \n\u003col\u003e\n  \u003cli\u003e\"EGLDSender.py\" performs an airdrop of EGLD tokens \u003c/li\u003e\n  \u003cli\u003e\"ESDTSender.py\" performs an airdrop of ESDT tokens \u003c/li\u003e\n  \u003cli\u003e\"multipleEGLDSender.py\" performs an airdrop of multiple ESDT tokens \u003c/li\u003e\n\u003c/ol\u003e\n\n\n## Requirements\n\n[multiversx-sdk-core](https://pypi.org/project/multiversx-sdk-core/) needs to be installed.  \u003cbr\u003e\n[multiversx-sdk-wallet](https://pypi.org/project/multiversx-sdk-wallet/) needs to be installed.  \u003cbr\u003e\n[multiversx-sdk-network-providers](https://pypi.org/project/multiversx-sdk-network-providers/) needs to be installed.  \u003cbr\u003e\nPandas as well.  \u003cbr\u003e  \u003cbr\u003e\nAll libraries versions are in the requirements file, and they can be installed with pip. \n\nYou need also need a [walletKey.pem](https://docs.multiversx.com/sdk-and-tools/sdk-py/deriving-the-wallet-pem-file/#__docusaurus/)\n\n## Devnet \u0026 Testnet\n\nIn order to use the Devnet you need to: \u003cbr\u003e\u003cbr\u003e\nChange this line: \n```CHAIN = \"mainnet\"```\nand use this gateway: ```\"devnet\"``` or ```\"testnet\"```\n\n## CLI\n\nIn a terminal the command should look like :\n\n```python3 EGLDSender.py --filename LIST_OF_HOLDER_ADDRESSES.csv --amount_airdrop EGLD_QUANTITY --pem PATH_TO.pem```\n\nor\n\n```python3 ESDTSender.py --filename LIST_OF_HOLDER_ADDRESSES.csv --amount_airdrop ESDT_QUANTITY --id ESDT_ID --pem PATH_TO.pem```\n\nor \n\n```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```\n\nFor the EGLDSender command you can use ```--data MESSAGE TO SEND``` if you want to attach a message to the transaction\n\nThe 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. \u003cbr\u003e\nAn 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\nset to false (default), then the amount is the same for every address. \u003cbr\u003e\n\nNote 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.\n\n\n## Improvements\n\nThere 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxdevguild%2Fesdt-and-egld-airdrop-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxdevguild%2Fesdt-and-egld-airdrop-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxdevguild%2Fesdt-and-egld-airdrop-scripts/lists"}