@owney/sdk 0.7.27-beta.2 → 0.7.27-beta.3

package/dist/index.d.cts

@@ -566,6 +566,9 @@ type AgentsApyOptions = {
     chainId?: number;
 };
 type DepositOptions = {
+    /** Optional synchronous foreground ownership fence for the default Permit2 rail.
+     * Throw to stop preparation/dispatch and late journal writes after lease/session loss. */
+    assertSubmissionCurrent?: () => void;
     /** Resume only these already signed relayer bytes; never create a new authorization. */
     resumeTxHash?: `0x${string}`;
     onProgress?: FundingProgress;
@@ -605,6 +608,15 @@ type UnsignedUserOperationEvidence = {
     maxPriorityFeePerGas: string;
     paymasterAndData: string;
 };
+type DepositAuthorizationReference = {
+    authorizationId: `0x${string}`;
+    predecessorTxHash?: `0x${string}`;
+};
+type DepositReplacementValidation = {
+    authorizationId: `0x${string}`;
+    predecessorTxHash: `0x${string}`;
+    replacementTxHash: `0x${string}`;
+};
 /** Evidence about one provider leg. Amounts are token base units, never USD. */
 interface FundingEvidence {
     agentId: AgentId;
@@ -629,6 +641,7 @@ interface FundingEvidence {
     callsId?: string;
     /** Deposit execution was attempted, rather than only prepared. Not confirmation. */
     depositSubmission?: "started";
+    depositAuthorization?: DepositAuthorizationReference;
     blockNumber?: string;
     logIndexes?: number[];
     transferLogs?: {
@@ -1139,6 +1152,7 @@ declare class OwneySDK {
     private paymasterServiceUrl?;
     private cachedSponsoredCallsCallbacks;
     private readonly agentReads;
+    private readonly depositFamilyReads;
     private readonly recoveredFundingReads;
     private fundingBalanceChecks;
     private readonly activationChecks;
@@ -1319,6 +1333,8 @@ declare class OwneySDK {
     /** 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>;
+    /** Validate signed journal membership, never just a caller-supplied family ID. */
+    validateDepositReplacement(previous: FundingEvidence[], next: FundingEvidence[]): Promise<DepositReplacementValidation | undefined>;
     /** Optional post-payout display proof; receipt verification and the provider
      * adapter must agree before attaching it to this exact balance object. */
     verifyWithdrawalBalance(evidence: FundingEvidence, balance: AgentBalance): Promise<AgentBalance>;
@@ -1586,6 +1602,12 @@ declare class OwneySDK {
         /** Percent, classic rail only. Fusion+ prices through its auction. */
         slippage?: number;
         onSwapProgress?: (stage: SwapStage) => void;
+        /** Destination balance baseline, read after the swap and before deposit preparation. */
+        onBeforeDeposit?: () => Promise<void>;
+        onDepositProgress?: FundingProgress;
+        onBeforeDepositSubmission?: DepositOptions["onBeforeSubmission"];
+        /** Stop a stale foreground attempt before it prepares or sends another transaction. */
+        assertCurrent?: () => void;
     }): Promise<{
         swap: {
             received: string;
@@ -1802,7 +1824,7 @@ declare class OwneySDK {
      * @param expectedChainId Chain captured by the deposit that requested approval.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint, expectedChainId?: OwneySupportedChainId): Promise<`0x${string}`>;
+    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint, expectedChainId?: OwneySupportedChainId, assertCurrent?: () => void): 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")
@@ -1889,6 +1911,7 @@ declare class YieldseekerAgent implements IAgent {
     private readonly routingApiBaseUrl?;
     private receiptClient?;
     private readonly withdrawalVersionCache;
+    private readonly pendingWalletStatus;
     private readonly pendingUpgrades;
     private readonly transactionExecutor?;
     private readonly unwindReceiptWaiter?;
@@ -1905,11 +1928,13 @@ declare class YieldseekerAgent implements IAgent {
     private readonly liquidityVersions;
     private readonly snapshotFailures;
     private readonly standardReadFailures;
+    private readonly endpointReadFailures;
     private readonly reconcileUntil;
     private readonly allocationRefresh;
     private readonly activityRefreshUntil;
     private readonly snapshotMovements;
     private readonly movementEpochs;
+    private readonly settlementChecks;
     private readonly vaultOptions;
     private readonly pendingVaultOptions;
     constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
@@ -1966,7 +1991,13 @@ declare class YieldseekerAgent implements IAgent {
     private loadActivityPortfolio;
     private resolvePortfolioContexts;
     private portfolioVersion;
+    /** Snapshot cache lifetime: the settlement backoff while a movement is being
+     * checked, otherwise the routine non-forced cadence. */
     private portfolioCacheMs;
+    /** A pending movement inside its ten-minute window forces snapshots. */
+    private settling;
+    /** Start a new forced-check schedule, or keep the active one. */
+    private beginSettlement;
     private snapshotMovement;
     private advancePortfolioVersion;
     private requestPortfolioSnapshot;
@@ -2071,4 +2102,4 @@ type StoredOrder = {
  */
 declare function listOrders(_now?: number): StoredOrder[];
 
-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 PendingDeposit, type RebalanceLog, type RpcUrlsConfig, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UnsignedUserOperationEvidence, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, type WithdrawalCompletion, type WithdrawalCompletionContext, type WithdrawalSwapRecovery, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };
+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 DepositAuthorizationReference, type DepositCallback, type DepositOptions, type DepositReplacementValidation, 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 PendingDeposit, type RebalanceLog, type RpcUrlsConfig, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UnsignedUserOperationEvidence, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, type WithdrawalCompletion, type WithdrawalCompletionContext, type WithdrawalSwapRecovery, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.d.ts

@@ -566,6 +566,9 @@ type AgentsApyOptions = {
     chainId?: number;
 };
 type DepositOptions = {
+    /** Optional synchronous foreground ownership fence for the default Permit2 rail.
+     * Throw to stop preparation/dispatch and late journal writes after lease/session loss. */
+    assertSubmissionCurrent?: () => void;
     /** Resume only these already signed relayer bytes; never create a new authorization. */
     resumeTxHash?: `0x${string}`;
     onProgress?: FundingProgress;
@@ -605,6 +608,15 @@ type UnsignedUserOperationEvidence = {
     maxPriorityFeePerGas: string;
     paymasterAndData: string;
 };
+type DepositAuthorizationReference = {
+    authorizationId: `0x${string}`;
+    predecessorTxHash?: `0x${string}`;
+};
+type DepositReplacementValidation = {
+    authorizationId: `0x${string}`;
+    predecessorTxHash: `0x${string}`;
+    replacementTxHash: `0x${string}`;
+};
 /** Evidence about one provider leg. Amounts are token base units, never USD. */
 interface FundingEvidence {
     agentId: AgentId;
@@ -629,6 +641,7 @@ interface FundingEvidence {
     callsId?: string;
     /** Deposit execution was attempted, rather than only prepared. Not confirmation. */
     depositSubmission?: "started";
+    depositAuthorization?: DepositAuthorizationReference;
     blockNumber?: string;
     logIndexes?: number[];
     transferLogs?: {
@@ -1139,6 +1152,7 @@ declare class OwneySDK {
     private paymasterServiceUrl?;
     private cachedSponsoredCallsCallbacks;
     private readonly agentReads;
+    private readonly depositFamilyReads;
     private readonly recoveredFundingReads;
     private fundingBalanceChecks;
     private readonly activationChecks;
@@ -1319,6 +1333,8 @@ declare class OwneySDK {
     /** 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>;
+    /** Validate signed journal membership, never just a caller-supplied family ID. */
+    validateDepositReplacement(previous: FundingEvidence[], next: FundingEvidence[]): Promise<DepositReplacementValidation | undefined>;
     /** Optional post-payout display proof; receipt verification and the provider
      * adapter must agree before attaching it to this exact balance object. */
     verifyWithdrawalBalance(evidence: FundingEvidence, balance: AgentBalance): Promise<AgentBalance>;
@@ -1586,6 +1602,12 @@ declare class OwneySDK {
         /** Percent, classic rail only. Fusion+ prices through its auction. */
         slippage?: number;
         onSwapProgress?: (stage: SwapStage) => void;
+        /** Destination balance baseline, read after the swap and before deposit preparation. */
+        onBeforeDeposit?: () => Promise<void>;
+        onDepositProgress?: FundingProgress;
+        onBeforeDepositSubmission?: DepositOptions["onBeforeSubmission"];
+        /** Stop a stale foreground attempt before it prepares or sends another transaction. */
+        assertCurrent?: () => void;
     }): Promise<{
         swap: {
             received: string;
@@ -1802,7 +1824,7 @@ declare class OwneySDK {
      * @param expectedChainId Chain captured by the deposit that requested approval.
      * @returns the approval transaction hash.
      */
-    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint, expectedChainId?: OwneySupportedChainId): Promise<`0x${string}`>;
+    approvePermit2(asset?: OwneySupportedTokens, requiredAmount?: bigint, expectedChainId?: OwneySupportedChainId, assertCurrent?: () => void): 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")
@@ -1889,6 +1911,7 @@ declare class YieldseekerAgent implements IAgent {
     private readonly routingApiBaseUrl?;
     private receiptClient?;
     private readonly withdrawalVersionCache;
+    private readonly pendingWalletStatus;
     private readonly pendingUpgrades;
     private readonly transactionExecutor?;
     private readonly unwindReceiptWaiter?;
@@ -1905,11 +1928,13 @@ declare class YieldseekerAgent implements IAgent {
     private readonly liquidityVersions;
     private readonly snapshotFailures;
     private readonly standardReadFailures;
+    private readonly endpointReadFailures;
     private readonly reconcileUntil;
     private readonly allocationRefresh;
     private readonly activityRefreshUntil;
     private readonly snapshotMovements;
     private readonly movementEpochs;
+    private readonly settlementChecks;
     private readonly vaultOptions;
     private readonly pendingVaultOptions;
     constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
@@ -1966,7 +1991,13 @@ declare class YieldseekerAgent implements IAgent {
     private loadActivityPortfolio;
     private resolvePortfolioContexts;
     private portfolioVersion;
+    /** Snapshot cache lifetime: the settlement backoff while a movement is being
+     * checked, otherwise the routine non-forced cadence. */
     private portfolioCacheMs;
+    /** A pending movement inside its ten-minute window forces snapshots. */
+    private settling;
+    /** Start a new forced-check schedule, or keep the active one. */
+    private beginSettlement;
     private snapshotMovement;
     private advancePortfolioVersion;
     private requestPortfolioSnapshot;
@@ -2071,4 +2102,4 @@ type StoredOrder = {
  */
 declare function listOrders(_now?: number): StoredOrder[];
 
-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 PendingDeposit, type RebalanceLog, type RpcUrlsConfig, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UnsignedUserOperationEvidence, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, type WithdrawalCompletion, type WithdrawalCompletionContext, type WithdrawalSwapRecovery, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };
+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 DepositAuthorizationReference, type DepositCallback, type DepositOptions, type DepositReplacementValidation, 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 PendingDeposit, type RebalanceLog, type RpcUrlsConfig, type SwapChainTokens, type SwapDirection, type SwapOrderStatus, type SwapQuote, type SwapQuoteParams, type SwapRail, type SwapStage, type SwapTokenInfo, type SwapTokenSearchResult, type UnsignedUserOperationEvidence, type WithdrawOptions, type WithdrawSwapRecord, type WithdrawSwapStatus, type WithdrawalCompletion, type WithdrawalCompletionContext, type WithdrawalSwapRecovery, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };