This repository maintains airdrop whitelists for the Mint Club Airdrop Tool, along with scripts to update them.

• List summary (✅ summary file)

• MT Token Holders (Base) (📄 docs, ✅ whitelist, ⚙️ script)

• Developer Reward Winners (📄 docs, ✅ whitelist, ⚙️ script)
• Pro Subscribers (📄 docs, ✅ whitelist, ⚙️ script)

• Building NFT Holders (Mainnet) (📄 docs, ✅ whitelist, ⚙️ script)
• Mini Building NFT Holders (Base) (📄 docs, ✅ whitelist, ⚙️ script)
• HUNT Token Holders (Base) (📄 docs, ✅ whitelist, ⚙️ script)
• HUNT Token Holders (Mainnet) (📄 docs, ✅ whitelist, ⚙️ script)
• Top Builders (by total claps received) (📄 docs, ✅ whitelist, ⚙️ script)
• Top Builders (by mini-building grants) (📄 docs, ✅ whitelist, ⚙️ script)
• Top Clappers (📄 docs, ✅ whitelist, ⚙️ script)

• NOICE Token Holders (📄 docs, ✅ whitelist, ⚙️ script)

• VIRTUAL Token Holders (Base) (📄 docs, ✅ whitelist, ⚙️ script)
• VIRTUAL Token Holders (Mainnet) (📄 docs, ✅ whitelist, ⚙️ script)

You can update all whitelists at once or update a specific list.

To update all whitelists, run the following command, which will execute all the scripts in the scripts folder and its subfolders:

bun run update-all

Each file has the following JSON structure.

{
  "walletsCount": 2,
  "updatedAt": "2025-06-17T12:34:56.789Z",
  "wallets": [
    {
      "walletAddress": "0x1234567890123456789012345678901234567890",
      "weight": 50,
      "fid": 123,
      "username": "userA",
      "rank": 1
    },
    {
      "walletAddress": "0x0987654321098765432109876543210987654321",
      "fid": 456,
      "username": "userB",
      "rank": 2
    }
  ]
}

• walletsCount: The total number of whitelisted wallets.
• updatedAt: The timestamp when the whitelist was last updated.
• wallets: An array of whitelisted wallet objects.
  • walletAddress: The wallet address.
  • weight (optional): The weight of the wallet. This can be used to calculate the airdrop amount.
  • ... (optional): You can include other informational fields like fid, username, rank, etc., to provide additional context.

The whitelist/summary.json file provides a summary of all available whitelists. It contains a nested object where the keys are categories, and the values are objects containing the whitelists in that category. This file is automatically updated when you run the update scripts.

Here is an example of the summary.json format:

{
  "farcaster": {
    "farcaster-developer-reward-winners": {
      "title": "Developer Reward Winners",
      "documentLink": "https://docs.farcaster.xyz/reference/warpcast/api#get-developer-reward-winners",
      "isWeighted": true,
      "walletsCount": 100,
      "updatedAt": "2025-11-01T03:47:37.562Z",
      "script": "https://github.com/Steemhunt/airdrop-whitelist/blob/main/scripts/farcaster/farcaster-developer-reward-winners.ts",
      "endpoint": "https://raw.githubusercontent.com/Steemhunt/airdrop-whitelist/main/whitelist/farcaster/farcaster-developer-reward-winners.json"
    },
    ...
  }
  ...
}