@owney/sdk 0.2.8 → 0.2.9

package/README.md

@@ -32,9 +32,10 @@ const balances = await sdk.getBalances();
 
 Create a new SDK instance.
 
-| Param | Type | Description |
-|-------|------|-------------|
-| `config.apiKey` | `string` | Your Owney API key, used to authenticate with the routing API and fetch agent-specific keys |
+| Param                 | Type                                           | Description                                                                                 |
+| --------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| `config.apiKey`       | `string`                                       | Your Owney API key, used to authenticate with the routing API and fetch agent-specific keys |
+| `config.zyfaiRpcUrls` | `{ 8453?: string; 42161?: string }` (optional) | Per-chain RPC URL overrides used by Zyfai SDK network calls                                 |
 
 ```typescript
 import { OwneySDK } from "@owney/sdk";
@@ -42,12 +43,32 @@ import { OwneySDK } from "@owney/sdk";
 const sdk = new OwneySDK({ apiKey: "your-owney-api-key" });
 ```
 
+#### Custom Zyfai RPC URLs
+
+Use `zyfaiRpcUrls` to override Zyfai SDK RPC endpoints (for example, to avoid public endpoint rate limits).
+
+```typescript
+const sdk = new OwneySDK({
+  apiKey: "your-owney-api-key",
+  zyfaiRpcUrls: {
+    8453: "https://base-mainnet.g.alchemy.com/v2/<key>",
+    42161: "https://arb-mainnet.g.alchemy.com/v2/<key>",
+  },
+});
+```
+
+Notes:
+
+- These overrides are used by Zyfai SDK flows only.
+- If omitted, Zyfai SDK uses its default RPC endpoints.
+- Other app-level RPC clients (for example, direct viem calls outside Zyfai) are configured separately.
+
 ### `connect(provider)`
 
 Establish connection state. Must be called before any wallet-dependent operation.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param      | Type              | Description                                    |
+| ---------- | ----------------- | ---------------------------------------------- |
 | `provider` | EIP-1193 provider | Wallet provider (e.g. MetaMask, WalletConnect) |
 
 ```typescript
@@ -89,9 +110,9 @@ if (chainId) {
 
 Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted. Deploys the Safe contract and creates a session key if not already set up. Saves the chainId for use by all subsequent SDK calls.
 
-| Param | Type | Description |
-|-------|------|-------------|
-| `chainId` | `number` | Target chain ID (e.g. `8453` for Base, `42161` for Arbitrum) |
+| Param     | Type                   | Description                                                                   |
+| --------- | ---------------------- | ----------------------------------------------------------------------------- |
+| `chainId` | `number`               | Target chain ID (e.g. `8453` for Base, `42161` for Arbitrum)                  |
 | `agentId` | `AgentId[]` (optional) | Agents to activate. Omit to activate all agents that support the given chain. |
 
 ```typescript
@@ -104,14 +125,14 @@ await sdk.activateAgent(42161);
 
 ### `deposit(options)`
 
-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. When splitting across agents, `depositCallback` is invoked once per agent with that agent's split amount and smart wallet address — expect multiple wallet prompts.
+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, and agent minimum deposit amounts are taken into account. When splitting across agents, `depositCallback` is invoked once per final valid agent with that agent's split amount and smart wallet address — expect multiple wallet prompts.
 
-| Param | Type | Description |
-|-------|------|-------------|
-| `options.amount` | `string` | Amount in smallest unit (e.g. `"100000000"` for 100 USDC) |
-| `options.asset` | `string` | Asset symbol (e.g. `"USDC"`) |
-| `options.depositCallback` | `DepositCallback` | Callback that performs the token transfer and returns a tx hash |
-| `options.agentId` | `AgentId` (optional) | Target agent. Omit to split equally across all agents. |
+| Param                     | Type                 | Description                                                     |
+| ------------------------- | -------------------- | --------------------------------------------------------------- |
+| `options.amount`          | `string`             | Amount in smallest unit (e.g. `"100000000"` for 100 USDC)       |
+| `options.asset`           | `string`             | Asset symbol (e.g. `"USDC"`)                                    |
+| `options.depositCallback` | `DepositCallback`    | Callback that performs the token transfer and returns a tx hash |
+| `options.agentId`         | `AgentId` (optional) | Target agent. Omit to split equally across all agents.          |
 
 Returns: `OwneyDepositResult` (single agent) or `OwneyMultiDepositResult` (all agents)
 
@@ -126,9 +147,9 @@ const result = await sdk.deposit({
     return txHash;
   },
 });
-console.log(result.txHash);       // "0x..."
-console.log(result.smartWallet);  // "0x..."
-console.log(result.amount);       // "100000000"
+console.log(result.txHash); // "0x..."
+console.log(result.smartWallet); // "0x..."
+console.log(result.amount); // "100000000"
 
 // Split equally across all agents
 const results = await sdk.deposit({
@@ -138,19 +159,19 @@ const results = await sdk.deposit({
     return await transferTokens(smartWallet, amount);
   },
 });
-console.log(results.agentResults.zyfai.amount);  // "50000000"
-console.log(results.agentResults.sail.amount);    // "50000000"
+console.log(results.agentResults.zyfai.amount); // "50000000"
+console.log(results.agentResults.sail.amount); // "50000000"
 ```
 
 ### `withdraw(options)`
 
 Withdraw funds from a specific agent, or all agents that support the active chain+asset if `agentId` is omitted. Validates that the asset is supported.
 
-| Param | Type | Description |
-|-------|------|-------------|
-| `options.asset` | `string` | Asset symbol (e.g. `"USDC"`) |
-| `options.amount` | `string` (optional) | Amount to withdraw. Omit for full withdrawal. |
-| `options.agentId` | `AgentId` (optional) | Target agent. Omit to withdraw from all. |
+| Param             | Type                 | Description                                   |
+| ----------------- | -------------------- | --------------------------------------------- |
+| `options.asset`   | `string`             | Asset symbol (e.g. `"USDC"`)                  |
+| `options.amount`  | `string` (optional)  | Amount to withdraw. Omit for full withdrawal. |
+| `options.agentId` | `AgentId` (optional) | Target agent. Omit to withdraw from all.      |
 
 Returns: `AgentWithdrawResult` (single agent) or `OwneyWithdrawResult` (all agents)
 
@@ -161,21 +182,21 @@ const result = await sdk.withdraw({
   agentId: "zyfai",
   amount: "50000000",
 });
-console.log(result.type);    // "partial"
-console.log(result.amount);  // "50000000"
+console.log(result.type); // "partial"
+console.log(result.amount); // "50000000"
 
 // Full withdrawal from all agents
 const results = await sdk.withdraw({ asset: "USDC" });
-console.log(results.agentResult.zyfai.type);  // "full"
-console.log(results.agentResult.sail.type);   // "full"
+console.log(results.agentResult.zyfai.type); // "full"
+console.log(results.agentResult.sail.type); // "full"
 ```
 
 ### `getBalances(agentId?)`
 
 Get the user's balances for a specific agent, or aggregated across all agents.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param     | Type                           | Description                          |
+| --------- | ------------------------------ | ------------------------------------ |
 | `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
 
 Returns: `AgentBalance` (single agent) or `OwneyBalances` (all agents)
@@ -183,23 +204,23 @@ Returns: `AgentBalance` (single agent) or `OwneyBalances` (all agents)
 ```typescript
 // Single agent
 const balance = await sdk.getBalances("zyfai");
-console.log(balance.totalBalance);  // "150.25"
-console.log(balance.smartWallet);   // "0x..."
-console.log(balance.tokens);       // [{ chain: "BASE", chainId: 8453, asset: "USDC", amount: "150.25" }]
+console.log(balance.totalBalance); // "150.25"
+console.log(balance.smartWallet); // "0x..."
+console.log(balance.tokens); // [{ chain: "BASE", chainId: 8453, asset: "USDC", amount: "150.25" }]
 
 // All agents
 const allBalances = await sdk.getBalances();
-console.log(allBalances.totalBalance);                    // "300.50"
+console.log(allBalances.totalBalance); // "300.50"
 console.log(allBalances.agentBalances.zyfai.totalBalance); // "150.25"
-console.log(allBalances.agentBalances.sail.totalBalance);  // "150.25"
+console.log(allBalances.agentBalances.sail.totalBalance); // "150.25"
 ```
 
 ### `getEarnings(agentId?)`
 
 Get the user's on-chain earnings for a specific agent, or aggregated across all agents.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param     | Type                           | Description                          |
+| --------- | ------------------------------ | ------------------------------------ |
 | `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
 
 Returns: `AgentEarnings` (single agent) or `OwneyEarnings` (all agents)
@@ -207,12 +228,12 @@ Returns: `AgentEarnings` (single agent) or `OwneyEarnings` (all agents)
 ```typescript
 // Single agent
 const earnings = await sdk.getEarnings("zyfai");
-console.log(earnings.smartWallet);       // "0x..."
-console.log(earnings.lifetimeEarnings);  // 42.5
+console.log(earnings.smartWallet); // "0x..."
+console.log(earnings.lifetimeEarnings); // 42.5
 
 // All agents
 const allEarnings = await sdk.getEarnings();
-console.log(allEarnings.totalEarnings);                      // "85.0"
+console.log(allEarnings.totalEarnings); // "85.0"
 console.log(allEarnings.agentEarnings.zyfai.lifetimeEarnings); // 42.5
 ```
 
@@ -220,37 +241,37 @@ console.log(allEarnings.agentEarnings.zyfai.lifetimeEarnings); // 42.5
 
 Get the weighted APY for the user's account. When querying all agents, the total APY is a balance-weighted average.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param     | Type                           | Description                                      |
+| --------- | ------------------------------ | ------------------------------------------------ |
 | `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for balance-weighted total. |
-| `days` | `"7D" \| "14D" \| "30D"` | Lookback period |
+| `days`    | `"7D" \| "14D" \| "30D"`       | Lookback period                                  |
 
 Returns: `AccountAgentApy` (single agent) or `OwneyAccountApy` (all agents)
 
 ```typescript
 // Single agent
 const apy = await sdk.getAccountApy({ agentId: "zyfai", days: "30D" });
-console.log(apy.walletAddress);       // "0x..."
+console.log(apy.walletAddress); // "0x..."
 console.log(apy.weightedApyAfterFee); // 5.2
 // Per chain + token breakdown, when the agent reports it
-console.log(apy.weightedApyAfterFeeDetails?.apyPerAsset[8453]?.USDC);  // 5.4
+console.log(apy.weightedApyAfterFeeDetails?.apyPerAsset[8453]?.USDC); // 5.4
 
 // All agents (balance-weighted)
 const allApy = await sdk.getAccountApy({ days: "30D" });
-console.log(allApy.totalApy);                        // "5.6"
+console.log(allApy.totalApy); // "5.6"
 console.log(allApy.agentApy.zyfai.weightedApyAfterFee); // 6.0
-console.log(allApy.agentApy.sail.weightedApyAfterFee);  // 4.0
+console.log(allApy.agentApy.sail.weightedApyAfterFee); // 4.0
 ```
 
 ### `getHistory({ agentId?, filters? })`
 
 Get transaction history for a specific agent, or all agents. When querying all agents, results are merged into a single list sorted by date (newest first). Each entry includes the originating `agent` and a `transactions` array with typed on-chain transaction details.
 
-| Param | Type | Description |
-|-------|------|-------------|
-| `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
-| `filters.fromDate` | `string` (optional) | Start date (`YYYY-MM-DD`) |
-| `filters.toDate` | `string` (optional) | End date (`YYYY-MM-DD`) |
+| Param              | Type                           | Description                          |
+| ------------------ | ------------------------------ | ------------------------------------ |
+| `agentId`          | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
+| `filters.fromDate` | `string` (optional)            | Start date (`YYYY-MM-DD`)            |
+| `filters.toDate`   | `string` (optional)            | End date (`YYYY-MM-DD`)              |
 
 Returns: `OwneyAgentHistory`
 
@@ -260,65 +281,65 @@ const history = await sdk.getHistory({
   agentId: "zyfai",
   filters: { fromDate: "2025-01-01" },
 });
-console.log(history.total);                              // 42
-console.log(history.data[0].agent);                      // "zyfai"
-console.log(history.data[0].action);                     // "Rebalance"
-console.log(history.data[0].date);                       // "2025-03-15T12:00:00Z"
-console.log(history.data[0].transactions[0].txHashes);   // ["0x..."]
-console.log(history.data[0].transactions[0].amount);     // "100.00"
+console.log(history.total); // 42
+console.log(history.data[0].agent); // "zyfai"
+console.log(history.data[0].action); // "Rebalance"
+console.log(history.data[0].date); // "2025-03-15T12:00:00Z"
+console.log(history.data[0].transactions[0].txHashes); // ["0x..."]
+console.log(history.data[0].transactions[0].amount); // "100.00"
 console.log(history.data[0].transactions[0].tokenSymbol); // "USDC"
 
 // Rebalance logs show fund movement between protocols
 console.log(history.data[0].rebalanceLog[0].fromProtocol); // "Aave V3"
-console.log(history.data[0].rebalanceLog[0].toProtocol);   // "Morpho Blue"
-console.log(history.data[0].rebalanceLog[0].tokenSymbol);  // "USDC"
-console.log(history.data[0].rebalanceLog[0].amount);       // "100.00"
-console.log(history.data[0].rebalanceLog[0].status);       // "success"
+console.log(history.data[0].rebalanceLog[0].toProtocol); // "Morpho Blue"
+console.log(history.data[0].rebalanceLog[0].tokenSymbol); // "USDC"
+console.log(history.data[0].rebalanceLog[0].amount); // "100.00"
+console.log(history.data[0].rebalanceLog[0].status); // "success"
 
 // All agents (merged and sorted by date)
 const allHistory = await sdk.getHistory();
-console.log(allHistory.total);            // 57
-console.log(allHistory.data[0].agent);    // "sail" (most recent entry)
-console.log(allHistory.data[0].action);   // "Rebalance"
+console.log(allHistory.total); // 57
+console.log(allHistory.data[0].agent); // "sail" (most recent entry)
+console.log(allHistory.data[0].action); // "Rebalance"
 ```
 
 ### `pauseAgent(agentId)`
 
 Pause an agent's automated operations. The agent will stop rebalancing until resumed.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param     | Type                | Description    |
+| --------- | ------------------- | -------------- |
 | `agentId` | `"zyfai" \| "sail"` | Agent to pause |
 
 Returns: `OwneyAgentStatus`
 
 ```typescript
 const status = await sdk.pauseAgent("zyfai");
-console.log(status.success);  // true
+console.log(status.success); // true
 ```
 
 ### `resumeAgent(agentId)`
 
 Resume an agent's automated operations.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param     | Type                | Description     |
+| --------- | ------------------- | --------------- |
 | `agentId` | `"zyfai" \| "sail"` | Agent to resume |
 
 Returns: `OwneyAgentStatus`
 
 ```typescript
 const status = await sdk.resumeAgent("zyfai");
-console.log(status.success);    // true
-console.log(status.protocols);  // ["aave", "compound"]
+console.log(status.success); // true
+console.log(status.protocols); // ["aave", "compound"]
 ```
 
 ### `getUserProfile(agentId?)`
 
 Get the user's profile for a specific agent, or all agents.
 
-| Param | Type | Description |
-|-------|------|-------------|
+| Param     | Type                           | Description                          |
+| --------- | ------------------------------ | ------------------------------------ |
 | `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
 
 Returns: `AgentUserProfile` (single agent) or `OwneyUserProfile` (all agents)
@@ -326,28 +347,28 @@ Returns: `AgentUserProfile` (single agent) or `OwneyUserProfile` (all agents)
 ```typescript
 // Single agent
 const profile = await sdk.getUserProfile("zyfai");
-console.log(profile.address);             // "0x..."
-console.log(profile.smartWallet);         // "0x..."
-console.log(profile.chains);             // [8453]
+console.log(profile.address); // "0x..."
+console.log(profile.smartWallet); // "0x..."
+console.log(profile.chains); // [8453]
 console.log(profile.hasActiveSessionKey); // true
-console.log(profile.protocols);          // ["aave", "compound"]
+console.log(profile.protocols); // ["aave", "compound"]
 
 // All agents
 const allProfiles = await sdk.getUserProfile();
 console.log(allProfiles.agentUserProfile.zyfai.smartWallet); // "0x..."
-console.log(allProfiles.agentUserProfile.sail.smartWallet);  // "0x..."
+console.log(allProfiles.agentUserProfile.sail.smartWallet); // "0x..."
 ```
 
 ### `getAgentApy({ agentId?, days, tokenSymbol?, chainId? })`
 
 Get the agent's average APY performance over a time period. Does not require a wallet connection.
 
-| Param | Type | Description |
-|-------|------|-------------|
-| `agentId` | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents. |
-| `days` | `"7D" \| "14D" \| "30D"` | Lookback period |
-| `tokenSymbol` | `string` (optional) | Asset symbol (e.g. `"USDC"`, `"WETH"`). Scopes the upstream request to a specific asset when the agent's backend supports it. Zyfai forwards this; Sail currently ignores it at the API level. |
-| `chainId` | `number` (optional) | Chain id. Typically paired with `tokenSymbol` for per-asset+chain APY. Zyfai forwards this; Sail currently ignores it at the API level. |
+| Param         | Type                           | Description                                                                                                                                                                                    |
+| ------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `agentId`     | `"zyfai" \| "sail"` (optional) | Agent to query. Omit for all agents.                                                                                                                                                           |
+| `days`        | `"7D" \| "14D" \| "30D"`       | Lookback period                                                                                                                                                                                |
+| `tokenSymbol` | `string` (optional)            | Asset symbol (e.g. `"USDC"`, `"WETH"`). Scopes the upstream request to a specific asset when the agent's backend supports it. Zyfai forwards this; Sail currently ignores it at the API level. |
+| `chainId`     | `number` (optional)            | Chain id. Typically paired with `tokenSymbol` for per-asset+chain APY. Zyfai forwards this; Sail currently ignores it at the API level.                                                        |
 
 Returns: `AgentApy` (single agent) or `OwneyAgentApy` (all agents)
 
@@ -359,13 +380,13 @@ returns.
 ```typescript
 // Single agent
 const apy = await sdk.getAgentApy({ agentId: "zyfai", days: "30D" });
-console.log(apy.averageApy);  // 8.5
+console.log(apy.averageApy); // 8.5
 console.log(apy.detailedApys?.apyPerAsset[8453]?.USDC); // 8.7
 
 // All agents
 const allApy = await sdk.getAgentApy({ days: "30D" });
 console.log(allApy.agentApy.zyfai.averageApy); // 8.5
-console.log(allApy.agentApy.sail.averageApy);  // 6.2
+console.log(allApy.agentApy.sail.averageApy); // 6.2
 console.log(allApy.agentApy.sail.detailedApys?.apyPerAsset[42161]?.USDT); // 6.4
 
 // Scope the upstream query to USDC on Base (Zyfai-aware; Sail ignores the filter)
@@ -385,7 +406,7 @@ Returns: `OwneyAgentAllocation`
 
 ```typescript
 const allocation = await sdk.getAgentAllocation();
-console.log(allocation.agentAllocation);  // { zyfai: 75, sail: 25 }
+console.log(allocation.agentAllocation); // { zyfai: 75, sail: 25 }
 ```
 
 ## Types
@@ -408,6 +429,10 @@ type AgentSupportedAssets = {
 
 interface OwneySDKConfig {
   apiKey: string;
+  zyfaiRpcUrls?: {
+    8453?: string;
+    42161?: string;
+  };
 }
 
 interface ConnectionState {
@@ -417,8 +442,8 @@ interface ConnectionState {
 }
 
 type HistoryFilters = {
-  fromDate?: string;  // YYYY-MM-DD
-  toDate?: string;    // YYYY-MM-DD
+  fromDate?: string; // YYYY-MM-DD
+  toDate?: string; // YYYY-MM-DD
 };
 
 type HistoryOptions = {
@@ -447,8 +472,8 @@ type AccountApyOptions = {
 type AgentsApyOptions = {
   agentId?: AgentId;
   days: DailyApyDays;
-  tokenSymbol?: string;  // e.g. "USDC", "WETH"
-  chainId?: number;      // typically paired with tokenSymbol
+  tokenSymbol?: string; // e.g. "USDC", "WETH"
+  chainId?: number; // typically paired with tokenSymbol
 };
 ```
 
@@ -634,36 +659,36 @@ try {
 ```typescript
 type OwneyErrorCode =
   // Connection & wallet
-  | "NOT_CONNECTED"           // Wallet-dependent method called before connect()
-  | "NO_ACTIVE_CHAIN"         // Method called before activateAgent()
-  | "WALLET_NO_ACCOUNTS"      // Provider returned no accounts during connect()
+  | "NOT_CONNECTED" // Wallet-dependent method called before connect()
+  | "NO_ACTIVE_CHAIN" // Method called before activateAgent()
+  | "WALLET_NO_ACCOUNTS" // Provider returned no accounts during connect()
   | "WALLET_ADDRESS_REQUIRED" // Wallet address missing during agent auth
   // Agent resolution
-  | "AGENT_NOT_FOUND"          // Unknown agent ID passed
+  | "AGENT_NOT_FOUND" // Unknown agent ID passed
   | "AGENT_CHAIN_INCOMPATIBLE" // Agent(s) don't support the given chain
-  | "AGENT_EMPTY_LIST"         // Empty agentId array passed to activateAgent()
+  | "AGENT_EMPTY_LIST" // Empty agentId array passed to activateAgent()
   // Chain
-  | "CHAIN_UNSUPPORTED"           // Chain ID not in supported list (8453, 42161)
-  | "CHAIN_NO_COMPATIBLE_AGENTS"  // No agents support the given chain
+  | "CHAIN_UNSUPPORTED" // Chain ID not in supported list (8453, 42161)
+  | "CHAIN_NO_COMPATIBLE_AGENTS" // No agents support the given chain
   // Asset
-  | "ASSET_UNSUPPORTED"           // Agent doesn't support the asset on the active chain
-  | "ASSET_NO_COMPATIBLE_AGENTS"  // No agents support the asset on the active chain
+  | "ASSET_UNSUPPORTED" // Agent doesn't support the asset on the active chain
+  | "ASSET_NO_COMPATIBLE_AGENTS" // No agents support the asset on the active chain
   // Deposit
-  | "DEPOSIT_AMOUNT_TOO_SMALL"    // Amount too small to split across agents
-  | "DEPOSIT_CALLBACK_REQUIRED"   // Sail agent requires a depositCallback
-  | "DEPOSIT_CALLBACK_INVALID"    // depositCallback didn't return a tx hash
+  | "DEPOSIT_AMOUNT_BELOW_MINIMUM" // Amount below an agent's required minimum deposit
+  | "DEPOSIT_CALLBACK_REQUIRED" // Sail agent requires a depositCallback
+  | "DEPOSIT_CALLBACK_INVALID" // depositCallback didn't return a tx hash
   | "DEPOSIT_NO_PERMITTED_TOKENS" // No permitted tokens available for deposit
   // Withdraw
   | "WITHDRAW_NO_PERMITTED_TOKENS" // No permitted tokens available for withdrawal
   // API
-  | "API_ROUTING_ERROR"  // Routing API returned a non-OK HTTP status
+  | "API_ROUTING_ERROR" // Routing API returned a non-OK HTTP status
   | "API_ROUTING_FAILED" // Routing API returned { success: false }
-  | "API_SAIL_ERROR"     // Sail API returned a non-OK HTTP status
-  | "API_SAIL_TIMEOUT"   // Sail API request timed out
-  | "API_NO_AGENTS"      // No supported agents returned by routing API
+  | "API_SAIL_ERROR" // Sail API returned a non-OK HTTP status
+  | "API_SAIL_TIMEOUT" // Sail API request timed out
+  | "API_NO_AGENTS" // No supported agents returned by routing API
   // Aggregation
-  | "BALANCE_ALL_FAILED"     // All agents failed to return balances
-  | "ALLOCATION_ALL_FAILED"  // All agents failed to return allocation data
+  | "BALANCE_ALL_FAILED" // All agents failed to return balances
+  | "ALLOCATION_ALL_FAILED" // All agents failed to return allocation data
   // Validation
   | "VALIDATION_INVALID_DAYS"; // Invalid days value (expected "7D", "14D", or "30D")
 
@@ -675,10 +700,10 @@ class OwneyError extends Error {
 
 The three convenience subclasses extend `OwneyError` and remain backwards-compatible:
 
-| Class | Code | Extra properties |
-|-------|------|------------------|
-| `NotConnectedError` | `NOT_CONNECTED` | — |
-| `AgentNotFoundError` | `AGENT_NOT_FOUND` | — |
+| Class                         | Code                       | Extra properties                         |
+| ----------------------------- | -------------------------- | ---------------------------------------- |
+| `NotConnectedError`           | `NOT_CONNECTED`            | —                                        |
+| `AgentNotFoundError`          | `AGENT_NOT_FOUND`          | —                                        |
 | `AgentChainIncompatibleError` | `AGENT_CHAIN_INCOMPATIBLE` | `incompatibleAgents`, `connectedChainId` |
 
 ## License

package/dist/index.cjs

@@ -303,8 +303,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 = [
     {
@@ -324,7 +329,10 @@ var ZyfaiAgent = class {
   smartWalletCache = /* @__PURE__ */ new Map();
   connectAuthPromise = null;
   constructor(apiKey, rpcUrls) {
-    this.sdk = new import_sdk.ZyfaiSDK({ apiKey, rpcUrls });
+    this.sdk = new import_sdk.ZyfaiSDK({
+      apiKey,
+      rpcUrls: rpcUrls ?? DEFAULT_ZYFAI_RPC_URLS
+    });
   }
   // --- Private helpers ---
   getAddress() {
@@ -640,7 +648,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,
@@ -707,6 +715,7 @@ var PAGE_ID = "home";
 var SAIL_PORTFOLIO_TIMEOUT_MS = 8e3;
 var SailAgent = class {
   id = "sail";
+  minDepositAmount = "4800000000";
   supportedChainIds = [8453, 42161];
   supportedAssets = [
     {
@@ -1372,7 +1381,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")
@@ -1384,28 +1393,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,
@@ -1415,6 +1425,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
@@ -1597,18 +1638,30 @@ 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;
       }
     }
+    console.log("account apy", {
+      totalApy: String(totalApy),
+      agentApy: results
+    });
     return {
       totalApy: String(totalApy),
       agentApy: results

package/dist/index.d.cts

@@ -24,6 +24,7 @@ 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>;
@@ -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,7 +341,7 @@ 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" | "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>;
@@ -366,4 +365,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.d.ts

@@ -24,6 +24,7 @@ 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>;
@@ -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,7 +341,7 @@ 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" | "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>;
@@ -366,4 +365,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

@@ -273,8 +273,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,7 +299,10 @@ 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() {
@@ -610,7 +618,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,
@@ -677,6 +685,7 @@ var PAGE_ID = "home";
 var SAIL_PORTFOLIO_TIMEOUT_MS = 8e3;
 var SailAgent = class {
   id = "sail";
+  minDepositAmount = "4800000000";
   supportedChainIds = [8453, 42161];
   supportedAssets = [
     {
@@ -1342,7 +1351,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 +1363,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 +1395,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
@@ -1567,18 +1608,30 @@ 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;
       }
     }
+    console.log("account apy", {
+      totalApy: String(totalApy),
+      agentApy: results
+    });
     return {
       totalApy: String(totalApy),
       agentApy: results

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -26,5 +26,8 @@
     "dotenv": "^17.3.1",
     "tsup": "^7.0.0",
     "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }