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

package/dist/index.d.cts

@@ -137,7 +137,7 @@ interface IAgent {
      * unchanged rather than break the connect.
      */
     applyOrgPolicy?(state: ConnectionState, chainId: number, policy: OrgAgentConfig): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress): Promise<OwneyDepositResult>;
+    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress, onBeforeSubmission?: (evidence: FundingEvidence) => void | Promise<void>): Promise<OwneyDepositResult>;
     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;
@@ -314,6 +314,9 @@ type DepositOptions = {
     /** Resume only these already signed relayer bytes; never create a new authorization. */
     resumeTxHash?: `0x${string}`;
     onProgress?: FundingProgress;
+    /** Awaited immediately before dispatch. Throwing prevents submission.
+     * All legs of an atomic batch are checkpointed together. */
+    onBeforeSubmission?: (evidence: FundingEvidence[]) => void | Promise<void>;
     amount: string;
     asset: Asset;
     depositCallback?: DepositCallback;
@@ -344,6 +347,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;
@@ -351,6 +358,8 @@ interface FundingEvidence {
     userOperation?: UnsignedUserOperationEvidence;
     /** Base Account calls ID used to recover an uncertain wallet submission. */
     callsId?: string;
+    /** Deposit execution was attempted, rather than only prepared. Not confirmation. */
+    depositSubmission?: "started";
     blockNumber?: string;
     logIndexes?: number[];
     transferLogs?: {
@@ -405,9 +414,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 +430,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 +715,8 @@ declare class OwneySDK {
      */
     private disabledAgents;
     private state;
+    private connectionRevision;
+    private disconnectingAgents;
     private apiKey;
     private orgAgentConfig;
     private orgAgentConfigPromise;
@@ -721,6 +734,7 @@ declare class OwneySDK {
     private readonly recoveredFundingReads;
     private fundingBalanceChecks;
     private readonly activationChecks;
+    private readonly withdrawalSubmissions;
     private readAgent;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
@@ -735,6 +749,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 +899,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 +1085,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 +1112,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;
@@ -1127,7 +1145,7 @@ 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>;
+    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress, onBeforeSubmission?: (evidence: FundingEvidence) => void | Promise<void>): 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. */
@@ -1193,7 +1211,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_CHECKPOINT_FAILED" | "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

@@ -137,7 +137,7 @@ interface IAgent {
      * unchanged rather than break the connect.
      */
     applyOrgPolicy?(state: ConnectionState, chainId: number, policy: OrgAgentConfig): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress): Promise<OwneyDepositResult>;
+    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress, onBeforeSubmission?: (evidence: FundingEvidence) => void | Promise<void>): Promise<OwneyDepositResult>;
     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;
@@ -314,6 +314,9 @@ type DepositOptions = {
     /** Resume only these already signed relayer bytes; never create a new authorization. */
     resumeTxHash?: `0x${string}`;
     onProgress?: FundingProgress;
+    /** Awaited immediately before dispatch. Throwing prevents submission.
+     * All legs of an atomic batch are checkpointed together. */
+    onBeforeSubmission?: (evidence: FundingEvidence[]) => void | Promise<void>;
     amount: string;
     asset: Asset;
     depositCallback?: DepositCallback;
@@ -344,6 +347,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;
@@ -351,6 +358,8 @@ interface FundingEvidence {
     userOperation?: UnsignedUserOperationEvidence;
     /** Base Account calls ID used to recover an uncertain wallet submission. */
     callsId?: string;
+    /** Deposit execution was attempted, rather than only prepared. Not confirmation. */
+    depositSubmission?: "started";
     blockNumber?: string;
     logIndexes?: number[];
     transferLogs?: {
@@ -405,9 +414,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 +430,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 +715,8 @@ declare class OwneySDK {
      */
     private disabledAgents;
     private state;
+    private connectionRevision;
+    private disconnectingAgents;
     private apiKey;
     private orgAgentConfig;
     private orgAgentConfigPromise;
@@ -721,6 +734,7 @@ declare class OwneySDK {
     private readonly recoveredFundingReads;
     private fundingBalanceChecks;
     private readonly activationChecks;
+    private readonly withdrawalSubmissions;
     private readAgent;
     private initializingAgentsPromise;
     constructor(config: OwneySDKConfig);
@@ -735,6 +749,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 +899,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 +1085,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 +1112,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;
@@ -1127,7 +1145,7 @@ 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>;
+    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback, onProgress?: FundingProgress, onBeforeSubmission?: (evidence: FundingEvidence) => void | Promise<void>): 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. */
@@ -1193,7 +1211,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_CHECKPOINT_FAILED" | "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>;