@unlink-xyz/react 0.1.0 → 0.1.3-canary.04befc5

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, 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';
 
 /**
  * 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 */
@@ -181,6 +184,28 @@ type UnlinkActions = {
     planWithdraw(params: WithdrawInput[]): Promise<WithdrawPlanResult>;
     /** Execute a pre-built withdrawal plan */
     executeWithdraw(plans: WithdrawPlanResult): 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.
@@ -549,4 +574,68 @@ 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>;
+
+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 { 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 };