Airdrop SDK

@bonkit/airdrop-sdk is a TypeScript SDK for interacting with Bonkit Airdrop Studio on Solana.

What It Is For

The SDK is designed around two usage patterns:

Read on-chain state — fetch recipient lists and claim status for existing airdrops.
Build transactions — create versioned transactions for both claim modes supported by Airdrop Studio: merkle (proof-based claims from a merkle tree) and onchain (claims resolved against a recipient list stored on-chain). The SDK builds the transaction; you sign and send it.

Most transaction methods return a VersionedTransaction. Sending is left to the caller so the SDK works in browsers, backends, and serverless functions.

When to Use the SDK

You want to	Use
Embed claim into your own app or backend	This SDK
Run a self-hosted claim site without writing code	Airdrop Studio CLI
Use a managed campaign page on Bonkit	Hosted Airdrop Studio

Supported Networks

devnet
mainnet-beta (and the alias mainnet)

Package

npm — @bonkit/airdrop-sdk
GitHub — bonkit-dev/airdrop-sdk
License — MIT

API Surface

Client — AirdropStudioClient initialization and read methods
Transactions — fourteen transaction builders (seven per claim mode)
Merkle Tools — tree builders, serialized helpers, and full payload helpers
On-chain List — recipient list chunk decoders
Validation and Errors — mint precheck and error normalization
PDAs — createPdas for deterministic addresses
Examples — end-to-end snippets

Start Here

Getting Started Client Examples