@tokenops/sdk 1.5.1 → 2.0.0-alpha.1

package/dist/fhe-airdrop/react/useAirdropFactorySetFeeCollector.d.ts

@@ -1,15 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address } from "viem";
-import type { TxHash } from "../../core/brands.js";
-import { type BaseHookOptions } from "./_shared.js";
-export interface UseAirdropFactorySetFeeCollectorArgs {
-    newFeeCollector: Address;
-    account?: Account | Address;
-}
-/**
- * Admin: change the factory's fee collector address. Requires
- * `FEE_MANAGER_ROLE`.
- *
- * After success, invalidate `useFactoryFeeCollector()`.
- */
-export declare function useAirdropFactorySetFeeCollector(options?: BaseHookOptions): UseMutationResult<TxHash, Error, UseAirdropFactorySetFeeCollectorArgs>;

package/dist/fhe-airdrop/react/useAirdropGrantRole.d.ts

@@ -1,16 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropGrantRoleArgs {
-    role: Hex;
-    accountTarget: Address;
-    account?: Account | Address;
-}
-/**
- * AccessControl: grant `role` to `accountTarget` on this airdrop clone.
- * Caller must be a member of the role's admin role (typically
- * `DEFAULT_ADMIN_ROLE`).
- *
- * After success, invalidate `useAirdropHasRole({ role, account: accountTarget })`.
- */
-export declare function useAirdropGrantRole(options: AirdropHookOptions): UseMutationResult<Hex, Error, UseAirdropGrantRoleArgs>;

package/dist/fhe-airdrop/react/useAirdropHasClaimEnded.d.ts

@@ -1,7 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Read whether the current chain timestamp is past `endTime` on this airdrop
- * clone. Free chain read — no gas, no tx.
- */
-export declare function useAirdropHasClaimEnded(options: AirdropHookOptions): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useAirdropHasClaimStarted.d.ts

@@ -1,7 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Read whether the current chain timestamp is past `START_TIME` on this
- * airdrop clone. Free chain read — no gas, no tx.
- */
-export declare function useAirdropHasClaimStarted(options: AirdropHookOptions): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useAirdropIsClaimWindowActive.d.ts

@@ -1,9 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Read whether the airdrop is currently within its claim window AND not paused.
- * Free chain read — no gas, no tx.
- *
- * Use this as a pre-claim UI gate.
- */
-export declare function useAirdropIsClaimWindowActive(options: AirdropHookOptions): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useAirdropIsPaused.d.ts

@@ -1,8 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Read whether claims are currently paused by the admin on this airdrop clone.
- *
- * After a successful `useSetPaused`, invalidate this query.
- */
-export declare function useAirdropIsPaused(options: AirdropHookOptions): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useAirdropIsSignatureClaimed.d.ts

@@ -1,22 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Address, Hex } from "viem";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropIsSignatureClaimedArgs extends AirdropHookOptions {
-    /** Recipient address from the claim authorization. */
-    user?: Address;
-    /** `externalEuint64` handle (as `Hex`) from the claim payload. */
-    encryptedAmountHandle?: Hex;
-}
-/**
- * Check whether a claim has been consumed for a `(user, encryptedAmountHandle)`
- * pair on this airdrop clone. The contract recomputes the struct hash
- * internally and looks it up in storage.
- *
- * Most frontends want this hook over {@link useAirdropClaimedSignatures} —
- * pass the same `user` + `encryptedAmountHandle` that appear in the
- * admin-issued claim payload.
- *
- * After a successful {@link useClaim}, invalidate this query for the claimed
- * `(user, encryptedAmountHandle)` pair.
- */
-export declare function useAirdropIsSignatureClaimed(args: UseAirdropIsSignatureClaimedArgs): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useAirdropIsSignatureValid.d.ts

@@ -1,51 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Address, Hex } from "viem";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropIsSignatureValidArgs extends AirdropHookOptions {
-    /** `externalEuint64` handle (as `Hex`) from the claim payload. */
-    encryptedAmountHandle?: Hex;
-    /** EIP-712 admin signature over `Claim(address recipient, bytes32 encryptedAmount)`. */
-    signature?: Hex;
-    /**
-     * Caller address — the contract recomputes the struct hash over
-     * `(msg.sender, encryptedAmount)`, so validity is caller-specific.
-     * Defaults to the connected wallet via wagmi's account hook (v2
-     * `useAccount()` / v3 `useConnection()`); pass explicitly to check on
-     * behalf of another address.
-     */
-    caller?: Address;
-}
-/**
- * Check whether an admin-issued claim authorization is valid for a specific
- * caller, without consuming it.
- *
- * The query has **two distinct failure shapes** that must be handled separately:
- *
- * - `data === false`: the signature is structurally valid but fails the on-chain
- *   check — already claimed, claim window inactive, or signer lacks
- *   `DEFAULT_ADMIN_ROLE`.
- * - `error?.code === "TOKENOPS_INVALID_SIGNATURE"`: the signature bytes are
- *   structurally malformed (wrong length, invalid `s`-value range, unparseable).
- *   The on-chain `ECDSA.recover` reverts before the boolean logic runs, so this
- *   shows up on `error`, not on `data`.
- *
- * ```ts
- * const sig = useAirdropIsSignatureValid({ address, encryptedAmountHandle, signature, caller });
- * if (sig.error?.code === "TOKENOPS_INVALID_SIGNATURE") {
- *   // malformed signature bytes
- * } else if (sig.data === false) {
- *   // wrong signer, already claimed, or window closed
- * } else if (sig.data === true) {
- *   // ready to claim
- * }
- * ```
- *
- * The result is caller-specific (the on-chain check binds to `msg.sender`).
- * `caller` defaults to the connected wallet; the query stays disabled until
- * a caller is available, and the caller is part of the query key so cached
- * results don't bleed across account switches.
- *
- * Use this to show a pre-claim validation state in the UI before asking the
- * user to pay gas.
- */
-export declare function useAirdropIsSignatureValid(args: UseAirdropIsSignatureValidArgs): UseQueryResult<boolean, Error>;

package/dist/fhe-airdrop/react/useAirdropRevokeRole.d.ts

@@ -1,15 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropRevokeRoleArgs {
-    role: Hex;
-    accountTarget: Address;
-    account?: Account | Address;
-}
-/**
- * AccessControl: revoke `role` from `accountTarget` on this airdrop clone.
- * Caller must be a member of the role's admin role.
- *
- * After success, invalidate `useAirdropHasRole({ role, account: accountTarget })`.
- */
-export declare function useAirdropRevokeRole(options: AirdropHookOptions): UseMutationResult<Hex, Error, UseAirdropRevokeRoleArgs>;

package/dist/fhe-airdrop/react/useAirdropStartTime.d.ts

@@ -1,10 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Read the airdrop clone's immutable `START_TIME` — the unix timestamp when
- * claims become available.
- *
- * @example
- * const { data: startTime } = useAirdropStartTime({ address: airdropAddress });
- */
-export declare function useAirdropStartTime(options: AirdropHookOptions): UseQueryResult<number, Error>;

package/dist/fhe-airdrop/react/useAirdropWithdrawGasFee.d.ts

@@ -1,15 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropWithdrawGasFeeArgs {
-    recipient: Address;
-    /** Amount of ETH to withdraw (in wei). Pass `0n` to withdraw the entire balance. */
-    amount: bigint;
-    account?: Account | Address;
-}
-/**
- * Fee collector: withdraw collected ETH gas fees from the airdrop clone.
- * Requires `FEE_COLLECTOR_ROLE`. Pass `amount = 0n` to withdraw the entire
- * balance.
- */
-export declare function useAirdropWithdrawGasFee(options: AirdropHookOptions): UseMutationResult<Hex, Error, UseAirdropWithdrawGasFeeArgs>;

package/dist/fhe-airdrop/react/useAirdropWithdrawOtherConfidentialToken.d.ts

@@ -1,14 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address } from "viem";
-import type { TxHash } from "../../core/brands.js";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropWithdrawOtherConfidentialTokenArgs {
-    tokenAddress: Address;
-    recipient: Address;
-    account?: Account | Address;
-}
-/**
- * Admin: rescue accidentally sent ERC-7984 confidential tokens (other than
- * this airdrop's configured `TOKEN`). Requires `DEFAULT_ADMIN_ROLE`.
- */
-export declare function useAirdropWithdrawOtherConfidentialToken(options: AirdropHookOptions): UseMutationResult<TxHash, Error, UseAirdropWithdrawOtherConfidentialTokenArgs>;

package/dist/fhe-airdrop/react/useAirdropWithdrawOtherToken.d.ts

@@ -1,14 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address } from "viem";
-import type { TxHash } from "../../core/brands.js";
-import { type AirdropHookOptions } from "./_shared.js";
-export interface UseAirdropWithdrawOtherTokenArgs {
-    tokenAddress: Address;
-    recipient: Address;
-    account?: Account | Address;
-}
-/**
- * Admin: rescue accidentally sent ERC-20 (non-confidential) tokens. Requires
- * `DEFAULT_ADMIN_ROLE`.
- */
-export declare function useAirdropWithdrawOtherToken(options: AirdropHookOptions): UseMutationResult<TxHash, Error, UseAirdropWithdrawOtherTokenArgs>;

package/dist/fhe-airdrop/react/useClaim.d.ts

@@ -1,31 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Hex } from "viem";
-import type { ClaimArgs } from "../airdrop.js";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Claim tokens from an airdrop using an EIP-712 admin signature. Submits the
- * admin-issued `{ encryptedInput, signature }` pair verbatim — the SDK does
- * NOT re-encrypt on the recipient side, because the signature commits to the
- * exact `bytes32` handle and any re-encryption would invalidate it.
- *
- * Attaches `GAS_FEE()` ETH as `msg.value` automatically unless `args.value` is
- * set.
- *
- * The admin builds `encryptedInput` server-side via
- * {@link encryptUint64} with `userAddress: recipient` (Zama input proofs are
- * bound to the recipient), then signs the resulting handle with
- * {@link signClaimAuthorization}. Deliver `(encryptedInput, signature)` to
- * the recipient via your channel of choice; the recipient passes the pair to
- * this hook unchanged.
- *
- * After a successful claim, invalidate
- * `useAirdropIsSignatureClaimed({ user, encryptedAmountHandle })` and any
- * UI counts you computed off it.
- *
- * **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.
- *
- * @example
- * const claim = useClaim({ address: airdropAddress });
- * claim.mutate({ encryptedInput, signature });
- */
-export declare function useClaim(options: AirdropHookOptions): UseMutationResult<Hex, Error, ClaimArgs>;

package/dist/fhe-airdrop/react/useConfidentialAirdropFactoryImplementation.d.ts

@@ -1,11 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Address } from "viem";
-import { type BaseHookOptions } from "./_shared.js";
-/**
- * Read the FHE-airdrop factory's current `implementation()` address — the
- * LibClone target every new airdrop clone delegates to.
- *
- * @example
- * const { data: implementation } = useConfidentialAirdropFactoryImplementation();
- */
-export declare function useConfidentialAirdropFactoryImplementation(options?: BaseHookOptions): UseQueryResult<Address, Error>;

package/dist/fhe-airdrop/react/useCreateAndFundConfidentialAirdrop.d.ts

@@ -1,41 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { CreateAirdropResult, CreateAndFundAirdropArgs } from "../factory.js";
-import { type FactoryHookOptions } from "./_shared.js";
-/**
- * Deploy AND fund a new airdrop clone in a single transaction. The SDK
- * encrypts the plaintext `amount` into an `externalEuint64` and submits it
- * with an input proof — callers never handle ciphertext.
- *
- * **Encryptor resolution.** The hook-level `encryptor` (from
- * {@link FactoryHookOptions}) is forwarded lazily to the SDK client. You can
- * also pass `encryptor` per-mutation via `args.encryptor` to override it. If
- * neither is present, the SDK throws `Missing encryptor — pass encryptor…`
- * verbatim.
- *
- * **Prerequisites:** caller must have set the factory as an operator on the
- * token: `token.setOperator(factoryAddress, deadline)`.
- *
- * **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.
- *
- * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
- * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
- * ERC-20. Amount parameters are base units of the token's actual decimals:
- * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
- * transparent TTT test token uses 18 decimals.
- *
- * After success, invalidate factory queries that depend on per-creator state:
- *
- * ```ts
- * function Component() {
- *   const queryClient = useQueryClient();
- *   const zamaSDK = useZamaSDK();
- *   const create = useCreateAndFundConfidentialAirdrop({ encryptor: () => zamaSDK.relayer });
- *   create.mutate(args, {
- *     onSuccess: () => {
- *       queryClient.invalidateQueries({ queryKey: ["tokenops-sdk", "fhe-airdrop"] });
- *     },
- *   });
- * }
- * ```
- */
-export declare function useCreateAndFundConfidentialAirdrop(options?: FactoryHookOptions): UseMutationResult<CreateAirdropResult, Error, CreateAndFundAirdropArgs>;

package/dist/fhe-airdrop/react/useCreateAndFundConfidentialAirdropAndGetAddress.d.ts

@@ -1,48 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { CreateAirdropResult, CreateAndFundAirdropArgs } from "../factory.js";
-import { type FactoryHookOptions } from "./_shared.js";
-/**
- * **Recommended fund-on-create entry point.** Deploy AND fund a new airdrop
- * clone in one tx, then resolve its address from the
- * `ConfidentialAirdropCreated` event in the receipt.
- *
- * Use this in place of {@link useCreateAndFundConfidentialAirdrop} when you
- * need the deployed clone address — for example to navigate to a detail page
- * immediately after the deploy.
- *
- * Internally: `createAndFundConfidentialAirdrop` → `waitForTransactionReceipt`
- * → `parseEventLogs({ eventName: "ConfidentialAirdropCreated" })`.
- *
- * **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.
- *
- * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
- * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
- * ERC-20. Amount parameters are base units of the token's actual decimals:
- * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
- * transparent TTT test token uses 18 decimals.
- *
- * After a successful create, invalidate factory queries that depend on
- * per-creator state:
- *
- * ```ts
- * function Component() {
- *   const queryClient = useQueryClient();
- *   const zamaSDK = useZamaSDK();
- *   const create = useCreateAndFundConfidentialAirdropAndGetAddress({
- *     encryptor: () => zamaSDK.relayer,
- *   });
- *   create.mutate(args, {
- *     onSuccess: ({ airdrop }) => {
- *       queryClient.invalidateQueries({ queryKey: ["tokenops-sdk", "fhe-airdrop"] });
- *       navigate(`/airdrop/${airdrop}`);
- *     },
- *   });
- * }
- * ```
- *
- * @example
- * const create = useCreateAndFundConfidentialAirdropAndGetAddress();
- * create.mutate({ params, userSalt, amount });
- * // create.data → { hash, airdrop }
- */
-export declare function useCreateAndFundConfidentialAirdropAndGetAddress(options?: FactoryHookOptions): UseMutationResult<CreateAirdropResult, Error, CreateAndFundAirdropArgs>;

package/dist/fhe-airdrop/react/useCreateConfidentialAirdrop.d.ts

@@ -1,29 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { CreateAirdropArgs, CreateAirdropResult } from "../factory.js";
-import { type FactoryHookOptions } from "./_shared.js";
-/**
- * Deploy a new airdrop clone via the factory. Raw-hash-only variant — parse
- * the `ConfidentialAirdropCreated` event yourself if you need the address.
- *
- * **For the common "deploy and learn the address" flow, prefer
- * {@link useCreateConfidentialAirdropAndGetAddress}** — it's a one-call wrapper
- * that returns `{ hash, airdrop }`.
- *
- * After a successful create, invalidate factory queries that depend on
- * per-creator state:
- *
- * ```ts
- * const queryClient = useQueryClient();
- * const create = useCreateConfidentialAirdrop();
- * create.mutate(args, {
- *   onSuccess: () => {
- *     queryClient.invalidateQueries({ queryKey: ["tokenops-sdk", "fhe-airdrop"] });
- *   },
- * });
- * ```
- *
- * @example
- * const create = useCreateConfidentialAirdrop();
- * create.mutate({ params, userSalt });
- */
-export declare function useCreateConfidentialAirdrop(options?: FactoryHookOptions): UseMutationResult<CreateAirdropResult, Error, CreateAirdropArgs>;

package/dist/fhe-airdrop/react/useCreateConfidentialAirdropAndGetAddress.d.ts

@@ -1,31 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { CreateAirdropResult, CreateAirdropArgs } from "../factory.js";
-import { type FactoryHookOptions } from "./_shared.js";
-/**
- * **Recommended factory entry point.** Deploy a new
- * `ConfidentialAirdropCloneable` clone and resolve its address from the
- * `ConfidentialAirdropCreated` event in the tx receipt — in one call.
- *
- * Internally: `createConfidentialAirdrop` → `waitForTransactionReceipt` →
- * `parseEventLogs({ eventName: "ConfidentialAirdropCreated" })`.
- *
- * After a successful create, invalidate factory queries that depend on
- * per-creator state:
- *
- * ```ts
- * const queryClient = useQueryClient();
- * const create = useCreateConfidentialAirdropAndGetAddress();
- * create.mutate(args, {
- *   onSuccess: ({ airdrop }) => {
- *     queryClient.invalidateQueries({ queryKey: ["tokenops-sdk", "fhe-airdrop"] });
- *     navigate(`/airdrop/${airdrop}`);
- *   },
- * });
- * ```
- *
- * @example
- * const create = useCreateConfidentialAirdropAndGetAddress();
- * create.mutate({ params, userSalt });
- * // create.data → { hash, airdrop }
- */
-export declare function useCreateConfidentialAirdropAndGetAddress(options?: FactoryHookOptions): UseMutationResult<CreateAirdropResult, Error, CreateAirdropArgs>;

package/dist/fhe-airdrop/react/useDisableCustomFee.d.ts

@@ -1,14 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import { type BaseHookOptions } from "./_shared.js";
-export interface UseDisableCustomFeeArgs {
-    campaignCreator: Address;
-    account?: Account | Address;
-}
-/**
- * Admin: remove a per-creator fee override, reverting to `defaultGasFee`.
- * Requires `FEE_MANAGER_ROLE`.
- *
- * After success, invalidate `useFactoryCustomFee({ creator: campaignCreator })`.
- */
-export declare function useDisableCustomFee(options?: BaseHookOptions): UseMutationResult<Hex, Error, UseDisableCustomFeeArgs>;

package/dist/fhe-airdrop/react/useFactoryCustomFee.d.ts

@@ -1,17 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Address } from "viem";
-import { type CustomFee } from "../types.js";
-import { type BaseHookOptions } from "./_shared.js";
-export interface UseFactoryCustomFeeArgs extends BaseHookOptions {
-    /** Address whose per-creator fee override to read. Hook is disabled until set. */
-    creator?: Address;
-}
-/**
- * Read the per-creator fee override set on the factory for `creator`. Returns
- * `{ enabled: false, gasFee: 0n }` when no override exists.
- *
- * @example
- * const { data: customFee } = useFactoryCustomFee({ creator });
- * if (customFee?.enabled) { ... use customFee.gasFee ... }
- */
-export declare function useFactoryCustomFee(args?: UseFactoryCustomFeeArgs): UseQueryResult<CustomFee, Error>;

package/dist/fhe-airdrop/react/useFactoryDefaultGasFee.d.ts

@@ -1,10 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import { type BaseHookOptions } from "./_shared.js";
-/**
- * Read the factory-wide default per-claim gas fee (in wei) — applied to new
- * airdrop clones at deployment when the creator has no custom override.
- *
- * @example
- * const { data: defaultGasFee } = useFactoryDefaultGasFee();
- */
-export declare function useFactoryDefaultGasFee(options?: BaseHookOptions): UseQueryResult<bigint, Error>;

package/dist/fhe-airdrop/react/useFactoryFeeCollector.d.ts

@@ -1,11 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Address } from "viem";
-import { type BaseHookOptions } from "./_shared.js";
-/**
- * Read the factory's current fee collector address — the account authorized to
- * call `withdrawGasFee` on each deployed airdrop clone.
- *
- * @example
- * const { data: feeCollector } = useFactoryFeeCollector();
- */
-export declare function useFactoryFeeCollector(options?: BaseHookOptions): UseQueryResult<Address, Error>;

package/dist/fhe-airdrop/react/useFactoryInitCodeHash.d.ts

@@ -1,17 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Hex } from "viem";
-import { type AirdropParams } from "../types.js";
-import { type BaseHookOptions } from "./_shared.js";
-export interface UseFactoryInitCodeHashArgs extends BaseHookOptions {
-    params?: AirdropParams;
-    gasFee?: bigint;
-}
-/**
- * Read the init-code hash the factory would use to CREATE2 an airdrop clone
- * with the given `params` + `gasFee`. Mirrors Solidity's `getInitCodeHash`
- * selector.
- *
- * @example
- * const { data: initCodeHash } = useFactoryInitCodeHash({ params, gasFee });
- */
-export declare function useFactoryInitCodeHash(args?: UseFactoryInitCodeHashArgs): UseQueryResult<Hex, Error>;

package/dist/fhe-airdrop/react/useFundConfidentialAirdrop.d.ts

@@ -1,33 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Hex } from "viem";
-import type { FundAirdropArgs } from "../factory.js";
-import { type FactoryHookOptions } from "./_shared.js";
-/**
- * Fund an existing (or not-yet-deployed) airdrop clone with encrypted tokens
- * via the factory. The SDK encrypts the plaintext `amount` into an
- * `externalEuint64` and submits it with an input proof — callers never handle
- * ciphertext.
- *
- * **Encryptor resolution.** The hook-level `encryptor` (from
- * {@link FactoryHookOptions}) is forwarded lazily to the SDK client. You can
- * also pass `encryptor` per-mutation via `args.encryptor` to override it. If
- * neither is present, the SDK throws `Missing encryptor — pass encryptor…`
- * verbatim.
- *
- * **Prerequisites:** caller must have set the factory as an operator on the
- * token: `token.setOperator(factoryAddress, deadline)`.
- *
- * **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.
- *
- * **Amount units:** TokenOps confidential (ERC-7984) tokens use a 6-decimals
- * convention (1 token = 1_000_000 base units), not the 18 decimals typical of
- * ERC-20. Amount parameters are base units of the token's actual decimals:
- * for the CTTT test token (6 decimals) `1_000_000n` = 1 CTTT, while the
- * transparent TTT test token uses 18 decimals.
- *
- * **`args.gasFee` MUST match the fee active for `deployer` at airdrop creation
- * time** — custom fee if `getCustomFee(deployer).enabled`, otherwise
- * `defaultGasFee`. The factory derives the target clone address from this
- * value via CREATE2; a mismatch funds the wrong (predicted) address.
- */
-export declare function useFundConfidentialAirdrop(options?: FactoryHookOptions): UseMutationResult<Hex, Error, FundAirdropArgs>;

package/dist/fhe-airdrop/react/useGetClaimAmount.d.ts

@@ -1,30 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { EncryptedViewResult, GetClaimAmountArgs } from "../airdrop.js";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * **Submits a transaction (costs gas) to grant the caller decrypt access to
- * the claim amount as an `euint64` handle.** The handle is granted persistent
- * ACL on-chain via `FHE.allow(handle, msg.sender)`; the SDK extracts it from
- * the receipt's `ACL.Allowed` event (NOT from simulation — that returns a
- * divergent, ACL-less handle; see CLAUDE.md Pitfall #1).
- *
- * Pass `data.handle` to the Zama relayer's `userDecrypt` to obtain the
- * plaintext amount. The handle is only valid after the tx lands.
- *
- * Does **not** consume the claim (the `claimedSignatures` bit is not set).
- * Call {@link useClaim} when the user is ready to transfer tokens.
- *
- * Submits the admin-issued `{ encryptedInput, signature }` pair verbatim. The
- * SDK does NOT re-encrypt — the signature commits to the exact handle.
- *
- * @example
- * // `encryptedInput` + `signature` are the admin-issued payload delivered to
- * // the recipient (same pair the recipient passes to `useClaim`). Sourced
- * // from your server API or, for admin-dashboard flows, by combining
- * // `encryptUint64({ userAddress: recipient, ... })` with
- * // `useSignClaimAuthorization`.
- * const view = useGetClaimAmount({ address: airdropAddress });
- * view.mutate({ encryptedInput, signature });
- * // view.data → { handle: "0x...", hash: "0x..." }
- */
-export declare function useGetClaimAmount(options: AirdropHookOptions): UseMutationResult<EncryptedViewResult, Error, GetClaimAmountArgs>;

package/dist/fhe-airdrop/react/usePreflightCreateAirdrop.d.ts

@@ -1,51 +0,0 @@
-import { type UseQueryResult } from "@tanstack/react-query";
-import type { Address, Hex } from "viem";
-import type { AirdropParams, CreateAirdropPreflightReport } from "../types.js";
-import { type BaseHookOptions } from "./_shared.js";
-export interface UsePreflightCreateAirdropArgs extends BaseHookOptions {
-    /** The airdrop parameters that will be passed to the create call. */
-    params?: AirdropParams;
-    /** The address that will send the create transaction (`msg.sender`). */
-    creator?: Address;
-    /**
-     * The `userSalt` planned for the create call. Optional — when supplied, the
-     * report also carries `predictedAirdrop` and `alreadyDeployed`.
-     */
-    userSalt?: Hex;
-    /**
-     * Set `true` when the plan is `useCreateAndFundConfidentialAirdrop` — a
-     * missing factory-operator approval then becomes a blocker instead of
-     * informational `isFactoryOperator` state.
-     */
-    funding?: boolean;
-}
-/**
- * Read-only preflight for `useCreateConfidentialAirdrop` /
- * `useCreateAndFundConfidentialAirdrop` — wraps
- * {@link ConfidentialAirdropFactoryClient.preflightCreateAirdrop} as a
- * TanStack query.
- *
- * The report carries `isFactoryOperator`, `gasFee`, `predictedAirdrop`,
- * `alreadyDeployed`, `ready`, `blockers` (human-readable strings) and
- * `blockerErrors` (typed `TokenOpsSdkError`s, index-aligned with `blockers` —
- * branch on `error.code`).
- *
- * Checks: structural `params` validation (non-zero token/admin, timestamp
- * ordering, end time in the future), ERC-7984 operator approval of the
- * factory on `params.token` (blocker only with `funding: true`), and — when
- * `userSalt` is set — whether a clone already exists at the predicted CREATE2
- * address. The creator's confidential token balance is NOT checked
- * (encrypted; an underfunded create-and-fund silently moves an encrypted
- * zero) — see the headless method's TSDoc.
- *
- * Hook is disabled until `params` and `creator` are both set. Refetch after
- * the user calls `setOperator` (e.g. via `queryClient.invalidateQueries` or a
- * `refetchInterval`).
- *
- * @example
- * const { data: report } = usePreflightCreateAirdrop({
- *   params, creator, userSalt, funding: true,
- * });
- * if (report?.ready) { /* enable submit *\/ }
- */
-export declare function usePreflightCreateAirdrop(args?: UsePreflightCreateAirdropArgs): UseQueryResult<CreateAirdropPreflightReport, Error>;

package/dist/fhe-airdrop/react/useSetCustomFee.d.ts

@@ -1,16 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import { type BaseHookOptions } from "./_shared.js";
-export interface UseSetCustomFeeArgs {
-    campaignCreator: Address;
-    gasFee: bigint;
-    account?: Account | Address;
-}
-/**
- * Admin: install a per-creator gas-fee override on the factory. Takes
- * precedence over `defaultGasFee` for all airdrops `campaignCreator` deploys
- * after the override. Requires `FEE_MANAGER_ROLE`.
- *
- * After success, invalidate `useFactoryCustomFee({ creator: campaignCreator })`.
- */
-export declare function useSetCustomFee(options?: BaseHookOptions): UseMutationResult<Hex, Error, UseSetCustomFeeArgs>;