SDK 2.1: platform toolkit + vesting engine
v2.1.0 stable
SDK 2.1 is the stable release on the latest dist-tag. Install it with pnpm add @tokenops/sdk. The receipt-free and Safe create surface of /fhe-airdrop remains @beta.
This page also documents AirdropBaseClient
Every method below except claim, claimAndUnwrap, getClaimAmount, isSignatureValid, the EIP-712 identity reads, and SIGNER_ROLE lives on the shared AirdropBaseClient both EcdsaAirdropClient and MerkleAirdropClient extend. See MerkleAirdropClient for the Merkle-specific surface built on the same base.
Airdrop v2 · Client@tokenops/sdk/fhe-airdrop

EcdsaAirdropClient

Extends AirdropBaseClient. The config takes no dedupMode - the policy is frozen at create, read it from the chain with readDedupMode(). Optional gasHeadroomPercent pads every write; each write object also takes a per-call gas. Recipients claim with a { encryptedInput, dedupId, deadline, signer, signature } payload over a 4-field EIP-712 Claim struct; the gas fee attaches automatically as msg.value.

Construct

Headless TS — non-React consumers (Node, Vite, server workers). React hosts use the per-hook surface; same method names, lazy encryptor.

@tokenops/sdk/fhe-airdrop
ts
import { createEcdsaAirdropClient } from "@tokenops/sdk/fhe-airdrop";

const client = createEcdsaAirdropClient({
  publicClient,
  walletClient,
  // address optional: resolved from publicClient.chain.id
});

Methods

Write · 4

Encrypted read · 6

Read · 21

Recovery · 7

Roles · RBAC · 17