@owney/sdk 0.2.6 → 0.2.7

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(src_exports, {
   AgentChainIncompatibleError: () => AgentChainIncompatibleError,
   AgentNotFoundError: () => AgentNotFoundError,
   NotConnectedError: () => NotConnectedError,
+  OwneyError: () => OwneyError,
   OwneySDK: () => OwneySDK
 });
 module.exports = __toCommonJS(src_exports);
@@ -55,11 +56,58 @@ var SupportedAssets = [
   }
 ];
 
+// src/errors.ts
+var OwneyError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "OwneyError";
+    this.code = code;
+    this.details = details;
+  }
+};
+var AgentNotFoundError = class extends OwneyError {
+  constructor(agentId, available) {
+    super(
+      "AGENT_NOT_FOUND",
+      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
+      { agentId, available }
+    );
+    this.name = "AgentNotFoundError";
+  }
+};
+var NotConnectedError = class extends OwneyError {
+  constructor() {
+    super("NOT_CONNECTED", "Not connected. Call sdk.connect(provider) first.");
+    this.name = "NotConnectedError";
+  }
+};
+var AgentChainIncompatibleError = class extends OwneyError {
+  incompatibleAgents;
+  connectedChainId;
+  constructor(incompatibleAgents, connectedChainId) {
+    const details = incompatibleAgents.map(
+      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
+    ).join("; ");
+    super(
+      "AGENT_CHAIN_INCOMPATIBLE",
+      `Chain ${connectedChainId} is not supported by the following agents: ${details}`,
+      { incompatibleAgents, connectedChainId }
+    );
+    this.name = "AgentChainIncompatibleError";
+    this.incompatibleAgents = incompatibleAgents;
+    this.connectedChainId = connectedChainId;
+  }
+};
+
 // src/lib/utils.ts
 var isValidChainId = (chainId) => {
   if (!SUPPORTED_CHAIN_IDS.includes(chainId)) {
-    throw new Error(
-      `Unsupported chain ID: ${chainId}. Supported chains: ${SUPPORTED_CHAIN_IDS.join(", ")}`
+    throw new OwneyError(
+      "CHAIN_UNSUPPORTED",
+      `Unsupported chain ID: ${chainId}. Supported chains: ${SUPPORTED_CHAIN_IDS.join(", ")}`,
+      { chainId, supportedChainIds: [...SUPPORTED_CHAIN_IDS] }
     );
   }
   return chainId;
@@ -74,6 +122,15 @@ function hexToDecimal(hex, decimals = 6) {
   const remainder = parsed % divisor;
   return Number(whole) + Number(remainder) / Number(divisor);
 }
+function normalizeDecimalPlace(value, decimals = 6) {
+  const parsed = BigInt(value);
+  if (decimals <= 0)
+    return Number(parsed);
+  const divisor = BigInt(10 ** decimals);
+  const whole = parsed / divisor;
+  const remainder = parsed % divisor;
+  return Number(whole) + Number(remainder) / Number(divisor);
+}
 var DayFilterMapping = {
   "30D": 30,
   "14D": 14,
@@ -103,7 +160,7 @@ var CHAIN_NAME_TO_ID = {
   BASE: 8453,
   ARBITRUM: 42161
 };
-function mapBalances(raw, chainId) {
+function mapBalances(raw, chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const tokenMap = /* @__PURE__ */ new Map();
   for (const p of portfolio.positions || []) {
@@ -114,18 +171,7 @@ function mapBalances(raw, chainId) {
     tokenMap.set(key, {
       symbol,
       chainId: positionChainId,
-      amount: (current?.amount ?? 0) + hexToDecimal(p.amount || "0")
-    });
-  }
-  for (const s of portfolio.staleBalances || []) {
-    const symbol = s.tokenSymbol || "USDC";
-    const staleChainId = s.chainId ?? chainId;
-    const key = `${symbol}:${staleChainId}`;
-    const current = tokenMap.get(key);
-    tokenMap.set(key, {
-      symbol,
-      chainId: staleChainId,
-      amount: (current?.amount ?? 0) + hexToDecimal(s.balance || "0")
+      amount: (current?.amount ?? 0) + normalizeDecimalPlace(p.underlyingAmount || "0")
     });
   }
   let totalBalance = 0;
@@ -140,7 +186,7 @@ function mapBalances(raw, chainId) {
     });
   }
   return {
-    smartWallet: portfolio.smartWallet,
+    smartWallet,
     totalBalance: String(totalBalance),
     tokens
   };
@@ -292,7 +338,10 @@ var ZyfaiAgent = class {
   // --- Private helpers ---
   getAddress() {
     if (!this.connectedAddress) {
-      throw new Error("Wallet not connected. Call sdk.connect() first.");
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "Wallet not connected. Call sdk.connect() first."
+      );
     }
     return this.connectedAddress;
   }
@@ -444,15 +493,14 @@ var ZyfaiAgent = class {
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
     const startedAt = Date.now();
-    await this.connectAuth(state, chainId);
-    const validChainId = isValidChainId(chainId);
-    const positionsStart = Date.now();
-    const raw = await this.sdk.getPositions(this.getAddress(), validChainId);
-    logTiming("getBalances getPositions", positionsStart, {
+    const { smartWallet, chainId: validChainId } = await this.resolveSmartWallet(state, chainId);
+    const portfolioStart = Date.now();
+    const raw = await this.sdk.getPortfolio(this.getAddress());
+    logTiming("getBalances getPortfolio", portfolioStart, {
       chainId: validChainId
     });
     logTiming("getBalances success", startedAt, { chainId: validChainId });
-    return mapBalances(raw, validChainId);
+    return mapBalances(raw, validChainId, smartWallet);
   }
   async getEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
@@ -764,7 +812,11 @@ var SailAgent = class {
       });
     } catch (error) {
       if (error instanceof Error && error.name === "AbortError" && timeoutMs) {
-        throw new Error(`Sail API timeout ${timeoutMs}ms: ${method} ${path}`);
+        throw new OwneyError(
+          "API_SAIL_TIMEOUT",
+          `Sail API timeout ${timeoutMs}ms: ${method} ${path}`,
+          { timeoutMs, method, path }
+        );
       }
       throw error;
     } finally {
@@ -773,7 +825,11 @@ var SailAgent = class {
     }
     if (!res.ok) {
       const text = await res.text().catch(() => "");
-      throw new Error(`Sail API error ${res.status}: ${text}`);
+      throw new OwneyError(
+        "API_SAIL_ERROR",
+        `Sail API error ${res.status}: ${text}`,
+        { statusCode: res.status, method, path, responseBody: text }
+      );
     }
     return res.json();
   }
@@ -814,7 +870,10 @@ var SailAgent = class {
       return;
     }
     if (!state.walletAddress) {
-      throw new Error("Wallet address is required");
+      throw new OwneyError(
+        "WALLET_ADDRESS_REQUIRED",
+        "Wallet address is required. Call sdk.connect(provider) first."
+      );
     }
     this.connectPromise = (async () => {
       const { sessionId, signature, message } = await this.signSiwe(
@@ -850,7 +909,10 @@ var SailAgent = class {
     await this.connectFull(state, chainId);
     const validChainId = isValidChainId(chainId);
     if (!this.smartWalletAddress) {
-      throw new Error("Wallet not connected. Call sdk.connect() first.");
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "Wallet not connected. Call sdk.connect() first."
+      );
     }
     logTiming2("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return {
@@ -877,7 +939,8 @@ var SailAgent = class {
   }
   async deposit(state, chainId, amount, depositCallback) {
     if (!depositCallback) {
-      throw new Error(
+      throw new OwneyError(
+        "DEPOSIT_CALLBACK_REQUIRED",
         "depositCallback is required for Sail. Provide a callback that transfers tokens and returns the transaction hash."
       );
     }
@@ -886,12 +949,16 @@ var SailAgent = class {
       const depositInfo = await this.getDepositInfo();
       const resolvedTokenAddress = depositInfo.permittedTokens[0]?.address;
       if (!resolvedTokenAddress) {
-        throw new Error("No permitted tokens available for deposit.");
+        throw new OwneyError(
+          "DEPOSIT_NO_PERMITTED_TOKENS",
+          "No permitted tokens available for deposit."
+        );
       }
       await this.executePreHooks(resolvedTokenAddress, amount, chainId);
       const txHash = await depositCallback(smartWallet, chainId, amount);
       if (!txHash) {
-        throw new Error(
+        throw new OwneyError(
+          "DEPOSIT_CALLBACK_INVALID",
           "depositCallback must return a transaction hash (txHash) for Sail deposits."
         );
       }
@@ -945,7 +1012,10 @@ var SailAgent = class {
     const withdrawInfo = await this.getWithdrawInfo();
     const tokenAddress = withdrawInfo.permittedTokens[0]?.address;
     if (!tokenAddress) {
-      throw new Error("No permitted tokens available for withdrawal.");
+      throw new OwneyError(
+        "WITHDRAW_NO_PERMITTED_TOKENS",
+        "No permitted tokens available for withdrawal."
+      );
     }
     const resolvedAmount = amount ?? withdrawInfo.currentBalance;
     const { signature: adminWalletSignature, message: adminWalletPayload } = await this.signSiwe(state, chainId);
@@ -978,7 +1048,7 @@ var SailAgent = class {
       logTiming2("getBalances success", startedAt, { chainId });
       return mapPortfolioBalances(raw, smartWallet);
     } catch (error) {
-      if (error instanceof Error && error.message.startsWith("Sail API timeout")) {
+      if (error instanceof OwneyError && error.code === "API_SAIL_TIMEOUT") {
         console.warn(
           "Sail portfolio request timed out; using empty snapshot.",
           {
@@ -1062,8 +1132,10 @@ var SailAgent = class {
     }
     const dayCount = DayFilterMapping[days];
     if (dayCount === void 0) {
-      throw new Error(
-        `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`
+      throw new OwneyError(
+        "VALIDATION_INVALID_DAYS",
+        `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`,
+        { days }
       );
     }
     const now = /* @__PURE__ */ new Date();
@@ -1140,37 +1212,6 @@ var SailAgent = class {
   }
 };
 
-// src/errors.ts
-var AgentNotFoundError = class extends Error {
-  constructor(agentId, available) {
-    super(
-      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`
-    );
-    this.name = "AgentNotFoundError";
-  }
-};
-var NotConnectedError = class extends Error {
-  constructor() {
-    super("Not connected. Call sdk.connect(provider) first.");
-    this.name = "NotConnectedError";
-  }
-};
-var AgentChainIncompatibleError = class extends Error {
-  incompatibleAgents;
-  connectedChainId;
-  constructor(incompatibleAgents, connectedChainId) {
-    const details = incompatibleAgents.map(
-      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
-    ).join("; ");
-    super(
-      `Chain ${connectedChainId} is not supported by the following agents: ${details}`
-    );
-    this.name = "AgentChainIncompatibleError";
-    this.incompatibleAgents = incompatibleAgents;
-    this.connectedChainId = connectedChainId;
-  }
-};
-
 // src/lib/routing-api.ts
 var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
 async function fetchAgentKeys(apiKey) {
@@ -1184,11 +1225,19 @@ async function fetchAgentKeys(apiKey) {
   });
   if (!res.ok) {
     const text = await res.text().catch(() => "");
-    throw new Error(`Routing API error ${res.status}: ${text}`);
+    throw new OwneyError(
+      "API_ROUTING_ERROR",
+      `Routing API error ${res.status}: ${text}`,
+      { statusCode: res.status, responseBody: text }
+    );
   }
   const json = await res.json();
   if (!json.success) {
-    throw new Error(`Routing API request failed: ${json.message}`);
+    throw new OwneyError(
+      "API_ROUTING_FAILED",
+      `Routing API request failed: ${json.message}`,
+      { message: json.message }
+    );
   }
   return json.data;
 }
@@ -1228,7 +1277,8 @@ var OwneySDK = class {
     });
     const walletAddress = accounts[0];
     if (!walletAddress) {
-      throw new Error(
+      throw new OwneyError(
+        "WALLET_NO_ACCOUNTS",
         "No accounts found. Ensure the wallet is unlocked and connected."
       );
     }
@@ -1267,7 +1317,8 @@ var OwneySDK = class {
   requireChainId() {
     const chainId = this.state?.chainId ?? null;
     if (chainId === null) {
-      throw new Error(
+      throw new OwneyError(
+        "NO_ACTIVE_CHAIN",
         "No active chain. Call sdk.activateAgent(chainId) first."
       );
     }
@@ -1303,7 +1354,8 @@ var OwneySDK = class {
           this.agents.set(agent_type, agent);
         }
         if (this.agents.size === 0) {
-          throw new Error(
+          throw new OwneyError(
+            "API_NO_AGENTS",
             "No supported agents returned by the routing API. Check your API key and routing configuration."
           );
         }
@@ -1332,7 +1384,8 @@ var OwneySDK = class {
     await this.ensureAgentsInitialized();
     if (agentId !== void 0) {
       if (agentId.length === 0) {
-        throw new Error(
+        throw new OwneyError(
+          "AGENT_EMPTY_LIST",
           "agentId array must not be empty. Omit the argument to activate all compatible agents."
         );
       }
@@ -1374,7 +1427,11 @@ var OwneySDK = class {
       (agent) => agent.supportedChainIds.includes(chainId)
     );
     if (compatible.length === 0) {
-      throw new Error(`No agents support chain ${chainId}.`);
+      throw new OwneyError(
+        "CHAIN_NO_COMPATIBLE_AGENTS",
+        `No agents support chain ${chainId}.`,
+        { chainId }
+      );
     }
     this.activeAgents.clear();
     for (const agent of compatible) {
@@ -1422,8 +1479,10 @@ var OwneySDK = class {
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
     const totalAmount = BigInt(amount);
     if (totalAmount < BigInt(eligibleAgents.length)) {
-      throw new Error(
-        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`
+      throw new OwneyError(
+        "DEPOSIT_AMOUNT_TOO_SMALL",
+        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`,
+        { amount, agentCount: eligibleAgents.length }
       );
     }
     const perAgent = totalAmount / BigInt(eligibleAgents.length);
@@ -1446,8 +1505,10 @@ var OwneySDK = class {
       (sa) => sa.chainId === chainId
     );
     if (!chainAssets || !chainAssets.assets.includes(asset)) {
-      throw new Error(
-        `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`
+      throw new OwneyError(
+        "ASSET_UNSUPPORTED",
+        `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`,
+        { agentId: agent.id, asset, chainId }
       );
     }
   }
@@ -1459,8 +1520,10 @@ var OwneySDK = class {
       return chainAssets && chainAssets.assets.includes(asset);
     });
     if (eligible.length === 0) {
-      throw new Error(
-        `No agents support asset "${asset}" on chain ${chainId}.`
+      throw new OwneyError(
+        "ASSET_NO_COMPATIBLE_AGENTS",
+        `No agents support asset "${asset}" on chain ${chainId}.`,
+        { asset, chainId }
       );
     }
     return eligible;
@@ -1485,10 +1548,25 @@ var OwneySDK = class {
       return agent.withdraw(state, chainId, amount);
     }
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
+    if (!amount) {
+      const results2 = {};
+      for (const agent of eligibleAgents) {
+        results2[agent.id] = await agent.withdraw(state, chainId);
+      }
+      return { agentResult: results2 };
+    }
     const results = {};
+    let lastError;
     for (const agent of eligibleAgents) {
-      results[agent.id] = await agent.withdraw(state, chainId, amount);
+      try {
+        results[agent.id] = await agent.withdraw(state, chainId, amount);
+        return { agentResult: results };
+      } catch (err) {
+        lastError = err;
+      }
     }
+    if (lastError)
+      throw lastError;
     return {
       agentResult: results
     };
@@ -1534,7 +1612,10 @@ var OwneySDK = class {
       console.error("getBalances agent failed:", settledResult.reason);
     }
     if (successCount === 0) {
-      throw new Error("Failed to fetch balances for all active agents.");
+      throw new OwneyError(
+        "BALANCE_ALL_FAILED",
+        "Failed to fetch balances for all active agents."
+      );
     }
     logTiming3("getBalances aggregate", startedAt, {
       chainId,
@@ -1776,7 +1857,10 @@ var OwneySDK = class {
       }
     }
     if (successCount === 0) {
-      throw new Error("Failed to fetch allocation: all agents failed.");
+      throw new OwneyError(
+        "ALLOCATION_ALL_FAILED",
+        "Failed to fetch allocation: all agents failed."
+      );
     }
     const allocation = {};
     if (totalBalance === 0) {
@@ -1805,5 +1889,6 @@ var OwneySDK = class {
   AgentChainIncompatibleError,
   AgentNotFoundError,
   NotConnectedError,
+  OwneyError,
   OwneySDK
 });

package/dist/index.d.cts

@@ -334,13 +334,19 @@ declare class OwneySDK {
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
 }
 
-declare class AgentNotFoundError extends Error {
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_TOO_SMALL" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+declare class OwneyError extends Error {
+    readonly code: OwneyErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: OwneyErrorCode, message: string, details?: Record<string, unknown>);
+}
+declare class AgentNotFoundError extends OwneyError {
     constructor(agentId: string, available: string[]);
 }
-declare class NotConnectedError extends Error {
+declare class NotConnectedError extends OwneyError {
     constructor();
 }
-declare class AgentChainIncompatibleError extends Error {
+declare class AgentChainIncompatibleError extends OwneyError {
     readonly incompatibleAgents: Array<{
         agentId: string;
         supportedChainIds: readonly number[];
@@ -352,4 +358,4 @@ declare class AgentChainIncompatibleError extends Error {
     }>, connectedChainId: number);
 }
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyMultiDepositResult, OwneyRouteResponse, OwneySDK, OwneySDKConfig, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyRouteResponse, OwneySDK, OwneySDKConfig, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };

package/dist/index.d.ts

@@ -334,13 +334,19 @@ declare class OwneySDK {
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
 }
 
-declare class AgentNotFoundError extends Error {
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_TOO_SMALL" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_SAIL_ERROR" | "API_SAIL_TIMEOUT" | "API_NO_AGENTS" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+declare class OwneyError extends Error {
+    readonly code: OwneyErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: OwneyErrorCode, message: string, details?: Record<string, unknown>);
+}
+declare class AgentNotFoundError extends OwneyError {
     constructor(agentId: string, available: string[]);
 }
-declare class NotConnectedError extends Error {
+declare class NotConnectedError extends OwneyError {
     constructor();
 }
-declare class AgentChainIncompatibleError extends Error {
+declare class AgentChainIncompatibleError extends OwneyError {
     readonly incompatibleAgents: Array<{
         agentId: string;
         supportedChainIds: readonly number[];
@@ -352,4 +358,4 @@ declare class AgentChainIncompatibleError extends Error {
     }>, connectedChainId: number);
 }
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyMultiDepositResult, OwneyRouteResponse, OwneySDK, OwneySDKConfig, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentId, AgentNotFoundError, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, NotConnectedError, OwneyAccountApy, OwneyAgentAllocation, OwneyAgentApy, OwneyAgentHistory, OwneyAgentStatus, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyRouteResponse, OwneySDK, OwneySDKConfig, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };

package/dist/index.js

@@ -26,11 +26,58 @@ var SupportedAssets = [
   }
 ];
 
+// src/errors.ts
+var OwneyError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "OwneyError";
+    this.code = code;
+    this.details = details;
+  }
+};
+var AgentNotFoundError = class extends OwneyError {
+  constructor(agentId, available) {
+    super(
+      "AGENT_NOT_FOUND",
+      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
+      { agentId, available }
+    );
+    this.name = "AgentNotFoundError";
+  }
+};
+var NotConnectedError = class extends OwneyError {
+  constructor() {
+    super("NOT_CONNECTED", "Not connected. Call sdk.connect(provider) first.");
+    this.name = "NotConnectedError";
+  }
+};
+var AgentChainIncompatibleError = class extends OwneyError {
+  incompatibleAgents;
+  connectedChainId;
+  constructor(incompatibleAgents, connectedChainId) {
+    const details = incompatibleAgents.map(
+      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
+    ).join("; ");
+    super(
+      "AGENT_CHAIN_INCOMPATIBLE",
+      `Chain ${connectedChainId} is not supported by the following agents: ${details}`,
+      { incompatibleAgents, connectedChainId }
+    );
+    this.name = "AgentChainIncompatibleError";
+    this.incompatibleAgents = incompatibleAgents;
+    this.connectedChainId = connectedChainId;
+  }
+};
+
 // src/lib/utils.ts
 var isValidChainId = (chainId) => {
   if (!SUPPORTED_CHAIN_IDS.includes(chainId)) {
-    throw new Error(
-      `Unsupported chain ID: ${chainId}. Supported chains: ${SUPPORTED_CHAIN_IDS.join(", ")}`
+    throw new OwneyError(
+      "CHAIN_UNSUPPORTED",
+      `Unsupported chain ID: ${chainId}. Supported chains: ${SUPPORTED_CHAIN_IDS.join(", ")}`,
+      { chainId, supportedChainIds: [...SUPPORTED_CHAIN_IDS] }
     );
   }
   return chainId;
@@ -45,6 +92,15 @@ function hexToDecimal(hex, decimals = 6) {
   const remainder = parsed % divisor;
   return Number(whole) + Number(remainder) / Number(divisor);
 }
+function normalizeDecimalPlace(value, decimals = 6) {
+  const parsed = BigInt(value);
+  if (decimals <= 0)
+    return Number(parsed);
+  const divisor = BigInt(10 ** decimals);
+  const whole = parsed / divisor;
+  const remainder = parsed % divisor;
+  return Number(whole) + Number(remainder) / Number(divisor);
+}
 var DayFilterMapping = {
   "30D": 30,
   "14D": 14,
@@ -74,7 +130,7 @@ var CHAIN_NAME_TO_ID = {
   BASE: 8453,
   ARBITRUM: 42161
 };
-function mapBalances(raw, chainId) {
+function mapBalances(raw, chainId, smartWallet) {
   const portfolio = raw.portfolio;
   const tokenMap = /* @__PURE__ */ new Map();
   for (const p of portfolio.positions || []) {
@@ -85,18 +141,7 @@ function mapBalances(raw, chainId) {
     tokenMap.set(key, {
       symbol,
       chainId: positionChainId,
-      amount: (current?.amount ?? 0) + hexToDecimal(p.amount || "0")
-    });
-  }
-  for (const s of portfolio.staleBalances || []) {
-    const symbol = s.tokenSymbol || "USDC";
-    const staleChainId = s.chainId ?? chainId;
-    const key = `${symbol}:${staleChainId}`;
-    const current = tokenMap.get(key);
-    tokenMap.set(key, {
-      symbol,
-      chainId: staleChainId,
-      amount: (current?.amount ?? 0) + hexToDecimal(s.balance || "0")
+      amount: (current?.amount ?? 0) + normalizeDecimalPlace(p.underlyingAmount || "0")
     });
   }
   let totalBalance = 0;
@@ -111,7 +156,7 @@ function mapBalances(raw, chainId) {
     });
   }
   return {
-    smartWallet: portfolio.smartWallet,
+    smartWallet,
     totalBalance: String(totalBalance),
     tokens
   };
@@ -263,7 +308,10 @@ var ZyfaiAgent = class {
   // --- Private helpers ---
   getAddress() {
     if (!this.connectedAddress) {
-      throw new Error("Wallet not connected. Call sdk.connect() first.");
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "Wallet not connected. Call sdk.connect() first."
+      );
     }
     return this.connectedAddress;
   }
@@ -415,15 +463,14 @@ var ZyfaiAgent = class {
   // --- IAgent: Portfolio reads ---
   async getBalances(state, chainId) {
     const startedAt = Date.now();
-    await this.connectAuth(state, chainId);
-    const validChainId = isValidChainId(chainId);
-    const positionsStart = Date.now();
-    const raw = await this.sdk.getPositions(this.getAddress(), validChainId);
-    logTiming("getBalances getPositions", positionsStart, {
+    const { smartWallet, chainId: validChainId } = await this.resolveSmartWallet(state, chainId);
+    const portfolioStart = Date.now();
+    const raw = await this.sdk.getPortfolio(this.getAddress());
+    logTiming("getBalances getPortfolio", portfolioStart, {
       chainId: validChainId
     });
     logTiming("getBalances success", startedAt, { chainId: validChainId });
-    return mapBalances(raw, validChainId);
+    return mapBalances(raw, validChainId, smartWallet);
   }
   async getEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
@@ -735,7 +782,11 @@ var SailAgent = class {
       });
     } catch (error) {
       if (error instanceof Error && error.name === "AbortError" && timeoutMs) {
-        throw new Error(`Sail API timeout ${timeoutMs}ms: ${method} ${path}`);
+        throw new OwneyError(
+          "API_SAIL_TIMEOUT",
+          `Sail API timeout ${timeoutMs}ms: ${method} ${path}`,
+          { timeoutMs, method, path }
+        );
       }
       throw error;
     } finally {
@@ -744,7 +795,11 @@ var SailAgent = class {
     }
     if (!res.ok) {
       const text = await res.text().catch(() => "");
-      throw new Error(`Sail API error ${res.status}: ${text}`);
+      throw new OwneyError(
+        "API_SAIL_ERROR",
+        `Sail API error ${res.status}: ${text}`,
+        { statusCode: res.status, method, path, responseBody: text }
+      );
     }
     return res.json();
   }
@@ -785,7 +840,10 @@ var SailAgent = class {
       return;
     }
     if (!state.walletAddress) {
-      throw new Error("Wallet address is required");
+      throw new OwneyError(
+        "WALLET_ADDRESS_REQUIRED",
+        "Wallet address is required. Call sdk.connect(provider) first."
+      );
     }
     this.connectPromise = (async () => {
       const { sessionId, signature, message } = await this.signSiwe(
@@ -821,7 +879,10 @@ var SailAgent = class {
     await this.connectFull(state, chainId);
     const validChainId = isValidChainId(chainId);
     if (!this.smartWalletAddress) {
-      throw new Error("Wallet not connected. Call sdk.connect() first.");
+      throw new OwneyError(
+        "NOT_CONNECTED",
+        "Wallet not connected. Call sdk.connect() first."
+      );
     }
     logTiming2("resolveSmartWallet ready", startedAt, { chainId: validChainId });
     return {
@@ -848,7 +909,8 @@ var SailAgent = class {
   }
   async deposit(state, chainId, amount, depositCallback) {
     if (!depositCallback) {
-      throw new Error(
+      throw new OwneyError(
+        "DEPOSIT_CALLBACK_REQUIRED",
         "depositCallback is required for Sail. Provide a callback that transfers tokens and returns the transaction hash."
       );
     }
@@ -857,12 +919,16 @@ var SailAgent = class {
       const depositInfo = await this.getDepositInfo();
       const resolvedTokenAddress = depositInfo.permittedTokens[0]?.address;
       if (!resolvedTokenAddress) {
-        throw new Error("No permitted tokens available for deposit.");
+        throw new OwneyError(
+          "DEPOSIT_NO_PERMITTED_TOKENS",
+          "No permitted tokens available for deposit."
+        );
       }
       await this.executePreHooks(resolvedTokenAddress, amount, chainId);
       const txHash = await depositCallback(smartWallet, chainId, amount);
       if (!txHash) {
-        throw new Error(
+        throw new OwneyError(
+          "DEPOSIT_CALLBACK_INVALID",
           "depositCallback must return a transaction hash (txHash) for Sail deposits."
         );
       }
@@ -916,7 +982,10 @@ var SailAgent = class {
     const withdrawInfo = await this.getWithdrawInfo();
     const tokenAddress = withdrawInfo.permittedTokens[0]?.address;
     if (!tokenAddress) {
-      throw new Error("No permitted tokens available for withdrawal.");
+      throw new OwneyError(
+        "WITHDRAW_NO_PERMITTED_TOKENS",
+        "No permitted tokens available for withdrawal."
+      );
     }
     const resolvedAmount = amount ?? withdrawInfo.currentBalance;
     const { signature: adminWalletSignature, message: adminWalletPayload } = await this.signSiwe(state, chainId);
@@ -949,7 +1018,7 @@ var SailAgent = class {
       logTiming2("getBalances success", startedAt, { chainId });
       return mapPortfolioBalances(raw, smartWallet);
     } catch (error) {
-      if (error instanceof Error && error.message.startsWith("Sail API timeout")) {
+      if (error instanceof OwneyError && error.code === "API_SAIL_TIMEOUT") {
         console.warn(
           "Sail portfolio request timed out; using empty snapshot.",
           {
@@ -1033,8 +1102,10 @@ var SailAgent = class {
     }
     const dayCount = DayFilterMapping[days];
     if (dayCount === void 0) {
-      throw new Error(
-        `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`
+      throw new OwneyError(
+        "VALIDATION_INVALID_DAYS",
+        `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`,
+        { days }
       );
     }
     const now = /* @__PURE__ */ new Date();
@@ -1111,37 +1182,6 @@ var SailAgent = class {
   }
 };
 
-// src/errors.ts
-var AgentNotFoundError = class extends Error {
-  constructor(agentId, available) {
-    super(
-      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`
-    );
-    this.name = "AgentNotFoundError";
-  }
-};
-var NotConnectedError = class extends Error {
-  constructor() {
-    super("Not connected. Call sdk.connect(provider) first.");
-    this.name = "NotConnectedError";
-  }
-};
-var AgentChainIncompatibleError = class extends Error {
-  incompatibleAgents;
-  connectedChainId;
-  constructor(incompatibleAgents, connectedChainId) {
-    const details = incompatibleAgents.map(
-      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
-    ).join("; ");
-    super(
-      `Chain ${connectedChainId} is not supported by the following agents: ${details}`
-    );
-    this.name = "AgentChainIncompatibleError";
-    this.incompatibleAgents = incompatibleAgents;
-    this.connectedChainId = connectedChainId;
-  }
-};
-
 // src/lib/routing-api.ts
 var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
 async function fetchAgentKeys(apiKey) {
@@ -1155,11 +1195,19 @@ async function fetchAgentKeys(apiKey) {
   });
   if (!res.ok) {
     const text = await res.text().catch(() => "");
-    throw new Error(`Routing API error ${res.status}: ${text}`);
+    throw new OwneyError(
+      "API_ROUTING_ERROR",
+      `Routing API error ${res.status}: ${text}`,
+      { statusCode: res.status, responseBody: text }
+    );
   }
   const json = await res.json();
   if (!json.success) {
-    throw new Error(`Routing API request failed: ${json.message}`);
+    throw new OwneyError(
+      "API_ROUTING_FAILED",
+      `Routing API request failed: ${json.message}`,
+      { message: json.message }
+    );
   }
   return json.data;
 }
@@ -1199,7 +1247,8 @@ var OwneySDK = class {
     });
     const walletAddress = accounts[0];
     if (!walletAddress) {
-      throw new Error(
+      throw new OwneyError(
+        "WALLET_NO_ACCOUNTS",
         "No accounts found. Ensure the wallet is unlocked and connected."
       );
     }
@@ -1238,7 +1287,8 @@ var OwneySDK = class {
   requireChainId() {
     const chainId = this.state?.chainId ?? null;
     if (chainId === null) {
-      throw new Error(
+      throw new OwneyError(
+        "NO_ACTIVE_CHAIN",
         "No active chain. Call sdk.activateAgent(chainId) first."
       );
     }
@@ -1274,7 +1324,8 @@ var OwneySDK = class {
           this.agents.set(agent_type, agent);
         }
         if (this.agents.size === 0) {
-          throw new Error(
+          throw new OwneyError(
+            "API_NO_AGENTS",
             "No supported agents returned by the routing API. Check your API key and routing configuration."
           );
         }
@@ -1303,7 +1354,8 @@ var OwneySDK = class {
     await this.ensureAgentsInitialized();
     if (agentId !== void 0) {
       if (agentId.length === 0) {
-        throw new Error(
+        throw new OwneyError(
+          "AGENT_EMPTY_LIST",
           "agentId array must not be empty. Omit the argument to activate all compatible agents."
         );
       }
@@ -1345,7 +1397,11 @@ var OwneySDK = class {
       (agent) => agent.supportedChainIds.includes(chainId)
     );
     if (compatible.length === 0) {
-      throw new Error(`No agents support chain ${chainId}.`);
+      throw new OwneyError(
+        "CHAIN_NO_COMPATIBLE_AGENTS",
+        `No agents support chain ${chainId}.`,
+        { chainId }
+      );
     }
     this.activeAgents.clear();
     for (const agent of compatible) {
@@ -1393,8 +1449,10 @@ var OwneySDK = class {
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
     const totalAmount = BigInt(amount);
     if (totalAmount < BigInt(eligibleAgents.length)) {
-      throw new Error(
-        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`
+      throw new OwneyError(
+        "DEPOSIT_AMOUNT_TOO_SMALL",
+        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`,
+        { amount, agentCount: eligibleAgents.length }
       );
     }
     const perAgent = totalAmount / BigInt(eligibleAgents.length);
@@ -1417,8 +1475,10 @@ var OwneySDK = class {
       (sa) => sa.chainId === chainId
     );
     if (!chainAssets || !chainAssets.assets.includes(asset)) {
-      throw new Error(
-        `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`
+      throw new OwneyError(
+        "ASSET_UNSUPPORTED",
+        `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`,
+        { agentId: agent.id, asset, chainId }
       );
     }
   }
@@ -1430,8 +1490,10 @@ var OwneySDK = class {
       return chainAssets && chainAssets.assets.includes(asset);
     });
     if (eligible.length === 0) {
-      throw new Error(
-        `No agents support asset "${asset}" on chain ${chainId}.`
+      throw new OwneyError(
+        "ASSET_NO_COMPATIBLE_AGENTS",
+        `No agents support asset "${asset}" on chain ${chainId}.`,
+        { asset, chainId }
       );
     }
     return eligible;
@@ -1456,10 +1518,25 @@ var OwneySDK = class {
       return agent.withdraw(state, chainId, amount);
     }
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
+    if (!amount) {
+      const results2 = {};
+      for (const agent of eligibleAgents) {
+        results2[agent.id] = await agent.withdraw(state, chainId);
+      }
+      return { agentResult: results2 };
+    }
     const results = {};
+    let lastError;
     for (const agent of eligibleAgents) {
-      results[agent.id] = await agent.withdraw(state, chainId, amount);
+      try {
+        results[agent.id] = await agent.withdraw(state, chainId, amount);
+        return { agentResult: results };
+      } catch (err) {
+        lastError = err;
+      }
     }
+    if (lastError)
+      throw lastError;
     return {
       agentResult: results
     };
@@ -1505,7 +1582,10 @@ var OwneySDK = class {
       console.error("getBalances agent failed:", settledResult.reason);
     }
     if (successCount === 0) {
-      throw new Error("Failed to fetch balances for all active agents.");
+      throw new OwneyError(
+        "BALANCE_ALL_FAILED",
+        "Failed to fetch balances for all active agents."
+      );
     }
     logTiming3("getBalances aggregate", startedAt, {
       chainId,
@@ -1747,7 +1827,10 @@ var OwneySDK = class {
       }
     }
     if (successCount === 0) {
-      throw new Error("Failed to fetch allocation: all agents failed.");
+      throw new OwneyError(
+        "ALLOCATION_ALL_FAILED",
+        "Failed to fetch allocation: all agents failed."
+      );
     }
     const allocation = {};
     if (totalBalance === 0) {
@@ -1775,5 +1858,6 @@ export {
   AgentChainIncompatibleError,
   AgentNotFoundError,
   NotConnectedError,
+  OwneyError,
   OwneySDK
 };

package/package.json

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