@owney/sdk 0.7.32-beta.1 → 0.7.32-beta.2

package/dist/index.cjs

@@ -1548,7 +1548,7 @@ var SnapshotHistory = class {
 };
 
 // src/lib/funding-ledger.ts
-var SDK_VERSION = "0.7.32-beta.1";
+var SDK_VERSION = "0.7.32-beta.2";
 var SCOPE2 = "funding-ledger";
 var REQUEST_TIMEOUT_MS2 = 5e3;
 var RETRY_DELAYS_MS = [1e3, 4e3, 16e3];
@@ -2158,6 +2158,8 @@ function ledgerLegFromEvidence(e, kind) {
   if (e.callsId && e.callsId.length <= 200) leg.callsId = e.callsId;
   if (isUint(e.confirmedAmount)) leg.confirmedAmountRaw = e.confirmedAmount;
   if (e.blockNumber && /^\d{1,19}$/.test(e.blockNumber)) leg.blockNumber = e.blockNumber;
+  const providerRef = e.withdrawalRequest?.providerWithdrawalId;
+  if (typeof providerRef === "string" && providerRef.length >= 1 && providerRef.length <= 128) leg.providerRef = providerRef;
   const failure = e.withdrawalRequest?.failure;
   if (failure) leg.errorCode = failure.toUpperCase().replace(/-/g, "_");
   return leg;
@@ -2824,6 +2826,7 @@ var AgentReads = class {
 // src/agents/zyfai/zyfai.withdraw-submission.ts
 var BELOW_MINIMUM = /^Idle balance (\d+(?:\.\d+)?) (USDC|WETH|ETH|EURC) is below the minimum withdrawal of (\d+(?:\.\d+)?) \2\.?$/;
 var listenersByClient = /* @__PURE__ */ new WeakMap();
+var MAX_WITHDRAWAL_ID_LENGTH = 128;
 function observeWithdrawalSubmission(sdk, chainId, token, assertCurrent) {
   const client = sdk.httpClient;
   if (!client || typeof client.get !== "function" || typeof client.post !== "function")
@@ -2854,6 +2857,7 @@ function observeWithdrawalSubmission(sdk, chainId, token, assertCurrent) {
           method: method === "get" ? "GET" : "POST",
           path: method === "get" ? "/users/withdraw" : "/users/partial-withdraw"
         };
+        if (withdrawal) request3.path = `${request3.path}/v2`;
         let belowMinimum2;
         const notify2 = (outcome) => {
           if (outcome === "rejected" && matching.length !== 1) return;
@@ -2886,8 +2890,26 @@ function observeWithdrawalSubmission(sdk, chainId, token, assertCurrent) {
             captureStatus
           ] };
         }
+        const send = (route) => original.apply(this, [route, ...callArgs.slice(1)]);
         try {
-          return await original.apply(this, callArgs);
+          let result;
+          if (!withdrawal) result = await send(url);
+          else {
+            try {
+              result = await send(`${url}/v2`);
+            } catch (error) {
+              const status = request3.httpStatus ?? error?.response?.status;
+              if (status !== 404) throw error;
+              for (const observer of matching) observer.assertCurrent?.();
+              request3.path = url;
+              delete request3.httpStatus;
+              result = await send(url);
+            }
+            const id = result?.id;
+            if (request3.path?.endsWith("/v2") && typeof id === "string" && id.length >= 1 && id.length <= MAX_WITHDRAWAL_ID_LENGTH)
+              request3.providerWithdrawalId = id;
+          }
+          return result;
         } catch (error) {
           const message = error instanceof Error ? error.message : "";
           const minimum = BELOW_MINIMUM.exec(message);
@@ -5514,6 +5536,22 @@ var ZyfaiAgent = class _ZyfaiAgent {
     this.ledgerReads.clear();
     return { ...evidence, registration: "confirmed" };
   }
+  /** Reads a withdrawal's lifecycle by its id. Never signs, prompts or authenticates:
+   * it uses only a session the vendor client already holds, and any failure is `null`. */
+  async getWithdrawalLifecycle(state, withdrawalId) {
+    const internals = this.sdk;
+    const client = internals.httpClient;
+    if (!client?.authToken || typeof client.get !== "function" || this.connectedAddress?.toLowerCase() !== state.walletAddress.toLowerCase()) return null;
+    try {
+      const body = await client.get(`/users/withdrawals/${encodeURIComponent(withdrawalId)}`);
+      if (!body || typeof body !== "object" || typeof body.status !== "string" || typeof body.syncSettled !== "boolean")
+        return null;
+      const hash2 = typeof body.syncTxHash === "string" && /^0x[0-9a-fA-F]{64}$/.test(body.syncTxHash) ? body.syncTxHash : void 0;
+      return { status: body.status, syncSettled: body.syncSettled, ...hash2 ? { syncTxHash: hash2 } : {} };
+    } catch {
+      return null;
+    }
+  }
   // --- IAgent: Portfolio reads ---
   async getFundingWallet(state, chainId) {
     return this.readSmartWallet(state.walletAddress, isValidChainId(chainId));
@@ -8971,7 +9009,8 @@ var YieldseekerAgent = class {
         );
       const confirmedAmount = evidence.confirmedAmount && /^\d+$/.test(evidence.confirmedAmount) ? BigInt(evidence.confirmedAmount) : void 0;
       const feeIncrease = ownerFunds.fees - initialFunds.fees;
-      const feeAdjustment = amount !== void 0 && receipt && initialFunds.blockNumber !== void 0 && latestUnwindBlock !== void 0 && initialFunds.blockNumber <= latestUnwindBlock && receipt.blockNumber >= latestUnwindBlock && evidence.transfer === "confirmed" && evidence.delivery === "confirmed" && confirmedAmount === payout && feeIncrease > 0n && feeIncrease <= maxFee && requested - payout === feeIncrease ? { grossAmount: requested.toString(), feeAmount: feeIncrease.toString() } : void 0;
+      const feeShortfall = requested - payout;
+      const feeAdjustment = amount !== void 0 && receipt && initialFunds.blockNumber !== void 0 && latestUnwindBlock !== void 0 && initialFunds.blockNumber <= latestUnwindBlock && receipt.blockNumber >= latestUnwindBlock && evidence.transfer === "confirmed" && evidence.delivery === "confirmed" && confirmedAmount === payout && feeIncrease > 0n && feeIncrease <= maxFee && feeShortfall > 0n && feeShortfall <= feeIncrease ? { grossAmount: requested.toString(), feeAmount: feeShortfall.toString() } : void 0;
       return {
         txHash,
         type: amount === void 0 && !completion ? "full" : "partial",
@@ -10805,7 +10844,7 @@ var YieldseekerAgent = class {
       }
       const ttl = this.portfolioCacheMs(contextKey);
       this.settlementChecks.set(contextKey, 1);
-      const force = !this.deferredToLedger(contextKey);
+      const force = movement === "withdrawal" || !this.deferredToLedger(contextKey);
       await this.cachedRead(
         `snapshot:${contextKey}`,
         ttl,
@@ -15443,6 +15482,14 @@ var OwneySDK = class {
     if (verified.agentId !== "zyfai") return verified;
     return this.getAgent("zyfai").retryDepositRegistration(state, verified);
   }
+  /** A Zyfai withdrawal's lifecycle by the id recorded on its evidence. Never signs,
+   * prompts or authenticates; `null` when unavailable or not this wallet's Zyfai withdrawal. */
+  async getZyfaiWithdrawal(evidence) {
+    const state = this.state;
+    const id = evidence.withdrawalRequest?.providerWithdrawalId;
+    if (evidence.agentId !== "zyfai" || !id || !state || state.walletAddress.toLowerCase() !== evidence.walletAddress.toLowerCase()) return null;
+    return this.getAgent("zyfai").getWithdrawalLifecycle(state, id);
+  }
   // --- Fund operations ---
   /** On-chain version and ownership status for this owner's Yieldseeker agent. */
   async getYieldseekerWalletStatus(asset) {

package/dist/index.d.cts

@@ -777,13 +777,16 @@ interface FundingEvidence {
     withdrawalRequest?: {
         attempted: boolean;
         method?: "GET" | "POST";
-        path?: "/users/withdraw" | "/users/partial-withdraw";
+        /** The route that answered; a v2 path may fall back to v1 after an HTTP 404. */
+        path?: "/users/withdraw" | "/users/partial-withdraw" | "/users/withdraw/v2" | "/users/partial-withdraw/v2";
         elapsedMs?: number;
         /** 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";
         /** When the provider accepted the request without a hash (ms since epoch). */
         acceptedAt?: number;
+        /** Zyfai's v2 withdrawal id, for the lifecycle lookup (1-128 chars). */
+        providerWithdrawalId?: string;
     };
     /** Where an on-chain payout search may start, for a hashless acceptance.
      * `fromBlock` is the chain head read just before the request (decimal string). */
@@ -795,6 +798,14 @@ interface FundingEvidence {
     delivery: FundingStage;
 }
 type FundingProgress = (evidence: FundingEvidence) => void;
+/** The part of Zyfai's withdrawal lifecycle (`GET /users/withdrawals/{id}`) that Owney acts on. */
+type ZyfaiWithdrawalLifecycle = {
+    status: string;
+    /** The synchronous payout leg has settled. */
+    syncSettled: boolean;
+    /** Hash of the synchronous payout transaction; present only when well formed. */
+    syncTxHash?: `0x${string}`;
+};
 interface AssetReadMetadata {
     chainId: number;
     asset: string;
@@ -1621,6 +1632,9 @@ declare class OwneySDK {
     /** History lookup for receipt recovery; adapters may not authenticate or sign here. */
     getFundingHistory(evidence: FundingEvidence, fromDate: string, options?: Pick<HistoryFilters, "cursor" | "toDate">): Promise<OwneyAgentHistory>;
     recoverDepositRegistration(evidence: FundingEvidence): Promise<FundingEvidence>;
+    /** A Zyfai withdrawal's lifecycle by the id recorded on its evidence. Never signs,
+     * prompts or authenticates; `null` when unavailable or not this wallet's Zyfai withdrawal. */
+    getZyfaiWithdrawal(evidence: FundingEvidence): Promise<ZyfaiWithdrawalLifecycle | null>;
     /** On-chain version and ownership status for this owner's Yieldseeker agent. */
     getYieldseekerWalletStatus(asset: OwneySupportedTokens): Promise<YieldseekerWalletStatus | null>;
     /** Deployment gate; an unavailable response keeps the current paid path. */
@@ -2642,6 +2656,8 @@ type LedgerLegReport = {
     userOpHash?: string;
     callsId?: string;
     orderHash?: string;
+    /** The provider's own id for this leg's request (Zyfai's v2 withdrawal id). */
+    providerRef?: string;
     confirmedAmountRaw?: string;
     blockNumber?: string;
     errorCode?: string;
@@ -2660,4 +2676,4 @@ type LedgerLegReport = {
     };
 };
 
-export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentFundingLedgerAccess, 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 FundingOperationKind, type FundingOperationLeg, type FundingOperationRow, type FundingProgress, type FundingStage, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LedgerLegReport, 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 ProviderSnapshotSample, type RebalanceLog, type ReservationAgent, type ReservationReleaseReason, type RpcUrlsConfig, SDK_VERSION, 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 WithdrawalPayoutCandidate, type WithdrawalPayoutScan, type WithdrawalReservationConflict, type WithdrawalReservationMode, type WithdrawalReservationOptions, 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 AgentFundingLedgerAccess, 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 FundingOperationKind, type FundingOperationLeg, type FundingOperationRow, type FundingProgress, type FundingStage, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LedgerLegReport, 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 ProviderSnapshotSample, type RebalanceLog, type ReservationAgent, type ReservationReleaseReason, type RpcUrlsConfig, SDK_VERSION, 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 WithdrawalPayoutCandidate, type WithdrawalPayoutScan, type WithdrawalReservationConflict, type WithdrawalReservationMode, type WithdrawalReservationOptions, type WithdrawalSwapRecovery, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, type ZyfaiWithdrawalLifecycle, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.d.ts

@@ -777,13 +777,16 @@ interface FundingEvidence {
     withdrawalRequest?: {
         attempted: boolean;
         method?: "GET" | "POST";
-        path?: "/users/withdraw" | "/users/partial-withdraw";
+        /** The route that answered; a v2 path may fall back to v1 after an HTTP 404. */
+        path?: "/users/withdraw" | "/users/partial-withdraw" | "/users/withdraw/v2" | "/users/partial-withdraw/v2";
         elapsedMs?: number;
         /** 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";
         /** When the provider accepted the request without a hash (ms since epoch). */
         acceptedAt?: number;
+        /** Zyfai's v2 withdrawal id, for the lifecycle lookup (1-128 chars). */
+        providerWithdrawalId?: string;
     };
     /** Where an on-chain payout search may start, for a hashless acceptance.
      * `fromBlock` is the chain head read just before the request (decimal string). */
@@ -795,6 +798,14 @@ interface FundingEvidence {
     delivery: FundingStage;
 }
 type FundingProgress = (evidence: FundingEvidence) => void;
+/** The part of Zyfai's withdrawal lifecycle (`GET /users/withdrawals/{id}`) that Owney acts on. */
+type ZyfaiWithdrawalLifecycle = {
+    status: string;
+    /** The synchronous payout leg has settled. */
+    syncSettled: boolean;
+    /** Hash of the synchronous payout transaction; present only when well formed. */
+    syncTxHash?: `0x${string}`;
+};
 interface AssetReadMetadata {
     chainId: number;
     asset: string;
@@ -1621,6 +1632,9 @@ declare class OwneySDK {
     /** History lookup for receipt recovery; adapters may not authenticate or sign here. */
     getFundingHistory(evidence: FundingEvidence, fromDate: string, options?: Pick<HistoryFilters, "cursor" | "toDate">): Promise<OwneyAgentHistory>;
     recoverDepositRegistration(evidence: FundingEvidence): Promise<FundingEvidence>;
+    /** A Zyfai withdrawal's lifecycle by the id recorded on its evidence. Never signs,
+     * prompts or authenticates; `null` when unavailable or not this wallet's Zyfai withdrawal. */
+    getZyfaiWithdrawal(evidence: FundingEvidence): Promise<ZyfaiWithdrawalLifecycle | null>;
     /** On-chain version and ownership status for this owner's Yieldseeker agent. */
     getYieldseekerWalletStatus(asset: OwneySupportedTokens): Promise<YieldseekerWalletStatus | null>;
     /** Deployment gate; an unavailable response keeps the current paid path. */
@@ -2642,6 +2656,8 @@ type LedgerLegReport = {
     userOpHash?: string;
     callsId?: string;
     orderHash?: string;
+    /** The provider's own id for this leg's request (Zyfai's v2 withdrawal id). */
+    providerRef?: string;
     confirmedAmountRaw?: string;
     blockNumber?: string;
     errorCode?: string;
@@ -2660,4 +2676,4 @@ type LedgerLegReport = {
     };
 };
 
-export { type AccountAgentApy, type AccountApyOptions, type AccountDailyEarnings, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentFundingLedgerAccess, 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 FundingOperationKind, type FundingOperationLeg, type FundingOperationRow, type FundingProgress, type FundingStage, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LedgerLegReport, 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 ProviderSnapshotSample, type RebalanceLog, type ReservationAgent, type ReservationReleaseReason, type RpcUrlsConfig, SDK_VERSION, 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 WithdrawalPayoutCandidate, type WithdrawalPayoutScan, type WithdrawalReservationConflict, type WithdrawalReservationMode, type WithdrawalReservationOptions, 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 AgentFundingLedgerAccess, 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 FundingOperationKind, type FundingOperationLeg, type FundingOperationRow, type FundingProgress, type FundingStage, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, type LedgerLegReport, 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 ProviderSnapshotSample, type RebalanceLog, type ReservationAgent, type ReservationReleaseReason, type RpcUrlsConfig, SDK_VERSION, 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 WithdrawalPayoutCandidate, type WithdrawalPayoutScan, type WithdrawalReservationConflict, type WithdrawalReservationMode, type WithdrawalReservationOptions, type WithdrawalSwapRecovery, YieldseekerAgent, type YieldseekerWalletStatus, type ZyfaiRpcUrlsConfig, type ZyfaiWithdrawalLifecycle, clearWithdrawSwap, createOwneySIWX, listPendingDeposits, listOrders as listPendingSwaps, listWithdrawSwaps, saveWithdrawSwap, setOwneyDebug, subscribeWithdrawSwaps, updateWithdrawSwap };

package/dist/index.js

@@ -960,7 +960,7 @@ var SnapshotHistory = class {
 };
 
 // src/lib/funding-ledger.ts
-var SDK_VERSION = "0.7.32-beta.1";
+var SDK_VERSION = "0.7.32-beta.2";
 var SCOPE2 = "funding-ledger";
 var REQUEST_TIMEOUT_MS2 = 5e3;
 var RETRY_DELAYS_MS = [1e3, 4e3, 16e3];
@@ -1570,6 +1570,8 @@ function ledgerLegFromEvidence(e, kind) {
   if (e.callsId && e.callsId.length <= 200) leg.callsId = e.callsId;
   if (isUint(e.confirmedAmount)) leg.confirmedAmountRaw = e.confirmedAmount;
   if (e.blockNumber && /^\d{1,19}$/.test(e.blockNumber)) leg.blockNumber = e.blockNumber;
+  const providerRef = e.withdrawalRequest?.providerWithdrawalId;
+  if (typeof providerRef === "string" && providerRef.length >= 1 && providerRef.length <= 128) leg.providerRef = providerRef;
   const failure = e.withdrawalRequest?.failure;
   if (failure) leg.errorCode = failure.toUpperCase().replace(/-/g, "_");
   return leg;
@@ -2228,6 +2230,7 @@ var AgentReads = class {
 // src/agents/zyfai/zyfai.withdraw-submission.ts
 var BELOW_MINIMUM = /^Idle balance (\d+(?:\.\d+)?) (USDC|WETH|ETH|EURC) is below the minimum withdrawal of (\d+(?:\.\d+)?) \2\.?$/;
 var listenersByClient = /* @__PURE__ */ new WeakMap();
+var MAX_WITHDRAWAL_ID_LENGTH = 128;
 function observeWithdrawalSubmission(sdk, chainId, token, assertCurrent) {
   const client = sdk.httpClient;
   if (!client || typeof client.get !== "function" || typeof client.post !== "function")
@@ -2258,6 +2261,7 @@ function observeWithdrawalSubmission(sdk, chainId, token, assertCurrent) {
           method: method === "get" ? "GET" : "POST",
           path: method === "get" ? "/users/withdraw" : "/users/partial-withdraw"
         };
+        if (withdrawal) request3.path = `${request3.path}/v2`;
         let belowMinimum2;
         const notify2 = (outcome) => {
           if (outcome === "rejected" && matching.length !== 1) return;
@@ -2290,8 +2294,26 @@ function observeWithdrawalSubmission(sdk, chainId, token, assertCurrent) {
             captureStatus
           ] };
         }
+        const send = (route) => original.apply(this, [route, ...callArgs.slice(1)]);
         try {
-          return await original.apply(this, callArgs);
+          let result;
+          if (!withdrawal) result = await send(url);
+          else {
+            try {
+              result = await send(`${url}/v2`);
+            } catch (error) {
+              const status = request3.httpStatus ?? error?.response?.status;
+              if (status !== 404) throw error;
+              for (const observer of matching) observer.assertCurrent?.();
+              request3.path = url;
+              delete request3.httpStatus;
+              result = await send(url);
+            }
+            const id = result?.id;
+            if (request3.path?.endsWith("/v2") && typeof id === "string" && id.length >= 1 && id.length <= MAX_WITHDRAWAL_ID_LENGTH)
+              request3.providerWithdrawalId = id;
+          }
+          return result;
         } catch (error) {
           const message = error instanceof Error ? error.message : "";
           const minimum = BELOW_MINIMUM.exec(message);
@@ -4915,6 +4937,22 @@ var ZyfaiAgent = class _ZyfaiAgent {
     this.ledgerReads.clear();
     return { ...evidence, registration: "confirmed" };
   }
+  /** Reads a withdrawal's lifecycle by its id. Never signs, prompts or authenticates:
+   * it uses only a session the vendor client already holds, and any failure is `null`. */
+  async getWithdrawalLifecycle(state, withdrawalId) {
+    const internals = this.sdk;
+    const client = internals.httpClient;
+    if (!client?.authToken || typeof client.get !== "function" || this.connectedAddress?.toLowerCase() !== state.walletAddress.toLowerCase()) return null;
+    try {
+      const body = await client.get(`/users/withdrawals/${encodeURIComponent(withdrawalId)}`);
+      if (!body || typeof body !== "object" || typeof body.status !== "string" || typeof body.syncSettled !== "boolean")
+        return null;
+      const hash2 = typeof body.syncTxHash === "string" && /^0x[0-9a-fA-F]{64}$/.test(body.syncTxHash) ? body.syncTxHash : void 0;
+      return { status: body.status, syncSettled: body.syncSettled, ...hash2 ? { syncTxHash: hash2 } : {} };
+    } catch {
+      return null;
+    }
+  }
   // --- IAgent: Portfolio reads ---
   async getFundingWallet(state, chainId) {
     return this.readSmartWallet(state.walletAddress, isValidChainId(chainId));
@@ -8395,7 +8433,8 @@ var YieldseekerAgent = class {
         );
       const confirmedAmount = evidence.confirmedAmount && /^\d+$/.test(evidence.confirmedAmount) ? BigInt(evidence.confirmedAmount) : void 0;
       const feeIncrease = ownerFunds.fees - initialFunds.fees;
-      const feeAdjustment = amount !== void 0 && receipt && initialFunds.blockNumber !== void 0 && latestUnwindBlock !== void 0 && initialFunds.blockNumber <= latestUnwindBlock && receipt.blockNumber >= latestUnwindBlock && evidence.transfer === "confirmed" && evidence.delivery === "confirmed" && confirmedAmount === payout && feeIncrease > 0n && feeIncrease <= maxFee && requested - payout === feeIncrease ? { grossAmount: requested.toString(), feeAmount: feeIncrease.toString() } : void 0;
+      const feeShortfall = requested - payout;
+      const feeAdjustment = amount !== void 0 && receipt && initialFunds.blockNumber !== void 0 && latestUnwindBlock !== void 0 && initialFunds.blockNumber <= latestUnwindBlock && receipt.blockNumber >= latestUnwindBlock && evidence.transfer === "confirmed" && evidence.delivery === "confirmed" && confirmedAmount === payout && feeIncrease > 0n && feeIncrease <= maxFee && feeShortfall > 0n && feeShortfall <= feeIncrease ? { grossAmount: requested.toString(), feeAmount: feeShortfall.toString() } : void 0;
       return {
         txHash,
         type: amount === void 0 && !completion ? "full" : "partial",
@@ -10229,7 +10268,7 @@ var YieldseekerAgent = class {
       }
       const ttl = this.portfolioCacheMs(contextKey);
       this.settlementChecks.set(contextKey, 1);
-      const force = !this.deferredToLedger(contextKey);
+      const force = movement === "withdrawal" || !this.deferredToLedger(contextKey);
       await this.cachedRead(
         `snapshot:${contextKey}`,
         ttl,
@@ -14872,6 +14911,14 @@ var OwneySDK = class {
     if (verified.agentId !== "zyfai") return verified;
     return this.getAgent("zyfai").retryDepositRegistration(state, verified);
   }
+  /** A Zyfai withdrawal's lifecycle by the id recorded on its evidence. Never signs,
+   * prompts or authenticates; `null` when unavailable or not this wallet's Zyfai withdrawal. */
+  async getZyfaiWithdrawal(evidence) {
+    const state = this.state;
+    const id = evidence.withdrawalRequest?.providerWithdrawalId;
+    if (evidence.agentId !== "zyfai" || !id || !state || state.walletAddress.toLowerCase() !== evidence.walletAddress.toLowerCase()) return null;
+    return this.getAgent("zyfai").getWithdrawalLifecycle(state, id);
+  }
   // --- Fund operations ---
   /** On-chain version and ownership status for this owner's Yieldseeker agent. */
   async getYieldseekerWalletStatus(asset) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.7.32-beta.1",
+  "version": "0.7.32-beta.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",