Reference
CLI
airdrop-studio [path]
airdrop-studio --help
airdrop-studio --version| Argument | Behavior |
|---|---|
[path] | Path to a workspace. Creates a new one if the path does not exist. Defaults to the current directory |
--help | Prints usage and exits |
--version | Prints the CLI version and exits |
Workspace Files
All files live in the workspace root or .bonkit/.
| Path | Purpose | Key fields |
|---|---|---|
campaign.config.json | Runtime config — bundled into the generated app | brand, network, campaign, ui, content, links |
.bonkit/workspace.json | Studio-only state | studio (layout, theme, colors, labels, images), airdrop (addresses, signatures, recipients, schedule) |
.bonkit/export-manifest.json | Generation record | Timestamp, layout, network, claim mode |
.bonkit/batch-draft.json | In-progress recipient append | Current batch slice |
.bonkit/batch-history.json | Completed batch transactions | Per-batch signatures and sizes |
.bonkit/activity-log.json | Full transaction log | All on-chain transactions from the workspace |
Constants
| Constant | Value | Applies to |
|---|---|---|
MAX_APPEND | 16 | Recipients appended per transaction |
MAX_RECIPIENTS | 10,000 | Total recipients per airdrop |
Design Rules
These rules are enforced by the studio UI. If something looks disabled or blocked, it usually maps back to one of these rules.
| Rule | Why |
|---|---|
| Contract account values are not manually editable | startDate, endDate, allocations, and cumulative claim totals are read-only from on-chain state |
No visibility toggle for Connect Wallet, Claim, and Eligibility | These are essential features of an airdrop page |
Network and Token Mint cannot be changed after Draft | The on-chain account has already been created; use Reset to change them. Reset only clears the local references in workspace.json — the existing on-chain airdrop account is not deleted |
| Schedule can still be finalized at the Start step | Draft is configuration only; the Start transaction writes schedule on-chain |
| Mainnet requires your own RPC | Public RPC rate limits break claim traffic |
| Preview matches the generated app | Preview and runtime layouts share the same source files |
Links
Last updated on