@owney/sdk 0.7.25-beta.3 → 0.7.26-beta.0

package/dist/index.d.ts

@@ -1,6 +1,197 @@
-import { Hex } from 'viem';
 import { SIWXConfig } from '@reown/appkit-controllers';
 
+/**
+ * Swap-to-yield types (ROUT-242).
+ *
+ * The SDK never talks to 1inch directly — the API key is a paid credential and
+ * lives in the routing API. Everything here describes the routing API's
+ * `/api/v1/swap/*` contract.
+ */
+/**
+ * Which rail a swap rides, decided server-side from the chains.
+ *
+ * `classic` — same chain. One atomic transaction: it either completes or
+ * nothing moved.
+ *
+ * `fusion-plus` — crossing chains. The user's funds sit in an escrow while a
+ * resolver fills the other side, so the order has a lifecycle and can end in
+ * `expired` → `refunding` → `refunded` without ever depositing.
+ */
+type SwapRail = "classic" | "fusion-plus";
+type SwapTokenInfo = {
+    readonly symbol: string;
+    readonly address: string;
+    readonly decimals: number;
+    /** Native asset (ETH). A swap SOURCE only — never a deposit target. */
+    readonly isNative?: true;
+};
+type SwapChainTokens = {
+    readonly chainId: number;
+    /** What the user may pay with. */
+    readonly sources: readonly SwapTokenInfo[];
+    /** What a swap may resolve into — what Owney actually deposits. */
+    readonly depositTargets: readonly SwapTokenInfo[];
+    /**
+     * How many more sources `searchSwapTokens` could reach on this chain.
+     *
+     * `sources` is the short list worth showing unprompted; the full set runs to
+     * thousands per chain, which is not something to download to render a
+     * picker. A non-zero count here is what tells the UI a search box is worth
+     * offering. Zero, absent, or an older routing API all mean the same thing:
+     * the short list is everything.
+     */
+    readonly searchableSources?: number;
+};
+/**
+ * A search hit from `searchSwapTokens`.
+ *
+ * Richer than `SwapTokenInfo` because the search endpoint returns more than
+ * the bulk list does, and the extra fields are the ones a picker needs to let
+ * someone choose safely between three tokens all called PEPE.
+ */
+type SwapTokenSearchResult = SwapTokenInfo & {
+    readonly chainId: number;
+    readonly name?: string;
+    readonly logoURI?: string;
+    /**
+     * The token lists carrying this address, by NAME — ["1inch", "CoinGecko"].
+     *
+     * An array, not a count. It was typed as a number first, and a UI that
+     * rendered it straight into a row got "1inch,CoinGecko lists".
+     *
+     * The best available "is this the real one" signal: the genuine mainnet PEPE
+     * is on several lists, a lookalike on one. Worth sorting on; the names are
+     * too long to put on a row.
+     */
+    readonly providers?: readonly string[];
+    /**
+     * Fee-on-transfer: less arrives than was sent. The swap still works (arrival
+     * is measured, not assumed) but any figure quoted to the user beforehand
+     * will read high.
+     */
+    readonly isFoT?: boolean;
+    /** 1inch's own ranking. Not a trust score — an unverified token can outrank
+     *  an established one, so do not present it as safety. */
+    readonly rating?: string;
+};
+type SwapQuote = {
+    rail: SwapRail;
+    src: {
+        chainId: number;
+        symbol: string;
+        address: string;
+        amount: string;
+    };
+    dst: {
+        chainId: number;
+        symbol: string;
+        address: string;
+        amount: string;
+    };
+    /**
+     * Worst-case output once the Dutch auction has fully decayed. Gate minimum
+     * deposit checks on THIS, not `dst.amount` — a fill at auction end that lands
+     * under the agent's floor would leave the user swapped but not deposited.
+     */
+    dstAmountMin: string;
+    /** Cross-chain only. Per-order escrow schedule in seconds, set by 1inch. */
+    timeLocks?: Record<string, number>;
+    /**
+     * Cross-chain only. How many preimages to mint before building an order.
+     * Building with the wrong number produces escrows the user's secrets cannot
+     * unlock, stranding the swap until its cancellation timelock.
+     */
+    secretsCount?: number;
+    /**
+     * Cross-chain only. The contract the source token must be approved to (the
+     * 1inch Limit Order Protocol) before a resolver can fill the order.
+     *
+     * Absent on the classic rail, where the router address arrives with the swap
+     * calldata instead.
+     */
+    spender?: string;
+    /**
+     * True only for a cross-chain swap FROM native ETH, which needs an on-chain
+     * order creation carrying the full amount as msg.value. The user's funds
+     * leave the wallet before any fill, so the UI must say so. ERC-20 sources are
+     * signature-only after their one-time approval.
+     */
+    requiresOnchainOrder: boolean;
+    /**
+     * What the swap costs, as the provider reports it on this quote.
+     *
+     * Surfaced rather than derived: a fee the UI computes from its own constant
+     * drifts from the one actually charged the moment the two disagree, and they
+     * did — the integrator fee was configured on our side for days while the
+     * provider had it switched off, so the real charge was zero.
+     *
+     * Cross-chain only. The classic rail reports no breakdown.
+     */
+    feeInfo?: {
+        /** Owney's cut. Absent until a fee receiver is configured. */
+        integratorFee?: {
+            receiver: string;
+            bps: number;
+            share: number;
+        };
+        /** The filler's cut, charged either way. */
+        resolverFee?: {
+            receiver: string;
+            bps: number;
+        };
+    };
+    /**
+     * Owney's cut in basis points, for display.
+     *
+     * Distinct from `feeInfo`, which is what the provider measured on this
+     * quote. When the provider applies the fee at settlement it reports nothing
+     * here, and this carries the agreed figure instead so the UI can still name
+     * one. Stated, not verified.
+     */
+    integratorFeeBps?: number;
+};
+/**
+ * Terminal states are `executed`, `expired`, `cancelled` and `refunded`.
+ * `refunding` is the window the returning-funds screen renders: the order has
+ * failed and the money is on its way back, but is not back yet.
+ */
+type SwapOrderStatus = "pending" | "executed" | "expired" | "cancelled" | "refunding" | "refunded" | "unpublished";
+/**
+ * Stage reported to the UI while a swap runs, in either direction.
+ *
+ * `withdrawing` and `withdrawn` belong to the withdrawal path only: the
+ * withdrawal is acknowledged by the agent long before the tokens appear in the
+ * wallet, and the swap cannot start until they have. That wait is a visible
+ * stage rather than dead time inside "quoting", because it is the longest part
+ * of the flow and the one place a user would otherwise think nothing is
+ * happening.
+ */
+type SwapStage = "withdrawing" | "withdrawn" | "quoting" | "approving" | "signing" | "swapping" | "swapped" | "depositing" | "refunding" | "refunded";
+/**
+ * Which way the funds travel, which decides what each side may be.
+ *
+ * On a `deposit` the source is any wallet asset and the destination must be
+ * depositable. On a `withdraw` that reverses, and the destination widens to
+ * anything the wallet can receive — native ETH and USDT included. The routing
+ * API enforces both, so this has to be stated rather than inferred.
+ */
+type SwapDirection = "deposit" | "withdraw";
+type SwapQuoteParams = {
+    /** Asset being spent: a wallet asset on a deposit, an Owney asset on a withdrawal. */
+    from: {
+        chainId: number;
+        symbol: string;
+        amount: string;
+    };
+    /** Asset being received: a deposit target on a deposit, any wallet asset on a withdrawal. */
+    to: {
+        chainId: number;
+        symbol: string;
+    };
+    /** Defaults to `deposit`. */
+    direction?: SwapDirection;
+};
+
 type ZyfaiRpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
 interface OwneySDKConfig {
     apiKey: string;
@@ -9,10 +200,6 @@ interface OwneySDKConfig {
      * Example: { 8453: "https://...", 42161: "https://..." }
      */
     zyfaiRpcUrls?: ZyfaiRpcUrlsConfig;
-    /** Optional Owney Yieldseeker proxy base URL override for integration tests. */
-    yieldseekerApiBaseUrl?: string;
-    /** Optional SIWE origin override. Defaults to the requesting browser origin. */
-    yieldseekerSiweOrigin?: string;
     /**
      * Optional override for the Owney routing API base URL used by all routing
      * calls (defaults to the OWNEY_ROUTING_API_BASE_URL env var, then the
@@ -59,7 +246,7 @@ type OwneySupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
 type OwneySupportedChains = (typeof SUPPORTED_CHAINS)[number];
 type OwneySupportedTokens = (typeof SUPPORTED_TOKENS)[number];
 
-type AgentId = "zyfai" | "yieldseeker";
+type AgentId = "zyfai";
 type Asset = string;
 type AgentSupportedAsset = {
     readonly symbol: string;
@@ -237,8 +424,6 @@ interface OwneyPosition {
     pool?: string;
     asset: string;
     amount: string;
-    /** Smallest-unit amount when the provider exposes it alongside `amount`. */
-    amountRaw?: string;
     apy?: number;
     tvl?: number;
     /** Pool liquidity. Prepared slot — Zyfai will add this to its portfolio
@@ -269,19 +454,10 @@ interface OwneyPendingAllocation {
     since?: string;
 }
 interface AgentBalance {
-    /** Authoritative native balances per asset/network, including idle and invested funds. */
-    assetBalances?: OwneyToken[];
     smartWallet?: `0x${string}`;
     totalBalance: string;
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
-    /**
-     * Describes whether `tokens` already includes deployed `positions`.
-     * Consumers must add matching positions only for `tokens-plus-positions`;
-     * doing so for Zyfai would double-count, while omitting it for Yieldseeker
-     * makes its balance disappear as soon as idle funds enter a vault.
-     */
-    balanceComposition?: "tokens-include-positions" | "tokens-plus-positions";
     tokens: OwneyToken[];
     /**
      * Per-protocol/pool positions when the agent's portfolio payload includes
@@ -296,14 +472,10 @@ interface OwneyBalances {
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
     agentBalances: Record<AgentId, AgentBalance>;
-    /**
-     * Per-agent read failures when an aggregate balance request returned only a
-     * partial result. Callers may display the successful balances, but funding
-     * operations must not interpret a missing agent as having a zero balance.
-     */
-    agentErrors?: Partial<Record<AgentId, string>>;
+    /** Omitted agents failed to load; they must not be interpreted as zero. */
+    agentErrors?: Record<AgentId, string>;
     /** Absolute provider cooldown deadlines (Unix milliseconds). */
-    agentRetryAt?: Partial<Record<AgentId, number>>;
+    agentRetryAt?: Record<AgentId, number>;
 }
 interface AgentEarnings {
     smartWallet: `0x${string}`;
@@ -476,15 +648,8 @@ interface IAgent {
     readonly id: string;
     readonly supportedChainIds: readonly OwneySupportedChainId[];
     readonly supportedAssets: readonly AgentSupportedAssets[];
-    /**
-     * Describes how `AgentBalance.tokens` relates to `positions`.
-     * Most adapters expose token totals that already include deployed positions.
-     * Providers such as Yieldseeker expose idle wallet tokens separately, so
-     * withdrawal planning must add matching position amounts.
-     */
-    readonly balanceComposition?: "tokens-include-positions" | "tokens-plus-positions";
     disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
+    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
     /**
      * Apply the organization's agent policy to this user's account.
      *
@@ -555,8 +720,6 @@ declare class OwneySDK {
     private orgAgentConfig;
     private orgAgentConfigPromise;
     private zyfaiRpcUrls?;
-    private yieldseekerApiBaseUrl?;
-    private yieldseekerSiweOrigin?;
     private routingApiBaseUrl?;
     private referralSource?;
     private cachedSponsoredCallback;
@@ -593,15 +756,25 @@ declare class OwneySDK {
     private requireState;
     private requireChainId;
     private requireConnectedProvider;
-    /** Builds the default USDC batch callback for the connected wallet. */
+    /**
+     * Lazily builds (and caches) the default EIP-3009 sponsored deposit callback
+     * used when the caller omits `depositCallback`. Wraps the connected EIP-1193
+     * provider with viem `custom(provider)` to read token meta and sign the
+     * `TransferWithAuthorization`, then POSTs to the sponsor API.
+     */
     private getDefaultSponsoredCallback;
-    /** Builds the wallet-native sponsored calls callback for compatible paymasters. */
+    /**
+     * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
+     * callback used when the caller omits `depositCallback` for a WETH
+     * deposit. Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
+     * `PermitTransferFrom` instead of an EIP-3009 authorization.
+     */
     private getDefaultSponsoredCallsCallback;
     /**
      * Lazily builds (and caches) the default Permit2 sponsored WETH deposit
      * callback used when the caller omits `depositCallback` for a WETH deposit.
      * Mirrors `getDefaultSponsoredCallback()` but signs a Permit2
-     * single-use batch authorization instead of an EIP-3009 authorization.
+     * `PermitTransferFrom` instead of an EIP-3009 authorization.
      */
     private getDefaultWethSponsoredCallback;
     private getAgent;
@@ -637,8 +810,7 @@ declare class OwneySDK {
      *   If provided, ALL specified agents must support the chainId or the call
      *   throws before activating any agent.
      */
-    activateAgent(chainId: number, agentId?: AgentId[], asset?: OwneySupportedTokens): Promise<void>;
-    private assertActivationSession;
+    activateAgent(chainId: number, agentId?: AgentId[]): Promise<void>;
     /**
      * Activate agents ONE AT A TIME, each followed by its org policy.
      *
@@ -652,9 +824,10 @@ declare class OwneySDK {
      * Serializing costs no real wall-clock: the user can only approve one prompt
      * at a time anyway.
      *
-     * Stop at the first failure so a canceled sign-in does not open another
-     * agent's wallet prompt. Report any earlier successes for diagnostics; the
-     * app discards the session when the complete sign-in does not succeed.
+     * Every agent is attempted even if an earlier one fails, so one declined
+     * signature can't deny the remaining agents their turn. The first failure is
+     * rethrown (matching the previous `Promise.all` rejection) once all agents
+     * have had a chance to activate.
      */
     private activateAgentsInTurn;
     /**
@@ -665,8 +838,7 @@ declare class OwneySDK {
      * @param options.asset - Asset symbol to deposit (e.g. "USDC")
      * @param options.depositCallback - Callback that performs the token transfer and returns a tx hash.
      *   When agentId is omitted, this callback is invoked once per eligible agent with that agent's
-     *   split amount and smart wallet address. Default sponsored deposits batch
-     *   all shares into one signature; custom callbacks still run once per agent.
+     *   split amount and smart wallet address — expect multiple wallet prompts.
      * @param options.agentId - Optional explicit target. Otherwise split equally,
      *   or fund remaining agents when a recovery deposit cannot meet every minimum.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
@@ -678,7 +850,7 @@ declare class OwneySDK {
      *
      * 1. Missing Permit2 allowance: when the app did not supply its own
      *    callback and the attempt fails with `PERMIT2_APPROVAL_REQUIRED` on a
-     *    token deposit, this is the wallet's first Permit2 deposit for that token. We send
+     *    WETH deposit, this is the wallet's first gasless WETH deposit. We send
      *    the one-time (user-paid) Permit2 approval via `approvePermit2()` and
      *    retry the SAME sponsored attempt once. Bounded to one approval attempt
      *    per call so a wallet/agent that keeps reporting the allowance as
@@ -700,7 +872,6 @@ declare class OwneySDK {
     private depositWithFallback;
     private getMinDepositAmount;
     private splitDepositAmount;
-    private formatAgentName;
     private validateMinDepositAmount;
     /**
      * Whether the user already holds a non-zero balance with `agent` for the
@@ -711,6 +882,159 @@ declare class OwneySDK {
     private hasExistingBalance;
     private validateAssetSupport;
     private getEligibleAgents;
+    /** Lazily built so an app that never swaps pays nothing for it. */
+    private swapApiClient?;
+    private swapApi;
+    /**
+     * Put the wallet on `chainId`, or fail with something actionable.
+     *
+     * Reuses the same guard the deposit rail uses, which re-reads the chain after
+     * switching — some wallets resolve wallet_switchEthereumChain before the
+     * network has actually changed.
+     */
+    private ensureSwapChain;
+    /**
+     * Binds the executor's abstract deps to this client's wallet.
+     *
+     * Kept as a builder rather than baked into the executor so the whole swap
+     * flow stays testable without a provider — the executor never imports viem.
+     */
+    private buildSwapDeps;
+    /**
+     * Assets the user may pay with, and what each chain deposits into.
+     *
+     * The source list is deliberately wider than the deposit list: it includes
+     * native ETH and USDT, which Owney never holds but users often do.
+     */
+    getSwapTokens(): Promise<{
+        chains: SwapChainTokens[];
+    }>;
+    /**
+     * Search the assets a user may pay with on one chain.
+     *
+     * `getSwapTokens` returns the short list worth rendering unprompted. This
+     * reaches everything else the routing API will accept — thousands per chain
+     * once the wider allowlist is enabled, which is why it is a query rather
+     * than a download.
+     *
+     * Results are filtered server-side to what a quote will accept, so anything
+     * returned can be paid with. They are NOT ranked by trustworthiness: several
+     * tokens can share a ticker, and `providers` (how many token lists carry the
+     * address) is the only usable signal for telling them apart. Surface it.
+     *
+     * Returns nothing for a blank query rather than asking for the whole list.
+     */
+    searchSwapTokens(params: {
+        chainId: number;
+        query: string;
+        limit?: number;
+    }): Promise<{
+        tokens: SwapTokenSearchResult[];
+    }>;
+    /**
+     * Price a swap without committing to it.
+     *
+     * `dstAmountMin` is the number to validate against a deposit minimum —
+     * `dst.amount` is an estimate that a decaying auction or slippage can undercut,
+     * and a swap landing below the floor leaves the user swapped but not
+     * deposited.
+     */
+    getSwapQuote(params: SwapQuoteParams): Promise<SwapQuote>;
+    /**
+     * Swap an asset the user holds into a deposit asset, then deposit it.
+     *
+     * Kept separate from `deposit()` rather than bolted on as an option: the
+     * return shape differs, the staging callback is meaningless on the plain
+     * path, and integrators who never swap should not have to reason about any
+     * of it.
+     *
+     * The deposit runs on the MEASURED arrival, not the quote. A quote is an
+     * estimate, so depositing the quoted figure would either strand dust or try
+     * to move funds that never came.
+     *
+     * Failure modes differ in a way callers must respect. A same-chain swap is
+     * atomic — if it fails, nothing moved. A cross-chain swap escrows the user's
+     * funds first, so SWAP_ORDER_EXPIRED / REFUNDED / CANCELLED all mean the
+     * money left the wallet. Only the former can honestly say "nothing has left
+     * your wallet".
+     */
+    swapAndDeposit(options: {
+        from: {
+            chainId: number;
+            symbol: string;
+            amount: string;
+        };
+        /** Deposit target. Defaults to the active chain's asset when omitted. */
+        to: {
+            chainId: number;
+            symbol: string;
+        };
+        agentId?: AgentId;
+        /** Percent, classic rail only. Fusion+ prices through its auction. */
+        slippage?: number;
+        onSwapProgress?: (stage: SwapStage) => void;
+    }): Promise<{
+        swap: {
+            received: string;
+            orderHash?: string;
+            txHash?: string;
+        };
+        deposit: OwneyDepositResult | OwneyMultiDepositResult;
+    }>;
+    /**
+     * Withdraw from an agent and swap the proceeds into whatever the user wants
+     * to hold, delivered to their own wallet.
+     *
+     * The mirror of `swapAndDeposit()`, with one structural difference that
+     * drives the whole implementation: a deposit swap starts from funds already
+     * sitting in the wallet, but a withdrawal has to wait for them. The agent's
+     * provider acknowledges a withdrawal and *then* queues the on-chain transfer
+     * to the EOA, so `withdraw()` resolving means "accepted", not "arrived".
+     * Quoting before the tokens land would size the swap against a balance that
+     * is not there yet.
+     *
+     * The swap is therefore sized from the MEASURED arrival, exactly as the
+     * deposit path sizes its deposit from the measured swap output. On a full
+     * withdrawal there is no other number available — "MAX" has no figure until
+     * the agent picks one.
+     *
+     * **Failure here is not symmetrical with the deposit path.** A failed
+     * deposit-swap leaves the user holding what they started with. A failed
+     * withdrawal-swap leaves them holding the AGENT'S asset in their own wallet:
+     * the money is out, safe, and in the wrong denomination. Both
+     * `WITHDRAW_ARRIVAL_TIMEOUT` and `WITHDRAW_SWAP_FAILED` carry `withdrawn` for
+     * that reason — the UI has to tell the user where their money actually is,
+     * and must never present either as a lost withdrawal.
+     */
+    withdrawAndSwap(options: {
+        /** The agent's asset. Must be on the active chain. */
+        from: {
+            chainId: number;
+            symbol: string;
+        };
+        /** What to deliver to the wallet. Any swappable asset, including native ETH. */
+        to: {
+            chainId: number;
+            symbol: string;
+        };
+        /** Human units ("10.5"). Omit to withdraw the full agent balance. */
+        amount?: string;
+        agentId?: AgentId;
+        /** Percent, classic rail only. Fusion+ prices through its auction. */
+        slippage?: number;
+        onSwapProgress?: (stage: SwapStage) => void;
+        /** How long to wait for the withdrawal to land before giving up on the swap. */
+        arrivalTimeoutMs?: number;
+    }): Promise<{
+        withdraw: OwneyWithdrawResult | AgentWithdrawResult;
+        /** What actually arrived in the wallet, smallest unit of the agent's asset. */
+        withdrawn: string;
+        swap: {
+            received: string;
+            orderHash?: string;
+            txHash?: string;
+        };
+    }>;
     /**
      * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
      * Validates that the asset is supported by the target agent(s) on the active chain.
@@ -792,15 +1116,14 @@ declare class OwneySDK {
      */
     ensureAutoSelectProtocols(asset: "USDC" | "WETH", agentId?: AgentId): Promise<boolean>;
     /**
-     * User-paid approval of Permit2 on the selected token for the active chain.
-     * Grants the maximum ERC20 allowance so later deposits do not require another
-     * approval. Resolves after one confirmation so the subsequent deposit attempt
-     * sees the new allowance.
-     *
-     * @param requiredAmount Raw base-unit amount the pending deposit must cover.
+     * One-time, user-paid approval of Permit2 on the sponsored WETH token for
+     * the active chain. Required once per wallet per chain before gasless WETH
+     * deposits; afterwards deposit() is signature-only. Resolves only after the
+     * approval transaction is mined (1 confirmation), so a subsequent deposit()
+     * will see the new allowance; throws if the transaction reverted.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint): Promise<`0x${string}`>;
+    approvePermit2(asset?: "WETH"): Promise<`0x${string}`>;
     /**
      * Get the agent's average APY performance over a time period. Does not require a wallet connection.
      * @param options - Contains agentId (optional) and days ("7D", "14D", or "30D")
@@ -824,96 +1147,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type YieldseekerAuthDependencies = {
-    origin?: string;
-    now?: () => Date;
-    nonce?: () => string;
-};
-
-type YieldseekerFetch = typeof fetch;
-
-type YieldseekerTransaction = {
-    from: `0x${string}`;
-    to: `0x${string}`;
-    data: `0x${string}`;
-    value: string;
-    chainId: number;
-};
-
-type YieldseekerAgentOptions = {
-    baseUrl?: string;
-    fetchFn?: YieldseekerFetch;
-    auth?: YieldseekerAuthDependencies;
-    /** Test seam for the wallet-submission/receipt boundary. */
-    transactionExecutor?: (state: ConnectionState, chainId: number, transaction: YieldseekerTransaction) => Promise<Hex>;
-    /** Test seam for transactions submitted outside transactionExecutor. */
-    unwindReceiptWaiter?: (state: ConnectionState, chainId: number, transactionHash: Hex) => Promise<void>;
-};
-declare class YieldseekerAgent implements IAgent {
-    readonly id = "yieldseeker";
-    readonly balanceComposition: "tokens-plus-positions";
-    readonly supportedChainIds: readonly [8453];
-    readonly supportedAssets: readonly [{
-        readonly chainId: 8453;
-        readonly chain: "BASE";
-        readonly assets: readonly [{
-            readonly symbol: "USDC";
-            readonly minDepositAmount: "10000000";
-        }, {
-            readonly symbol: "WETH";
-            readonly minDepositAmount: "1";
-        }];
-    }];
-    private readonly api;
-    private readonly auth;
-    private readonly transactionExecutor?;
-    private readonly unwindReceiptWaiter?;
-    private readonly agentContexts;
-    private readonly users;
-    private readonly pendingAgents;
-    private readonly yieldOptions;
-    private readonly pendingYieldOptions;
-    constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
-    disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
-    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
-    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
-    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, tokenSymbol?: string): Promise<AccountAgentApy>;
-    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
-    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
-    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
-    private loadYieldOptions;
-    private userKey;
-    private contextKey;
-    private resolveUser;
-    private forgetUser;
-    private ensureAgent;
-    private findAgent;
-    private resolveAgent;
-    private loadPortfolio;
-    private loadPortfolioContext;
-    private deployAgent;
-    private refreshSnapshotAfterMovement;
-    private agentPath;
-    private walletRequest;
-    private providerRequest;
-    private mapApiError;
-    private submitTransaction;
-    private waitForReceipt;
-    private assertTransaction;
-    private assertAgent;
-    private isOwneyAgent;
-    private assetForAgent;
-    private isTransactionHash;
-    private assertChain;
-    private assertOptionalChain;
-    private assertAsset;
-    private invalidResponse;
-}
-
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_BALANCE_UNAVAILABLE" | "DEPOSIT_PARTIAL_FAILURE" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "AGENT_RATE_LIMITED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_BALANCE_UNAVAILABLE" | "DEPOSIT_PARTIAL_FAILURE" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "AGENT_RATE_LIMITED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "SWAP_DISABLED" | "SWAP_RATE_LIMITED" | "SWAP_REQUEST_FAILED" | "SWAP_QUOTE_FAILED" | "SWAP_UNSUPPORTED_PAIR" | "SWAP_APPROVAL_REQUIRED" | "SWAP_BELOW_DEPOSIT_MINIMUM" | "SWAP_ORDER_EXPIRED" | "SWAP_ORDER_REFUNDED" | "SWAP_ORDER_CANCELLED" | "WITHDRAW_ARRIVAL_TIMEOUT" | "WITHDRAW_SWAP_FAILED" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -979,4 +1213,40 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LookbackDays, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type RebalanceLog, type WithdrawOptions, YieldseekerAgent, createOwneySIWX, setOwneyDebug };
+/**
+ * Persists cross-chain swap secrets so an in-flight order survives a reload.
+ *
+ * This is not a convenience. A Fusion+ order is only completable by whoever
+ * holds the secret preimages: the resolver deploys escrows, then waits for the
+ * secret before it can claim and release funds to the user. Lose the secrets
+ * mid-order and the swap cannot complete — the user waits out the cancellation
+ * timelock for a refund instead.
+ *
+ * That matters here because the UI explicitly tells the user "you can safely
+ * close this window", so surviving a reload is a requirement, not a nicety.
+ *
+ * Trade-off: the same one `zyfai.auth-cache` makes. Secrets in `localStorage`
+ * are exposed to XSS, but they are single-use, worthless once the order
+ * settles, and only ever unlock funds back to the user's own wallet.
+ */
+type StoredOrder = {
+    orderHash: string;
+    /** Preimages, one per fill. Index matters — fill N needs secret N. */
+    secrets: string[];
+    /** Chain the funds left from, so a resumed session can report it. */
+    srcChainId: number;
+    /** For the resumed UI: what the user was paying with and expecting. */
+    srcSymbol: string;
+    dstSymbol: string;
+    dstChainId: number;
+    amount: string;
+    /** Epoch ms. Used to drop orders far past any plausible timelock. */
+    createdAt: number;
+};
+/**
+ * Every stored order, newest first, dropping anything past MAX_AGE_MS.
+ * Used on mount to resume orders the user left in flight.
+ */
+declare function listOrders(now?: number): StoredOrder[];
+
+export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AssetDailyEarnings, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LookbackDays, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type RebalanceLog, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type WithdrawOptions, createOwneySIWX, listOrders as listPendingSwaps, setOwneyDebug };