@unlink-xyz/react 0.1.3-canary.b90837a → 0.1.3-canary.ffa8bc4

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, Environment, 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, 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.
@@ -181,6 +181,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 +273,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.
  */
@@ -549,4 +553,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

@@ -57475,6 +57475,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;
@@ -57648,6 +57678,8 @@ function UnlinkProvider({
       requestDeposit,
       // Withdraw actions
       requestWithdraw,
+      // Adapter actions
+      executeAdapter,
       planWithdraw,
       executeWithdraw,
       // Sync actions
@@ -57673,6 +57705,7 @@ function UnlinkProvider({
       executeTransfer,
       requestDeposit,
       requestWithdraw,
+      executeAdapter,
       planWithdraw,
       executeWithdraw,
       refresh,
@@ -57910,6 +57943,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 +57970,7 @@ export {
   parseZkAddress,
   randomHex,
   shortenHex,
+  useAdapter,
   useDeposit,
   useOperationMutation,
   useTransfer,