Sablier Merkle Airdrop Creation
Overview
Create token airdrops using the Sablier Merkle system. A campaign creator deploys a campaign contract via a factory, storing a Merkle root. Anyone can then fund the campaign by transferring tokens to it. Recipients claim individually using Merkle proofs, paying their own gas.
Funding does not have to happen in the same session as deployment. For CLI execution, deploy first, then ask whether the user wants to fund immediately or later. If they defer funding, finish successfully after deployment, share the campaign URL plus key metadata, and warn that claims will fail until the campaign holds at least the aggregate amount.
The local CLI route generates the campaign artifact locally and uploads it to IPFS through Pinata v3, so it requires a Pinata JWT with Files: Write permission.
This skill is a coordinator for airdrop campaign creation and execution routing.
Arguments
| Argument |
Description |
chain_name |
EVM chain where to create the airdrop campaign |
token_address |
ERC-20 token contract address to distribute. Token symbols cannot be resolved to addresses — the user must provide the exact contract address. |
airdrop_details_with_csv |
Campaign type, recipient list in CSV, vesting schedule (if applicable) |
Campaign Types
| Type |
Code |
Distribution Method |
| Instant |
MerkleInstant |
Direct token transfer on claim |
| Linear |
MerkleLL |
Creates a Lockup Linear stream per claim (vesting over time) |
| Tranched |
MerkleLT |
Creates a Lockup Tranched stream per claim (discrete unlock steps) |
Choosing a Campaign Type
Q1: Do recipients need vesting after claiming?
├─ No → ✅ Instant
└─ Yes → Q2
Q2: Do tokens unlock continuously or in discrete steps?
├─ Continuously (with optional cliff) → ✅ MerkleLL
└─ At discrete intervals (monthly, quarterly, etc.) → ✅ MerkleLT
Workflow
1. Confirm product fit before implementation details
- Verify the user needs Merkle-based token distribution to many recipients.
- If the user needs fixed-schedule vesting, route to
sablier-create-vesting. If this skill is unavailable, recommend installing it with:
npx skills add sablier-labs/sablier-skills --skill sablier-create-vesting
2. Check requested features
Stop and call out unsupported requests before selecting an execution path.
Treat the following as unsupported by this skill and by Sablier Airdrops:
- Launching tokens for users. Require the user to explicitly provide an existing token address as input.
- Resolving token symbols (e.g. "USDC") to contract addresses. If the user provides a symbol instead of an address, ask them to provide the exact ERC-20 contract address.
- Distributing native tokens (ETH, POL, etc.). Only ERC-20 tokens can be airdropped. If the user wants to airdrop a native token, inform them they must wrap it first (e.g. WETH) and provide the wrapped token contract address.
- Rebasing tokens (e.g. Aave aTokens such as aUSDC/aDAI, stETH, AMPL). Sablier only supports non-rebasing ERC-20 tokens: campaign amounts are fixed at creation and the contract cannot account for balance changes from external rebases, so recipients would be under- or over-paid. If the user requests a rebasing token, stop and tell them this is not allowed; suggest the non-rebasing wrapped variant instead (e.g. static aTokens, wstETH, WAMPL) and ask for that contract address.
3. Clarify airdrop details
If any of the following are missing or ambiguous from the user's input, use the AskUserQuestion tool to ask the user to clarify before proceeding:
- Chain name (e.g. "Ethereum", "Base", etc.)
- Campaign type (Instant, LL, LT — use the decision tree if unclear)
- Recipient list (file path to a CSV, or pasted inline for small lists)
- Token address
- Campaign start time (when claims open)
- Expiration (when unclaimed tokens can be recovered by admin): ask user to choose between 90 days, 30 days, or never (set as
0 in the factory call)
- Vesting schedule (for LL: duration and cliff; for LT: tranche intervals)
If the missing detail is the token address, tell the user they can look it up on a blockchain explorer such as Etherscan.
Do not guess or silently apply defaults for the campaign type, recipient list, or vesting schedule. Only proceed once all required inputs are confirmed.
4. Infer intent before selecting references
- Execution intent: user wants the agent to create an airdrop campaign on their behalf (run CLI transactions).
- Onchain integration intent: user wants developer integration guidance.
5. Validate chain support before routing
- Check whether the user's desired chain is listed on Supported Chains.
- If the chain is not supported, inform the user and stop execution of this skill.
6. Route in two steps
- Classify the request as one of:
- Airdrop campaign creation on the user's behalf
- Onchain integration guidance
- Any other integration type (frontend, backend, indexer, etc.)
- If the request is any other integration type, inform the user that this skill does not support non-onchain integrations and stop.
- Otherwise, follow the route below.
| Intent |
EVM |
| Airdrop campaign creation on the user's behalf |
Use cli.md |
| Onchain integration guidance |
Use evm-onchain.md |
7. Handle funding after deployment
For the EVM CLI route:
- Deploy the campaign first.
- After the deployment receipt is confirmed, use the
AskUserQuestion tool to ask whether the user wants to fund now or later.
- If the user chooses later, treat the deployment as a successful completion, share the campaign URL and core campaign metadata, and warn that claims will fail until the campaign is funded.
- If the user chooses now, continue with the token funding transaction.
Resources
Support
If you encounter any issues or unexpected errors with this skill, please file an issue at
sablier-labs/sablier-skills.
1---2name: sablier-create-airdrop3description: This skill should be used when the user asks to create "token airdrops", "Merkle airdrops", "community airdrops", "Sablier airdrop", "vested airdrops", "claimable airdrops", "token claim campaigns", "ERC-20 airdrops", "BEP-20 airdrops", or "BEP20 airdrops" with Sablier Airdrops, wants to distribute tokens to many recipients on Ethereum or EVM-compatible chains using Merkle proofs, or needs an agent to run onchain airdrop-campaign-creation transactions on their behalf.4---56# Sablier Merkle Airdrop Creation78## Overview910Create token airdrops using the Sablier Merkle system. A campaign creator deploys a campaign contract via a factory, storing a Merkle root. Anyone can then fund the campaign by transferring tokens to it. Recipients claim individually using Merkle proofs, paying their own gas.1112Funding does not have to happen in the same session as deployment. For CLI execution, deploy first, then ask whether the user wants to fund immediately or later. If they defer funding, finish successfully after deployment, share the campaign URL plus key metadata, and warn that claims will fail until the campaign holds at least the aggregate amount.1314The local CLI route generates the campaign artifact locally and uploads it to IPFS through Pinata v3, so it requires a Pinata JWT with `Files: Write` permission.1516This skill is a coordinator for airdrop campaign creation and execution routing.1718## Arguments1920| Argument | Description |21| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |22| `chain_name` | EVM chain where to create the airdrop campaign |23| `token_address` | ERC-20 token contract address to distribute. Token symbols cannot be resolved to addresses — the user must provide the exact contract address. |24| `airdrop_details_with_csv` | Campaign type, recipient list in CSV, vesting schedule (if applicable) |2526## Campaign Types2728| Type | Code | Distribution Method |29| -------- | ------------- | ------------------------------------------------------------------ |30| Instant | MerkleInstant | Direct token transfer on claim |31| Linear | MerkleLL | Creates a Lockup Linear stream per claim (vesting over time) |32| Tranched | MerkleLT | Creates a Lockup Tranched stream per claim (discrete unlock steps) |3334### Choosing a Campaign Type3536```37Q1: Do recipients need vesting after claiming?38├─ No → ✅ Instant39└─ Yes → Q24041Q2: Do tokens unlock continuously or in discrete steps?42├─ Continuously (with optional cliff) → ✅ MerkleLL43└─ At discrete intervals (monthly, quarterly, etc.) → ✅ MerkleLT44```4546## Workflow4748### 1. Confirm product fit before implementation details49501. Verify the user needs Merkle-based token distribution to many recipients.512. If the user needs fixed-schedule vesting, route to `sablier-create-vesting`. If this skill is unavailable, recommend installing it with:5253```bash54npx skills add sablier-labs/sablier-skills --skill sablier-create-vesting55```5657### 2. Check requested features5859Stop and call out unsupported requests before selecting an execution path.6061Treat the following as unsupported by this skill and by Sablier Airdrops:6263- Launching tokens for users. Require the user to explicitly provide an existing token address as input.64- Resolving token symbols (e.g. "USDC") to contract addresses. If the user provides a symbol instead of an address, ask them to provide the exact ERC-20 contract address.65- Distributing native tokens (ETH, POL, etc.). Only ERC-20 tokens can be airdropped. If the user wants to airdrop a native token, inform them they must wrap it first (e.g. WETH) and provide the wrapped token contract address.66- Rebasing tokens (e.g. Aave aTokens such as aUSDC/aDAI, stETH, AMPL). Sablier only supports non-rebasing ERC-20 tokens: campaign amounts are fixed at creation and the contract cannot account for balance changes from external rebases, so recipients would be under- or over-paid. If the user requests a rebasing token, stop and tell them this is not allowed; suggest the non-rebasing wrapped variant instead (e.g. static aTokens, wstETH, WAMPL) and ask for that contract address.6768### 3. Clarify airdrop details6970If any of the following are missing or ambiguous from the user's input, use the `AskUserQuestion` tool to ask the user to clarify before proceeding:7172- Chain name (e.g. "Ethereum", "Base", etc.)73- Campaign type (Instant, LL, LT — use the [decision tree](#choosing-a-campaign-type) if unclear)74- Recipient list (file path to a CSV, or pasted inline for small lists)75- Token address76- Campaign start time (when claims open)77- Expiration (when unclaimed tokens can be recovered by admin): ask user to choose between 90 days, 30 days, or never (set as `0` in the factory call)78- Vesting schedule (for LL: duration and cliff; for LT: tranche intervals)7980If the missing detail is the token address, tell the user they can look it up on a blockchain explorer such as Etherscan.8182Do not guess or silently apply defaults for the campaign type, recipient list, or vesting schedule. Only proceed once all required inputs are confirmed.8384### 4. Infer intent before selecting references85861. **Execution intent:** user wants the agent to create an airdrop campaign on their behalf (run CLI transactions).872. **Onchain integration intent:** user wants developer integration guidance.8889### 5. Validate chain support before routing90911. Check whether the user's desired chain is listed on [Supported Chains](https://docs.sablier.com/concepts/chains).922. If the chain is not supported, inform the user and stop execution of this skill.9394### 6. Route in two steps95961. Classify the request as one of:97 - Airdrop campaign creation on the user's behalf98 - Onchain integration guidance99 - Any other integration type (frontend, backend, indexer, etc.)1002. If the request is any other integration type, inform the user that this skill does not support non-onchain integrations and stop.1013. Otherwise, follow the route below.102103| Intent | EVM |104| ---------------------------------------------- | ----------------------------------------------- |105| Airdrop campaign creation on the user's behalf | Use [cli.md](references/cli.md) |106| Onchain integration guidance | Use [evm-onchain.md](references/evm-onchain.md) |107108### 7. Handle funding after deployment109110For the EVM CLI route:1111121. Deploy the campaign first.1132. After the deployment receipt is confirmed, use the `AskUserQuestion` tool to ask whether the user wants to fund now or later.1143. If the user chooses later, treat the deployment as a successful completion, share the campaign URL and core campaign metadata, and warn that claims will fail until the campaign is funded.1154. If the user chooses now, continue with the token funding transaction.116117## Resources118119- [Sablier Documentation](https://docs.sablier.com/llms.txt)120- [EVM Airdrop Deployments](https://docs.sablier.com/guides/airdrops/deployments.md)121- [Sablier Airdrops Monorepo](https://github.com/sablier-labs/airdrops)122- [Merkle API (tree generation + eligibility)](https://github.com/sablier-labs/merkle-api)123- [EVM Integration Examples](https://github.com/sablier-labs/evm-examples)124125## Support126127If you encounter any issues or unexpected errors with this skill, please file an issue at128[sablier-labs/sablier-skills](https://github.com/sablier-labs/sablier-skills/issues).
sablier-labs