@owney/sdk 0.2.8 → 0.2.10

package/dist/index.d.ts

@@ -24,10 +24,11 @@ interface IAgent {
     readonly id: string;
     readonly supportedChainIds: readonly OwneySupportedChainId[];
     readonly supportedAssets: readonly AgentSupportedAssets[];
+    readonly minDepositAmount: string;
     disconnect(): Promise<void>;
     activateAgent(state: ConnectionState, chainId: number): Promise<void>;
     deposit(state: ConnectionState, chainId: number, amount: string, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, amount?: string): Promise<AgentWithdrawResult>;
+    withdraw(state: ConnectionState, chainId: number, token: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
     getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays): Promise<AccountAgentApy>;
@@ -196,10 +197,6 @@ interface AgentApy {
 interface OwneyAgentApy {
     agentApy: Record<AgentId, AgentApy>;
 }
-interface OwneyRouteResponse {
-    agent: AgentId;
-    chainId: number;
-}
 interface OwneyAgentAllocation {
     agentAllocation: Record<AgentId, number>;
 }
@@ -252,7 +249,7 @@ declare class OwneySDK {
     activateAgent(chainId: number, agentId?: AgentId[]): Promise<void>;
     /**
      * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
-     * Validates that the asset is supported by the target agent(s) on the active chain.
+      * Validates that the asset is supported and amount meets minimums for the target agent(s).
      * @param options - Deposit parameters
      * @param options.amount - Amount to deposit in smallest unit (e.g. "100000000" for 100 USDC)
      * @param options.asset - Asset symbol to deposit (e.g. "USDC")
@@ -263,6 +260,8 @@ declare class OwneySDK {
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
      */
     deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
+    private splitDepositAmount;
+    private validateMinDepositAmount;
     private validateAssetSupport;
     private getEligibleAgents;
     /**
@@ -342,11 +341,12 @@ declare class OwneySDK {
     getAgentAllocation(): Promise<OwneyAgentAllocation>;
 }
 
-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";
+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_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "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>);
+    readonly agentId?: string;
+    constructor(code: OwneyErrorCode, message: string, details?: Record<string, unknown>, agentId?: string);
 }
 declare class AgentNotFoundError extends OwneyError {
     constructor(agentId: string, available: string[]);
@@ -366,4 +366,4 @@ declare class AgentChainIncompatibleError extends OwneyError {
     }>, 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, OwneyError, OwneyErrorCode, 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, OwneySDK, OwneySDKConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions };

package/dist/index.js

@@ -12,17 +12,20 @@ var SupportedAssets = [
   {
     address: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`,
     symbol: "USDC",
-    chainId: 8453
+    chainId: 8453,
+    decimals: 6
   },
   {
     address: `0xaf88d065e77c8cC2239327C5EDb3A432268e5831`,
     symbol: "USDC",
-    chainId: 42161
+    chainId: 42161,
+    decimals: 6
   },
   {
     address: `0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9`,
     symbol: "USDT",
-    chainId: 42161
+    chainId: 42161,
+    decimals: 6
   }
 ];
 
@@ -30,11 +33,13 @@ var SupportedAssets = [
 var OwneyError = class extends Error {
   code;
   details;
-  constructor(code, message, details) {
-    super(message);
+  agentId;
+  constructor(code, message, details, agentId) {
+    super(agentId ? `[agent:${agentId}] ${message}` : message);
     this.name = "OwneyError";
     this.code = code;
     this.details = details;
+    this.agentId = agentId;
   }
 };
 var AgentNotFoundError = class extends OwneyError {
@@ -42,7 +47,8 @@ var AgentNotFoundError = class extends OwneyError {
     super(
       "AGENT_NOT_FOUND",
       `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
-      { agentId, available }
+      { agentId, available },
+      agentId
     );
     this.name = "AgentNotFoundError";
   }
@@ -273,8 +279,13 @@ function mapApyByStrategy(raw) {
 }
 
 // src/agents/zyfai/zyfai.agent.ts
+var DEFAULT_ZYFAI_RPC_URLS = {
+  8453: "https://base-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
+  42161: "https://arb-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V"
+};
 var ZyfaiAgent = class {
   id = "zyfai";
+  minDepositAmount = "0";
   supportedChainIds = [8453, 42161];
   supportedAssets = [
     {
@@ -294,14 +305,19 @@ var ZyfaiAgent = class {
   smartWalletCache = /* @__PURE__ */ new Map();
   connectAuthPromise = null;
   constructor(apiKey, rpcUrls) {
-    this.sdk = new ZyfaiSDK({ apiKey, rpcUrls });
+    this.sdk = new ZyfaiSDK({
+      apiKey,
+      rpcUrls: rpcUrls ?? DEFAULT_ZYFAI_RPC_URLS
+    });
   }
   // --- Private helpers ---
   getAddress() {
     if (!this.connectedAddress) {
       throw new OwneyError(
         "NOT_CONNECTED",
-        "Wallet not connected. Call sdk.connect() first."
+        "Wallet not connected. Call sdk.connect() first.",
+        void 0,
+        this.id
       );
     }
     return this.connectedAddress;
@@ -407,13 +423,14 @@ var ZyfaiAgent = class {
     }
   }
   // --- IAgent: Fund operations ---
-  async withdraw(state, chainId, amount) {
+  async withdraw(state, chainId, token, amount) {
     await this.connectFull(state, chainId);
     const validChainId = isValidChainId(chainId);
     const raw = await this.sdk.withdrawFunds(
       this.getAddress(),
       validChainId,
-      amount
+      amount,
+      token
     );
     return mapWithdraw(raw);
   }
@@ -610,7 +627,7 @@ function mapHistory2(raw) {
     rewards: "Earned"
   };
   const filtered = raw.result.items.filter(
-    (i) => i.status === "success" && i.transactions.length
+    (i) => !(i.type === "execution" && (i.status === "failed" || !i.transactions.length))
   );
   return {
     total: filtered.length,
@@ -671,12 +688,14 @@ function remapApyPerAssetToSymbols(raw) {
 }
 
 // src/agents/sail/sail.agent.ts
+import { parseUnits } from "viem";
 var SAIL_API_BASE = "https://app.sail.money";
 var PROJECT_ID = "sail";
 var PAGE_ID = "home";
 var SAIL_PORTFOLIO_TIMEOUT_MS = 8e3;
 var SailAgent = class {
   id = "sail";
+  minDepositAmount = "4800000000";
   supportedChainIds = [8453, 42161];
   supportedAssets = [
     {
@@ -727,7 +746,8 @@ var SailAgent = class {
         throw new OwneyError(
           "API_SAIL_TIMEOUT",
           `Sail API timeout ${timeoutMs}ms: ${method} ${path}`,
-          { timeoutMs, method, path }
+          { timeoutMs, method, path },
+          this.id
         );
       }
       throw error;
@@ -740,7 +760,8 @@ var SailAgent = class {
       throw new OwneyError(
         "API_SAIL_ERROR",
         `Sail API error ${res.status}: ${text}`,
-        { statusCode: res.status, method, path, responseBody: text }
+        { statusCode: res.status, method, path, responseBody: text },
+        this.id
       );
     }
     return res.json();
@@ -779,7 +800,9 @@ var SailAgent = class {
     if (!state.walletAddress) {
       throw new OwneyError(
         "WALLET_ADDRESS_REQUIRED",
-        "Wallet address is required. Call sdk.connect(provider) first."
+        "Wallet address is required. Call sdk.connect(provider) first.",
+        void 0,
+        this.id
       );
     }
     this.connectPromise = (async () => {
@@ -816,7 +839,9 @@ var SailAgent = class {
     if (!this.smartWalletAddress) {
       throw new OwneyError(
         "NOT_CONNECTED",
-        "Wallet not connected. Call sdk.connect() first."
+        "Wallet not connected. Call sdk.connect() first.",
+        void 0,
+        this.id
       );
     }
     return {
@@ -845,7 +870,9 @@ var SailAgent = class {
     if (!depositCallback) {
       throw new OwneyError(
         "DEPOSIT_CALLBACK_REQUIRED",
-        "depositCallback is required for Sail. Provide a callback that transfers tokens and returns the transaction hash."
+        "depositCallback is required for Sail. Provide a callback that transfers tokens and returns the transaction hash.",
+        void 0,
+        this.id
       );
     }
     try {
@@ -855,7 +882,9 @@ var SailAgent = class {
       if (!resolvedTokenAddress) {
         throw new OwneyError(
           "DEPOSIT_NO_PERMITTED_TOKENS",
-          "No permitted tokens available for deposit."
+          "No permitted tokens available for deposit.",
+          void 0,
+          this.id
         );
       }
       await this.executePreHooks(resolvedTokenAddress, amount, chainId);
@@ -863,7 +892,9 @@ var SailAgent = class {
       if (!txHash) {
         throw new OwneyError(
           "DEPOSIT_CALLBACK_INVALID",
-          "depositCallback must return a transaction hash (txHash) for Sail deposits."
+          "depositCallback must return a transaction hash (txHash) for Sail deposits.",
+          void 0,
+          this.id
         );
       }
       const postResult = await this.executePostHooks(
@@ -911,14 +942,29 @@ var SailAgent = class {
     );
   }
   // --- IAgent: Fund operations ---
-  async withdraw(state, chainId, amount) {
+  async withdraw(state, chainId, token, amount) {
     await this.connectFull(state, chainId);
     const withdrawInfo = await this.getWithdrawInfo();
-    const tokenAddress = withdrawInfo.permittedTokens[0]?.address;
+    const selectedTokenAddress = SupportedAssets.find(
+      (a) => a.symbol === token && a.chainId === chainId
+    );
+    if (!selectedTokenAddress) {
+      throw new OwneyError(
+        "WITHDRAW_NO_PERMITTED_TOKENS",
+        "Unsupported asset.",
+        void 0,
+        this.id
+      );
+    }
+    const tokenAddress = withdrawInfo.permittedTokens.find(
+      (t) => t.address === selectedTokenAddress.address
+    )?.address;
     if (!tokenAddress) {
       throw new OwneyError(
         "WITHDRAW_NO_PERMITTED_TOKENS",
-        "No permitted tokens available for withdrawal."
+        "No permitted tokens available for withdrawal.",
+        void 0,
+        this.id
       );
     }
     const resolvedAmount = amount ?? withdrawInfo.currentBalance;
@@ -938,7 +984,10 @@ var SailAgent = class {
     return mapWithdraw2({
       txHash: raw.transactionHash,
       type: amount ? "partial" : "full",
-      amount: resolvedAmount
+      amount: parseUnits(
+        resolvedAmount,
+        selectedTokenAddress.decimals
+      ).toString()
     });
   }
   // --- IAgent: Portfolio reads ---
@@ -1042,7 +1091,8 @@ var SailAgent = class {
       throw new OwneyError(
         "VALIDATION_INVALID_DAYS",
         `Invalid days value: "${days}". Expected one of: "7D", "14D", "30D".`,
-        { days }
+        { days },
+        this.id
       );
     }
     const now = /* @__PURE__ */ new Date();
@@ -1149,7 +1199,65 @@ async function fetchAgentKeys(apiKey) {
   return json.data;
 }
 
+// src/lib/helpers/withdraw-helper.ts
+function planProportionalShares(balances, requested, totalAvailable) {
+  const plans = balances.map(({ agent, balance }) => ({
+    agent,
+    balance,
+    planned: totalAvailable > 0n ? balance * requested / totalAvailable : 0n
+  }));
+  const assigned = plans.reduce((s, p) => s + p.planned, 0n);
+  let remainder = requested - assigned;
+  const byHeadroom = [...plans].sort((a, b) => {
+    const diff = b.balance - b.planned - (a.balance - a.planned);
+    return diff > 0n ? 1 : diff < 0n ? -1 : 0;
+  });
+  for (const p of byHeadroom) {
+    if (remainder === 0n)
+      break;
+    const headroom = p.balance - p.planned;
+    if (headroom <= 0n)
+      continue;
+    const take = headroom < remainder ? headroom : remainder;
+    p.planned += take;
+    remainder -= take;
+  }
+  return plans;
+}
+function redistributeShare(plans, fromIndex, amount) {
+  const candidates = plans.slice(fromIndex + 1).filter((c) => c.balance - c.planned > 0n);
+  const totalHeadroom = candidates.reduce(
+    (s, c) => s + (c.balance - c.planned),
+    0n
+  );
+  if (totalHeadroom === 0n)
+    return;
+  let distributed = 0n;
+  for (const c of candidates) {
+    const headroom = c.balance - c.planned;
+    const proportional = headroom * amount / totalHeadroom;
+    const give = proportional > headroom ? headroom : proportional;
+    c.planned += give;
+    distributed += give;
+  }
+  let leftover = amount - distributed;
+  for (const c of candidates) {
+    if (leftover === 0n)
+      break;
+    const headroom = c.balance - c.planned;
+    if (headroom <= 0n)
+      continue;
+    const take = headroom < leftover ? headroom : leftover;
+    c.planned += take;
+    leftover -= take;
+  }
+}
+function sumWithdrawnAmount(results) {
+  return Object.values(results).reduce((sum, r) => sum + BigInt(r.amount), 0n);
+}
+
 // src/client.ts
+import { formatUnits, parseUnits as parseUnits2 } from "viem";
 var OwneySDK = class {
   agents = /* @__PURE__ */ new Map();
   activeAgents = /* @__PURE__ */ new Set();
@@ -1342,7 +1450,7 @@ var OwneySDK = class {
   }
   /**
    * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
-   * Validates that the asset is supported by the target agent(s) on the active chain.
+    * Validates that the asset is supported and amount meets minimums for the target agent(s).
    * @param options - Deposit parameters
    * @param options.amount - Amount to deposit in smallest unit (e.g. "100000000" for 100 USDC)
    * @param options.asset - Asset symbol to deposit (e.g. "USDC")
@@ -1354,28 +1462,29 @@ var OwneySDK = class {
    */
   async deposit(options) {
     const { amount, asset, depositCallback, agentId } = options;
+    if (BigInt(amount) === 0n) {
+      return { agentResults: {} };
+    }
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
       const agent = this.getAgent(agentId);
       this.validateAssetSupport(agent, chainId, asset);
+      this.validateMinDepositAmount(agent, amount);
       return agent.deposit(state, chainId, amount, depositCallback);
     }
-    const eligibleAgents = this.getEligibleAgents(chainId, asset);
     const totalAmount = BigInt(amount);
-    if (totalAmount < BigInt(eligibleAgents.length)) {
+    const eligibleAgents = this.getEligibleAgents(chainId, asset);
+    const agentAmounts = this.splitDepositAmount(totalAmount, eligibleAgents);
+    if (agentAmounts.length === 0) {
       throw new OwneyError(
-        "DEPOSIT_AMOUNT_TOO_SMALL",
-        `Amount "${amount}" is too small to split across ${eligibleAgents.length} agents.`,
-        { amount, agentCount: eligibleAgents.length }
+        "DEPOSIT_AMOUNT_BELOW_MINIMUM",
+        `Amount "${amount}" cannot satisfy minimum deposit requirements for any eligible agent.`,
+        { amount }
       );
     }
-    const perAgent = totalAmount / BigInt(eligibleAgents.length);
-    const remainder = totalAmount % BigInt(eligibleAgents.length);
     const agentResults = {};
-    for (let i = 0; i < eligibleAgents.length; i++) {
-      const agent = eligibleAgents[i];
-      const agentAmount = i === eligibleAgents.length - 1 ? String(perAgent + remainder) : String(perAgent);
+    for (const { agent, amount: agentAmount } of agentAmounts) {
       agentResults[agent.id] = await agent.deposit(
         state,
         chainId,
@@ -1385,6 +1494,37 @@ var OwneySDK = class {
     }
     return { agentResults };
   }
+  splitDepositAmount(totalAmount, agents) {
+    if (agents.length === 0)
+      return [];
+    const perAgent = totalAmount / BigInt(agents.length);
+    const remainder = totalAmount % BigInt(agents.length);
+    const splits = agents.map((agent, i) => ({
+      agent,
+      amount: i === agents.length - 1 ? perAgent + remainder : perAgent
+    }));
+    const valid = splits.filter(
+      (s) => s.amount >= BigInt(s.agent.minDepositAmount)
+    );
+    if (valid.length === agents.length) {
+      return splits.map((s) => ({ agent: s.agent, amount: String(s.amount) }));
+    }
+    return this.splitDepositAmount(totalAmount, valid.map((s) => s.agent));
+  }
+  validateMinDepositAmount(agent, amount) {
+    const minDepositAmount = BigInt(agent.minDepositAmount);
+    const parsedAmount = BigInt(amount);
+    if (parsedAmount < minDepositAmount) {
+      throw new OwneyError(
+        "DEPOSIT_AMOUNT_BELOW_MINIMUM",
+        `Amount "${amount}" is below the required minimum deposit for agent "${agent.id}".`,
+        {
+          agentId: agent.id,
+          amount
+        }
+      );
+    }
+  }
   validateAssetSupport(agent, chainId, asset) {
     const chainAssets = agent.supportedAssets.find(
       (sa) => sa.chainId === chainId
@@ -1393,7 +1533,8 @@ var OwneySDK = class {
       throw new OwneyError(
         "ASSET_UNSUPPORTED",
         `Agent "${agent.id}" does not support asset "${asset}" on chain ${chainId}.`,
-        { agentId: agent.id, asset, chainId }
+        { agentId: agent.id, asset, chainId },
+        agent.id
       );
     }
   }
@@ -1427,34 +1568,99 @@ var OwneySDK = class {
     const { asset, amount, agentId } = options;
     const state = this.requireState();
     const chainId = this.requireChainId();
+    const token = asset;
+    const assetInfo = SupportedAssets.find(
+      (a) => a.chainId === chainId && a.symbol === token
+    );
+    if (!assetInfo) {
+      throw new OwneyError(
+        "WITHDRAW_NO_PERMITTED_TOKENS",
+        "Asset selected is not supported"
+      );
+    }
     if (agentId) {
       const agent = this.getAgent(agentId);
       this.validateAssetSupport(agent, chainId, asset);
-      return agent.withdraw(state, chainId, amount);
+      return agent.withdraw(state, chainId, token, amount);
     }
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
     if (!amount) {
       const results2 = {};
       for (const agent of eligibleAgents) {
-        results2[agent.id] = await agent.withdraw(state, chainId);
+        results2[agent.id] = await agent.withdraw(state, chainId, token);
       }
       return { agentResult: results2 };
     }
+    const requested = BigInt(amount);
+    const aggregated = await this.getBalances();
+    const balances = eligibleAgents.map((agent) => {
+      const agentBalance = aggregated.agentBalances[agent.id];
+      const tokenBalance = agentBalance?.tokens.find(
+        (t) => t.chainId === chainId && t.asset === asset
+      );
+      if (!tokenBalance)
+        return { agent, balance: 0n };
+      const balance = parseUnits2(tokenBalance.amount, assetInfo.decimals);
+      return { agent, balance };
+    });
+    const totalAvailable = balances.reduce((sum, x) => sum + x.balance, 0n);
+    if (totalAvailable < requested) {
+      throw new OwneyError(
+        "WITHDRAW_INSUFFICIENT_BALANCE",
+        `Requested withdrawal "${amount}" exceeds available balance "${totalAvailable.toString()}" for asset "${asset}".`,
+        {
+          asset,
+          requested: amount,
+          available: totalAvailable.toString()
+        }
+      );
+    }
+    const plans = planProportionalShares(balances, requested, totalAvailable);
     const results = {};
-    let lastError;
-    for (const agent of eligibleAgents) {
+    const agentErrors = {};
+    for (let i = 0; i < plans.length; i++) {
+      const p = plans[i];
+      if (p.planned === 0n)
+        continue;
       try {
-        results[agent.id] = await agent.withdraw(state, chainId, amount);
-        return { agentResult: results };
+        results[p.agent.id] = await p.agent.withdraw(
+          state,
+          chainId,
+          token,
+          p.agent.id === "sail" ? formatUnits(p.planned, assetInfo.decimals) : p.planned.toString()
+        );
       } catch (err) {
-        lastError = err;
+        console.error(`withdraw failed for agent "${p.agent.id}":`, err);
+        agentErrors[p.agent.id] = err instanceof Error ? err.message : String(err);
+        redistributeShare(plans, i, p.planned);
       }
     }
-    if (lastError)
-      throw lastError;
-    return {
-      agentResult: results
-    };
+    if (Object.keys(results).length === 0) {
+      throw new OwneyError(
+        "WITHDRAW_ALL_FAILED",
+        `Failed to withdraw "${amount}" of "${asset}" from all eligible agents.`,
+        {
+          asset,
+          amount,
+          agentErrors
+        }
+      );
+    }
+    const withdrawn = sumWithdrawnAmount(results);
+    if (withdrawn < requested) {
+      throw new OwneyError(
+        "WITHDRAW_PARTIAL_FAILURE",
+        `Withdrew "${withdrawn.toString()}" of requested "${amount}" of "${asset}". One or more agents failed; remaining balance could not cover the shortfall.`,
+        {
+          asset,
+          requested: amount,
+          withdrawn: withdrawn.toString(),
+          partialResults: results,
+          agentErrors
+        }
+      );
+    }
+    return { agentResult: results };
   }
   // --- Portfolio reads ---
   /**
@@ -1479,7 +1685,10 @@ var OwneySDK = class {
       })
     );
     let successCount = 0;
-    for (const settledResult of balanceResults) {
+    const agentErrors = {};
+    for (let i = 0; i < balanceResults.length; i++) {
+      const settledResult = balanceResults[i];
+      const [agentId2] = entries[i];
       if (settledResult.status === "fulfilled") {
         const [id, b] = settledResult.value;
         results[id] = b;
@@ -1487,12 +1696,14 @@ var OwneySDK = class {
         successCount += 1;
         continue;
       }
-      console.error("getBalances agent failed:", settledResult.reason);
+      const reason = settledResult.reason;
+      agentErrors[agentId2] = reason instanceof Error ? reason.message : String(reason);
     }
     if (successCount === 0) {
       throw new OwneyError(
         "BALANCE_ALL_FAILED",
-        "Failed to fetch balances for all active agents."
+        "Failed to fetch balances for all active agents.",
+        { agentErrors }
       );
     }
     return {
@@ -1567,16 +1778,24 @@ var OwneySDK = class {
       results[id] = apy;
     }
     const balances = {};
-    let totalBalance = 0;
     for (const [id, bal] of balanceResults) {
       balances[id] = bal;
-      totalBalance += bal;
     }
     let totalApy = 0;
-    if (totalBalance > 0) {
+    let relevantBalance = 0;
+    for (const id of Object.keys(results)) {
+      const agentApy = Number(results[id].weightedApyAfterFee ?? 0);
+      if (agentApy === 0)
+        continue;
+      relevantBalance += balances[id];
+    }
+    if (relevantBalance > 0) {
       for (const id of Object.keys(results)) {
-        const weight = balances[id] / totalBalance;
-        totalApy += Number(results[id].weightedApyAfterFee ?? 0) * weight;
+        const agentApy = Number(results[id].weightedApyAfterFee ?? 0);
+        if (agentApy === 0)
+          continue;
+        const weight = balances[id] / relevantBalance;
+        totalApy += agentApy * weight;
       }
     }
     return {
@@ -1719,20 +1938,26 @@ var OwneySDK = class {
       })
     );
     let successCount = 0;
-    for (const settledResult of balanceResults) {
+    const agentErrors = {};
+    for (let i = 0; i < balanceResults.length; i++) {
+      const settledResult = balanceResults[i];
+      const [agentId] = entries[i];
       if (settledResult.status === "fulfilled") {
         const [id, bal] = settledResult.value;
         balances[id] = bal;
         totalBalance += bal;
         successCount += 1;
       } else {
-        console.error("getAgentAllocation agent failed:", settledResult.reason);
+        const reason = settledResult.reason;
+        agentErrors[agentId] = reason instanceof Error ? reason.message : String(reason);
+        console.error(`getAgentAllocation agent "${agentId}" failed:`, reason);
       }
     }
     if (successCount === 0) {
       throw new OwneyError(
         "ALLOCATION_ALL_FAILED",
-        "Failed to fetch allocation: all agents failed."
+        "Failed to fetch allocation: all agents failed.",
+        { agentErrors }
       );
     }
     const allocation = {};