@unlink-xyz/react 0.1.3-canary.01ac52d → 0.1.3-canary.05ae89f

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { BrowserWalletOptions, SupportedChain, UnlinkWallet, AccountInfo, Account, NoteRecord, BurnerAccount, HistoryStatus, TransferResult, TransferPlanResult, DepositRelayResult, WithdrawalInput, WithdrawResult, WithdrawPlanResult, BurnerSendParams, SimpleBurnerFundParams, SimpleBurnerSweepToPoolParams, SimpleAdapterExecuteParams, AdapterExecuteResult, RelayState, HistoryEntry } from '@unlink-xyz/core';
-export { Account, AccountInfo, AdapterExecuteResult, AdapterExecutionCall, BurnerAccount, BurnerSendParams, Chain, HistoryEntry, InputTokenSpec, NoteRecord, ParsedZkAddress, ReshieldInput, SimpleAdapterExecuteParams, SimpleBurnerFundParams, SimpleBurnerSweepToPoolParams, SupportedChain, TransferPlanResult, TransferResult, TxStatusChangedEvent, UnlinkWallet, WalletSDKEvent, WithdrawPlanResult, WithdrawResult, computeBalances, decodeAddress, encodeAddress, formatAmount, normalizeAddress, parseAmount, parseZkAddress, randomHex, shortenHex } from '@unlink-xyz/core';
+import { BrowserWalletOptions, SupportedChain, Unlink, AccountInfo, Account, NoteRecord, BurnerAccount, HistoryStatus, SignerOverride, SendResult, SendPlanResult, DepositRelayResult, WithdrawalInput, WithdrawResult, WithdrawPlanResult, BurnerSendParams, SimpleBurnerFundParams, SimpleBurnerSweepToPoolParams, SimpleInteractParams, InteractResult, RelayState, HistoryEntry } from '@unlink-xyz/core';
+export { Account, AccountInfo, AdapterExecutionCall, BurnerAccount, BurnerSendParams, Chain, HistoryEntry, InputTokenSpec, InteractResult, NoteRecord, ParsedZkAddress, ReceiveInput, ReshieldInput, SendPlanResult, SendResult, SignerOverride, SimpleBurnerFundParams, SimpleBurnerSweepToPoolParams, SimpleInteractParams, SpendInput, SupportedChain, TransactionLike, TxStatusChangedEvent, Unlink, UnlinkEvent, UnlinkWallet, WalletSDKEvent, WithdrawPlanResult, WithdrawResult, approve, buildApproveCall, computeBalances, contract, decodeAddress, encodeAddress, formatAmount, normalizeAddress, parseAmount, parseZkAddress, randomHex, shortenHex, toCall } from '@unlink-xyz/core';
 
 /**
  * Wallet note with value as bigint for convenience.
@@ -23,7 +23,7 @@ type PendingJobBase = {
 type PendingDepositJob = PendingJobBase & {
     commitment?: string;
 };
-type PendingTransferJob = PendingJobBase & {
+type PendingSendJob = PendingJobBase & {
     recipient: string;
 };
 type PendingWithdrawJob = PendingJobBase & {
@@ -63,8 +63,8 @@ type UnlinkConfig = UnlinkConfigBase & ({
  * State exposed by the useUnlink hook.
  */
 type UnlinkState = {
-    /** The underlying wallet instance */
-    wallet: UnlinkWallet | null;
+    /** The underlying Unlink instance */
+    unlink: Unlink | null;
     /** Whether a wallet (mnemonic) exists */
     walletExists: boolean;
     /** All derived accounts */
@@ -83,8 +83,8 @@ type UnlinkState = {
     burners: BurnerAccount[];
     /** Pending deposit jobs */
     pendingDeposits: PendingDepositJob[];
-    /** Pending transfer jobs */
-    pendingTransfers: PendingTransferJob[];
+    /** Pending send jobs */
+    pendingSends: PendingSendJob[];
     /** Pending withdraw jobs */
     pendingWithdrawals: PendingWithdrawJob[];
     /** Whether the SDK is initialized and ready */
@@ -99,9 +99,9 @@ type UnlinkState = {
     error: UnlinkError | null;
 };
 /**
- * Transfer parameters for useUnlink.send()
+ * Send parameters for useUnlink.send()
  */
-type TransferInput = {
+type SendInput = {
     token: string;
     /** Unlink address (unlink1... bech32m) */
     recipient: string;
@@ -117,7 +117,7 @@ type DepositInput = {
     depositor: string;
 };
 /**
- * Withdraw parameters for useUnlink.requestWithdraw()
+ * Withdraw parameters for useUnlink.withdraw()
  */
 type WithdrawInput = WithdrawalInput;
 /**
@@ -143,28 +143,28 @@ type UnlinkActions = {
      * Multiple transfers are processed atomically.
      *
      * @param params - Array of transfers (token + amount + recipient)
-     * @returns TransferResult with array of plans
+     * @returns SendResult with array of plans
      */
-    send(params: TransferInput[]): Promise<TransferResult>;
+    send(params: SendInput[], overrides?: SignerOverride): Promise<SendResult>;
     /**
-     * Get a transfer plan without executing (for preview).
+     * Get a send plan without executing (for preview).
      * Validates balances and returns plans for each transfer.
      *
      * @param params - Array of transfers (token + amount + recipient)
      * @returns Array of TransactionPlan
      */
-    planTransfer(params: TransferInput[]): Promise<TransferPlanResult>;
-    /** Execute a pre-built transfer plan */
-    executeTransfer(plans: TransferPlanResult): Promise<TransferResult>;
+    planSend(params: SendInput[]): Promise<SendPlanResult>;
+    /** Execute a pre-built send plan */
+    executeSend(plans: SendPlanResult, overrides?: SignerOverride): Promise<SendResult>;
     /**
-     * Request a deposit (1 or more tokens).
+     * Deposit (1 or more tokens).
      * Returns calldata that the user must submit on-chain via their EOA.
      * Use the returned `to` and `calldata` fields to construct the transaction.
      *
      * @param params - Array of deposits (token + amount + depositor)
      * @returns DepositRelayResult with array of commitments
      */
-    requestDeposit(params: DepositInput[]): Promise<DepositRelayResult>;
+    deposit(params: DepositInput[]): Promise<DepositRelayResult>;
     /**
      * High-level withdraw (1 or more tokens).
      * Specify recipient EOA + amount for each withdrawal.
@@ -173,7 +173,7 @@ type UnlinkActions = {
      * @param params - Array of withdrawals (token + amount + recipient)
      * @returns WithdrawResult with array of plans
      */
-    requestWithdraw(params: WithdrawInput[]): Promise<WithdrawResult>;
+    withdraw(params: WithdrawInput[], overrides?: SignerOverride): Promise<WithdrawResult>;
     /**
      * Get a withdrawal plan without executing (for preview).
      * Validates balances and returns plans for each withdrawal.
@@ -183,7 +183,7 @@ type UnlinkActions = {
      */
     planWithdraw(params: WithdrawInput[]): Promise<WithdrawPlanResult>;
     /** Execute a pre-built withdrawal plan */
-    executeWithdraw(plans: WithdrawPlanResult): Promise<WithdrawResult>;
+    executeWithdraw(plans: WithdrawPlanResult, overrides?: SignerOverride): Promise<WithdrawResult>;
     /** Derive and track burner account at index */
     createBurner(index: number): Promise<BurnerAccount>;
     /** Remove tracked burner account (client-side only) */
@@ -203,9 +203,9 @@ type UnlinkActions = {
     /** Get native balance for address */
     burnerGetBalance(address: string): Promise<bigint>;
     /**
-     * Execute an atomic private adapter flow (unshield -> calls -> reshield).
+     * Execute an atomic private DeFi flow (unshield -> calls -> reshield).
      */
-    executeAdapter(params: SimpleAdapterExecuteParams): Promise<AdapterExecuteResult>;
+    interact(params: SimpleInteractParams): Promise<InteractResult>;
     /** Refresh notes and balances */
     refresh(): Promise<void>;
     /** Force full resync from chain */
@@ -294,7 +294,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" | "executeAdapter" | "executeWithdraw" | "createBurner" | "burnerSend" | "burnerFund" | "burnerSweepToPool" | "refresh" | "forceResync";
+type UnlinkErrorOperation = "init" | "createWallet" | "importWallet" | "clearWallet" | "createAccount" | "switchAccount" | "send" | "executeSend" | "deposit" | "withdraw" | "interact" | "executeWithdraw" | "createBurner" | "burnerSend" | "burnerFund" | "burnerSweepToPool" | "refresh" | "forceResync";
 /**
  * Structured error type for the Unlink context.
  */
@@ -350,7 +350,7 @@ type UseUnlinkHistoryResult = {
     refresh: () => Promise<void>;
 };
 /**
- * Hook to get transaction history for the wallet.
+ * Hook to get transaction history for the Unlink instance.
  *
  * Uses the SDK's history service which provides properly categorized
  * transaction entries (Deposit, Receive, Send, SelfSend, Withdraw).
@@ -462,8 +462,8 @@ declare function useUnlinkBalances(): {
 declare function useTxStatus(txId: string | null): UseTxStatusResult;
 
 type UseOperationMutationResult<TInput, TOutput> = {
-    /** Execute the mutation */
-    mutate: (input: TInput) => Promise<TOutput>;
+    /** Execute the operation */
+    execute: (input: TInput) => Promise<TOutput>;
     /** Last successful result */
     data: TOutput | null;
     /** Whether the mutation is currently running */
@@ -477,6 +477,13 @@ type UseOperationMutationResult<TInput, TOutput> = {
     /** Reset state back to idle */
     reset: () => void;
 };
+/**
+ * `UseOperationMutationResult` with `execute` replaced by a semantic action name.
+ * Used by operation-specific hooks (useSend, useDeposit, etc.).
+ */
+type NamedMutationResult<TAction extends string, TInput, TOutput> = Omit<UseOperationMutationResult<TInput, TOutput>, "execute"> & {
+    [K in TAction]: (input: TInput) => Promise<TOutput>;
+};
 /**
  * Generic async mutation state machine for wallet operations.
  *
@@ -486,11 +493,11 @@ type UseOperationMutationResult<TInput, TOutput> = {
  * @example
  * ```tsx
  * function DepositButton() {
- *   const { requestDeposit } = useUnlink();
- *   const { mutate, isPending, error } = useOperationMutation(requestDeposit);
+ *   const { deposit } = useUnlink();
+ *   const { execute, isPending, error } = useOperationMutation(deposit);
  *
  *   return (
- *     <button onClick={() => mutate(params)} disabled={isPending}>
+ *     <button onClick={() => execute(params)} disabled={isPending}>
  *       {isPending ? "Depositing..." : "Deposit"}
  *     </button>
  *   );
@@ -499,13 +506,14 @@ type UseOperationMutationResult<TInput, TOutput> = {
  */
 declare function useOperationMutation<TInput, TOutput>(operation: (input: TInput) => Promise<TOutput>): UseOperationMutationResult<TInput, TOutput>;
 
+type UseDepositResult = NamedMutationResult<"deposit", DepositInput[], DepositRelayResult>;
 /**
  * Hook for requesting deposits with loading/error state.
  *
  * @example
  * ```tsx
  * function DepositForm() {
- *   const { mutate: deposit, isPending, error } = useDeposit();
+ *   const { deposit, isPending, error } = useDeposit();
  *
  *   const handleDeposit = async () => {
  *     const result = await deposit([
@@ -522,15 +530,18 @@ declare function useOperationMutation<TInput, TOutput>(operation: (input: TInput
  * }
  * ```
  */
-declare function useDeposit(): UseOperationMutationResult<DepositInput[], DepositRelayResult>;
+declare function useDeposit(): UseDepositResult;
 
+type UseSendResult = NamedMutationResult<"send", SendInput[], SendResult>;
 /**
  * Hook for sending private transfers with loading/error state.
  *
+ * @param overrides - Optional signer override for multisig transactions
+ *
  * @example
  * ```tsx
  * function SendForm() {
- *   const { mutate: send, isPending, error } = useTransfer();
+ *   const { send, isPending, error } = useSend();
  *
  *   const handleSend = async () => {
  *     const result = await send([
@@ -547,15 +558,18 @@ declare function useDeposit(): UseOperationMutationResult<DepositInput[], Deposi
  * }
  * ```
  */
-declare function useTransfer(): UseOperationMutationResult<TransferInput[], TransferResult>;
+declare function useSend(overrides?: SignerOverride): UseSendResult;
 
+type UseWithdrawResult = NamedMutationResult<"withdraw", WithdrawInput[], WithdrawResult>;
 /**
  * Hook for requesting withdrawals with loading/error state.
  *
+ * @param overrides - Optional signer override for multisig transactions
+ *
  * @example
  * ```tsx
  * function WithdrawForm() {
- *   const { mutate: withdraw, isPending, error } = useWithdraw();
+ *   const { withdraw, isPending, error } = useWithdraw();
  *
  *   const handleWithdraw = async () => {
  *     const result = await withdraw([
@@ -572,24 +586,24 @@ declare function useTransfer(): UseOperationMutationResult<TransferInput[], Tran
  * }
  * ```
  */
-declare function useWithdraw(): UseOperationMutationResult<WithdrawInput[], WithdrawResult>;
+declare function useWithdraw(overrides?: SignerOverride): UseWithdrawResult;
 
+type UseInteractResult = NamedMutationResult<"interact", SimpleInteractParams, InteractResult>;
 /**
- * Hook for executing private DeFi adapter operations with loading/error state.
+ * Hook for executing private DeFi interactions 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 { interact, isPending, error } = useInteract();
  *
  *   const handleSwap = async () => {
- *     const result = await executeAdapter({
- *       adapterAddress: "0x...",
- *       inputs: [{ token: "0x...", amount: 1000n }],
+ *     const result = await interact({
+ *       spend: [{ token: "0x...", amount: 1000n }],
  *       calls: [approveCall, swapCall],
- *       reshields: [{ token: "0x...", minAmount: 500n }],
+ *       receive: [{ token: "0x...", minAmount: 500n }],
  *     });
  *     console.log("Relay ID:", result.relayId);
  *   };
@@ -602,7 +616,7 @@ declare function useWithdraw(): UseOperationMutationResult<WithdrawInput[], With
  * }
  * ```
  */
-declare function useAdapter(): UseOperationMutationResult<SimpleAdapterExecuteParams, AdapterExecuteResult>;
+declare function useInteract(): UseInteractResult;
 
 type BurnerSendInput = {
     index: number;
@@ -634,8 +648,8 @@ type UseBurnerResult = {
  * Hook for burner account operations.
  *
  * `exportKey` is intentionally excluded here and can be accessed via
- * `useUnlink().wallet?.burner.exportKey(index)`.
+ * `useUnlink().unlink?.burner.exportKey(index)`.
  */
 declare function useBurner(): UseBurnerResult;
 
-export { type BurnerFundInput, type BurnerSendInput, type BurnerSweepInput, 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 UseBurnerResult, type UseOperationMutationResult, type UseTxStatusResult, type UseUnlinkBalanceResult, type UseUnlinkHistoryOptions, type UseUnlinkHistoryResult, type WaitForConfirmationOptions, type WalletNote, type WithdrawInput, useAdapter, useBurner, useDeposit, useOperationMutation, useTransfer, useTxStatus, useUnlink, useUnlinkBalance, useUnlinkBalances, useUnlinkHistory, useWithdraw };
+export { type BurnerFundInput, type BurnerSendInput, type BurnerSweepInput, CONFIRMATION_POLL_INTERVAL_MS, DEFAULT_CONFIRMATION_TIMEOUT_MS, type DepositInput, type NamedMutationResult, type PendingDepositJob, type PendingSendJob, type PendingWithdrawJob, type SendInput, TERMINAL_TX_STATES, TimeoutError, TransactionFailedError, type TxState, type TxStatus, type UnlinkActions, type UnlinkConfig, type UnlinkContextValue, type UnlinkError, type UnlinkErrorCode, type UnlinkErrorOperation, UnlinkProvider, type UnlinkProviderProps, type UnlinkState, type UseBurnerResult, type UseDepositResult, type UseInteractResult, type UseOperationMutationResult, type UseSendResult, type UseTxStatusResult, type UseUnlinkBalanceResult, type UseUnlinkHistoryOptions, type UseUnlinkHistoryResult, type UseWithdrawResult, type WaitForConfirmationOptions, type WalletNote, type WithdrawInput, useBurner, useDeposit, useInteract, useOperationMutation, useSend, useTxStatus, useUnlink, useUnlinkBalance, useUnlinkBalances, useUnlinkHistory, useWithdraw };