@tokenops/sdk 1.6.0 → 2.0.0-alpha.2

package/dist/chunk-S2XD75JM.js

@@ -1,1637 +0,0 @@
-import { getFhevmAclAddress, requireFhevmAclAddress, ACL_ALLOWED_EVENT } from './chunk-YPYCWLYP.js';
-import { SDK_VERSION, mapContractRevert, isContractRevert } from './chunk-6WSNS3UV.js';
-import { TokenOpsSdkError, PausedError, InsufficientFeeError, ReceiptEventNotFoundError, ReceiptEventAmbiguousError, InvalidArgumentError, MissingWalletClientError, MissingAccountError, InsufficientBalanceError, InvalidSignatureError } from './chunk-DRSPMIZ7.js';
-import { withTelemetry } from './chunk-Q2GP5UDC.js';
-import { parseEventLogs, isAddress } from 'viem';
-
-// src/fhe-airdrop/abis/cloneable.ts
-var confidentialAirdropCloneableAbi = [
-  {
-    inputs: [],
-    stateMutability: "nonpayable",
-    type: "constructor"
-  },
-  {
-    inputs: [],
-    name: "AccessControlBadConfirmation",
-    type: "error"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "account",
-        type: "address"
-      },
-      {
-        internalType: "bytes32",
-        name: "neededRole",
-        type: "bytes32"
-      }
-    ],
-    name: "AccessControlUnauthorizedAccount",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ClaimNotStarted",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ClaimWindowFinished",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ClaimsPaused",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ECDSAInvalidSignature",
-    type: "error"
-  },
-  {
-    inputs: [
-      {
-        internalType: "uint256",
-        name: "length",
-        type: "uint256"
-      }
-    ],
-    name: "ECDSAInvalidSignatureLength",
-    type: "error"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "s",
-        type: "bytes32"
-      }
-    ],
-    name: "ECDSAInvalidSignatureS",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "EndTimeInPast",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ExtensionNotAllowed",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InsufficientBalance",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InsufficientFee",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InvalidAddress",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InvalidDuration",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InvalidInitialization",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InvalidSignature",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "InvalidStartTime",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "NotInitializing",
-    type: "error"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "handle",
-        type: "bytes32"
-      },
-      {
-        internalType: "address",
-        name: "sender",
-        type: "address"
-      }
-    ],
-    name: "SenderNotAllowedToUseHandle",
-    type: "error"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "sender",
-        type: "address"
-      }
-    ],
-    name: "SenderNotAllowed",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "SignatureAlreadyClaimed",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "TransferFailed",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ZamaProtocolUnsupported",
-    type: "error"
-  },
-  {
-    inputs: [],
-    name: "ZeroBalance",
-    type: "error"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "admin",
-        type: "address"
-      },
-      {
-        indexed: false,
-        internalType: "uint32",
-        name: "oldEndTime",
-        type: "uint32"
-      },
-      {
-        indexed: false,
-        internalType: "uint32",
-        name: "newEndTime",
-        type: "uint32"
-      }
-    ],
-    name: "ClaimWindowExtended",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "user",
-        type: "address"
-      },
-      {
-        indexed: false,
-        internalType: "bytes32",
-        name: "signatureHash",
-        type: "bytes32"
-      }
-    ],
-    name: "Claimed",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [],
-    name: "EIP712DomainChanged",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      },
-      {
-        indexed: false,
-        internalType: "uint256",
-        name: "amount",
-        type: "uint256"
-      }
-    ],
-    name: "GasFeeWithdrawn",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: false,
-        internalType: "uint64",
-        name: "version",
-        type: "uint64"
-      }
-    ],
-    name: "Initialized",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "admin",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "feeCollector",
-        type: "address"
-      },
-      {
-        indexed: false,
-        internalType: "uint32",
-        name: "endTime",
-        type: "uint32"
-      }
-    ],
-    name: "Initialized",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "admin",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "token",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      }
-    ],
-    name: "OtherConfidentialTokenWithdrawn",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "admin",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "token",
-        type: "address"
-      },
-      {
-        indexed: false,
-        internalType: "uint256",
-        name: "amount",
-        type: "uint256"
-      }
-    ],
-    name: "OtherTokenWithdrawn",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: false,
-        internalType: "bool",
-        name: "isPaused",
-        type: "bool"
-      }
-    ],
-    name: "PauseToggled",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        indexed: true,
-        internalType: "bytes32",
-        name: "previousAdminRole",
-        type: "bytes32"
-      },
-      {
-        indexed: true,
-        internalType: "bytes32",
-        name: "newAdminRole",
-        type: "bytes32"
-      }
-    ],
-    name: "RoleAdminChanged",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "account",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "sender",
-        type: "address"
-      }
-    ],
-    name: "RoleGranted",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "account",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "sender",
-        type: "address"
-      }
-    ],
-    name: "RoleRevoked",
-    type: "event"
-  },
-  {
-    anonymous: false,
-    inputs: [
-      {
-        indexed: true,
-        internalType: "address",
-        name: "admin",
-        type: "address"
-      },
-      {
-        indexed: true,
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      }
-    ],
-    name: "Withdrawn",
-    type: "event"
-  },
-  {
-    inputs: [],
-    name: "CAN_EXTEND_CLAIM_WINDOW",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "CLAIM_TYPEHASH",
-    outputs: [
-      {
-        internalType: "bytes32",
-        name: "",
-        type: "bytes32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "DEFAULT_ADMIN_ROLE",
-    outputs: [
-      {
-        internalType: "bytes32",
-        name: "",
-        type: "bytes32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "DOMAIN_SEPARATOR",
-    outputs: [
-      {
-        internalType: "bytes32",
-        name: "",
-        type: "bytes32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "FEE_COLLECTOR_ROLE",
-    outputs: [
-      {
-        internalType: "bytes32",
-        name: "",
-        type: "bytes32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "GAS_FEE",
-    outputs: [
-      {
-        internalType: "uint256",
-        name: "",
-        type: "uint256"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "START_TIME",
-    outputs: [
-      {
-        internalType: "uint32",
-        name: "",
-        type: "uint32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "TOKEN",
-    outputs: [
-      {
-        internalType: "contract IERC7984",
-        name: "",
-        type: "address"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "externalEuint64",
-        name: "inputAmount",
-        type: "bytes32"
-      },
-      {
-        internalType: "bytes",
-        name: "inputProof",
-        type: "bytes"
-      },
-      {
-        internalType: "bytes",
-        name: "signature",
-        type: "bytes"
-      }
-    ],
-    name: "claim",
-    outputs: [],
-    stateMutability: "payable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "signatureHash",
-        type: "bytes32"
-      }
-    ],
-    name: "claimedSignatures",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "isClaimed",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "deploymentBlockNumber",
-    outputs: [
-      {
-        internalType: "uint256",
-        name: "",
-        type: "uint256"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "eip712Domain",
-    outputs: [
-      {
-        internalType: "bytes1",
-        name: "fields",
-        type: "bytes1"
-      },
-      {
-        internalType: "string",
-        name: "name",
-        type: "string"
-      },
-      {
-        internalType: "string",
-        name: "version",
-        type: "string"
-      },
-      {
-        internalType: "uint256",
-        name: "chainId",
-        type: "uint256"
-      },
-      {
-        internalType: "address",
-        name: "verifyingContract",
-        type: "address"
-      },
-      {
-        internalType: "bytes32",
-        name: "salt",
-        type: "bytes32"
-      },
-      {
-        internalType: "uint256[]",
-        name: "extensions",
-        type: "uint256[]"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "endTime",
-    outputs: [
-      {
-        internalType: "uint32",
-        name: "",
-        type: "uint32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "uint32",
-        name: "newEndTime",
-        type: "uint32"
-      }
-    ],
-    name: "extendClaimWindow",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "externalEuint64",
-        name: "inputAmount",
-        type: "bytes32"
-      },
-      {
-        internalType: "bytes",
-        name: "inputProof",
-        type: "bytes"
-      },
-      {
-        internalType: "bytes",
-        name: "signature",
-        type: "bytes"
-      }
-    ],
-    name: "getClaimAmount",
-    outputs: [
-      {
-        internalType: "euint64",
-        name: "encryptedAmount",
-        type: "bytes32"
-      }
-    ],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      }
-    ],
-    name: "getRoleAdmin",
-    outputs: [
-      {
-        internalType: "bytes32",
-        name: "",
-        type: "bytes32"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        internalType: "address",
-        name: "account",
-        type: "address"
-      }
-    ],
-    name: "grantRole",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "hasClaimEnded",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "hasClaimStarted",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        internalType: "address",
-        name: "account",
-        type: "address"
-      }
-    ],
-    name: "hasRole",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "_admin",
-        type: "address"
-      },
-      {
-        internalType: "address",
-        name: "_feeCollector",
-        type: "address"
-      },
-      {
-        internalType: "uint32",
-        name: "_endTime",
-        type: "uint32"
-      }
-    ],
-    name: "initialize",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "isClaimWindowActive",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [],
-    name: "isPaused",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "user",
-        type: "address"
-      },
-      {
-        internalType: "externalEuint64",
-        name: "encryptedAmount",
-        type: "bytes32"
-      }
-    ],
-    name: "isSignatureClaimed",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "externalEuint64",
-        name: "inputAmount",
-        type: "bytes32"
-      },
-      {
-        internalType: "bytes",
-        name: "signature",
-        type: "bytes"
-      }
-    ],
-    name: "isSignatureValid",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        internalType: "address",
-        name: "callerConfirmation",
-        type: "address"
-      }
-    ],
-    name: "renounceRole",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes32",
-        name: "role",
-        type: "bytes32"
-      },
-      {
-        internalType: "address",
-        name: "account",
-        type: "address"
-      }
-    ],
-    name: "revokeRole",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bool",
-        name: "paused",
-        type: "bool"
-      }
-    ],
-    name: "setPaused",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "bytes4",
-        name: "interfaceId",
-        type: "bytes4"
-      }
-    ],
-    name: "supportsInterface",
-    outputs: [
-      {
-        internalType: "bool",
-        name: "",
-        type: "bool"
-      }
-    ],
-    stateMutability: "view",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      }
-    ],
-    name: "withdraw",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      },
-      {
-        internalType: "uint256",
-        name: "amount",
-        type: "uint256"
-      }
-    ],
-    name: "withdrawGasFee",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "tokenAddress",
-        type: "address"
-      },
-      {
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      }
-    ],
-    name: "withdrawOtherConfidentialToken",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  },
-  {
-    inputs: [
-      {
-        internalType: "address",
-        name: "tokenAddress",
-        type: "address"
-      },
-      {
-        internalType: "address",
-        name: "recipient",
-        type: "address"
-      }
-    ],
-    name: "withdrawOtherToken",
-    outputs: [],
-    stateMutability: "nonpayable",
-    type: "function"
-  }
-];
-
-// src/fhe-airdrop/errors.ts
-var AlreadyClaimedError = class extends TokenOpsSdkError {
-  name = "AlreadyClaimedError";
-  constructor(args) {
-    const who = args.caller ? `${args.caller}: ` : "";
-    super(`${args.method}: ${who}this airdrop claim has already been redeemed.`, {
-      code: "TOKENOPS_ALREADY_CLAIMED",
-      cause: args.cause,
-      context: {
-        method: args.method,
-        contractAddress: args.contractAddress,
-        caller: args.caller
-      }
-    });
-  }
-};
-var ClaimNotStartedError = class extends TokenOpsSdkError {
-  name = "ClaimNotStartedError";
-  constructor(args) {
-    const detail = args.startsAt !== void 0 ? ` Opens at unix timestamp ${args.startsAt}.` : "";
-    super(`${args.method}: airdrop claim window has not started.${detail}`, {
-      code: "TOKENOPS_CLAIM_NOT_STARTED",
-      cause: args.cause,
-      context: {
-        method: args.method,
-        contractAddress: args.contractAddress,
-        startsAt: args.startsAt
-      }
-    });
-  }
-};
-var ClaimWindowClosedError = class extends TokenOpsSdkError {
-  name = "ClaimWindowClosedError";
-  constructor(args) {
-    const detail = args.endedAt !== void 0 ? ` Closed at unix timestamp ${args.endedAt}.` : "";
-    super(`${args.method}: airdrop claim window has closed.${detail}`, {
-      code: "TOKENOPS_CLAIM_WINDOW_CLOSED",
-      cause: args.cause,
-      context: {
-        method: args.method,
-        contractAddress: args.contractAddress,
-        endedAt: args.endedAt
-      }
-    });
-  }
-};
-var CONFIDENTIAL_POOL_BALANCE_METHODS = /* @__PURE__ */ new Set([
-  "claim",
-  "withdraw",
-  "withdrawOtherConfidentialToken"
-]);
-var airdropProductMapper = (name, _args, ctx) => {
-  switch (name) {
-    case "SignatureAlreadyClaimed":
-      return new AlreadyClaimedError(ctx);
-    case "ClaimNotStarted":
-      return new ClaimNotStartedError(ctx);
-    case "ClaimWindowFinished":
-      return new ClaimWindowClosedError(ctx);
-    // OZ ECDSA reverts surface from `isSignatureValid` when the signature
-    // bytes are structurally malformed (e.g. `s`-value out of range,
-    // 0-length, wrong length). Map to a single typed error so consumers
-    // can branch on `error.code === "TOKENOPS_INVALID_SIGNATURE"`.
-    case "ECDSAInvalidSignature":
-    case "ECDSAInvalidSignatureS":
-    case "ECDSAInvalidSignatureLength":
-      return new InvalidSignatureError(ctx);
-    case "ZeroBalance":
-    case "InsufficientBalance":
-      return CONFIDENTIAL_POOL_BALANCE_METHODS.has(ctx.method) ? new InsufficientBalanceError({ ...ctx, balanceKind: "confidential" }) : void 0;
-    default:
-      return void 0;
-  }
-};
-var ConfidentialAirdropClient = class {
-  publicClient;
-  walletClient;
-  address;
-  #aclAddressOverride;
-  #telemetry;
-  #cachedAclAddress;
-  constructor(config) {
-    this.publicClient = config.publicClient;
-    this.walletClient = config.walletClient;
-    this.address = config.address;
-    this.#telemetry = config.telemetry;
-    this.#aclAddressOverride = config.aclAddress;
-    const chainIdForInit = config.publicClient.chain?.id;
-    this.#telemetry?.event("fhe-airdrop.client.init", {
-      surface: "client",
-      chainId: chainIdForInit ?? null,
-      hasWallet: !!this.walletClient,
-      aclResolved: !!config.aclAddress || chainIdForInit !== void 0 && !!getFhevmAclAddress(chainIdForInit),
-      sdkVersion: SDK_VERSION
-    });
-  }
-  /**
-   * The FHEVM ACL contract address used by encrypted-view methods to parse
-   * `ACL.Allowed` events. Resolved lazily on first access; throws
-   * `DeploymentAddressUnavailableError` if no override was passed and the
-   * SDK does not have an ACL deployed for the connected chain.
-   */
-  get aclAddress() {
-    if (this.#cachedAclAddress) return this.#cachedAclAddress;
-    this.#cachedAclAddress = this.#aclAddressOverride ?? requireFhevmAclAddress(this.publicClient.chain?.id, "ConfidentialAirdropClient");
-    return this.#cachedAclAddress;
-  }
-  // ============================================================
-  //                     IMMUTABLE READS
-  // ============================================================
-  /** ERC-7984 confidential token this airdrop was deployed for. Immutable arg. */
-  async token() {
-    return this.#read("TOKEN");
-  }
-  /** Per-claim gas fee in wei. Immutable arg. Attached as `msg.value` by `claim()` automatically. */
-  async gasFee() {
-    return this.#read("GAS_FEE");
-  }
-  /** Unix timestamp when claims become available. Immutable arg. */
-  async startTime() {
-    return this.#read("START_TIME");
-  }
-  /** Whether the admin can extend the claim window past `endTime`. Immutable arg. */
-  async canExtendClaimWindow() {
-    return this.#read("CAN_EXTEND_CLAIM_WINDOW");
-  }
-  // ============================================================
-  //                     STORAGE READS
-  // ============================================================
-  /** Unix timestamp when claims end. Mutable — can be extended by admin if `canExtendClaimWindow`. */
-  async endTime() {
-    return this.#read("endTime");
-  }
-  /** Whether claims are currently paused by the admin. */
-  async isPaused() {
-    return this.#read("isPaused");
-  }
-  /** Block number at which this clone was deployed. */
-  async deploymentBlockNumber() {
-    return this.#read("deploymentBlockNumber");
-  }
-  /**
-   * Check whether a pre-computed signature hash has been consumed.
-   *
-   * The contract keys claim replay-protection on
-   * `keccak256(abi.encode(CLAIM_TYPEHASH, recipient, bytes32(encryptedAmountHandle)))`.
-   * Use this when you already hold the struct hash (e.g. you computed it server-side
-   * while building the claim payload). For the more common case where you hold the
-   * user address and the encrypted handle, use {@link isSignatureClaimed} instead —
-   * it computes the hash for you.
-   *
-   * @param signatureHash `bytes32` storage key — the EIP-712 struct hash of the Claim.
-   */
-  async claimedSignatures(signatureHash) {
-    return this.#read("claimedSignatures", [signatureHash]);
-  }
-  // ============================================================
-  //                     VIEW FUNCTIONS
-  // ============================================================
-  /** `true` if within the claim time window and not paused. Free read — no gas. */
-  async isClaimWindowActive() {
-    return this.#read("isClaimWindowActive");
-  }
-  /** `true` if the current timestamp is past `START_TIME`. */
-  async hasClaimStarted() {
-    return this.#read("hasClaimStarted");
-  }
-  /** `true` if the current timestamp is past `endTime`. */
-  async hasClaimEnded() {
-    return this.#read("hasClaimEnded");
-  }
-  /** EIP-712 domain separator for the clone. Useful for off-chain signing tools. */
-  async domainSeparator() {
-    return this.#read("DOMAIN_SEPARATOR");
-  }
-  /**
-   * EIP-712 type hash for the `Claim(address recipient, bytes32 encryptedAmount)`
-   * struct. Off-chain signers that don't use {@link signClaimAuthorization}
-   * (e.g. custom HSM-backed signers, ledger flows) need this to assemble the
-   * typed-data payload manually.
-   */
-  async claimTypehash() {
-    return this.#read("CLAIM_TYPEHASH");
-  }
-  /**
-   * Check whether a claim has been consumed, given the user address and encrypted amount handle.
-   *
-   * This is the method most frontend developers want. Pass the same `user` and
-   * `encryptedAmountHandle` that appear in the admin-issued claim payload; the contract
-   * recomputes the struct hash internally and looks it up in storage.
-   *
-   * Prefer this over {@link claimedSignatures} unless you already hold the pre-computed
-   * `bytes32` struct hash (e.g. from a server-side indexer).
-   *
-   * @param user Recipient address from the claim authorization.
-   * @param encryptedAmountHandle The `externalEuint64` handle (as `Hex`) from the claim payload.
-   */
-  async isSignatureClaimed(user, encryptedAmountHandle) {
-    return this.#read("isSignatureClaimed", [user, encryptedAmountHandle]);
-  }
-  /**
-   * Check whether an admin-issued claim authorization is valid for a specific caller,
-   * without consuming it.
-   *
-   * Returns `false` (not a revert) when the signature is **structurally valid** but
-   * fails one of the on-chain checks: already-claimed, claim window inactive, or the
-   * signer lacks `DEFAULT_ADMIN_ROLE`. The on-chain implementation recomputes the
-   * EIP-712 struct hash over `(msg.sender, encryptedAmount)`, so the result is
-   * caller-specific: a signature issued for recipient A is invalid when checked
-   * against caller B. Pass the address that will actually submit the claim.
-   *
-   * **Throws** {@link InvalidSignatureError} (code `TOKENOPS_INVALID_SIGNATURE`)
-   * when the signature bytes are **structurally malformed** — wrong length, invalid
-   * `s`-value range, or unparseable. The on-chain `ECDSA.recover` reverts before
-   * the boolean logic runs in that case, so consumer code must catch this
-   * separately from the `false` return:
-   *
-   * ```ts
-   * try {
-   *   const ok = await airdrop.isSignatureValid({ encryptedAmountHandle, signature, caller });
-   *   if (!ok) { /* signed by non-admin, window closed, or already claimed *\/ }
-   * } catch (err) {
-   *   if (err instanceof InvalidSignatureError) { /* malformed signature bytes *\/ }
-   * }
-   * ```
-   *
-   * Use this to show a pre-claim validation state in the UI before asking the user to
-   * pay gas.
-   */
-  async isSignatureValid(args) {
-    try {
-      return await this.publicClient.readContract({
-        address: this.address,
-        abi: confidentialAirdropCloneableAbi,
-        functionName: "isSignatureValid",
-        args: [args.encryptedAmountHandle, args.signature],
-        account: args.caller
-      });
-    } catch (err) {
-      throw mapContractRevert(err, {
-        method: "isSignatureValid",
-        contractAddress: this.address,
-        abi: confidentialAirdropCloneableAbi,
-        productMapper: airdropProductMapper,
-        account: args.caller
-      });
-    }
-  }
-  // ============================================================
-  //                       PREFLIGHT
-  // ============================================================
-  /**
-   * Read-only preflight for {@link claim}. Runs the deterministic-from-off-chain
-   * checks in parallel and reports any blockers as typed {@link TokenOpsSdkError}s.
-   * Returns `{ ready: true, blockers: [] }` when the claim is safe to submit.
-   *
-   * Preflight is **opt-in**. Consumers who have already validated state can
-   * skip this call and invoke `claim` directly — they'll receive the same
-   * typed errors at write time via the revert mapper.
-   *
-   * Checks performed (all read-only, no gas):
-   * - Claim window started (`block.timestamp ≥ START_TIME`).
-   * - Claim window not closed (`block.timestamp ≤ endTime`).
-   * - Claims not paused.
-   * - Signature not already redeemed by this caller.
-   * - ETH balance covers `GAS_FEE()` (the `msg.value` the claim must attach).
-   *
-   * The EIP-712 admin-signature check is **not** preflight-detectable — the
-   * SDK cannot verify the signer's role without the contract round-trip — and
-   * will still surface as {@link InvalidSignatureError} at write time.
-   *
-   * Pool balance is also **not** preflight-detectable: the clone's confidential
-   * balance is an encrypted `euint64` handle that the SDK cannot read in
-   * plaintext. An unfunded clone will pass preflight and revert on-chain with
-   * {@link FheHandleNotAllowedError} (the FHEVM ACL rejects `FHE.allowTransient`
-   * on an uninitialized handle). Confirm the pool has been funded before
-   * showing `ready: true`.
-   *
-   * @returns `{ ready, blockers }` — same `code` shape the write would throw.
-   */
-  async preflightClaim(args) {
-    const blockers = [];
-    const [startTime, endTime, isPaused, isClaimed, block, gasFee, callerBalance] = await Promise.all([
-      this.startTime(),
-      this.endTime(),
-      this.isPaused(),
-      this.isSignatureClaimed(args.caller, args.encryptedAmountHandle),
-      this.publicClient.getBlock(),
-      this.gasFee(),
-      this.publicClient.getBalance({ address: args.caller })
-    ]);
-    const now = Number(block.timestamp);
-    if (isPaused) {
-      blockers.push(new PausedError({ method: "claim", contractAddress: this.address }));
-    }
-    if (now < startTime) {
-      blockers.push(
-        new ClaimNotStartedError({
-          method: "claim",
-          contractAddress: this.address,
-          startsAt: startTime
-        })
-      );
-    }
-    if (now > endTime) {
-      blockers.push(
-        new ClaimWindowClosedError({
-          method: "claim",
-          contractAddress: this.address,
-          endedAt: endTime
-        })
-      );
-    }
-    if (isClaimed) {
-      blockers.push(
-        new AlreadyClaimedError({
-          method: "claim",
-          contractAddress: this.address,
-          caller: args.caller
-        })
-      );
-    }
-    if (callerBalance < gasFee) {
-      blockers.push(
-        new InsufficientFeeError({
-          method: "claim",
-          contractAddress: this.address,
-          feeKind: "gas",
-          required: gasFee,
-          provided: callerBalance
-        })
-      );
-    }
-    return { ready: blockers.length === 0, blockers };
-  }
-  // ============================================================
-  //                     CLAIM (USER OP)
-  // ============================================================
-  /**
-   * Claim tokens using an EIP-712 admin signature. Sends `GAS_FEE()` ETH with the tx.
-   *
-   * The `encryptedInput` must be the exact handle the admin signed in
-   * {@link signClaimAuthorization}. The signature commits to that handle, so the SDK
-   * does NOT re-encrypt — submit the admin-issued payload as-is.
-   *
-   * **Silent-zero transfers.** ERC-7984 transfers do not revert when the sender's encrypted balance is insufficient — the transfer succeeds and moves an encrypted zero instead. This is by design: reverting would leak balance information. The transaction receipt alone cannot tell you whether value actually moved.
-   *
-   * **An unfunded pool is the opposite case — it reverts loudly.** Do not
-   * generalize the silent-zero rule above to a clone whose pool was never
-   * funded: that claim throws {@link FheHandleNotAllowedError} (the FHEVM ACL
-   * rejects `FHE.allowTransient` on an uninitialized handle), and
-   * {@link preflightClaim} cannot detect it because the pool balance is an
-   * encrypted `euint64` the SDK cannot read in plaintext.
-   *
-   * @returns Transaction hash.
-   * @example
-   * const fee = await airdrop.gasFee();
-   * const hash = await airdrop.claim({ encryptedInput, signature });
-   */
-  async claim(args) {
-    const wallet = this.#requireWallet("claim");
-    const account = this.#resolveAccount(wallet, args.account, "claim");
-    const fee = args.value ?? await this.gasFee();
-    const writeArgs = [
-      args.encryptedInput.handle,
-      args.encryptedInput.inputProof,
-      args.signature
-    ];
-    await this.#preflightWrite("claim", "claim", writeArgs, account, fee);
-    try {
-      return await wallet.writeContract({
-        address: this.address,
-        abi: confidentialAirdropCloneableAbi,
-        functionName: "claim",
-        args: writeArgs,
-        account,
-        chain: wallet.chain,
-        value: fee
-      });
-    } catch (err) {
-      throw this.#mapRevert("claim", err, accountAddress(account));
-    }
-  }
-  /**
-   * **This is a write transaction, not a free view. It costs gas.**
-   *
-   * Verify the admin-signed claim allocation and grant the caller decrypt access
-   * to the encrypted amount. Budget gas and `await` the receipt before calling
-   * the Zama relayer's `userDecrypt` — the handle is only valid after the tx lands.
-   *
-   * Internally the contract calls `FHE.allow(handle, msg.sender)`, which persists
-   * the ACL grant on-chain. The handle is extracted from the receipt's ACL `Allowed`
-   * event — `simulateContract` would return a divergent handle and break decryption.
-   *
-   * Does **not** consume the claim (the `claimedSignatures` bit is not set). Call
-   * {@link claim} when the user is ready to transfer tokens.
-   *
-   * @returns `{ handle, hash }` — `handle` is a `euint64` granted to the caller;
-   *   pass it to the Zama relayer's `userDecrypt` to obtain the plaintext amount.
-   */
-  async getClaimAmount(args) {
-    const wallet = this.#requireWallet("getClaimAmount");
-    const account = this.#resolveAccount(wallet, args.account, "getClaimAmount");
-    const writeArgs = [
-      args.encryptedInput.handle,
-      args.encryptedInput.inputProof,
-      args.signature
-    ];
-    await this.#preflightWrite("getClaimAmount", "getClaimAmount", writeArgs, account);
-    let hash;
-    try {
-      hash = await wallet.writeContract({
-        address: this.address,
-        abi: confidentialAirdropCloneableAbi,
-        functionName: "getClaimAmount",
-        args: writeArgs,
-        account,
-        chain: wallet.chain
-      });
-    } catch (err) {
-      throw this.#mapRevert("getClaimAmount", err, accountAddress(account));
-    }
-    const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
-    const callerAddress = accountAddress(account).toLowerCase();
-    const aclLogs = receipt.logs.filter(
-      (log) => log.address.toLowerCase() === this.aclAddress.toLowerCase()
-    );
-    const events = parseEventLogs({ abi: [ACL_ALLOWED_EVENT], logs: aclLogs });
-    const granted = events.filter(
-      (ev) => ev.args.account.toLowerCase() === callerAddress && ev.args.caller.toLowerCase() === this.address.toLowerCase()
-    );
-    if (granted.length === 0) {
-      throw new ReceiptEventNotFoundError({
-        method: "getClaimAmount",
-        eventName: "Allowed",
-        contractAddress: this.aclAddress,
-        txHash: hash,
-        hint: `Expected ACL grant from airdrop ${this.address} to caller ${callerAddress}; the contract did not grant decrypt access.`
-      });
-    }
-    if (granted.length > 1) {
-      throw new ReceiptEventAmbiguousError({
-        method: "getClaimAmount",
-        eventName: "Allowed",
-        contractAddress: this.aclAddress,
-        txHash: hash,
-        count: granted.length
-      });
-    }
-    const handle = granted[0].args.handle;
-    return { handle, hash };
-  }
-  // ============================================================
-  //                     ADMIN WRITES
-  // ============================================================
-  /**
-   * Withdraw all confidential tokens to `recipient`. `DEFAULT_ADMIN_ROLE` only.
-   *
-   * Calling on a clone whose pool was **never funded** throws
-   * {@link FheHandleNotAllowedError} (code `TOKENOPS_FHE_HANDLE_NOT_ALLOWED`).
-   * The contract calls `FHE.allowTransient` on the confidential balance handle;
-   * when the handle is uninitialized, the FHEVM ACL contract reverts with
-   * `SenderNotAllowed(address)`. Confirm the pool has been funded (e.g. via the
-   * factory's `createAndFund...` variant or a follow-up `confidentialTransfer`)
-   * before calling.
-   */
-  async withdraw(recipient, account) {
-    this.#requireChecksumAddress("withdraw", "recipient", recipient);
-    return this.#simpleWrite("withdraw", [recipient], account);
-  }
-  /** Pause or unpause claims. DEFAULT_ADMIN_ROLE only. */
-  async setPaused(paused, account) {
-    return withTelemetry(this.#telemetry, "fhe-airdrop.client.setPaused", async () => {
-      return this.#simpleWrite("setPaused", [paused], account);
-    });
-  }
-  /**
-   * Extend the claim window end time. DEFAULT_ADMIN_ROLE only.
-   * Requires `CAN_EXTEND_CLAIM_WINDOW == true` or the contract reverts.
-   */
-  async extendClaimWindow(newEndTime, account) {
-    return withTelemetry(this.#telemetry, "fhe-airdrop.client.extendClaimWindow", async () => {
-      return this.#simpleWrite("extendClaimWindow", [newEndTime], account);
-    });
-  }
-  /** Rescue accidentally sent ERC20 tokens. DEFAULT_ADMIN_ROLE only. */
-  async withdrawOtherToken(tokenAddress, recipient, account) {
-    this.#requireChecksumAddress("withdrawOtherToken", "tokenAddress", tokenAddress);
-    this.#requireChecksumAddress("withdrawOtherToken", "recipient", recipient);
-    return this.#simpleWrite("withdrawOtherToken", [tokenAddress, recipient], account);
-  }
-  /** Rescue accidentally sent ERC7984 confidential tokens. DEFAULT_ADMIN_ROLE only. */
-  async withdrawOtherConfidentialToken(tokenAddress, recipient, account) {
-    this.#requireChecksumAddress("withdrawOtherConfidentialToken", "tokenAddress", tokenAddress);
-    this.#requireChecksumAddress("withdrawOtherConfidentialToken", "recipient", recipient);
-    return this.#simpleWrite("withdrawOtherConfidentialToken", [tokenAddress, recipient], account);
-  }
-  // ============================================================
-  //                     FEE COLLECTOR WRITES
-  // ============================================================
-  /**
-   * Withdraw collected ETH gas fees. FEE_COLLECTOR_ROLE only.
-   * Pass `amount = 0n` to withdraw the entire balance.
-   */
-  async withdrawGasFee(recipient, amount, account) {
-    this.#requireChecksumAddress("withdrawGasFee", "recipient", recipient);
-    return this.#simpleWrite("withdrawGasFee", [recipient, amount], account);
-  }
-  // ============================================================
-  //                     ROLE MANAGEMENT
-  // ============================================================
-  async hasRole(role, account) {
-    return this.#read("hasRole", [role, account]);
-  }
-  async grantRole(role, accountTarget, account) {
-    return withTelemetry(this.#telemetry, "fhe-airdrop.client.grantRole", async () => {
-      return this.#simpleWrite("grantRole", [role, accountTarget], account);
-    });
-  }
-  async revokeRole(role, accountTarget, account) {
-    return withTelemetry(this.#telemetry, "fhe-airdrop.client.revokeRole", async () => {
-      return this.#simpleWrite("revokeRole", [role, accountTarget], account);
-    });
-  }
-  // ============================================================
-  //                        INTERNALS
-  // ============================================================
-  #requireChecksumAddress(method, argument, value) {
-    if (!isAddress(value, { strict: true })) {
-      throw new InvalidArgumentError({
-        method,
-        argument,
-        reason: "must be a valid EIP-55 checksummed address",
-        value
-      });
-    }
-  }
-  #requireWallet(method) {
-    if (!this.walletClient) {
-      throw new MissingWalletClientError(method);
-    }
-    return this.walletClient;
-  }
-  #resolveAccount(wallet, override, method) {
-    const acct = override ?? wallet.account;
-    if (!acct) {
-      throw new MissingAccountError(method);
-    }
-    if (typeof acct === "string") {
-      this.#requireChecksumAddress(method, "account", acct);
-    }
-    return acct;
-  }
-  #mapRevert(method, err, account) {
-    return mapContractRevert(err, {
-      method,
-      contractAddress: this.address,
-      abi: confidentialAirdropCloneableAbi,
-      productMapper: airdropProductMapper,
-      account
-    });
-  }
-  async #simpleWrite(functionName, args, account) {
-    const wallet = this.#requireWallet(functionName);
-    const acct = this.#resolveAccount(wallet, account, functionName);
-    await this.#preflightWrite(functionName, functionName, args, acct);
-    try {
-      return await wallet.writeContract({
-        address: this.address,
-        abi: confidentialAirdropCloneableAbi,
-        functionName,
-        args,
-        account: acct,
-        chain: wallet.chain
-      });
-    } catch (err) {
-      throw this.#mapRevert(functionName, err, accountAddress(acct));
-    }
-  }
-  /**
-   * Pre-flight a write via `simulateContract` purely to surface typed reverts.
-   *
-   * The simulate's *return value* is discarded — FHE writes still need
-   * `writeContract` + receipt parsing because simulated FHE op handles diverge
-   * from the executed-tx handles (CLAUDE.md Pitfall #1). The only purpose of
-   * this call is to let viem decode any revert against the ABI and produce a
-   * `ContractFunctionRevertedError` frame the revert-mapper can classify.
-   */
-  async #preflightWrite(method, functionName, args, account, value) {
-    try {
-      await this.publicClient.simulateContract({
-        address: this.address,
-        abi: confidentialAirdropCloneableAbi,
-        functionName,
-        args,
-        account,
-        ...value !== void 0 ? { value } : {}
-      });
-    } catch (err) {
-      if (isContractRevert(err)) {
-        throw this.#mapRevert(method, err, accountAddress(account));
-      }
-    }
-  }
-  async #read(functionName, args = []) {
-    const result = await this.publicClient.readContract({
-      address: this.address,
-      abi: confidentialAirdropCloneableAbi,
-      functionName,
-      args
-    });
-    return result;
-  }
-};
-function createConfidentialAirdropClient(config) {
-  return new ConfidentialAirdropClient(config);
-}
-function accountAddress(account) {
-  return typeof account === "string" ? account : account.address;
-}
-
-export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, ConfidentialAirdropClient, confidentialAirdropCloneableAbi, createConfidentialAirdropClient };