airdrop2holders's Introduction

airdrop2holders

Utility script for Solana to airdrop a specified SPL Token to holders of a Candy Machine collection.

Features

Automatically retrieve all current holders of NFTs from a Candy Machine V1 or V2 collection.
Reduce unnecessary gas fees by skipping transfers to the sender account.
Specified starting holder in case airdrop fails midway or sender account runs out of funds.
Automatically retry failed transactions (no more monitoring airdrops for errors).

Requirements

Python3

Solana CLI

Installation

sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

Metaboss

Installation

cargo install metaboss

Usage

Ensure your Solana CLI config file is setup accordingly to the correct sending account keypair and environment before continuing.

python3 airdrop2holders [-h] [-s STARTATHOLDER] [--v2] [-l LIST] [-f FORCE] candymachineid tokenamount tokenaddress

Required arguments:
candymachineid        The Candy Machine ID of the collection, the holders of which you want to airdrop to. If using a list instead, enter 'none'.
tokenamount           The number of tokens you want to airdrop to each holder.
tokenaddress          The token address of the token you wish to airdrop.

Optional arguments:
-h, --help            Show this help message and exit
-s, --startatholder STARTATHOLDER
                      The holder number that you want to start the airdrop at (useful if an airdrop fails and must be restarted).
--v2                  Use if your collection uses Candy Machine V2.
-l, --list LIST       Path to JSON file containing a list of wallet addresses - overrides NFT holders lookup
-f, --force FORCE     WARNING: SCRIPT WILL RUN WITHOUT SAFETY INPUTS. Will automatically refresh holders if no list is provided and retry failed transactions until they are successful.

If this project helped you at all, please consider donating to support the development and maintenance of future utilities!

Recommend Projects