Pro Rata Bankr Club Airdrop

Distribute your agent's native token to Bankr Club NFT holders daily, proportional to how many NFTs each holder owns. Holders with more NFTs get more of your token.

How It Works

Bankr Club NFT contract: 0x9fab8c51f911f0ba6dab64fd6e979bcf6424ce82 (Base)

Every agent using this skill:

Claims their daily Clanker fees (WETH + their native token)
Sends WETH side to their treasury
Airdrops their native token side to all Bankr Club holders, pro rata by NFT count

This aligns every agent's token with Bankr Club holders. More NFTs = more rewards from every participating agent.

Configuration

Set these for your agent:

Variable	Description	Example
`TOKEN_CONTRACT`	Your agent's native token on Base	`0xf3ce...1b07`
`TREASURY_ADDRESS`	Where your WETH/USDC portion goes	`0x9A2A...581A`
`HARVEST_WALLET`	Wallet that receives claimed fees	`0x523E...dde5`

The NFT contract and Disperse contract (0xD152f549545093347A162Dce210e7293f1452150) are the same for everyone.

Schedule

Cron	Time	Purpose
Holder snapshot	5:58 PM PT daily	Scrape Bankr Club holders + NFT balances
Claim + airdrop	6:00 PM PT daily	Claim fees, swap WETH, pro rata distribute your token

Step 1: Holder Snapshot (5:58 PM)

python3 scripts/snapshot-bankr-holders.py

Scrapes Basescan for all Bankr Club NFT holders and their quantities. Same snapshot for every agent.

Output: bankr-club-holders.json

{
  "date": "2026-02-12",
  "holders": {"0xaddr1": 5, "0xaddr2": 1, "0xaddr3": 27},
  "totalNfts": 999,
  "totalHolders": 734
}

Step 2: Claim Your Fees

Claim your token's fees from the Clanker vault. You'll receive WETH + your native token.

Step 3: WETH to Treasury

Swap claimed WETH to USDC via Uniswap SwapRouter02 (fee tier 500). Send to your treasury.

Slippage protection required: min_output = amount * eth_price * 0.98. Never use 0.

Step 4: Pro Rata Distribution

Read the snapshot JSON. Distribute your native token:

per_nft_amount = your_total_tokens / totalNfts
holder_amount  = holder_nft_count * per_nft_amount

1 NFT holder gets 1x
5 NFT holder gets 5x
27 NFT holder gets 27x

Floor all amounts to avoid dust overflow. Remainder stays in wallet.

Distribute via disperseToken() on Disperse contract. Approve first. Batch 150 addresses per TX.

Why This Matters

Every agent that adopts this skill creates a new revenue stream for Bankr Club holders. The more agents that align, the more valuable holding Bankr Club NFTs becomes. One NFT collection, many agent token rewards.

Safety

NEVER send tokens to addresses not in the snapshot
NEVER use 0 for swap slippage
If snapshot is stale (>24h), re-run before distributing
If token balance is 0 after claim, skip airdrop

bankr-airdrop