ISablierMerkleInstant

Git Source

Inherits: ISablierMerkleBase

MerkleInstant enables an airdrop model where eligible users receive the tokens as soon as they claim.

Functions

claim

Claim airdrop on behalf of eligible recipient and transfer it to the recipient address.

*It emits a ClaimInstant event. Requirements:

• The current time must be greater than or equal to the campaign start time.
• The campaign must not have expired.
• msg.value must not be less than the value returned by {COMPTROLLER.calculateMinFeeWei}.
• The index must not be claimed already.
• The Merkle proof must be valid.*

function claim(uint256 index, address recipient, uint128 amount, bytes32[] calldata merkleProof) external payable;

Parameters

Name	Type	Description
index	uint256	The index of the recipient in the Merkle tree.
recipient	address	The address of the airdrop recipient.
amount	uint128	The amount of ERC-20 tokens allocated to the recipient.
merkleProof	bytes32[]	The proof of inclusion in the Merkle tree.

claimTo

Claim airdrop and transfer the tokens to the to address.

*It emits a ClaimInstant event. Requirements:

• msg.sender must be the airdrop recipient.
• The to must not be the zero address.
• Refer to the requirements in {claim}.*

function claimTo(uint256 index, address to, uint128 amount, bytes32[] calldata merkleProof) external payable;

Parameters

Name	Type	Description
index	uint256	The index of the msg.sender in the Merkle tree.
to	address	The address receiving the ERC-20 tokens on behalf of msg.sender.
amount	uint128	The amount of ERC-20 tokens allocated to the msg.sender.
merkleProof	bytes32[]	The proof of inclusion in the Merkle tree.

claimViaSig

Claim airdrop on behalf of eligible recipient using an EIP-712 or EIP-1271 signature, and transfer the tokens to the to address.

*It emits a ClaimInstant event. Requirements:

• If recipient is an EOA, it must match the recovered signer.
• If recipient is a contract, it must implement the IERC-1271 interface.
• The to must not be the zero address.
• The validFrom must be less than or equal to the current block timestamp.
• Refer to the requirements in {claim}. Below is the example of typed data to be signed by the airdrop recipient, referenced from https://docs.metamask.io/wallet/how-to/sign-data/#example.

types: {
EIP712Domain: [
{ name: "name", type: "string" },
{ name: "chainId", type: "uint256" },
{ name: "verifyingContract", type: "address" },
],
Claim: [
{ name: "index", type: "uint256" },
{ name: "recipient", type: "address" },
{ name: "to", type: "address" },
{ name: "amount", type: "uint128" },
{ name: "validFrom", type: "uint40" },
],
},
domain: {
name: "Sablier Airdrops Protocol",
chainId: 1, // Chain on which the contract is deployed
verifyingContract: "0xTheAddressOfThisContract", // The address of this contract
},
primaryType: "Claim",
message: {
index: 2, // The index of the signer in the Merkle tree
recipient: "0xTheAddressOfTheRecipient", // The address of the airdrop recipient
to: "0xTheAddressReceivingTheTokens", // The address where recipient wants to transfer the tokens
amount: "1000000000000000000000", // The amount of tokens allocated to the recipient
validFrom: 1752425637 // The timestamp from which the claim signature is valid
},

function claimViaSig(
    uint256 index,
    address recipient,
    address to,
    uint128 amount,
    uint40 validFrom,
    bytes32[] calldata merkleProof,
    bytes calldata signature
)
    external
    payable;

Parameters

Name	Type	Description
index	uint256	The index of the recipient in the Merkle tree.
recipient	address	The address of the airdrop recipient who is providing the signature.
to	address	The address receiving the ERC-20 tokens on behalf of the recipient.
amount	uint128	The amount of ERC-20 tokens allocated to the recipient.
validFrom	uint40	The timestamp from which the claim signature is valid.
merkleProof	bytes32[]	The proof of inclusion in the Merkle tree.
signature	bytes	The EIP-712 or EIP-1271 signature from the airdrop recipient.

Events

ClaimInstant

Emitted when an airdrop is claimed on behalf of an eligible recipient.

event ClaimInstant(uint256 index, address indexed recipient, uint128 amount, address to, bool viaSig);

Parameters

Name	Type	Description
index	uint256	The index of the airdrop recipient in the Merkle tree.
recipient	address	The address of the airdrop recipient.
amount	uint128	The amount of ERC-20 tokens claimed.
to	address	The address receiving the claim amount on behalf of the airdrop recipient.
viaSig	bool	Bool indicating whether the claim is made via a signature.