@unlink-xyz/react 0.1.5 → 0.1.6

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, BurnerAccount, HistoryStatus, SignerOverride, 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, SignerOverride, SimpleAdapterExecuteParams, SimpleBurnerFundParams, SimpleBurnerSweepToPoolParams, 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,12 +73,14 @@ 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 */
     balances: Record<string, bigint>;
+    /** Tracked burner accounts */
+    burners: BurnerAccount[];
     /** Pending deposit jobs */
     pendingDeposits: PendingDepositJob[];
     /** Pending transfer jobs */
@@ -100,7 +103,7 @@ type UnlinkState = {
  */
 type TransferInput = {
     token: string;
-    /** Unlink address (0zk1... bech32m) */
+    /** Unlink address (unlink1... bech32m) */
     recipient: string;
     amount: bigint;
 };
@@ -142,7 +145,7 @@ type UnlinkActions = {
      * @param params - Array of transfers (token + amount + recipient)
      * @returns TransferResult with array of plans
      */
-    send(params: TransferInput[]): Promise<TransferResult>;
+    send(params: TransferInput[], overrides?: SignerOverride): Promise<TransferResult>;
     /**
      * Get a transfer plan without executing (for preview).
      * Validates balances and returns plans for each transfer.
@@ -152,7 +155,7 @@ type UnlinkActions = {
      */
     planTransfer(params: TransferInput[]): Promise<TransferPlanResult>;
     /** Execute a pre-built transfer plan */
-    executeTransfer(plans: TransferPlanResult): Promise<TransferResult>;
+    executeTransfer(plans: TransferPlanResult, overrides?: SignerOverride): Promise<TransferResult>;
     /**
      * Request a deposit (1 or more tokens).
      * Returns calldata that the user must submit on-chain via their EOA.
@@ -170,7 +173,7 @@ type UnlinkActions = {
      * @param params - Array of withdrawals (token + amount + recipient)
      * @returns WithdrawResult with array of plans
      */
-    requestWithdraw(params: WithdrawInput[]): Promise<WithdrawResult>;
+    requestWithdraw(params: WithdrawInput[], overrides?: SignerOverride): Promise<WithdrawResult>;
     /**
      * Get a withdrawal plan without executing (for preview).
      * Validates balances and returns plans for each withdrawal.
@@ -180,7 +183,29 @@ 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) */
+    removeBurner(index: number): void;
+    /** Send transaction from burner account */
+    burnerSend(index: number, tx: BurnerSendParams): Promise<{
+        txHash: string;
+    }>;
+    /** Fund burner from shielded pool */
+    burnerFund(index: number, params: SimpleBurnerFundParams): Promise<WithdrawResult>;
+    /** Sweep burner funds back to shielded pool */
+    burnerSweepToPool(index: number, params: SimpleBurnerSweepToPoolParams): Promise<{
+        txHash: string;
+    }>;
+    /** Get ERC-20 token balance for address */
+    burnerGetTokenBalance(address: string, token: string): Promise<bigint>;
+    /** Get native balance for address */
+    burnerGetBalance(address: string): Promise<bigint>;
+    /**
+     * 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 +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" | "executeWithdraw" | "refresh" | "forceResync";
+type UnlinkErrorOperation = "init" | "createWallet" | "importWallet" | "clearWallet" | "createAccount" | "switchAccount" | "send" | "executeTransfer" | "requestDeposit" | "requestWithdraw" | "executeAdapter" | "executeWithdraw" | "createBurner" | "burnerSend" | "burnerFund" | "burnerSweepToPool" | "refresh" | "forceResync";
 /**
  * Structured error type for the Unlink context.
  */
@@ -284,7 +309,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.
@@ -437,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 */
@@ -462,10 +487,10 @@ type UseOperationMutationResult<TInput, TOutput> = {
  * ```tsx
  * function DepositButton() {
  *   const { requestDeposit } = useUnlink();
- *   const { mutate, isPending, error } = useOperationMutation(requestDeposit);
+ *   const { execute, isPending, error } = useOperationMutation(requestDeposit);
  *
  *   return (
- *     <button onClick={() => mutate(params)} disabled={isPending}>
+ *     <button onClick={() => execute(params)} disabled={isPending}>
  *       {isPending ? "Depositing..." : "Deposit"}
  *     </button>
  *   );
@@ -502,6 +527,8 @@ declare function useDeposit(): UseOperationMutationResult<DepositInput[], Deposi
 /**
  * Hook for sending private transfers with loading/error state.
  *
+ * @param overrides - Optional signer override for multisig transactions
+ *
  * @example
  * ```tsx
  * function SendForm() {
@@ -509,7 +536,7 @@ declare function useDeposit(): UseOperationMutationResult<DepositInput[], Deposi
  *
  *   const handleSend = async () => {
  *     const result = await send([
- *       { token: "0x...", recipient: "0zk1...", amount: 100n },
+ *       { token: "0x...", recipient: "unlink1...", amount: 100n },
  *     ]);
  *     console.log("Relay ID:", result.relayId);
  *   };
@@ -522,11 +549,13 @@ declare function useDeposit(): UseOperationMutationResult<DepositInput[], Deposi
  * }
  * ```
  */
-declare function useTransfer(): UseOperationMutationResult<TransferInput[], TransferResult>;
+declare function useTransfer(overrides?: SignerOverride): UseOperationMutationResult<TransferInput[], TransferResult>;
 
 /**
  * Hook for requesting withdrawals with loading/error state.
  *
+ * @param overrides - Optional signer override for multisig transactions
+ *
  * @example
  * ```tsx
  * function WithdrawForm() {
@@ -547,6 +576,70 @@ declare function useTransfer(): UseOperationMutationResult<TransferInput[], Tran
  * }
  * ```
  */
-declare function useWithdraw(): UseOperationMutationResult<WithdrawInput[], WithdrawResult>;
+declare function useWithdraw(overrides?: SignerOverride): UseOperationMutationResult<WithdrawInput[], WithdrawResult>;
+
+/**
+ * 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>;
+
+type BurnerSendInput = {
+    index: number;
+    tx: BurnerSendParams;
+};
+type BurnerFundInput = {
+    index: number;
+    params: SimpleBurnerFundParams;
+};
+type BurnerSweepInput = {
+    index: number;
+    params: SimpleBurnerSweepToPoolParams;
+};
+type UseBurnerResult = {
+    burners: BurnerAccount[];
+    createBurner: (index: number) => Promise<BurnerAccount>;
+    removeBurner: (index: number) => void;
+    send: UseOperationMutationResult<BurnerSendInput, {
+        txHash: string;
+    }>;
+    fund: UseOperationMutationResult<BurnerFundInput, WithdrawResult>;
+    sweepToPool: UseOperationMutationResult<BurnerSweepInput, {
+        txHash: string;
+    }>;
+    getTokenBalance: (address: string, token: string) => Promise<bigint>;
+    getBalance: (address: string) => Promise<bigint>;
+};
+/**
+ * Hook for burner account operations.
+ *
+ * `exportKey` is intentionally excluded here and can be accessed via
+ * `useUnlink().wallet?.burner.exportKey(index)`.
+ */
+declare function useBurner(): UseBurnerResult;
 
-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 };
+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 };