@owney/sdk 0.7.25-beta.19 → 0.7.25-beta.20

package/dist/index.d.cts

@@ -344,6 +344,10 @@ interface FundingEvidence {
     agentWallet?: string;
     intendedAmount: string;
     confirmedAmount?: string;
+    /** Receipt delivery and fulfillment of a typed requested amount are separate facts. */
+    amountCompletion?: "complete" | "shortfall";
+    /** Verified difference between the typed request and the actual owner payout. */
+    shortfallAmount?: string;
     txHash?: string;
     /** Persisted before a sponsored EOA operation is sent. */
     userOpHash?: string;
@@ -405,9 +409,10 @@ interface AgentWithdrawResult {
     evidence?: FundingEvidence;
     txHash?: string;
     type: "full" | "partial";
-    /** Owner payout is confirmed, but clearing all MAX positions still needs verification. */
+    /** Owner payout or clearing all MAX positions still needs verification. */
     completion?: "unverified";
-    /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
+    /** Confirmed smallest-unit amount; "0" when no owner payout is verified.
+     * Legacy providers may return a 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
@@ -420,8 +425,9 @@ interface AgentWithdrawResult {
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
     /**
-     * Sum of reported smallest-unit amounts; null when a full withdrawal's
-     * amount is not yet known. An accepted request is not proof of settlement.
+     * Sum of confirmed smallest-unit amounts; null while any returned leg's
+     * payout is not yet known, including typed requests accepted asynchronously.
+     * Evidence-less custom adapters retain their confirmed-amount contract.
      */
     totalWithdrawn: string | null;
 }
@@ -704,6 +710,8 @@ declare class OwneySDK {
      */
     private disabledAgents;
     private state;
+    private connectionRevision;
+    private disconnectingAgents;
     private apiKey;
     private orgAgentConfig;
     private orgAgentConfigPromise;
@@ -721,6 +729,7 @@ declare class OwneySDK {
     private readonly recoveredFundingReads;
     private fundingBalanceChecks;
     private readonly activationChecks;
+    private readonly withdrawalSubmissions;
     private readAgent;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
@@ -735,6 +744,8 @@ declare class OwneySDK {
      * After calling this, `connect()` must be called again before using agent methods.
      */
     disconnect(): Promise<void>;
+    private clearConnectionState;
+    private disconnectAgents;
     private isAgentDisabled;
     /**
      * Check if the SDK has an active connection state.
@@ -883,6 +894,7 @@ declare class OwneySDK {
     inspectFunding(evidence: FundingEvidence, direction: "deposit" | "withdraw", options?: {
         balanceRefreshUntil?: number;
         refreshBalance?: boolean;
+        requireAmountMatch?: boolean;
     }): Promise<FundingEvidence>;
     /** Resolve a saved sponsored-withdrawal ID without opening a wallet prompt. */
     resolveSponsoredWithdrawalEvidence(evidence: FundingEvidence, options?: {
@@ -1068,7 +1080,7 @@ type YieldseekerAgentOptions = {
     /** 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>;
+    transactionExecutor?: (state: ConnectionState, chainId: number, transaction: YieldseekerTransaction, onReceipt?: (receipt: viem.TransactionReceipt) => void) => Promise<Hex>;
     /** Test seam for transactions submitted outside transactionExecutor. */
     unwindReceiptWaiter?: (state: ConnectionState, chainId: number, transactionHash: Hex) => Promise<void>;
 };
@@ -1095,6 +1107,7 @@ declare class YieldseekerAgent implements IAgent {
     private readonly routingApiBaseUrl?;
     private receiptClient?;
     private readonly withdrawalVersionCache;
+    private readonly pendingUpgrades;
     private readonly transactionExecutor?;
     private readonly unwindReceiptWaiter?;
     private readonly agentContexts;
@@ -1193,7 +1206,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_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";
+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_INVALID_AMOUNT" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_IN_PROGRESS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_UNCONFIRMED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "WITHDRAW_INVALID_AMOUNT" | "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>;

package/dist/index.d.ts

@@ -344,6 +344,10 @@ interface FundingEvidence {
     agentWallet?: string;
     intendedAmount: string;
     confirmedAmount?: string;
+    /** Receipt delivery and fulfillment of a typed requested amount are separate facts. */
+    amountCompletion?: "complete" | "shortfall";
+    /** Verified difference between the typed request and the actual owner payout. */
+    shortfallAmount?: string;
     txHash?: string;
     /** Persisted before a sponsored EOA operation is sent. */
     userOpHash?: string;
@@ -405,9 +409,10 @@ interface AgentWithdrawResult {
     evidence?: FundingEvidence;
     txHash?: string;
     type: "full" | "partial";
-    /** Owner payout is confirmed, but clearing all MAX positions still needs verification. */
+    /** Owner payout or clearing all MAX positions still needs verification. */
     completion?: "unverified";
-    /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
+    /** Confirmed smallest-unit amount; "0" when no owner payout is verified.
+     * Legacy providers may return a 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
@@ -420,8 +425,9 @@ interface AgentWithdrawResult {
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
     /**
-     * Sum of reported smallest-unit amounts; null when a full withdrawal's
-     * amount is not yet known. An accepted request is not proof of settlement.
+     * Sum of confirmed smallest-unit amounts; null while any returned leg's
+     * payout is not yet known, including typed requests accepted asynchronously.
+     * Evidence-less custom adapters retain their confirmed-amount contract.
      */
     totalWithdrawn: string | null;
 }
@@ -704,6 +710,8 @@ declare class OwneySDK {
      */
     private disabledAgents;
     private state;
+    private connectionRevision;
+    private disconnectingAgents;
     private apiKey;
     private orgAgentConfig;
     private orgAgentConfigPromise;
@@ -721,6 +729,7 @@ declare class OwneySDK {
     private readonly recoveredFundingReads;
     private fundingBalanceChecks;
     private readonly activationChecks;
+    private readonly withdrawalSubmissions;
     private readAgent;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
@@ -735,6 +744,8 @@ declare class OwneySDK {
      * After calling this, `connect()` must be called again before using agent methods.
      */
     disconnect(): Promise<void>;
+    private clearConnectionState;
+    private disconnectAgents;
     private isAgentDisabled;
     /**
      * Check if the SDK has an active connection state.
@@ -883,6 +894,7 @@ declare class OwneySDK {
     inspectFunding(evidence: FundingEvidence, direction: "deposit" | "withdraw", options?: {
         balanceRefreshUntil?: number;
         refreshBalance?: boolean;
+        requireAmountMatch?: boolean;
     }): Promise<FundingEvidence>;
     /** Resolve a saved sponsored-withdrawal ID without opening a wallet prompt. */
     resolveSponsoredWithdrawalEvidence(evidence: FundingEvidence, options?: {
@@ -1068,7 +1080,7 @@ type YieldseekerAgentOptions = {
     /** 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>;
+    transactionExecutor?: (state: ConnectionState, chainId: number, transaction: YieldseekerTransaction, onReceipt?: (receipt: viem.TransactionReceipt) => void) => Promise<Hex>;
     /** Test seam for transactions submitted outside transactionExecutor. */
     unwindReceiptWaiter?: (state: ConnectionState, chainId: number, transactionHash: Hex) => Promise<void>;
 };
@@ -1095,6 +1107,7 @@ declare class YieldseekerAgent implements IAgent {
     private readonly routingApiBaseUrl?;
     private receiptClient?;
     private readonly withdrawalVersionCache;
+    private readonly pendingUpgrades;
     private readonly transactionExecutor?;
     private readonly unwindReceiptWaiter?;
     private readonly agentContexts;
@@ -1193,7 +1206,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_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";
+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_INVALID_AMOUNT" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_IN_PROGRESS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_UNCONFIRMED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "WITHDRAW_INVALID_AMOUNT" | "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>;