@unlink-xyz/react 0.1.3-canary.9185ea0 → 0.1.3-canary.9329a34

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, 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';
+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.
@@ -79,6 +79,8 @@ type UnlinkState = {
     notes: WalletNote[];
     /** Token balances by address */
     balances: Record<string, bigint>;
+    /** Tracked burner accounts */
+    burners: BurnerAccount[];
     /** Pending deposit jobs */
     pendingDeposits: PendingDepositJob[];
     /** Pending transfer jobs */
@@ -182,6 +184,24 @@ 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).
      */
@@ -274,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" | "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.
  */
@@ -584,4 +604,38 @@ declare function useWithdraw(): UseOperationMutationResult<WithdrawInput[], With
  */
 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 };
+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 };

package/dist/index.js

@@ -55656,6 +55656,16 @@ function createAdapterService(deps) {
       const reshieldSpecs = params.reshields.map(
         (reshield, i) => normalizeReshieldSpec(reshield, i)
       );
+      const seenReshieldTokens = /* @__PURE__ */ new Set();
+      for (const r2 of reshieldSpecs) {
+        const lower = r2.token.toLowerCase();
+        if (seenReshieldTokens.has(lower)) {
+          throw new AdapterError(
+            `duplicate reshield token ${r2.token}; each reshield must target a unique token`
+          );
+        }
+        seenReshieldTokens.add(lower);
+      }
       const account = overrides?.account ?? await deps.requireActiveAccount();
       const signer = overrides?.signer ?? deps.requireSigner(account);
       const nowSeconds = BigInt(Math.floor(nowImpl() / 1e3));
@@ -56957,6 +56967,7 @@ var initialState = {
   chainId: null,
   notes: [],
   balances: {},
+  burners: [],
   pendingDeposits: [],
   pendingTransfers: [],
   pendingWithdrawals: [],
@@ -57178,6 +57189,7 @@ function UnlinkProvider({
         accounts,
         activeAccount,
         activeAccountIndex,
+        burners: [],
         busy: false,
         status: accounts.length > 0 ? "Wallet imported" : "Wallet imported - create an account",
         syncError: null,
@@ -57212,6 +57224,7 @@ function UnlinkProvider({
         activeAccountIndex: null,
         notes: [],
         balances: {},
+        burners: [],
         busy: false,
         status: "Wallet cleared",
         syncError: null,
@@ -57567,6 +57580,149 @@ function UnlinkProvider({
       throw err;
     }
   }, []);
+  const createBurner = useCallback(async (index) => {
+    const wallet = walletRef.current;
+    if (!wallet) throw new Error("SDK not initialized");
+    setState((prev2) => ({
+      ...prev2,
+      busy: true,
+      status: `Creating burner ${index}...`
+    }));
+    try {
+      const burner = await wallet.burner.addressOf(index);
+      setState((prev2) => ({
+        ...prev2,
+        burners: [
+          ...prev2.burners.filter((existing) => existing.index !== burner.index),
+          burner
+        ],
+        busy: false,
+        status: `Burner ${index} ready`,
+        error: null
+      }));
+      return burner;
+    } catch (err) {
+      setState((prev2) => ({
+        ...prev2,
+        busy: false,
+        status: `Error: ${err instanceof Error ? err.message : "Unknown"}`,
+        error: createUnlinkError(err, "createBurner")
+      }));
+      throw err;
+    }
+  }, []);
+  const removeBurner = useCallback((index) => {
+    setState((prev2) => ({
+      ...prev2,
+      burners: prev2.burners.filter((burner) => burner.index !== index)
+    }));
+  }, []);
+  const burnerSend = useCallback(
+    async (index, tx) => {
+      const wallet = walletRef.current;
+      if (!wallet) throw new Error("SDK not initialized");
+      setState((prev2) => ({
+        ...prev2,
+        busy: true,
+        status: "Sending burner transaction..."
+      }));
+      try {
+        const result = await wallet.burner.send(index, tx);
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: "Burner transaction sent",
+          error: null
+        }));
+        return result;
+      } catch (err) {
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: `Error: ${err instanceof Error ? err.message : "Unknown"}`,
+          error: createUnlinkError(err, "burnerSend")
+        }));
+        throw err;
+      }
+    },
+    []
+  );
+  const burnerFund = useCallback(
+    async (index, params) => {
+      const wallet = walletRef.current;
+      if (!wallet) throw new Error("SDK not initialized");
+      setState((prev2) => ({
+        ...prev2,
+        busy: true,
+        status: "Funding burner..."
+      }));
+      try {
+        const result = await wallet.burner.fund(index, params);
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: "Burner funded",
+          error: null
+        }));
+        return result;
+      } catch (err) {
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: `Error: ${err instanceof Error ? err.message : "Unknown"}`,
+          error: createUnlinkError(err, "burnerFund")
+        }));
+        throw err;
+      }
+    },
+    []
+  );
+  const burnerSweepToPool = useCallback(
+    async (index, params) => {
+      const wallet = walletRef.current;
+      if (!wallet) throw new Error("SDK not initialized");
+      setState((prev2) => ({
+        ...prev2,
+        busy: true,
+        status: "Sweeping burner to pool..."
+      }));
+      try {
+        const result = await wallet.burner.sweepToPool(index, params);
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: "Burner sweep submitted",
+          error: null
+        }));
+        return result;
+      } catch (err) {
+        setState((prev2) => ({
+          ...prev2,
+          busy: false,
+          status: `Error: ${err instanceof Error ? err.message : "Unknown"}`,
+          error: createUnlinkError(err, "burnerSweepToPool")
+        }));
+        throw err;
+      }
+    },
+    []
+  );
+  const burnerGetTokenBalance = useCallback(
+    async (address, token) => {
+      const wallet = walletRef.current;
+      if (!wallet) throw new Error("SDK not initialized");
+      return wallet.burner.getTokenBalance(address, token);
+    },
+    []
+  );
+  const burnerGetBalance = useCallback(
+    async (address) => {
+      const wallet = walletRef.current;
+      if (!wallet) throw new Error("SDK not initialized");
+      return wallet.burner.getBalance(address);
+    },
+    []
+  );
   const refresh = useCallback(async () => {
     const wallet = walletRef.current;
     if (!wallet) return;
@@ -57702,6 +57858,14 @@ function UnlinkProvider({
       executeAdapter,
       planWithdraw,
       executeWithdraw,
+      // Burner actions
+      createBurner,
+      removeBurner,
+      burnerSend,
+      burnerFund,
+      burnerSweepToPool,
+      burnerGetTokenBalance,
+      burnerGetBalance,
       // Sync actions
       refresh,
       forceResync,
@@ -57727,6 +57891,13 @@ function UnlinkProvider({
       executeAdapter,
       planWithdraw,
       executeWithdraw,
+      createBurner,
+      removeBurner,
+      burnerSend,
+      burnerFund,
+      burnerSweepToPool,
+      burnerGetTokenBalance,
+      burnerGetBalance,
       refresh,
       forceResync,
       clearError,
@@ -57973,6 +58144,46 @@ function useAdapter() {
   );
   return useOperationMutation(op);
 }
+
+// src/useBurner.ts
+import { useCallback as useCallback9 } from "react";
+function useBurner() {
+  const {
+    burners,
+    createBurner,
+    removeBurner,
+    burnerSend,
+    burnerFund,
+    burnerSweepToPool,
+    burnerGetTokenBalance,
+    burnerGetBalance
+  } = useUnlink();
+  const sendOp = useCallback9(
+    (input) => burnerSend(input.index, input.tx),
+    [burnerSend]
+  );
+  const fundOp = useCallback9(
+    (input) => burnerFund(input.index, input.params),
+    [burnerFund]
+  );
+  const sweepOp = useCallback9(
+    (input) => burnerSweepToPool(input.index, input.params),
+    [burnerSweepToPool]
+  );
+  const send = useOperationMutation(sendOp);
+  const fund = useOperationMutation(fundOp);
+  const sweepToPool = useOperationMutation(sweepOp);
+  return {
+    burners,
+    createBurner,
+    removeBurner,
+    send,
+    fund,
+    sweepToPool,
+    getTokenBalance: burnerGetTokenBalance,
+    getBalance: burnerGetBalance
+  };
+}
 export {
   CONFIRMATION_POLL_INTERVAL_MS,
   DEFAULT_CONFIRMATION_TIMEOUT_MS,
@@ -57990,6 +58201,7 @@ export {
   randomHex,
   shortenHex,
   useAdapter,
+  useBurner,
   useDeposit,
   useOperationMutation,
   useTransfer,