@unlink-xyz/react 0.1.3-canary.a96530d → 0.1.3-canary.b0ad588

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { BrowserWalletOptions, Environment, UnlinkWallet, AccountInfo, Account, NoteRecord, HistoryStatus, TransferResult, TransferPlanResult, DepositRelayResult, WithdrawalInput, WithdrawResult, WithdrawPlanResult, RelayState, HistoryEntry } from '@unlink-xyz/core';
-export { Account, AccountInfo, Chain, HistoryEntry, NoteRecord, ParsedZkAddress, TransferPlanResult, TransferResult, TxStatusChangedEvent, UnlinkWallet, WalletSDKEvent, WithdrawPlanResult, WithdrawResult, computeBalances, decodeAddress, encodeAddress, formatAmount, normalizeAddress, parseAmount, parseZkAddress, randomHex, shortenHex } from '@unlink-xyz/core';
+import { BrowserWalletOptions, SupportedChain, UnlinkWallet, AccountInfo, Account, NoteRecord, HistoryStatus, TransferResult, TransferPlanResult, DepositRelayResult, WithdrawalInput, WithdrawResult, WithdrawPlanResult, SimpleAdapterExecuteParams, AdapterExecuteResult, RelayState, HistoryEntry } from '@unlink-xyz/core';
+export { Account, AccountInfo, AdapterExecuteResult, AdapterExecutionCall, Chain, HistoryEntry, InputTokenSpec, NoteRecord, ParsedZkAddress, ReshieldInput, SimpleAdapterExecuteParams, SupportedChain, TransferPlanResult, TransferResult, TxStatusChangedEvent, UnlinkWallet, WalletSDKEvent, WithdrawPlanResult, WithdrawResult, computeBalances, decodeAddress, encodeAddress, formatAmount, normalizeAddress, parseAmount, parseZkAddress, randomHex, shortenHex } from '@unlink-xyz/core';
 
 /**
  * Wallet note with value as bigint for convenience.
@@ -33,8 +33,6 @@ type PendingWithdrawJob = PendingJobBase & {
  * Base configuration shared by all UnlinkProvider variants.
  */
 type UnlinkConfigBase = {
-    /** Chain ID for the target blockchain */
-    chainId: number;
     /** Auto-sync interval in milliseconds (default: 5000) */
     syncInterval?: number;
     /** Whether to start auto-sync on mount (default: true) */
@@ -44,19 +42,22 @@ type UnlinkConfigBase = {
 };
 /**
  * Configuration for the UnlinkProvider.
- * Either provide explicit gatewayUrl + poolAddress, or environment to auto-resolve.
+ * Either provide a chain name to auto-resolve, or explicit gatewayUrl + poolAddress.
  */
 type UnlinkConfig = UnlinkConfigBase & ({
+    /** Supported chain name — resolves chainId, gateway, pool, artifacts */
+    chain: SupportedChain;
+    /** Override pool address from chain config */
+    poolAddress?: string;
+    chainId?: never;
+    gatewayUrl?: never;
+} | {
+    /** Chain ID for the target blockchain */
+    chainId: number;
     /** Explicit gateway URL - requires poolAddress */
     gatewayUrl: string;
     poolAddress: string;
-    environment?: never;
-} | {
-    /** Environment to use from the config file */
-    environment: Environment;
-    /** Pool contract address - optional, defaults to environment config */
-    poolAddress?: string;
-    gatewayUrl?: never;
+    chain?: never;
 });
 /**
  * State exposed by the useUnlink hook.
@@ -72,8 +73,8 @@ type UnlinkState = {
     activeAccount: Account | null;
     /** Current active account index (null if none) */
     activeAccountIndex: number | null;
-    /** Chain ID configured for this provider */
-    chainId: number;
+    /** Chain ID (resolved from chain config or provided explicitly, null before init) */
+    chainId: number | null;
     /** User's notes with value as bigint */
     notes: WalletNote[];
     /** Token balances by address */
@@ -181,6 +182,10 @@ type UnlinkActions = {
     planWithdraw(params: WithdrawInput[]): Promise<WithdrawPlanResult>;
     /** Execute a pre-built withdrawal plan */
     executeWithdraw(plans: WithdrawPlanResult): Promise<WithdrawResult>;
+    /**
+     * Execute an atomic private adapter flow (unshield -> calls -> reshield).
+     */
+    executeAdapter(params: SimpleAdapterExecuteParams): Promise<AdapterExecuteResult>;
     /** Refresh notes and balances */
     refresh(): Promise<void>;
     /** Force full resync from chain */
@@ -269,7 +274,7 @@ type UnlinkErrorCode = "UNKNOWN" | "SDK_NOT_INITIALIZED" | "NETWORK_ERROR" | "VA
 /**
  * Operations that can trigger an error in the Unlink context.
  */
-type UnlinkErrorOperation = "init" | "createWallet" | "importWallet" | "clearWallet" | "createAccount" | "switchAccount" | "send" | "executeTransfer" | "requestDeposit" | "requestWithdraw" | "executeWithdraw" | "refresh" | "forceResync";
+type UnlinkErrorOperation = "init" | "createWallet" | "importWallet" | "clearWallet" | "createAccount" | "switchAccount" | "send" | "executeTransfer" | "requestDeposit" | "requestWithdraw" | "executeAdapter" | "executeWithdraw" | "refresh" | "forceResync";
 /**
  * Structured error type for the Unlink context.
  */
@@ -284,7 +289,7 @@ type UnlinkError = {
 type UnlinkProviderProps = UnlinkConfig & {
     children: ReactNode;
 };
-declare function UnlinkProvider({ children, chainId, poolAddress, syncInterval, autoSync, gatewayUrl, environment, prover, }: UnlinkProviderProps): react_jsx_runtime.JSX.Element;
+declare function UnlinkProvider({ children, poolAddress, syncInterval, autoSync, prover, ...configProps }: UnlinkProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Hook to access the Unlink wallet SDK.
@@ -549,4 +554,34 @@ declare function useTransfer(): UseOperationMutationResult<TransferInput[], Tran
  */
 declare function useWithdraw(): UseOperationMutationResult<WithdrawInput[], WithdrawResult>;
 
-export { CONFIRMATION_POLL_INTERVAL_MS, DEFAULT_CONFIRMATION_TIMEOUT_MS, type DepositInput, type PendingDepositJob, type PendingTransferJob, type PendingWithdrawJob, TERMINAL_TX_STATES, TimeoutError, TransactionFailedError, type TransferInput, type TxState, type TxStatus, type UnlinkActions, type UnlinkConfig, type UnlinkContextValue, type UnlinkError, type UnlinkErrorCode, type UnlinkErrorOperation, UnlinkProvider, type UnlinkProviderProps, type UnlinkState, type UseOperationMutationResult, type UseTxStatusResult, type UseUnlinkBalanceResult, type UseUnlinkHistoryOptions, type UseUnlinkHistoryResult, type WaitForConfirmationOptions, type WalletNote, type WithdrawInput, useDeposit, useOperationMutation, useTransfer, useTxStatus, useUnlink, useUnlinkBalance, useUnlinkBalances, useUnlinkHistory, useWithdraw };
+/**
+ * Hook for executing private DeFi adapter operations with loading/error state.
+ *
+ * Performs atomic unshield → DeFi call(s) → reshield flows through an adapter contract.
+ *
+ * @example
+ * ```tsx
+ * function SwapButton() {
+ *   const { mutate: executeAdapter, isPending, error } = useAdapter();
+ *
+ *   const handleSwap = async () => {
+ *     const result = await executeAdapter({
+ *       adapterAddress: "0x...",
+ *       inputs: [{ token: "0x...", amount: 1000n }],
+ *       calls: [approveCall, swapCall],
+ *       reshields: [{ token: "0x...", minAmount: 500n }],
+ *     });
+ *     console.log("Relay ID:", result.relayId);
+ *   };
+ *
+ *   return (
+ *     <button onClick={handleSwap} disabled={isPending}>
+ *       {isPending ? "Executing..." : "Swap"}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useAdapter(): UseOperationMutationResult<SimpleAdapterExecuteParams, AdapterExecuteResult>;
+
+export { CONFIRMATION_POLL_INTERVAL_MS, DEFAULT_CONFIRMATION_TIMEOUT_MS, type DepositInput, type PendingDepositJob, type PendingTransferJob, type PendingWithdrawJob, TERMINAL_TX_STATES, TimeoutError, TransactionFailedError, type TransferInput, type TxState, type TxStatus, type UnlinkActions, type UnlinkConfig, type UnlinkContextValue, type UnlinkError, type UnlinkErrorCode, type UnlinkErrorOperation, UnlinkProvider, type UnlinkProviderProps, type UnlinkState, type UseOperationMutationResult, type UseTxStatusResult, type UseUnlinkBalanceResult, type UseUnlinkHistoryOptions, type UseUnlinkHistoryResult, type WaitForConfirmationOptions, type WalletNote, type WithdrawInput, useAdapter, useDeposit, useOperationMutation, useTransfer, useTxStatus, useUnlink, useUnlinkBalance, useUnlinkBalances, useUnlinkHistory, useWithdraw };

package/dist/index.js

@@ -35871,63 +35871,79 @@ var Runtime = {
   }
 };
 var CONFIG_URL = "https://config.unlink.xyz/networks.json";
-function parseRequiredString(env22, field, value) {
+function parseRequiredString(chain2, field, value) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new InitializationError(
-      `Invalid SDK config for ${env22}: ${field} must be a non-empty string`
+      `Invalid SDK config for ${chain2}: ${field} must be a non-empty string`
     );
   }
   return value.trim();
 }
-function parseOptionalString(env22, field, value) {
+function parseOptionalString(chain2, field, value) {
   if (value === void 0) return void 0;
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new InitializationError(
-      `Invalid SDK config for ${env22}: ${field} must be a non-empty string when provided`
+      `Invalid SDK config for ${chain2}: ${field} must be a non-empty string when provided`
     );
   }
   return value.trim();
 }
-function parseEnvironmentConfig(env22, value) {
+function parseRequiredChainId(chain2, value) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+    throw new InitializationError(
+      `Invalid SDK config for ${chain2}: chainId must be a positive integer`
+    );
+  }
+  return value;
+}
+function parseChainConfig(chain2, value) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     throw new InitializationError(
-      `Invalid SDK config for ${env22}: expected object`
+      `Invalid SDK config for ${chain2}: expected object`
     );
   }
   const raw = value;
+  const chainId = parseRequiredChainId(chain2, raw.chainId);
   const gatewayUrl = parseRequiredString(
-    env22,
+    chain2,
     "gatewayUrl",
     raw.gatewayUrl
   ).replace(/\/+$/, "");
-  const poolAddress = parseRequiredString(env22, "poolAddress", raw.poolAddress);
+  const poolAddress = parseRequiredString(
+    chain2,
+    "poolAddress",
+    raw.poolAddress
+  );
   const artifactVersion = parseRequiredString(
-    env22,
+    chain2,
     "artifactVersion",
     raw.artifactVersion
   ).replace(/^\/+|\/+$/g, "");
   const artifactBaseUrl = parseOptionalString(
-    env22,
+    chain2,
     "artifactBaseUrl",
     raw.artifactBaseUrl
   )?.replace(/\/+$/, "");
   return {
+    chainId,
     gatewayUrl,
     poolAddress,
     artifactVersion,
     ...artifactBaseUrl !== void 0 ? { artifactBaseUrl } : { artifactBaseUrl: DEFAULT_ARTIFACT_BASE_URL }
   };
 }
-async function fetchEnvironmentConfig(env22) {
+async function fetchChainConfig(chain2) {
   const res = await fetch(CONFIG_URL);
   if (!res.ok) {
     throw new InitializationError(`Failed to fetch SDK config: ${res.status}`);
   }
   const config22 = await res.json();
-  if (!config22[env22]) {
-    throw new InitializationError(`Unknown environment: ${env22}`);
+  if (!config22[chain2]) {
+    throw new InitializationError(
+      `Unknown chain: "${chain2}". Supported chains: ${Object.keys(config22).join(", ")}`
+    );
   }
-  return parseEnvironmentConfig(env22, config22[env22]);
+  return parseChainConfig(chain2, config22[chain2]);
 }
 function createServiceConfig(gatewayUrl) {
   const baseUrl = gatewayUrl.replace(/\/+$/, "");
@@ -56536,34 +56552,37 @@ var UnlinkWallet = class _UnlinkWallet {
    * Create a new UnlinkWallet instance.
    *
    * Handles all initialization internally:
-   * - Resolves environment config (if using `environment` instead of explicit URLs)
+   * - Resolves chain config (if using `chain` instead of explicit URLs)
    * - Auto-detects storage (IndexedDB in browser) and rng (crypto.getRandomValues)
    * - Runs schema migration via `initCore()`
    * - Creates the internal SDK
    */
   static async create(config22) {
+    let chainId;
     let gatewayUrl;
     let poolAddress;
     let proverConfig = config22.prover;
-    if ("gatewayUrl" in config22) {
+    if ("chain" in config22) {
+      const chainConfig = await fetchChainConfig(config22.chain);
+      chainId = chainConfig.chainId;
+      gatewayUrl = chainConfig.gatewayUrl;
+      poolAddress = config22.poolAddress ?? chainConfig.poolAddress;
+      proverConfig = {
+        artifactSource: {
+          baseUrl: config22.prover?.artifactSource?.baseUrl ?? chainConfig.artifactBaseUrl,
+          version: config22.prover?.artifactSource?.version ?? chainConfig.artifactVersion,
+          preferLocalFiles: config22.prover?.artifactSource?.preferLocalFiles
+        }
+      };
+    } else {
+      chainId = config22.chainId;
       gatewayUrl = config22.gatewayUrl;
       poolAddress = config22.poolAddress;
       if (typeof window !== "undefined" && !config22.prover?.artifactSource?.version) {
         throw new InitializationError(
-          "prover.artifactSource.version is required in browser when using explicit gatewayUrl mode. Use environment mode or provide a pinned artifact version."
+          "prover.artifactSource.version is required in browser when using explicit gatewayUrl mode. Use chain mode or provide a pinned artifact version."
         );
       }
-    } else {
-      const envConfig = await fetchEnvironmentConfig(config22.environment);
-      gatewayUrl = envConfig.gatewayUrl;
-      poolAddress = config22.poolAddress ?? envConfig.poolAddress;
-      proverConfig = {
-        artifactSource: {
-          baseUrl: config22.prover?.artifactSource?.baseUrl ?? envConfig.artifactBaseUrl,
-          version: config22.prover?.artifactSource?.version ?? envConfig.artifactVersion,
-          preferLocalFiles: config22.prover?.artifactSource?.preferLocalFiles
-        }
-      };
     }
     const storage = config22.storage ?? detectStorage();
     const rng = config22.rng ?? defaultRng;
@@ -56572,14 +56591,14 @@ var UnlinkWallet = class _UnlinkWallet {
     const sdk = createWalletSDK(
       { core, fetch: fetchImpl },
       {
-        chainId: config22.chainId,
+        chainId,
         gatewayUrl,
         chainRpcUrl: config22.chainRpcUrl,
         prover: proverConfig,
         autoSync: config22.autoSync
       }
     );
-    return new _UnlinkWallet(sdk, config22.chainId, poolAddress);
+    return new _UnlinkWallet(sdk, chainId, poolAddress);
   }
   // ===== Seed Lifecycle =====
   /** Seed management (create, import, export, delete mnemonic). */
@@ -56935,6 +56954,7 @@ var initialState = {
   accounts: [],
   activeAccount: null,
   activeAccountIndex: null,
+  chainId: null,
   notes: [],
   balances: {},
   pendingDeposits: [],
@@ -56954,14 +56974,15 @@ function convertNotes(noteRecords) {
 }
 function UnlinkProvider({
   children,
-  chainId,
   poolAddress,
   syncInterval = 5e3,
   autoSync = true,
-  gatewayUrl,
-  environment,
-  prover
+  prover,
+  ...configProps
 }) {
+  const chain2 = "chain" in configProps ? configProps.chain : void 0;
+  const chainId = "chainId" in configProps ? configProps.chainId : void 0;
+  const gatewayUrl = "gatewayUrl" in configProps ? configProps.gatewayUrl : void 0;
   const [state, setState] = useState(initialState);
   const walletRef = useRef(null);
   const proverKey = JSON.stringify(prover ?? null);
@@ -56991,13 +57012,13 @@ function UnlinkProvider({
     }
   }, []);
   useEffect(() => {
-    if (!gatewayUrl && !environment) {
+    if (!chain2 && !gatewayUrl) {
       const configError = new ValidationError(
-        "Either gatewayUrl or environment is required"
+        "Either chain or gatewayUrl is required"
       );
       setState((prev2) => ({
         ...prev2,
-        status: "Error: Either gatewayUrl or environment is required",
+        status: "Error: Either chain or gatewayUrl is required",
         error: createUnlinkError(configError, "init")
       }));
       return;
@@ -57011,14 +57032,13 @@ function UnlinkProvider({
           status: "Initializing SDK..."
         }));
         const wallet = await UnlinkWallet.create(
-          gatewayUrl ? {
-            chainId,
-            gatewayUrl,
+          chain2 ? {
+            chain: chain2,
             poolAddress,
             ...prover ? { prover } : {}
           } : {
             chainId,
-            environment,
+            gatewayUrl,
             poolAddress,
             ...prover ? { prover } : {}
           }
@@ -57059,6 +57079,7 @@ function UnlinkProvider({
           accounts,
           activeAccount,
           activeAccountIndex,
+          chainId: wallet.chainId,
           notes,
           balances,
           ready: true,
@@ -57069,7 +57090,7 @@ function UnlinkProvider({
           wallet.startAutoSync(syncInterval);
         }
         unsubscribe = wallet.on((event) => {
-          if (event.type === "notes-updated" && event.chainId === chainId) {
+          if (event.type === "notes-updated" && event.chainId === wallet.chainId) {
             setState((prev2) => ({ ...prev2, syncError: null }));
             void refreshState(wallet);
           }
@@ -57103,13 +57124,13 @@ function UnlinkProvider({
       walletRef.current?.stopAutoSync();
     };
   }, [
+    chain2,
     chainId,
     autoSync,
     syncInterval,
     refreshState,
     refreshAccounts,
     gatewayUrl,
-    environment,
     poolAddress,
     proverKey
   ]);
@@ -57475,6 +57496,36 @@ function UnlinkProvider({
     },
     []
   );
+  const executeAdapter = useCallback(
+    async (params) => {
+      const wallet = walletRef.current;
+      if (!wallet) throw new Error("SDK not initialized");
+      setState((prev2) => ({
+        ...prev2,
+        busy: true,
+        status: "Executing adapter..."
+      }));
+      try {
+        const result = await wallet.adapter.execute(params);
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: "Adapter execution submitted",
+          error: null
+        }));
+        return result;
+      } catch (err) {
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: `Error: ${err instanceof Error ? err.message : "Unknown"}`,
+          error: createUnlinkError(err, "executeAdapter")
+        }));
+        throw err;
+      }
+    },
+    []
+  );
   const planWithdraw = useCallback(
     async (params) => {
       const wallet = walletRef.current;
@@ -57631,7 +57682,6 @@ function UnlinkProvider({
   const value = useMemo(
     () => ({
       ...state,
-      chainId,
       // Wallet actions
       createWallet,
       importWallet,
@@ -57648,6 +57698,8 @@ function UnlinkProvider({
       requestDeposit,
       // Withdraw actions
       requestWithdraw,
+      // Adapter actions
+      executeAdapter,
       planWithdraw,
       executeWithdraw,
       // Sync actions
@@ -57661,7 +57713,6 @@ function UnlinkProvider({
     }),
     [
       state,
-      chainId,
       createWallet,
       importWallet,
       exportMnemonic,
@@ -57673,6 +57724,7 @@ function UnlinkProvider({
       executeTransfer,
       requestDeposit,
       requestWithdraw,
+      executeAdapter,
       planWithdraw,
       executeWithdraw,
       refresh,
@@ -57910,6 +57962,17 @@ function useWithdraw() {
   );
   return useOperationMutation(op);
 }
+
+// src/useAdapter.ts
+import { useCallback as useCallback8 } from "react";
+function useAdapter() {
+  const { executeAdapter } = useUnlink();
+  const op = useCallback8(
+    (params) => executeAdapter(params),
+    [executeAdapter]
+  );
+  return useOperationMutation(op);
+}
 export {
   CONFIRMATION_POLL_INTERVAL_MS,
   DEFAULT_CONFIRMATION_TIMEOUT_MS,
@@ -57926,6 +57989,7 @@ export {
   parseZkAddress,
   randomHex,
   shortenHex,
+  useAdapter,
   useDeposit,
   useOperationMutation,
   useTransfer,