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

package/dist/index.d.cts

@@ -145,6 +145,11 @@ interface IAgent {
     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>;
@@ -355,7 +360,9 @@ interface FundingEvidence {
         method?: "GET" | "POST";
         path?: "/users/withdraw" | "/users/partial-withdraw";
         elapsedMs?: number;
-        failure?: "network" | "unauthorized" | "forbidden" | "rate-limited" | "insufficient-balance" | "session-key-missing" | "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;
@@ -393,6 +400,13 @@ interface AgentWithdrawResult {
     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>;
@@ -904,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.
@@ -1100,6 +1116,13 @@ declare class YieldseekerAgent implements IAgent {
     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", 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;

package/dist/index.d.ts

@@ -145,6 +145,11 @@ interface IAgent {
     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>;
@@ -355,7 +360,9 @@ interface FundingEvidence {
         method?: "GET" | "POST";
         path?: "/users/withdraw" | "/users/partial-withdraw";
         elapsedMs?: number;
-        failure?: "network" | "unauthorized" | "forbidden" | "rate-limited" | "insufficient-balance" | "session-key-missing" | "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;
@@ -393,6 +400,13 @@ interface AgentWithdrawResult {
     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>;
@@ -904,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.
@@ -1100,6 +1116,13 @@ declare class YieldseekerAgent implements IAgent {
     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", 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;