@owney/sdk 0.7.25-beta.14 → 0.7.25-beta.16

package/dist/index.d.cts

@@ -138,13 +138,20 @@ interface IAgent {
      */
     applyOrgPolicy?(state: ConnectionState, chainId: number, policy: OrgAgentConfig): Promise<void>;
     deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid"): Promise<AgentWithdrawResult>;
+    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid", onBeforeSubmission?: FundingProgress): Promise<AgentWithdrawResult>;
     /** Invalidate only the confirmed asset. This hook must not sign or submit transactions. */
     invalidateFundingRead?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, refreshUntil?: number): void;
     /** End accelerated balance reads only for the exact snapshot the caller displayed. */
     endFundingBalanceRefresh?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingHistory?(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getFundingWallet?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;
+    /** Read-only chain proof when indexed withdrawal components are incomplete.
+     * Returns raw owner-withdrawable units; unavailable proof must throw.
+     * minimumAmount is the raw liquidity required from this agent for a typed
+     * plan, so adapters can expand discovery when known positions fall short. */
+    getWithdrawableBalance?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, minimumAmount?: bigint): Promise<bigint>;
+    /** Optional positive proof for a repeat deposit; unknown must fall back to portfolio validation. */
+    hasExistingDepositFunds?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<true | undefined>;
     getBalances(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<AgentBalance>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     /**
@@ -245,6 +252,11 @@ type WithdrawOptions = {
     /** Exclude unresolved providers from aggregate withdrawals; direct agent requests are unchanged. */
     excludeAgentIds?: AgentId[];
     onProgress?: FundingProgress;
+    /**
+     * Durable pre-dispatch checkpoint for adapters with a recoverable operation ID.
+     * Rejection prevents submission; progress observers remain non-fatal.
+     */
+    onBeforeSubmission?: FundingProgress;
     asset: Asset;
     amount?: string;
     agentId?: AgentId;
@@ -296,6 +308,8 @@ type AgentsApyOptions = {
     chainId?: number;
 };
 type DepositOptions = {
+    /** Resume only these already signed relayer bytes; never create a new authorization. */
+    resumeTxHash?: `0x${string}`;
     onProgress?: FundingProgress;
     amount: string;
     asset: Asset;
@@ -305,6 +319,19 @@ type DepositOptions = {
 };
 
 type FundingStage = "pending" | "confirmed" | "unknown" | "failed" | "not-applicable";
+/** Hash-bound v0.6 recovery metadata. Deliberately excludes the owner signature. */
+type UnsignedUserOperationEvidence = {
+    sender: string;
+    nonce: string;
+    initCode: string;
+    callData: string;
+    callGasLimit: string;
+    verificationGasLimit: string;
+    preVerificationGas: string;
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+    paymasterAndData: string;
+};
 /** Evidence about one provider leg. Amounts are token base units, never USD. */
 interface FundingEvidence {
     agentId: AgentId;
@@ -317,6 +344,8 @@ interface FundingEvidence {
     txHash?: string;
     /** Persisted before a sponsored EOA operation is sent. */
     userOpHash?: string;
+    /** Lets recovery verify a consumed nonce even if a bundler forgets the operation. */
+    userOperation?: UnsignedUserOperationEvidence;
     /** Base Account calls ID used to recover an uncertain wallet submission. */
     callsId?: string;
     blockNumber?: string;
@@ -331,7 +360,9 @@ interface FundingEvidence {
         method?: "GET" | "POST";
         path?: "/users/withdraw" | "/users/partial-withdraw";
         elapsedMs?: number;
-        failure?: "network" | "unauthorized" | "forbidden" | "rate-limited" | "other";
+        /** Actual response status captured before the vendor replaces the HTTP error. */
+        httpStatus?: number;
+        failure?: "network" | "unauthorized" | "forbidden" | "rate-limited" | "insufficient-balance" | "session-key-missing" | "withdrawal-in-progress" | "other";
     };
     transfer: FundingStage;
     registration: FundingStage;
@@ -365,8 +396,17 @@ interface AgentWithdrawResult {
     evidence?: FundingEvidence;
     txHash?: string;
     type: "full" | "partial";
+    /** Owner payout is confirmed, but clearing all MAX positions still needs verification. */
+    completion?: "unverified";
     /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
     amount: string;
+    /** Yieldseeker typed withdrawal fulfilled after an exactly verified fee
+     * deduction. Amount remains the confirmed net owner payout, and the gross
+     * amount must equal that payout plus the fee, all in token base units. */
+    feeAdjustment?: {
+        grossAmount: string;
+        feeAmount: string;
+    };
 }
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
@@ -834,7 +874,14 @@ declare class OwneySDK {
         refreshBalance?: boolean;
     }): Promise<FundingEvidence>;
     /** Resolve a saved sponsored-withdrawal ID without opening a wallet prompt. */
-    resolveSponsoredWithdrawalEvidence(evidence: FundingEvidence): Promise<FundingEvidence>;
+    resolveSponsoredWithdrawalEvidence(evidence: FundingEvidence, options?: {
+        submittedAt?: number;
+    }): Promise<FundingEvidence>;
+    /** Recover an EIP-5792 deposit or payout using this account's exact batch ID. */
+    resolveWalletCallsFundingEvidence(evidence: FundingEvidence, direction: "deposit" | "withdraw"): Promise<FundingEvidence>;
+    /** Whether a foreground deposit can resume the same signed batch, never a
+     * fresh authorization. The batch rail independently rechecks the exact plan. */
+    canResumePendingDeposit(evidences: FundingEvidence[], amount: string): Promise<boolean>;
     /** A display acknowledgement controls polling only; it never confirms a financial outcome. */
     endFundingBalanceRefresh(evidence: FundingEvidence, read: AssetReadMetadata): boolean;
     /** History lookup for receipt recovery; adapters may not authenticate or sign here. */
@@ -871,6 +918,8 @@ declare class OwneySDK {
         chainId?: number;
         asset?: OwneySupportedTokens;
     }): Promise<OwneyBalances | AgentBalance>;
+    /** Preserve failure objects for withdrawal recovery without changing public balance results. */
+    private readAggregatedBalances;
     /**
      * Get the user's on-chain earnings for a specific agent, or aggregated across all agents.
      * @param agentId - Optional. Agent to query. Omit for aggregated earnings.
@@ -1056,6 +1105,7 @@ declare class YieldseekerAgent implements IAgent {
     private getReceiptClient;
     /** Reads the actual proxy implementation; Yieldseeker's API walletType is not a version check. */
     getWalletStatus(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, useCachedV2?: boolean): Promise<YieldseekerWalletStatus | null>;
+    private rememberWalletStatus;
     /** Explicit owner action. This never runs as a side effect of withdrawal. */
     upgradeWallet(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, gasMode?: "paid" | "sponsored"): Promise<{
         txHash: Hex;
@@ -1064,12 +1114,20 @@ declare class YieldseekerAgent implements IAgent {
     disconnect(): Promise<void>;
     activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
     deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid"): Promise<AgentWithdrawResult>;
+    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid", onBeforeSubmission?: FundingProgress): Promise<AgentWithdrawResult>;
     private withdrawInternal;
+    /** A withdrawal-only liquidity floor; display snapshots never authorize it. */
+    getWithdrawableBalance(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, minimumAmount?: bigint): Promise<bigint>;
+    private readVaultLiquidity;
+    private validateWithdrawalPositions;
+    private withdrawalVaultHints;
+    private readWithdrawalPositions;
+    private resolveWithdrawalLiquidity;
     getBalances(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<AgentBalance>;
     invalidateFundingRead(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, refreshUntil?: number): void;
     endFundingBalanceRefresh(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingWallet(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;
+    hasExistingDepositFunds(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<true | undefined>;
     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>;
@@ -1119,7 +1177,7 @@ declare class YieldseekerAgent implements IAgent {
     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" | "EARNINGS_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" | "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_IN_PROGRESS" | "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" | "EARNINGS_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -1185,4 +1243,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 AssetReadMetadata, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type FundingEvidence, type FundingProgress, type FundingStage, 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 YieldseekerWalletStatus, 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 AssetReadMetadata, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type FundingEvidence, type FundingProgress, type FundingStage, 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 UnsignedUserOperationEvidence, type WithdrawOptions, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, createOwneySIWX, setOwneyDebug };

package/dist/index.d.ts

@@ -138,13 +138,20 @@ interface IAgent {
      */
     applyOrgPolicy?(state: ConnectionState, chainId: number, policy: OrgAgentConfig): Promise<void>;
     deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid"): Promise<AgentWithdrawResult>;
+    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid", onBeforeSubmission?: FundingProgress): Promise<AgentWithdrawResult>;
     /** Invalidate only the confirmed asset. This hook must not sign or submit transactions. */
     invalidateFundingRead?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, refreshUntil?: number): void;
     /** End accelerated balance reads only for the exact snapshot the caller displayed. */
     endFundingBalanceRefresh?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingHistory?(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getFundingWallet?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;
+    /** Read-only chain proof when indexed withdrawal components are incomplete.
+     * Returns raw owner-withdrawable units; unavailable proof must throw.
+     * minimumAmount is the raw liquidity required from this agent for a typed
+     * plan, so adapters can expand discovery when known positions fall short. */
+    getWithdrawableBalance?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, minimumAmount?: bigint): Promise<bigint>;
+    /** Optional positive proof for a repeat deposit; unknown must fall back to portfolio validation. */
+    hasExistingDepositFunds?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<true | undefined>;
     getBalances(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<AgentBalance>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     /**
@@ -245,6 +252,11 @@ type WithdrawOptions = {
     /** Exclude unresolved providers from aggregate withdrawals; direct agent requests are unchanged. */
     excludeAgentIds?: AgentId[];
     onProgress?: FundingProgress;
+    /**
+     * Durable pre-dispatch checkpoint for adapters with a recoverable operation ID.
+     * Rejection prevents submission; progress observers remain non-fatal.
+     */
+    onBeforeSubmission?: FundingProgress;
     asset: Asset;
     amount?: string;
     agentId?: AgentId;
@@ -296,6 +308,8 @@ type AgentsApyOptions = {
     chainId?: number;
 };
 type DepositOptions = {
+    /** Resume only these already signed relayer bytes; never create a new authorization. */
+    resumeTxHash?: `0x${string}`;
     onProgress?: FundingProgress;
     amount: string;
     asset: Asset;
@@ -305,6 +319,19 @@ type DepositOptions = {
 };
 
 type FundingStage = "pending" | "confirmed" | "unknown" | "failed" | "not-applicable";
+/** Hash-bound v0.6 recovery metadata. Deliberately excludes the owner signature. */
+type UnsignedUserOperationEvidence = {
+    sender: string;
+    nonce: string;
+    initCode: string;
+    callData: string;
+    callGasLimit: string;
+    verificationGasLimit: string;
+    preVerificationGas: string;
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+    paymasterAndData: string;
+};
 /** Evidence about one provider leg. Amounts are token base units, never USD. */
 interface FundingEvidence {
     agentId: AgentId;
@@ -317,6 +344,8 @@ interface FundingEvidence {
     txHash?: string;
     /** Persisted before a sponsored EOA operation is sent. */
     userOpHash?: string;
+    /** Lets recovery verify a consumed nonce even if a bundler forgets the operation. */
+    userOperation?: UnsignedUserOperationEvidence;
     /** Base Account calls ID used to recover an uncertain wallet submission. */
     callsId?: string;
     blockNumber?: string;
@@ -331,7 +360,9 @@ interface FundingEvidence {
         method?: "GET" | "POST";
         path?: "/users/withdraw" | "/users/partial-withdraw";
         elapsedMs?: number;
-        failure?: "network" | "unauthorized" | "forbidden" | "rate-limited" | "other";
+        /** Actual response status captured before the vendor replaces the HTTP error. */
+        httpStatus?: number;
+        failure?: "network" | "unauthorized" | "forbidden" | "rate-limited" | "insufficient-balance" | "session-key-missing" | "withdrawal-in-progress" | "other";
     };
     transfer: FundingStage;
     registration: FundingStage;
@@ -365,8 +396,17 @@ interface AgentWithdrawResult {
     evidence?: FundingEvidence;
     txHash?: string;
     type: "full" | "partial";
+    /** Owner payout is confirmed, but clearing all MAX positions still needs verification. */
+    completion?: "unverified";
     /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
     amount: string;
+    /** Yieldseeker typed withdrawal fulfilled after an exactly verified fee
+     * deduction. Amount remains the confirmed net owner payout, and the gross
+     * amount must equal that payout plus the fee, all in token base units. */
+    feeAdjustment?: {
+        grossAmount: string;
+        feeAmount: string;
+    };
 }
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
@@ -834,7 +874,14 @@ declare class OwneySDK {
         refreshBalance?: boolean;
     }): Promise<FundingEvidence>;
     /** Resolve a saved sponsored-withdrawal ID without opening a wallet prompt. */
-    resolveSponsoredWithdrawalEvidence(evidence: FundingEvidence): Promise<FundingEvidence>;
+    resolveSponsoredWithdrawalEvidence(evidence: FundingEvidence, options?: {
+        submittedAt?: number;
+    }): Promise<FundingEvidence>;
+    /** Recover an EIP-5792 deposit or payout using this account's exact batch ID. */
+    resolveWalletCallsFundingEvidence(evidence: FundingEvidence, direction: "deposit" | "withdraw"): Promise<FundingEvidence>;
+    /** Whether a foreground deposit can resume the same signed batch, never a
+     * fresh authorization. The batch rail independently rechecks the exact plan. */
+    canResumePendingDeposit(evidences: FundingEvidence[], amount: string): Promise<boolean>;
     /** A display acknowledgement controls polling only; it never confirms a financial outcome. */
     endFundingBalanceRefresh(evidence: FundingEvidence, read: AssetReadMetadata): boolean;
     /** History lookup for receipt recovery; adapters may not authenticate or sign here. */
@@ -871,6 +918,8 @@ declare class OwneySDK {
         chainId?: number;
         asset?: OwneySupportedTokens;
     }): Promise<OwneyBalances | AgentBalance>;
+    /** Preserve failure objects for withdrawal recovery without changing public balance results. */
+    private readAggregatedBalances;
     /**
      * Get the user's on-chain earnings for a specific agent, or aggregated across all agents.
      * @param agentId - Optional. Agent to query. Omit for aggregated earnings.
@@ -1056,6 +1105,7 @@ declare class YieldseekerAgent implements IAgent {
     private getReceiptClient;
     /** Reads the actual proxy implementation; Yieldseeker's API walletType is not a version check. */
     getWalletStatus(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, useCachedV2?: boolean): Promise<YieldseekerWalletStatus | null>;
+    private rememberWalletStatus;
     /** Explicit owner action. This never runs as a side effect of withdrawal. */
     upgradeWallet(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, gasMode?: "paid" | "sponsored"): Promise<{
         txHash: Hex;
@@ -1064,12 +1114,20 @@ declare class YieldseekerAgent implements IAgent {
     disconnect(): Promise<void>;
     activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
     deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid"): Promise<AgentWithdrawResult>;
+    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string, onProgress?: FundingProgress, gasMode?: "auto" | "sponsored" | "paid", onBeforeSubmission?: FundingProgress): Promise<AgentWithdrawResult>;
     private withdrawInternal;
+    /** A withdrawal-only liquidity floor; display snapshots never authorize it. */
+    getWithdrawableBalance(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, minimumAmount?: bigint): Promise<bigint>;
+    private readVaultLiquidity;
+    private validateWithdrawalPositions;
+    private withdrawalVaultHints;
+    private readWithdrawalPositions;
+    private resolveWithdrawalLiquidity;
     getBalances(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<AgentBalance>;
     invalidateFundingRead(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, refreshUntil?: number): void;
     endFundingBalanceRefresh(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingWallet(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;
+    hasExistingDepositFunds(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<true | undefined>;
     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>;
@@ -1119,7 +1177,7 @@ declare class YieldseekerAgent implements IAgent {
     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" | "EARNINGS_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" | "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_IN_PROGRESS" | "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" | "EARNINGS_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -1185,4 +1243,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 AssetReadMetadata, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type FundingEvidence, type FundingProgress, type FundingStage, 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 YieldseekerWalletStatus, 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 AssetReadMetadata, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DailyEarningsOptions, type DailyEarningsPoint, type DepositCallback, type DepositOptions, type FundingEvidence, type FundingProgress, type FundingStage, 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 UnsignedUserOperationEvidence, type WithdrawOptions, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, createOwneySIWX, setOwneyDebug };