@tokenops/sdk 1.1.1 → 1.6.0

package/dist/testnet-faucet/react/index.js

@@ -1,15 +1,15 @@
-import { createTestnetFaucetClient, isTestnetFaucetChainId } from '../../chunk-QE7ZONJ2.js';
-export { FaucetSupplyExhaustedError } from '../../chunk-QE7ZONJ2.js';
-import '../../chunk-JFLEEXKP.js';
-import { getConfidentialTestTokenAddress } from '../../chunk-M7V2EDPB.js';
-import '../../chunk-BE2AIZ3K.js';
+import { createTestnetFaucetClient, isTestnetFaucetChainId } from '../../chunk-WTK6JDSI.js';
+export { FaucetSupplyExhaustedError } from '../../chunk-WTK6JDSI.js';
+import { useWagmiAccount } from '../../chunk-FT4LNBOS.js';
+import '../../chunk-6WSNS3UV.js';
+import { getConfidentialTestTokenAddress } from '../../chunk-QKKBBH7I.js';
+import '../../chunk-46T67CE2.js';
+import { MissingClientError, UnsupportedChainError, DeploymentAddressUnavailableError } from '../../chunk-DRSPMIZ7.js';
+export { AccessDeniedError, AlreadyInitializedError, BatchTooLargeError, ContractRevertError, DecryptionFailedError, DeploymentAddressUnavailableError, EncryptionFailedError, FeatureDisabledError, FheHandleNotAllowedError, InsufficientBalanceError, InsufficientFeeError, InsufficientGasFundsError, InvalidArgumentError, InvalidSignatureError, MissingAccountError, MissingClientError, MissingEncryptorError, MissingPublicClientError, MissingWalletClientError, NetworkError, OperatorNotApprovedError, PausedError, ReceiptEventAmbiguousError, ReceiptEventNotFoundError, ReentrancyError, RelayerUnreachableError, SigningFailedError, TokenOpsContractError, TokenOpsSdkError, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../../chunk-DRSPMIZ7.js';
 import '../../chunk-Q2GP5UDC.js';
-import '../../chunk-KWFFIJYX.js';
-import { MissingClientError, UnsupportedChainError, DeploymentAddressUnavailableError } from '../../chunk-IVE3QEGD.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, TransferFailedError, UnknownWriteFailureError, UnsupportedChainError, UserDecryptNotAllowedError, UserRejectedSignatureError, WalletChainMismatchError, WalletRejectedError, isTokenOpsSdkError } from '../../chunk-IVE3QEGD.js';
 import { useQuery, useMutation } from '@tanstack/react-query';
-import { useAccount, usePublicClient, useWalletClient } from 'wagmi';
 import { useMemo } from 'react';
+import { usePublicClient, useWalletClient } from 'wagmi';
 
 var TESTNET_FAUCET_KEY = "tokenops-sdk";
 var TESTNET_FAUCET_NAMESPACE = "testnet-faucet";
@@ -95,7 +95,7 @@ function normalizeKeyArg(value) {
 function useConfidentialBalance(args = {}) {
   const { account, ...base } = args;
   const { client, chainId, resolvedAddress } = useMemoFaucetClient(base);
-  const { address: connected } = useAccount();
+  const { address: connected } = useWagmiAccount();
   const resolvedAccount = account ?? connected;
   return useQuery({
     queryKey: buildQueryKey("confidentialBalanceOf", chainId, resolvedAddress, resolvedAccount),
@@ -107,7 +107,7 @@ function useConfidentialBalance(args = {}) {
 function useUnderlyingBalance(args = {}) {
   const { account, ...base } = args;
   const { client, chainId, resolvedAddress } = useMemoFaucetClient(base);
-  const { address: connected } = useAccount();
+  const { address: connected } = useWagmiAccount();
   const resolvedAccount = account ?? connected;
   return useQuery({
     // The TTT is derived from the CTTT, which is already keyed via

package/dist/testnet-faucet/react/useConfidentialBalance.d.ts

@@ -4,8 +4,9 @@ import { type BaseHookOptions } from "./_shared.js";
 export interface UseConfidentialBalanceArgs extends BaseHookOptions {
     /**
      * Account whose confidential balance handle to read. Defaults to the
-     * connected wallet (`useAccount().address`). The hook stays disabled until an
-     * account is available.
+     * connected wallet (wagmi v2 `useAccount().address` / v3
+     * `useConnection().address`). The hook stays disabled until an account is
+     * available.
      */
     account?: Address;
 }

package/dist/testnet-faucet/react/useUnderlyingBalance.d.ts

@@ -4,8 +4,8 @@ import { type BaseHookOptions } from "./_shared.js";
 export interface UseUnderlyingBalanceArgs extends BaseHookOptions {
     /**
      * Account whose underlying TTT balance to read. Defaults to the connected
-     * wallet (`useAccount().address`). The hook stays disabled until an account
-     * is available.
+     * wallet (wagmi v2 `useAccount().address` / v3 `useConnection().address`).
+     * The hook stays disabled until an account is available.
      */
     account?: Address;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenops/sdk",
-  "version": "1.1.1",
+  "version": "1.6.0",
   "description": "Typed viem-first SDK for TokenOps FHEVM contracts (confidential vesting, confidential airdrops, confidential disperse, plus a testnet faucet for the ERC-7984 test-token pair TTT + CTTT) — consumed by tokenops-app (Next.js) and tokenops-api (Express).",
   "type": "module",
   "sideEffects": false,
@@ -267,6 +267,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:unit": "vitest run src",
+    "test:hooks": "vitest run src/core/wagmi-compat.test.ts test/fhe-vesting/react test/fhe-airdrop/react test/fhe-disperse/react test/testnet-faucet/react test/fhe/react test/react",
     "test:local": "vitest run test",
     "test:local-all": "./scripts/run-local-fhevm-tests.sh",
     "test:sepolia": "vitest run test --reporter=verbose",
@@ -289,7 +290,7 @@
     "@zama-fhe/sdk": "^3.0.0",
     "react": ">=18.0.0",
     "viem": "^2.47.0",
-    "wagmi": "^2.0.0"
+    "wagmi": "^2.0.0 || ^3.0.0"
   },
   "peerDependenciesMeta": {
     "@zama-fhe/sdk": {
@@ -315,25 +316,30 @@
     "overrides": {
       "@types/react": "19.2.15",
       "@types/react-dom": "19.2.3",
-      "axios@<1.15.2": "^1.16.1",
+      "axios@<1.18.0": "^1.18.0",
       "form-data@<4.0.6": "^4.0.6",
       "dompurify@<3.4.11": "^3.4.11",
       "ws@>=8.0.0 <8.20.1": "^8.21.0",
       "ws@>=7.0.0 <7.5.11": "^7.5.11",
-      "postcss@>=8.0.0 <8.5.10": "^8.5.15",
+      "postcss@<8.5.18": "8.5.23",
       "esbuild@<0.28.1": "^0.28.1",
       "vite@<6.4.3": "^6.4.3",
-      "hono@<4.12.25": "^4.12.25",
-      "js-yaml@<4.2.0": "^4.2.0",
+      "hono@<4.12.27": "^4.12.27",
+      "js-yaml@<4.3.0": "^4.3.0",
       "uuid@<11.1.1": "^11.1.1",
       "linkifyjs@<4.3.2": "^4.3.3",
+      "linkify-it@<5.0.2": "^5.0.2",
+      "fast-uri@>=3.0.0 <3.1.4": "^3.1.4",
+      "brace-expansion@<1.1.16": "^1.1.16",
+      "brace-expansion@>=2.0.0 <2.1.3": "^2.1.3",
+      "brace-expansion@>=3.0.0 <5.0.8": "^5.0.8",
       "@privy-io/js-sdk-core@<0.56.0": "^0.56.4"
     }
   },
   "devDependencies": {
     "@commitlint/cli": "^20.0.0",
     "@commitlint/config-conventional": "^20.0.0",
-    "@eslint/js": "^9.0.0",
+    "@eslint/js": "^10.0.1",
     "@fhevm/mock-utils": "^0.4.2",
     "@microsoft/api-extractor": "^7.58.7",
     "@tanstack/react-query": "^5.100.11",
@@ -343,7 +349,7 @@
     "@types/react-dom": "^18.3.7",
     "@vitest/coverage-v8": "^3.2.6",
     "@zama-fhe/sdk": "^3.0.0",
-    "eslint": "^9.0.0",
+    "eslint": "^10.8.0",
     "eslint-config-prettier": "^10.0.0",
     "ethers": "^6.16.0",
     "happy-dom": "^20.9.0",

package/dist/chunk-66IHPTOK.cjs

@@ -1,20 +0,0 @@
-'use strict';
-
-// src/core/brands.ts
-var asEncryptedHandle = (h) => h;
-var asExternalInputProof = (h) => h;
-var asTxHash = (h) => h;
-var asVestingId = (h) => h;
-var asAirdropId = (h) => h;
-var asDisperseId = (h) => h;
-var asRole = (h) => h;
-var asSignature = (h) => h;
-
-exports.asAirdropId = asAirdropId;
-exports.asDisperseId = asDisperseId;
-exports.asEncryptedHandle = asEncryptedHandle;
-exports.asExternalInputProof = asExternalInputProof;
-exports.asRole = asRole;
-exports.asSignature = asSignature;
-exports.asTxHash = asTxHash;
-exports.asVestingId = asVestingId;

package/dist/chunk-KWFFIJYX.js

@@ -1,11 +0,0 @@
-// src/core/brands.ts
-var asEncryptedHandle = (h) => h;
-var asExternalInputProof = (h) => h;
-var asTxHash = (h) => h;
-var asVestingId = (h) => h;
-var asAirdropId = (h) => h;
-var asDisperseId = (h) => h;
-var asRole = (h) => h;
-var asSignature = (h) => h;
-
-export { asAirdropId, asDisperseId, asEncryptedHandle, asExternalInputProof, asRole, asSignature, asTxHash, asVestingId };

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

@@ -1,25 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { TxHash } from "../../core/brands.js";
-import type { ClaimArgs } from "../airdrop.js";
-import { type AirdropHookOptions } from "./_shared.js";
-/**
- * Claim tokens from an airdrop using an EIP-712 admin signature. The SDK
- * encrypts the plaintext `amount` into an `externalEuint64` and submits it
- * with an input proof — callers never handle ciphertext. Attaches `GAS_FEE()`
- * ETH automatically unless `args.value` is set.
- *
- * **Encryptor resolution.** The hook-level `encryptor` (from
- * {@link AirdropHookOptions}) 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.
- *
- * After a successful claim, invalidate
- * `useAirdropIsSignatureClaimed({ user, encryptedAmountHandle })` and any
- * UI counts you computed off it.
- *
- * @example
- * const claim = useAirdropClaim({ address: airdropAddress, encryptor: () => useZamaSDK().relayer });
- * claim.mutate({ amount: 1_000_000n, signature });
- */
-export declare function useAirdropClaim(options: AirdropHookOptions): UseMutationResult<TxHash, Error, ClaimArgs>;

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-vesting/react/useGetClaimableAmount.d.ts

@@ -1,13 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import type { EncryptedViewResult } from "../manager.js";
-import { type ManagerHookOptions } from "./_shared.js";
-export interface UseGetClaimableAmountArgs {
-    vestingId: Hex;
-    account?: Account | Address;
-}
-/**
- * **Submits a transaction** to read the currently-claimable amount as an
- * `euint128` handle. Pass `data.handle` to the Zama relayer's `userDecrypt`.
- */
-export declare function useGetClaimableAmount(options: ManagerHookOptions): UseMutationResult<EncryptedViewResult, Error, UseGetClaimableAmountArgs>;

package/dist/fhe-vesting/react/useGetSettledAmount.d.ts

@@ -1,14 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import type { EncryptedViewResult } from "../manager.js";
-import { type ManagerHookOptions } from "./_shared.js";
-export interface UseGetSettledAmountArgs {
-    vestingId: Hex;
-    account?: Account | Address;
-}
-/**
- * **Submits a transaction** to read the already-claimed (settled) amount of a
- * vesting as an `euint128` handle. Pass `data.handle` to the Zama relayer's
- * `userDecrypt`.
- */
-export declare function useGetSettledAmount(options: ManagerHookOptions): UseMutationResult<EncryptedViewResult, Error, UseGetSettledAmountArgs>;

package/dist/fhe-vesting/react/useGetTotalAllocation.d.ts

@@ -1,13 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import type { EncryptedViewResult } from "../manager.js";
-import { type ManagerHookOptions } from "./_shared.js";
-export interface UseGetTotalAllocationArgs {
-    vestingId: Hex;
-    account?: Account | Address;
-}
-/**
- * **Submits a transaction** to read the total allocation of a vesting as an
- * `euint128` handle. Pass `data.handle` to the Zama relayer's `userDecrypt`.
- */
-export declare function useGetTotalAllocation(options: ManagerHookOptions): UseMutationResult<EncryptedViewResult, Error, UseGetTotalAllocationArgs>;

package/dist/fhe-vesting/react/useGetVestedAmount.d.ts

@@ -1,25 +0,0 @@
-import { type UseMutationResult } from "@tanstack/react-query";
-import type { Account, Address, Hex } from "viem";
-import type { EncryptedViewResult } from "../manager.js";
-import { type ManagerHookOptions } from "./_shared.js";
-export interface UseGetVestedAmountArgs {
-    vestingId: Hex;
-    /** Unix timestamp (seconds) — `Math.floor(Date.now() / 1000)` for "now". */
-    timestamp: number;
-    account?: Account | Address;
-}
-/**
- * **Submits a transaction** to read the vested amount at a given timestamp as
- * an `euint128` handle. The contract performs `FHE.allow(handle, msg.sender)`
- * so persistent ACL is granted to the caller; the SDK parses the handle from
- * the receipt's `ACL.Allowed` event (NOT from simulation — that returns a
- * different, ACL-less handle).
- *
- * Pass `data.handle` to the Zama relayer's `userDecrypt` to get the plaintext.
- *
- * @example
- * const getVested = useGetVestedAmount({ address: managerAddress });
- * getVested.mutate({ vestingId, timestamp: Math.floor(Date.now() / 1000) });
- * // getVested.data → { handle: "0x...", hash: "0x..." }
- */
-export declare function useGetVestedAmount(options: ManagerHookOptions): UseMutationResult<EncryptedViewResult, Error, UseGetVestedAmountArgs>;