@owney/sdk 0.7.25-beta.8 → 0.7.25

package/dist/index.d.cts

@@ -1,34 +1,18 @@
-import { Hex } from 'viem';
 import { SIWXConfig } from '@reown/appkit-controllers';
 
-type RpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
-/** @deprecated Use RpcUrlsConfig. */
-type ZyfaiRpcUrlsConfig = RpcUrlsConfig;
+type ZyfaiRpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
 interface OwneySDKConfig {
     apiKey: string;
-    /**
-     * Optional per-chain RPC overrides used for application-owned reads and
-     * transaction receipt polling. Missing chains use the Owney routing API's
-     * read-only RPC proxy. No upstream RPC credentials are included in the SDK.
-     * Wallet providers remain responsible for account access, chain switching,
-     * signatures, and transaction submission.
-     */
-    rpcUrls?: RpcUrlsConfig;
     /**
      * Optional per-chain RPC overrides for Zyfai SDK network calls.
      * Example: { 8453: "https://...", 42161: "https://..." }
-     * @deprecated Use rpcUrls so every agent shares the same read transport.
      */
     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. RPC proxy requests use OWNEY_ROUTING_API_BASE_URL when this is
-     * omitted; without either value, all rpcUrls must be configured.
-     * Set this to a local/staging routing API when testing sponsor changes.
+     * calls (defaults to the OWNEY_ROUTING_API_BASE_URL env var, then the
+     * production URL). Set this to point at a local/staging routing API,
+     * e.g. "http://localhost:3000", when testing sponsor changes.
      */
     routingApiBaseUrl?: string;
     /**
@@ -70,6 +54,148 @@ type OwneySupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
 type OwneySupportedChains = (typeof SUPPORTED_CHAINS)[number];
 type OwneySupportedTokens = (typeof SUPPORTED_TOKENS)[number];
 
+type AgentId = "zyfai";
+type Asset = string;
+type AgentSupportedAsset = {
+    readonly symbol: string;
+    readonly minDepositAmount: string;
+};
+type AgentSupportedAssets = {
+    readonly chainId: number;
+    readonly chain?: string;
+    readonly assets: readonly AgentSupportedAsset[];
+};
+type AvailableAgent = {
+    id: AgentId;
+    isEnabled: boolean;
+    supportedChainIds: readonly number[];
+    supportedAssets: readonly AgentSupportedAssets[];
+};
+type AvailableAgentsOptions = {
+    chainId?: number;
+    asset?: Asset;
+    /** Disabled agents are omitted by default because they cannot accept funds. */
+    includeDisabled?: boolean;
+};
+/**
+ * A lookback window for any "last N days" read — the APY series, the daily
+ * earnings series. Named for the window itself, so nothing borrows the APY's
+ * name to ask for something else.
+ */
+type LookbackDays = "7D" | "14D" | "30D";
+/** Kept so existing callers keep compiling. Prefer `LookbackDays`. */
+type DailyApyDays = LookbackDays;
+type HistoryFilters = {
+    fromDate?: string;
+    toDate?: string;
+    /** Max entries returned per call. Defaults to 10. */
+    limit?: number;
+    /** Opaque cursor returned by a previous getHistory call. */
+    cursor?: string;
+    /**
+     * Optional asset symbol (e.g. "USDC", "WETH") to scope the history to a
+     * single asset. Without it the page blends every asset on the chain, so a
+     * consumer showing one asset at a time has to filter client-side — and a
+     * page whose entries all belong to the *other* asset then renders empty
+     * even though matching entries exist further back. Agents whose backends
+     * cannot filter by asset ignore this and return the whole chain's history.
+     */
+    tokenSymbol?: string;
+};
+type HistoryOptions = {
+    agentId?: AgentId;
+    filters?: HistoryFilters;
+};
+type WithdrawOptions = {
+    asset: Asset;
+    amount?: string;
+    agentId?: AgentId;
+};
+type AccountApyOptions = {
+    agentId?: AgentId;
+    days: LookbackDays;
+    /**
+     * Optional asset symbol (e.g. "USDC", "WETH") to scope the daily APY series
+     * to a specific asset on the active chain. Without it the series blends every
+     * position on the chain, so two assets sharing a chain (USDC and WETH on
+     * Base/Arbitrum) would render one merged line. Agents whose backends do not
+     * expose per-asset positions ignore this. (ROUT-186)
+     */
+    tokenSymbol?: string;
+};
+/**
+ * Options for the daily earnings series. Same shape as `AccountApyOptions` and
+ * deliberately its own type: the two reads answer different questions and are
+ * free to diverge.
+ */
+type DailyEarningsOptions = {
+    agentId?: AgentId;
+    days: LookbackDays;
+    /**
+     * Optional asset symbol (e.g. "USDC", "WETH") scoping the series to one
+     * asset on the active chain.
+     */
+    tokenSymbol?: string;
+};
+type AllocationApyOptions = {
+    agentId?: AgentId;
+};
+type AgentsApyOptions = {
+    agentId?: AgentId;
+    days: DailyApyDays;
+    /**
+     * Optional asset symbol (e.g. "USDC", "WETH") to scope the APY to a
+     * specific asset+chain. Ignored by agents whose backends do not yet
+     * support per-asset APY.
+     */
+    tokenSymbol?: string;
+    /**
+     * Optional chain id for per-asset APY lookups. Typically paired with
+     * `tokenSymbol`.
+     */
+    chainId?: number;
+};
+type DepositOptions = {
+    amount: string;
+    asset: Asset;
+    depositCallback?: DepositCallback;
+    agentId?: AgentId;
+    onApproved?: () => void;
+};
+
+/**
+ * One protocol's pool selection on one chain. `pools` holds Zyfai pool NAMES
+ * verbatim — matched case-sensitively by customizeBatch, and an unrecognised
+ * name makes Zyfai's rebalance engine skip the whole protocol, so these strings
+ * must not be normalised anywhere.
+ *
+ * An empty array means "no usable pools on this chain".
+ */
+type OrgPoolSelection = {
+    protocolId: string;
+    chainId: number;
+    pools: string[];
+};
+/**
+ * The partner's protocol/pool policy (ROUT-224). Sparse — only protocols they
+ * narrowed appear. Optional so an older routing API, which does not return the
+ * field, still parses; undefined and null both mean "change nothing".
+ */
+type OrgPoolPolicy = {
+    autoApproveProtocols: boolean;
+    autoApprovePools: boolean;
+    selections: OrgPoolSelection[];
+};
+/**
+ * The organization's agent execution policy, or null when the partner has never
+ * configured one — in which case the agents leave the user's profile alone.
+ */
+type OrgAgentConfig = {
+    splittingMode: "none" | "automatic" | "force";
+    minSplits: number | null;
+    poolPolicy?: OrgPoolPolicy | null;
+};
+
 interface OwneyDepositResult {
     txHash: string;
     smartWallet: string;
@@ -106,10 +232,6 @@ interface OwneyPosition {
     pool?: string;
     asset: string;
     amount: string;
-    /** Provider-native raw quantity; may represent vault shares, not the underlying asset. */
-    amountRaw?: string;
-    /** Withdrawable underlying asset amount in that asset's smallest units. */
-    withdrawableAmountRaw?: string;
     apy?: number;
     tvl?: number;
     /** Pool liquidity. Prepared slot — Zyfai will add this to its portfolio
@@ -140,19 +262,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
@@ -167,14 +280,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}`;
@@ -342,170 +451,13 @@ interface AccountDailyEarnings {
     assets: AssetDailyEarnings[];
 }
 
-type AgentId = "zyfai" | "yieldseeker";
-type Asset = string;
-type AgentSupportedAsset = {
-    readonly symbol: string;
-    readonly minDepositAmount: string;
-};
-type AgentSupportedAssets = {
-    readonly chainId: number;
-    readonly chain?: string;
-    readonly assets: readonly AgentSupportedAsset[];
-};
-type AvailableAgent = {
-    id: AgentId;
-    isEnabled: boolean;
-    supportedChainIds: readonly number[];
-    supportedAssets: readonly AgentSupportedAssets[];
-};
-type AvailableAgentsOptions = {
-    chainId?: number;
-    asset?: Asset;
-    /** Disabled agents are omitted by default because they cannot accept funds. */
-    includeDisabled?: boolean;
-};
-/**
- * A lookback window for any "last N days" read — the APY series, the daily
- * earnings series. Named for the window itself, so nothing borrows the APY's
- * name to ask for something else.
- */
-type LookbackDays = "7D" | "14D" | "30D";
-/** Kept so existing callers keep compiling. Prefer `LookbackDays`. */
-type DailyApyDays = LookbackDays;
-type HistoryFilters = {
-    fromDate?: string;
-    toDate?: string;
-    /** Max entries returned per call. Defaults to 10. */
-    limit?: number;
-    /** Opaque cursor returned by a previous getHistory call. */
-    cursor?: string;
-    /**
-     * Optional asset symbol (e.g. "USDC", "WETH") to scope the history to a
-     * single asset. Without it the page blends every asset on the chain, so a
-     * consumer showing one asset at a time has to filter client-side — and a
-     * page whose entries all belong to the *other* asset then renders empty
-     * even though matching entries exist further back. Agents whose backends
-     * cannot filter by asset ignore this and return the whole chain's history.
-     */
-    tokenSymbol?: string;
-};
-type HistoryOptions = {
-    agentId?: AgentId;
-    filters?: HistoryFilters;
-};
-type WithdrawOptions = {
-    asset: Asset;
-    amount?: string;
-    agentId?: AgentId;
-    /** Called after each agent returns; callback failures never change a financial result. */
-    onAgentResult?: (agentId: AgentId, result: AgentWithdrawResult) => void;
-};
-type AccountApyOptions = {
-    agentId?: AgentId;
-    days: LookbackDays;
-    /**
-     * Optional asset symbol (e.g. "USDC", "WETH") to scope the daily APY series
-     * to a specific asset on the active chain. Without it the series blends every
-     * position on the chain, so two assets sharing a chain (USDC and WETH on
-     * Base/Arbitrum) would render one merged line. Agents whose backends do not
-     * expose per-asset positions ignore this. (ROUT-186)
-     */
-    tokenSymbol?: string;
-};
-/**
- * Options for the daily earnings series. Same shape as `AccountApyOptions` and
- * deliberately its own type: the two reads answer different questions and are
- * free to diverge.
- */
-type DailyEarningsOptions = {
-    agentId?: AgentId;
-    days: LookbackDays;
-    /**
-     * Optional asset symbol (e.g. "USDC", "WETH") scoping the series to one
-     * asset on the active chain.
-     */
-    tokenSymbol?: string;
-};
-type AllocationApyOptions = {
-    agentId?: AgentId;
-};
-type AgentsApyOptions = {
-    agentId?: AgentId;
-    days: DailyApyDays;
-    /**
-     * Optional asset symbol (e.g. "USDC", "WETH") to scope the APY to a
-     * specific asset+chain. Ignored by agents whose backends do not yet
-     * support per-asset APY.
-     */
-    tokenSymbol?: string;
-    /**
-     * Optional chain id for per-asset APY lookups. Typically paired with
-     * `tokenSymbol`.
-     */
-    chainId?: number;
-};
-type DepositOptions = {
-    amount: string;
-    asset: Asset;
-    depositCallback?: DepositCallback;
-    agentId?: AgentId;
-    onApproved?: () => void;
-};
-
-/**
- * One protocol's pool selection on one chain. `pools` holds Zyfai pool NAMES
- * verbatim — matched case-sensitively by customizeBatch, and an unrecognised
- * name makes Zyfai's rebalance engine skip the whole protocol, so these strings
- * must not be normalised anywhere.
- *
- * An empty array means "no usable pools on this chain".
- */
-type OrgPoolSelection = {
-    protocolId: string;
-    chainId: number;
-    pools: string[];
-};
-/**
- * The partner's protocol/pool policy (ROUT-224). Sparse — only protocols they
- * narrowed appear. Optional so an older routing API, which does not return the
- * field, still parses; undefined and null both mean "change nothing".
- */
-type OrgPoolPolicy = {
-    autoApproveProtocols: boolean;
-    autoApprovePools: boolean;
-    selections: OrgPoolSelection[];
-};
-/**
- * The organization's agent execution policy, or null when the partner has never
- * configured one — in which case the agents leave the user's profile alone.
- */
-type OrgAgentConfig = {
-    splittingMode: "none" | "automatic" | "force";
-    minSplits: number | null;
-    poolPolicy?: OrgPoolPolicy | null;
-};
-
 type DepositCallback = (smartWalletAddress: string, chainId: number, amount: string) => Promise<`0x${string}`> | `0x${string}`;
 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";
-    /**
-     * Whether a withdrawal requires an owner-approved wallet transaction.
-     * Aggregate withdrawals run these agents before relayer-only agents so a
-     * rejected wallet request cannot happen after another leg has committed.
-     */
-    readonly withdrawalRequiresWalletApproval?: boolean;
     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.
      *
@@ -575,10 +527,7 @@ declare class OwneySDK {
     private apiKey;
     private orgAgentConfig;
     private orgAgentConfigPromise;
-    private rpcUrls?;
     private zyfaiRpcUrls?;
-    private yieldseekerApiBaseUrl?;
-    private yieldseekerSiweOrigin?;
     private routingApiBaseUrl?;
     private referralSource?;
     private cachedSponsoredCallback;
@@ -615,16 +564,25 @@ declare class OwneySDK {
     private requireState;
     private requireChainId;
     private requireConnectedProvider;
-    private getPaidRpcClient;
-    /** 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;
@@ -660,8 +618,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.
      *
@@ -675,9 +632,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;
     /**
@@ -688,8 +646,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
@@ -699,12 +656,10 @@ declare class OwneySDK {
      * Invokes `agent.deposit` with the resolved sponsored callback, composing
      * two independent auto-recovery mechanisms:
      *
-     * 1. Missing Permit2 allowance outside the atomic Base-USDC path: when the
-     *    app did not supply its own callback and the attempt fails with
-     *    `PERMIT2_APPROVAL_REQUIRED`, this is the wallet's first Permit2 deposit
-     *    for that token. Base USDC bundles a gasless ERC-2612 approval inside
-     *    its sponsored deposit and never reaches this branch. Other tokens send
-     *    the one-time user-paid Permit2 approval via `approvePermit2()` and
+     * 1. Missing Permit2 allowance: when the app did not supply its own
+     *    callback and the attempt fails with `PERMIT2_APPROVAL_REQUIRED` on a
+     *    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
      *    missing can't loop forever. If `approvePermit2()` itself throws (e.g.
@@ -725,7 +680,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
@@ -736,13 +690,6 @@ declare class OwneySDK {
     private hasExistingBalance;
     private validateAssetSupport;
     private getEligibleAgents;
-    /**
-     * Run owner-approved withdrawals before relayer-only withdrawals. Wallet
-     * approval is the only point at which the user can cancel the aggregate
-     * operation, so no relayer leg should commit before it has completed.
-     */
-    private orderAgentsForWithdrawal;
-    private isUserRejectedWithdrawal;
     /**
      * 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.
@@ -824,17 +771,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. Deposit retries pass their captured chain id so a
-     * concurrent activation cannot redirect the approval to another network.
-     *
-     * @param requiredAmount Raw base-unit amount the pending deposit must cover.
-     * @param expectedChainId Chain captured by the deposit that requested approval.
+     * 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, expectedChainId?: OwneySupportedChainId): 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")
@@ -858,124 +802,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;
-    /** Dedicated read transport; Base is used for receipt polling. */
-    rpcUrls?: RpcUrlsConfig;
-    /** 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 withdrawalRequiresWalletApproval = true;
-    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 rpcUrls?;
-    private receiptClient?;
-    private readonly transactionExecutor?;
-    private readonly unwindReceiptWaiter?;
-    private readonly agentContexts;
-    private readonly users;
-    private readonly pendingAgents;
-    private readonly pendingWalletContexts;
-    private readonly readCache;
-    private readonly pendingReads;
-    private readGeneration;
-    private readonly portfolioVersions;
-    private readonly snapshotFailures;
-    private readonly standardReadFailures;
-    private readonly reconcileUntil;
-    private readonly activityRefreshUntil;
-    private readonly snapshotMovements;
-    private readonly movementEpochs;
-    private readonly yieldOptions;
-    private readonly pendingYieldOptions;
-    constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
-    private getReceiptClient;
-    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 assertSession;
-    private cachedRead;
-    private agentListKey;
-    private listAgents;
-    private contextForAgent;
-    private resolveUser;
-    private forgetUser;
-    private ensureAgent;
-    private findAgent;
-    private resolveAgent;
-    private loadPortfolio;
-    private portfolioVersion;
-    private portfolioCacheMs;
-    private snapshotMovement;
-    private advancePortfolioVersion;
-    private requestPortfolioSnapshot;
-    private portfolioSnapshot;
-    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" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -1041,4 +868,4 @@ 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 RpcUrlsConfig, type WithdrawOptions, YieldseekerAgent, type ZyfaiRpcUrlsConfig, createOwneySIWX, setOwneyDebug };
+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, createOwneySIWX, setOwneyDebug };