@owney/sdk 0.7.17-beta.0 → 0.7.17-beta.1

package/dist/index.cjs

@@ -3631,9 +3631,12 @@ var OwneySDK = class {
           { asset, agentErrors: agentErrors2 }
         );
       }
+      const amountsKnown = Object.values(results2).every(
+        (result) => typeof result.amount === "string" && /^\d+$/.test(result.amount)
+      );
       return {
         agentResult: results2,
-        totalWithdrawn: sumWithdrawnAmount(results2).toString()
+        totalWithdrawn: amountsKnown ? sumWithdrawnAmount(results2).toString() : null
       };
     }
     const requested = BigInt(amount);
@@ -3753,6 +3756,7 @@ var OwneySDK = class {
     );
     let successCount = 0;
     const agentErrors = {};
+    const agentRetryAt = {};
     const agentFailures = [];
     for (let i = 0; i < balanceResults.length; i++) {
       const settledResult = balanceResults[i];
@@ -3766,6 +3770,8 @@ var OwneySDK = class {
       }
       const reason = settledResult.reason;
       agentFailures.push(reason);
+      const retryDelay = rateLimitDelay(reason);
+      if (retryDelay !== void 0) agentRetryAt[agentId2] = Date.now() + retryDelay;
       agentErrors[agentId2] = reason instanceof Error ? reason.message : String(reason);
     }
     if (successCount === 0) {
@@ -3778,7 +3784,8 @@ var OwneySDK = class {
     return {
       totalBalance: String(totalBalance),
       totalBalanceAsset: "usdc",
-      agentBalances: results
+      agentBalances: results,
+      ...Object.keys(agentErrors).length > 0 ? { agentErrors, agentRetryAt } : {}
     };
   }
   /**

package/dist/index.d.cts

@@ -186,11 +186,16 @@ interface OwneyMultiDepositResult {
 interface AgentWithdrawResult {
     txHash?: string;
     type: "full" | "partial";
+    /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
     amount: string;
 }
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
-    totalWithdrawn: string;
+    /**
+     * 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.
+     */
+    totalWithdrawn: string | null;
 }
 interface OwneyToken {
     chain: OwneySupportedChains;
@@ -254,6 +259,10 @@ interface OwneyBalances {
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
     agentBalances: Record<AgentId, AgentBalance>;
+    /** Omitted agents failed to load; they must not be interpreted as zero. */
+    agentErrors?: Record<AgentId, string>;
+    /** Absolute provider cooldown deadlines (Unix milliseconds). */
+    agentRetryAt?: Record<AgentId, number>;
 }
 interface AgentEarnings {
     smartWallet: `0x${string}`;

package/dist/index.d.ts

@@ -186,11 +186,16 @@ interface OwneyMultiDepositResult {
 interface AgentWithdrawResult {
     txHash?: string;
     type: "full" | "partial";
+    /** Smallest-unit amount, or a provider sentinel such as "all" for a full request. */
     amount: string;
 }
 interface OwneyWithdrawResult {
     agentResult: Record<AgentId, AgentWithdrawResult>;
-    totalWithdrawn: string;
+    /**
+     * 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.
+     */
+    totalWithdrawn: string | null;
 }
 interface OwneyToken {
     chain: OwneySupportedChains;
@@ -254,6 +259,10 @@ interface OwneyBalances {
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
     agentBalances: Record<AgentId, AgentBalance>;
+    /** Omitted agents failed to load; they must not be interpreted as zero. */
+    agentErrors?: Record<AgentId, string>;
+    /** Absolute provider cooldown deadlines (Unix milliseconds). */
+    agentRetryAt?: Record<AgentId, number>;
 }
 interface AgentEarnings {
     smartWallet: `0x${string}`;

package/dist/index.js

@@ -3602,9 +3602,12 @@ var OwneySDK = class {
           { asset, agentErrors: agentErrors2 }
         );
       }
+      const amountsKnown = Object.values(results2).every(
+        (result) => typeof result.amount === "string" && /^\d+$/.test(result.amount)
+      );
       return {
         agentResult: results2,
-        totalWithdrawn: sumWithdrawnAmount(results2).toString()
+        totalWithdrawn: amountsKnown ? sumWithdrawnAmount(results2).toString() : null
       };
     }
     const requested = BigInt(amount);
@@ -3724,6 +3727,7 @@ var OwneySDK = class {
     );
     let successCount = 0;
     const agentErrors = {};
+    const agentRetryAt = {};
     const agentFailures = [];
     for (let i = 0; i < balanceResults.length; i++) {
       const settledResult = balanceResults[i];
@@ -3737,6 +3741,8 @@ var OwneySDK = class {
       }
       const reason = settledResult.reason;
       agentFailures.push(reason);
+      const retryDelay = rateLimitDelay(reason);
+      if (retryDelay !== void 0) agentRetryAt[agentId2] = Date.now() + retryDelay;
       agentErrors[agentId2] = reason instanceof Error ? reason.message : String(reason);
     }
     if (successCount === 0) {
@@ -3749,7 +3755,8 @@ var OwneySDK = class {
     return {
       totalBalance: String(totalBalance),
       totalBalanceAsset: "usdc",
-      agentBalances: results
+      agentBalances: results,
+      ...Object.keys(agentErrors).length > 0 ? { agentErrors, agentRetryAt } : {}
     };
   }
   /**

package/package.json

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