@tokenops/sdk 1.0.0

package/dist/fhe-airdrop/index.d.cts

@@ -0,0 +1,10 @@
+export { ConfidentialAirdropFactoryClient, createConfidentialAirdropFactoryClient, type ConfidentialAirdropFactoryClientConfig, type CreateAirdropArgs, type CreateAirdropResult, type CreateAndFundAirdropArgs, type FundAirdropArgs, } from "./factory.js";
+export { ConfidentialAirdropClient, createConfidentialAirdropClient, type ClaimArgs, type ConfidentialAirdropClientConfig, type EncryptedViewResult, type GetClaimAmountArgs, type IsSignatureValidArgs, } from "./airdrop.js";
+export { encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "./encryption.js";
+export { type AirdropParams, type CustomFee, type EncryptedInput, type EncryptedInputs, } from "./types.js";
+export { asAirdropId, type AirdropId, asEncryptedHandle, type EncryptedHandle, } from "../core/brands.js";
+export { confidentialAirdropFactoryAbi, confidentialAirdropCloneableAbi } from "./abis/index.js";
+export { erc7984OperatorAbi } from "../fhe/erc7984-abi.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
+export { type PreflightResult } from "../core/preflight.js";
+export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError } from "./errors.js";

package/dist/fhe-airdrop/index.d.ts

@@ -0,0 +1,10 @@
+export { ConfidentialAirdropFactoryClient, createConfidentialAirdropFactoryClient, type ConfidentialAirdropFactoryClientConfig, type CreateAirdropArgs, type CreateAirdropResult, type CreateAndFundAirdropArgs, type FundAirdropArgs, } from "./factory.js";
+export { ConfidentialAirdropClient, createConfidentialAirdropClient, type ClaimArgs, type ConfidentialAirdropClientConfig, type EncryptedViewResult, type GetClaimAmountArgs, type IsSignatureValidArgs, } from "./airdrop.js";
+export { encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization, type Encryptor, type EncryptorSource, type EncryptUint64Args, type EncryptUint64BatchArgs, type FheValueInput, } from "./encryption.js";
+export { type AirdropParams, type CustomFee, type EncryptedInput, type EncryptedInputs, } from "./types.js";
+export { asAirdropId, type AirdropId, asEncryptedHandle, type EncryptedHandle, } from "../core/brands.js";
+export { confidentialAirdropFactoryAbi, confidentialAirdropCloneableAbi } from "./abis/index.js";
+export { erc7984OperatorAbi } from "../fhe/erc7984-abi.js";
+export { TokenOpsSdkError, isTokenOpsSdkError, DeploymentAddressUnavailableError, UnsupportedChainError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, InvalidArgumentError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, TokenOpsValidationError, ContractRevertError, TokenOpsContractError, PausedError, AccessDeniedError, InsufficientFeeError, InsufficientBalanceError, BatchTooLargeError, FeatureDisabledError, TransferFailedError, FheHandleNotAllowedError, AlreadyInitializedError, ReentrancyError, InvalidSignatureError, WalletRejectedError, WalletChainMismatchError, NetworkError, InsufficientGasFundsError, UnknownWriteFailureError, UserRejectedSignatureError, SigningFailedError, RelayerUnreachableError, EncryptionFailedError, DecryptionFailedError, UserDecryptNotAllowedError, type DeploymentAddressUnavailableReason, type TokenOpsSdkErrorCode, } from "../core/errors.js";
+export { type PreflightResult } from "../core/preflight.js";
+export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError } from "./errors.js";

package/dist/fhe-airdrop/index.js

@@ -0,0 +1,10 @@
+export { AlreadyClaimedError, ClaimNotStartedError, ClaimWindowClosedError, ConfidentialAirdropClient, confidentialAirdropCloneableAbi, createConfidentialAirdropClient } from '../chunk-XXXDQSHE.js';
+export { ConfidentialAirdropFactoryClient, confidentialAirdropFactoryAbi, createConfidentialAirdropFactoryClient, encryptUint64, encryptUint64Batch, resolveEncryptor, signClaimAuthorization } from '../chunk-UOG4PJL5.js';
+export { erc7984OperatorAbi } from '../chunk-7VELUOMI.js';
+import '../chunk-FYQ2UW4T.js';
+import '../chunk-JFLEEXKP.js';
+import '../chunk-COPFW5Z4.js';
+import '../chunk-BE2AIZ3K.js';
+import '../chunk-Q2GP5UDC.js';
+export { asAirdropId, asEncryptedHandle } from '../chunk-KWFFIJYX.js';
+export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TokenOpsValidationError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../chunk-IVE3QEGD.js';

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

@@ -0,0 +1,107 @@
+import type { Address, PublicClient, WalletClient } from "viem";
+import { DeploymentAddressUnavailableError } from "../../core/errors.js";
+import { type Encryptor, type EncryptorSource } from "../encryption.js";
+import { type ConfidentialAirdropFactoryClient } from "../factory.js";
+import { type ConfidentialAirdropClient } from "../airdrop.js";
+/** Common per-hook overrides — every public hook accepts these alongside its own args. */
+export interface BaseHookOptions {
+    /** Override the on-chain contract address. Defaults to {@link getFheAirdropFactoryAddress} keyed by chain id. */
+    address?: Address;
+    /** Override the chain id used for default address resolution. Defaults to `usePublicClient().chain?.id`. */
+    chainId?: number;
+}
+/** Per-hook overrides for factory hooks that submit encrypted inputs. */
+export interface FactoryHookOptions extends BaseHookOptions {
+    /**
+     * Lazy or eager encryptor source. Optional at hook level; **required at call
+     * time** for factory methods that submit encrypted inputs
+     * (`useCreateAndFundConfidentialAirdrop`, `useFundConfidentialAirdrop`).
+     *
+     * Recommended in React: capture `useZamaSDK()` once at the top of your
+     * component and wire `encryptor: () => sdk.relayer` — the SDK
+     * calls this per-encryption so it picks up the live `ZamaSDK` instance
+     * rather than a stale capture (CLAUDE.md Pitfall #3).
+     */
+    encryptor?: EncryptorSource;
+}
+/** Per-hook overrides for FHE-airdrop *clone* hooks — `address` is required (per-airdrop). */
+export interface AirdropHookOptions {
+    /** Deployed airdrop clone address. Required — there is no chain-level default. */
+    address: Address;
+    /** Override the FHEVM ACL address (defaults to chain-id lookup). */
+    aclAddress?: Address;
+    /** Override the chain id used for ACL/public-client lookup. Defaults to `usePublicClient().chain?.id`. */
+    chainId?: number;
+}
+/** Stable query-key prefix for every hook in this subpath. */
+export declare const FHE_AIRDROP_KEY: "tokenops-sdk";
+export declare const FHE_AIRDROP_NAMESPACE: "fhe-airdrop";
+/**
+ * Resolve the FHE-airdrop factory address for `chainId`, mirroring the
+ * headless client's resolution. Throws the same {@link TokenOpsSdkError} the
+ * headless client would throw at construction time.
+ */
+export declare function resolveFactoryAddress(override: Address | undefined, chainId: number | undefined): Address;
+/**
+ * Same as {@link resolveFactoryAddress} but returns `undefined` instead of
+ * throwing. Used by query-key builders and `enabled` gates.
+ */
+export declare function tryResolveFactoryAddress(override: Address | undefined, chainId: number | undefined): Address | undefined;
+/**
+ * Memoize an {@link ConfidentialAirdropFactoryClient} keyed on
+ * `(publicClient, walletClient, address)`. The encryptor source is passed
+ * through as a **lazy** function (mirroring Pitfall #3 from CLAUDE.md): the
+ * SDK calls it per-encryption, picking up the live React context at submit
+ * time rather than baking in a stale capture.
+ *
+ * @returns `{ client, publicClient, walletClient }`. `client` is `undefined`
+ *   when no `publicClient` is available (wagmi may briefly return `undefined`
+ *   during reconnects) — gate queries with `enabled: !!client`.
+ */
+export declare function useMemoFactoryClient(opts?: FactoryHookOptions): {
+    client: ConfidentialAirdropFactoryClient | undefined;
+    resolutionError: DeploymentAddressUnavailableError | undefined;
+    publicClient: PublicClient | undefined;
+    walletClient: WalletClient | undefined;
+    chainId: number | undefined;
+    resolvedAddress: Address | undefined;
+};
+/**
+ * Memoize a {@link ConfidentialAirdropClient} keyed on
+ * `(publicClient, walletClient, address, aclAddress)`. The airdrop clone
+ * client does not encrypt — the recipient submits an admin-issued
+ * `{ encryptedInput, signature }` pair as-is — so no encryptor is wired here.
+ */
+export declare function useMemoAirdropClient(opts: AirdropHookOptions): {
+    client: ConfidentialAirdropClient | undefined;
+    publicClient: PublicClient | undefined;
+    walletClient: WalletClient | undefined;
+    chainId: number | undefined;
+};
+/**
+ * Resolve the encryptor for a mutation call. Order:
+ * 1. Explicit `override` (eager `Encryptor` or lazy `() => Encryptor | undefined`).
+ * 2. The hook-level `encryptor` source from the hook options.
+ *
+ * Both are resolved per-call (not cached), mirroring the lazy `EncryptorSource`
+ * pattern from CLAUDE.md Pitfall #3 — the consumer's React context is the
+ * source of truth.
+ *
+ * If both are missing, throws an actionable error. The hook layer does NOT
+ * dynamically import `@zama-fhe/react-sdk` — calling `useZamaSDK()` from
+ * inside `mutationFn` would violate the rules of hooks. Consumers wire the
+ * encryptor at hook construction. The safe pattern is two lines:
+ * `const sdk = useZamaSDK();` then `encryptor: () => sdk.relayer` — never
+ * `() => useZamaSDK().relayer` inline (that calls a React hook inside a
+ * mutation body, violating the rules of hooks).
+ */
+export declare function resolveCallTimeEncryptor(override: Encryptor | EncryptorSource | undefined, hookLevelSource: EncryptorSource | undefined): Encryptor;
+/**
+ * Build a stable TanStack Query key for an FHE-airdrop hook.
+ *
+ * Conventions:
+ * - Lowercase the contract address (TanStack uses structural equality; viem
+ *   sometimes returns checksummed addresses).
+ * - Convert bigints to base-10 strings (TanStack's serializer doesn't handle bigints).
+ */
+export declare function buildQueryKey(method: string, chainId: number | undefined, address: Address | undefined, ...args: ReadonlyArray<unknown>): ReadonlyArray<unknown>;