@stablechain/sdk 1.0.0 → 1.0.1

package/dist/index.cjs

@@ -223,6 +223,9 @@ var EarnReader = class {
       assetAddress: vaultData.asset
     };
   }
+  async getYield() {
+    return this._fetchYield();
+  }
   async preview(params) {
     const { amount, horizonDays } = params;
     const apy = await this._fetchNetApy();
@@ -249,10 +252,21 @@ var EarnReader = class {
     };
   }
   async _fetchNetApy() {
+    const { apy } = await this._fetchYield();
+    return apy;
+  }
+  async _fetchYield() {
     const query = `
-      query VaultNetApy($address: String!, $chainId: Int!) {
+      query VaultYield($address: String!, $chainId: Int!) {
         vaultV2ByAddress(address: $address, chainId: $chainId) {
           netApy
+          netApyExcludingRewards
+          performanceFee
+          managementFee
+          rewards {
+            asset { symbol address }
+            supplyApr
+          }
         }
       }
     `;
@@ -271,7 +285,7 @@ var EarnReader = class {
           if (!res.ok) {
             const retryable = res.status === 429 || res.status >= 500;
             throw new HttpError(
-              `earn preview: Morpho API returned ${res.status} \u2014 ${res.statusText}`,
+              `earn: Morpho API returned ${res.status} \u2014 ${res.statusText}`,
               res.status,
               retryable
             );
@@ -283,22 +297,29 @@ var EarnReader = class {
     } catch (err) {
       if (err instanceof TypeError || err instanceof HttpError) {
         throw new StableNetworkError({
-          shortMessage: err instanceof HttpError ? `earn preview: Morpho API returned ${err.status} after retries` : `earn preview: failed to reach Morpho API after retries \u2014 ${String(err)}`,
+          shortMessage: err instanceof HttpError ? `earn: Morpho API returned ${err.status} after retries` : `earn: failed to reach Morpho API after retries \u2014 ${String(err)}`,
           url: MORPHO_API_URL,
           cause: err
         });
       }
       throw err;
     }
-    const netApy = _optionalChain([body, 'optionalAccess', _4 => _4.data, 'optionalAccess', _5 => _5.vaultV2ByAddress, 'optionalAccess', _6 => _6.netApy]);
-    if (typeof netApy !== "number") {
+    const vault = _optionalChain([body, 'optionalAccess', _4 => _4.data, 'optionalAccess', _5 => _5.vaultV2ByAddress]);
+    if (!vault || typeof vault.netApy !== "number") {
       throw new StableValidationError(
         "apy",
         void 0,
-        "earn preview: vault not found in Morpho API or unexpected response shape"
+        "earn: vault not found in Morpho API or unexpected response shape"
       );
     }
-    return netApy;
+    const rewards = vault.rewards.filter((r) => typeof r.supplyApr === "number" && r.supplyApr > 0).map((r) => ({ symbol: r.asset.symbol, address: r.asset.address, apr: r.supplyApr }));
+    return {
+      apy: vault.netApy,
+      native: _nullishCoalesce(vault.netApyExcludingRewards, () => ( 0)),
+      rewards,
+      performanceFee: vault.performanceFee,
+      managementFee: vault.managementFee
+    };
   }
 };
 
@@ -416,7 +437,7 @@ var LiFiService = class {
   async quoteBridge(params) {
     this._validateBridgeParams(params);
     const { fromChain, toChain, fromToken, toToken, amount, fromDecimals = 6, recipient } = params;
-    const from = _nullishCoalesce(_nullishCoalesce(_optionalChain([this, 'access', _7 => _7.config, 'access', _8 => _8.walletClient, 'optionalAccess', _9 => _9.account, 'optionalAccess', _10 => _10.address]), () => ( _optionalChain([this, 'access', _11 => _11.config, 'access', _12 => _12.account, 'optionalAccess', _13 => _13.address]))), () => ( "0x0000000000000000000000000000000000000000"));
+    const from = _nullishCoalesce(_nullishCoalesce(_optionalChain([this, 'access', _6 => _6.config, 'access', _7 => _7.walletClient, 'optionalAccess', _8 => _8.account, 'optionalAccess', _9 => _9.address]), () => ( _optionalChain([this, 'access', _10 => _10.config, 'access', _11 => _11.account, 'optionalAccess', _12 => _12.address]))), () => ( "0x0000000000000000000000000000000000000000"));
     const src = CHAIN_CONFIGS[fromChain];
     const dst = CHAIN_CONFIGS[toChain];
     if (!src) throw new StableValidationError("fromChain", fromChain, `LI.FI bridge: unsupported source chain "${fromChain}"`);
@@ -493,7 +514,7 @@ var LiFiService = class {
     }
   }
   _requireFrom() {
-    const from = _nullishCoalesce(_optionalChain([this, 'access', _14 => _14.config, 'access', _15 => _15.walletClient, 'optionalAccess', _16 => _16.account, 'optionalAccess', _17 => _17.address]), () => ( _optionalChain([this, 'access', _18 => _18.config, 'access', _19 => _19.account, 'optionalAccess', _20 => _20.address])));
+    const from = _nullishCoalesce(_optionalChain([this, 'access', _13 => _13.config, 'access', _14 => _14.walletClient, 'optionalAccess', _15 => _15.account, 'optionalAccess', _16 => _16.address]), () => ( _optionalChain([this, 'access', _17 => _17.config, 'access', _18 => _18.account, 'optionalAccess', _19 => _19.address])));
     if (!from) {
       throw new StableValidationError(
         "signer",
@@ -675,6 +696,7 @@ function isLiFiQuoteShape(v) {
 
 
 
+
 var MorphoService = class {
   constructor(config) {
     this.config = config;
@@ -685,7 +707,7 @@ var MorphoService = class {
       chain: this.chain,
       transport: _nullishCoalesce(config.transport, () => ( _viem.http.call(void 0, config.rpc)))
     })));
-    const morphoWc = _optionalChain([this, 'access', _21 => _21.wc, 'access', _22 => _22.chain, 'optionalAccess', _23 => _23.id]) === config.chainId ? this.wc : _viem.createWalletClient.call(void 0, {
+    const morphoWc = _optionalChain([this, 'access', _20 => _20.wc, 'access', _21 => _21.chain, 'optionalAccess', _22 => _22.id]) === config.chainId ? this.wc : _viem.createWalletClient.call(void 0, {
       account: this.wc.account,
       chain: this.chain,
       transport: _viem.custom.call(void 0, { request: this.wc.request.bind(this.wc) })
@@ -695,6 +717,9 @@ var MorphoService = class {
   }
   deposit(params) {
     this._validateAmount(params.amount, "earn deposit");
+    if (params.depositBuffer !== void 0 && (params.depositBuffer <= 0 || params.depositBuffer > 1)) {
+      throw new StableValidationError("depositBuffer", params.depositBuffer, "earn deposit: depositBuffer must be > 0 and \u2264 1");
+    }
     return this._withIdempotency(params.idempotencyKey, () => this._deposit(params));
   }
   async bulkDeposit(items, options = {}) {
@@ -724,6 +749,33 @@ var MorphoService = class {
     };
     return this._withIdempotency(idempotencyKey, run);
   }
+  async bulkWithdraw(items, options = {}) {
+    const { idempotencyKey, stopOnError = false } = options;
+    const run = async () => {
+      const results = [];
+      for (const item of items) {
+        try {
+          const result = await this.withdraw(item);
+          results.push({ status: "fulfilled", txHash: result.txHash, idempotencyKey: item.idempotencyKey });
+        } catch (err) {
+          const entry = { status: "rejected", error: String(err), idempotencyKey: item.idempotencyKey };
+          results.push(entry);
+          if (stopOnError) {
+            const succeeded2 = results.filter((r) => r.status === "fulfilled").length;
+            throw new StableBulkError({
+              shortMessage: "bulkWithdraw halted on first failure",
+              results,
+              succeeded: succeeded2,
+              failed: results.length - succeeded2
+            });
+          }
+        }
+      }
+      const succeeded = results.filter((r) => r.status === "fulfilled").length;
+      return { results, succeeded, failed: results.length - succeeded, idempotencyKey };
+    };
+    return this._withIdempotency(idempotencyKey, run);
+  }
   withdraw(params) {
     this._validateAmount(params.amount, "earn withdraw");
     return this._withIdempotency(params.idempotencyKey, () => this._withdraw(params));
@@ -742,7 +794,7 @@ var MorphoService = class {
   }
   // ─── Private operations ──────────────────────────────────────────────────
   async _deposit(params) {
-    const { amount, tokenDecimals, slippageTolerance, idempotencyKey } = params;
+    const { amount, tokenDecimals, slippageTolerance, idempotencyKey, depositBuffer } = params;
     const from = this._requireFrom();
     const vaultAddr = _nullishCoalesce(params.vault, () => ( this.config.vault));
     await this._switchChain();
@@ -750,6 +802,19 @@ var MorphoService = class {
     const vaultData = await vault.getData();
     const decimals = await _asyncNullishCoalesce(tokenDecimals, async () => ( await this._resolveDecimals(vaultData.asset, "earn deposit")));
     const assetsRaw = _viem.parseUnits.call(void 0, String(amount), decimals);
+    if (depositBuffer !== void 0) {
+      const bps = BigInt(Math.round(depositBuffer * 1e4));
+      const maxAllowed = vaultData.assetBalance * bps / 10000n;
+      if (assetsRaw > maxAllowed) {
+        const maxFormatted = Number(_viem.formatUnits.call(void 0, maxAllowed, decimals));
+        const idleFormatted = Number(_viem.formatUnits.call(void 0, vaultData.assetBalance, decimals));
+        throw new StableValidationError(
+          "amount",
+          amount,
+          `earn deposit: amount ${amount} exceeds deposit buffer \u2014 max ${maxFormatted} (${depositBuffer * 100}% of ${idleFormatted} idle liquidity)`
+        );
+      }
+    }
     const depositAction = vault.deposit({
       amount: assetsRaw,
       userAddress: from,
@@ -920,7 +985,7 @@ var MorphoService = class {
   }
   // ─── Helpers ─────────────────────────────────────────────────────────────
   _requireFrom() {
-    const from = _optionalChain([this, 'access', _24 => _24.wc, 'access', _25 => _25.account, 'optionalAccess', _26 => _26.address]);
+    const from = _optionalChain([this, 'access', _23 => _23.wc, 'access', _24 => _24.account, 'optionalAccess', _25 => _25.address]);
     if (!from) {
       throw new StableValidationError(
         "signer",
@@ -1061,7 +1126,7 @@ function createStable({
   async function transfer(params) {
     validateTransferParams(params);
     const { from, to, amount, token, tokenDecimals } = params;
-    const acc = _nullishCoalesce(_nullishCoalesce(_optionalChain([walletClient, 'optionalAccess', _27 => _27.account]), () => ( account)), () => ( from));
+    const acc = _nullishCoalesce(_nullishCoalesce(_optionalChain([walletClient, 'optionalAccess', _26 => _26.account]), () => ( account)), () => ( from));
     const wc = _nullishCoalesce(walletClient, () => ( _viem.createWalletClient.call(void 0, {
       account: acc,
       chain,
@@ -1100,6 +1165,7 @@ function createStable({
       deposit: (params) => requireEarn().deposit(params),
       bulkDeposit: (items, options) => requireEarn().bulkDeposit(items, options),
       withdraw: (params) => requireEarn().withdraw(params),
+      bulkWithdraw: (items, options) => requireEarn().bulkWithdraw(items, options),
       redeem: (params) => requireEarn().redeem(params),
       forceWithdraw: (params) => requireEarn().forceWithdraw(params),
       forceRedeem: (params) => requireEarn().forceRedeem(params)
@@ -1110,6 +1176,7 @@ function createStableReader(config) {
   const reader = new EarnReader(config);
   return {
     earn: {
+      getYield: () => reader.getYield(),
       position: () => reader.position(),
       preview: (params) => reader.preview(params),
       withdrawability: (params) => reader.withdrawability(params)

package/dist/index.d.cts

@@ -118,6 +118,12 @@ interface EarnDepositParams {
     slippageTolerance?: number;
     /** Deduplication key: if an operation with this key is already in flight, the same Promise is returned. */
     idempotencyKey?: string;
+    /**
+     * Maximum fraction of the vault's idle liquidity that this deposit may consume (e.g. 0.8 = 80%).
+     * The SDK throws StableValidationError before sending the transaction if the amount exceeds the cap.
+     * Must be > 0 and ≤ 1. Omit to disable the check.
+     */
+    depositBuffer?: number;
 }
 interface EarnWithdrawParams {
     /** Amount of underlying assets to withdraw (human-readable) */
@@ -167,6 +173,15 @@ interface BulkDepositOptions {
      */
     stopOnError?: boolean;
 }
+interface BulkWithdrawOptions {
+    /** Batch-level deduplication key — if this batch is already in flight, the same Promise is returned. */
+    idempotencyKey?: string;
+    /**
+     * When true, the batch halts on the first failure and rejects.
+     * When false (default), all withdrawals are attempted and partial results are returned.
+     */
+    stopOnError?: boolean;
+}
 /**
  * A single adapter position to forcibly deallocate before a force withdraw/redeem.
  * `amount` is in underlying asset units (human-readable).
@@ -206,6 +221,26 @@ interface ForceRedeemParams {
     /** Deduplication key */
     idempotencyKey?: string;
 }
+interface VaultYieldReward {
+    /** Reward token symbol (e.g. "MORPHO") */
+    symbol: string;
+    /** Reward token contract address */
+    address: string;
+    /** APR contribution from this reward token as a decimal (e.g. 0.02 = 2%) */
+    apr: number;
+}
+interface VaultYield {
+    /** Total net APY after all fees, including rewards, as a decimal (e.g. 0.05 = 5%) */
+    apy: number;
+    /** Native yield component — underlying market rates after fees, excluding reward boosts */
+    native: number;
+    /** Per-token reward boosts */
+    rewards: VaultYieldReward[];
+    /** Performance fee as a decimal (e.g. 0.1 = 10%) */
+    performanceFee: number;
+    /** Management fee as a decimal */
+    managementFee: number;
+}
 interface VaultPosition {
     /** Raw vault share balance */
     shares: bigint;
@@ -255,6 +290,7 @@ interface StableClient {
         deposit(params: EarnDepositParams): Promise<EarnResult>;
         bulkDeposit(items: EarnDepositParams[], options?: BulkDepositOptions): Promise<BulkEarnResult>;
         withdraw(params: EarnWithdrawParams): Promise<EarnResult>;
+        bulkWithdraw(items: EarnWithdrawParams[], options?: BulkWithdrawOptions): Promise<BulkEarnResult>;
         redeem(params: EarnRedeemParams): Promise<EarnResult>;
         forceWithdraw(params: ForceWithdrawParams): Promise<EarnResult>;
         forceRedeem(params: ForceRedeemParams): Promise<EarnResult>;
@@ -262,6 +298,8 @@ interface StableClient {
 }
 interface StableReader {
     earn: {
+        /** Current net APY for the configured vault. */
+        getYield(): Promise<VaultYield>;
         /** Current vault position (shares + asset value) for the configured user address. */
         position(): Promise<VaultPosition>;
         /** Projected yield over a given horizon, using Morpho's live net APY. */
@@ -348,4 +386,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { type BridgeParams, type BridgeQuote, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type WithdrawStatus, type YieldPreview, createStable, createStableReader };
+export { type BridgeParams, type BridgeQuote, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type VaultYield, type VaultYieldReward, type WithdrawStatus, type YieldPreview, createStable, createStableReader };

package/dist/index.d.ts

@@ -118,6 +118,12 @@ interface EarnDepositParams {
     slippageTolerance?: number;
     /** Deduplication key: if an operation with this key is already in flight, the same Promise is returned. */
     idempotencyKey?: string;
+    /**
+     * Maximum fraction of the vault's idle liquidity that this deposit may consume (e.g. 0.8 = 80%).
+     * The SDK throws StableValidationError before sending the transaction if the amount exceeds the cap.
+     * Must be > 0 and ≤ 1. Omit to disable the check.
+     */
+    depositBuffer?: number;
 }
 interface EarnWithdrawParams {
     /** Amount of underlying assets to withdraw (human-readable) */
@@ -167,6 +173,15 @@ interface BulkDepositOptions {
      */
     stopOnError?: boolean;
 }
+interface BulkWithdrawOptions {
+    /** Batch-level deduplication key — if this batch is already in flight, the same Promise is returned. */
+    idempotencyKey?: string;
+    /**
+     * When true, the batch halts on the first failure and rejects.
+     * When false (default), all withdrawals are attempted and partial results are returned.
+     */
+    stopOnError?: boolean;
+}
 /**
  * A single adapter position to forcibly deallocate before a force withdraw/redeem.
  * `amount` is in underlying asset units (human-readable).
@@ -206,6 +221,26 @@ interface ForceRedeemParams {
     /** Deduplication key */
     idempotencyKey?: string;
 }
+interface VaultYieldReward {
+    /** Reward token symbol (e.g. "MORPHO") */
+    symbol: string;
+    /** Reward token contract address */
+    address: string;
+    /** APR contribution from this reward token as a decimal (e.g. 0.02 = 2%) */
+    apr: number;
+}
+interface VaultYield {
+    /** Total net APY after all fees, including rewards, as a decimal (e.g. 0.05 = 5%) */
+    apy: number;
+    /** Native yield component — underlying market rates after fees, excluding reward boosts */
+    native: number;
+    /** Per-token reward boosts */
+    rewards: VaultYieldReward[];
+    /** Performance fee as a decimal (e.g. 0.1 = 10%) */
+    performanceFee: number;
+    /** Management fee as a decimal */
+    managementFee: number;
+}
 interface VaultPosition {
     /** Raw vault share balance */
     shares: bigint;
@@ -255,6 +290,7 @@ interface StableClient {
         deposit(params: EarnDepositParams): Promise<EarnResult>;
         bulkDeposit(items: EarnDepositParams[], options?: BulkDepositOptions): Promise<BulkEarnResult>;
         withdraw(params: EarnWithdrawParams): Promise<EarnResult>;
+        bulkWithdraw(items: EarnWithdrawParams[], options?: BulkWithdrawOptions): Promise<BulkEarnResult>;
         redeem(params: EarnRedeemParams): Promise<EarnResult>;
         forceWithdraw(params: ForceWithdrawParams): Promise<EarnResult>;
         forceRedeem(params: ForceRedeemParams): Promise<EarnResult>;
@@ -262,6 +298,8 @@ interface StableClient {
 }
 interface StableReader {
     earn: {
+        /** Current net APY for the configured vault. */
+        getYield(): Promise<VaultYield>;
         /** Current vault position (shares + asset value) for the configured user address. */
         position(): Promise<VaultPosition>;
         /** Projected yield over a given horizon, using Morpho's live net APY. */
@@ -348,4 +386,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { type BridgeParams, type BridgeQuote, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type WithdrawStatus, type YieldPreview, createStable, createStableReader };
+export { type BridgeParams, type BridgeQuote, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, Network, type OperationResult, STABLE_USDT_ADDRESS, STABLE_VAULT_ADDRESS, StableBulkError, type StableClient, type StableConfig, StableError, StableNetworkError, StableQuoteError, type StableReader, type StableReaderConfig, StableTransactionError, StableValidationError, type SwapParams, type SwapQuote, type TransferParams, type VaultPosition, type VaultYield, type VaultYieldReward, type WithdrawStatus, type YieldPreview, createStable, createStableReader };

package/dist/index.js

@@ -223,6 +223,9 @@ var EarnReader = class {
       assetAddress: vaultData.asset
     };
   }
+  async getYield() {
+    return this._fetchYield();
+  }
   async preview(params) {
     const { amount, horizonDays } = params;
     const apy = await this._fetchNetApy();
@@ -249,10 +252,21 @@ var EarnReader = class {
     };
   }
   async _fetchNetApy() {
+    const { apy } = await this._fetchYield();
+    return apy;
+  }
+  async _fetchYield() {
     const query = `
-      query VaultNetApy($address: String!, $chainId: Int!) {
+      query VaultYield($address: String!, $chainId: Int!) {
         vaultV2ByAddress(address: $address, chainId: $chainId) {
           netApy
+          netApyExcludingRewards
+          performanceFee
+          managementFee
+          rewards {
+            asset { symbol address }
+            supplyApr
+          }
         }
       }
     `;
@@ -271,7 +285,7 @@ var EarnReader = class {
           if (!res.ok) {
             const retryable = res.status === 429 || res.status >= 500;
             throw new HttpError(
-              `earn preview: Morpho API returned ${res.status} \u2014 ${res.statusText}`,
+              `earn: Morpho API returned ${res.status} \u2014 ${res.statusText}`,
               res.status,
               retryable
             );
@@ -283,22 +297,29 @@ var EarnReader = class {
     } catch (err) {
       if (err instanceof TypeError || err instanceof HttpError) {
         throw new StableNetworkError({
-          shortMessage: err instanceof HttpError ? `earn preview: Morpho API returned ${err.status} after retries` : `earn preview: failed to reach Morpho API after retries \u2014 ${String(err)}`,
+          shortMessage: err instanceof HttpError ? `earn: Morpho API returned ${err.status} after retries` : `earn: failed to reach Morpho API after retries \u2014 ${String(err)}`,
           url: MORPHO_API_URL,
           cause: err
         });
       }
       throw err;
     }
-    const netApy = body?.data?.vaultV2ByAddress?.netApy;
-    if (typeof netApy !== "number") {
+    const vault = body?.data?.vaultV2ByAddress;
+    if (!vault || typeof vault.netApy !== "number") {
       throw new StableValidationError(
         "apy",
         void 0,
-        "earn preview: vault not found in Morpho API or unexpected response shape"
+        "earn: vault not found in Morpho API or unexpected response shape"
       );
     }
-    return netApy;
+    const rewards = vault.rewards.filter((r) => typeof r.supplyApr === "number" && r.supplyApr > 0).map((r) => ({ symbol: r.asset.symbol, address: r.asset.address, apr: r.supplyApr }));
+    return {
+      apy: vault.netApy,
+      native: vault.netApyExcludingRewards ?? 0,
+      rewards,
+      performanceFee: vault.performanceFee,
+      managementFee: vault.managementFee
+    };
   }
 };
 
@@ -667,6 +688,7 @@ import {
   createWalletClient as createWalletClient2,
   custom,
   erc20Abi as erc20Abi3,
+  formatUnits as formatUnits3,
   http as http3,
   parseUnits as parseUnits3
 } from "viem";
@@ -695,6 +717,9 @@ var MorphoService = class {
   }
   deposit(params) {
     this._validateAmount(params.amount, "earn deposit");
+    if (params.depositBuffer !== void 0 && (params.depositBuffer <= 0 || params.depositBuffer > 1)) {
+      throw new StableValidationError("depositBuffer", params.depositBuffer, "earn deposit: depositBuffer must be > 0 and \u2264 1");
+    }
     return this._withIdempotency(params.idempotencyKey, () => this._deposit(params));
   }
   async bulkDeposit(items, options = {}) {
@@ -724,6 +749,33 @@ var MorphoService = class {
     };
     return this._withIdempotency(idempotencyKey, run);
   }
+  async bulkWithdraw(items, options = {}) {
+    const { idempotencyKey, stopOnError = false } = options;
+    const run = async () => {
+      const results = [];
+      for (const item of items) {
+        try {
+          const result = await this.withdraw(item);
+          results.push({ status: "fulfilled", txHash: result.txHash, idempotencyKey: item.idempotencyKey });
+        } catch (err) {
+          const entry = { status: "rejected", error: String(err), idempotencyKey: item.idempotencyKey };
+          results.push(entry);
+          if (stopOnError) {
+            const succeeded2 = results.filter((r) => r.status === "fulfilled").length;
+            throw new StableBulkError({
+              shortMessage: "bulkWithdraw halted on first failure",
+              results,
+              succeeded: succeeded2,
+              failed: results.length - succeeded2
+            });
+          }
+        }
+      }
+      const succeeded = results.filter((r) => r.status === "fulfilled").length;
+      return { results, succeeded, failed: results.length - succeeded, idempotencyKey };
+    };
+    return this._withIdempotency(idempotencyKey, run);
+  }
   withdraw(params) {
     this._validateAmount(params.amount, "earn withdraw");
     return this._withIdempotency(params.idempotencyKey, () => this._withdraw(params));
@@ -742,7 +794,7 @@ var MorphoService = class {
   }
   // ─── Private operations ──────────────────────────────────────────────────
   async _deposit(params) {
-    const { amount, tokenDecimals, slippageTolerance, idempotencyKey } = params;
+    const { amount, tokenDecimals, slippageTolerance, idempotencyKey, depositBuffer } = params;
     const from = this._requireFrom();
     const vaultAddr = params.vault ?? this.config.vault;
     await this._switchChain();
@@ -750,6 +802,19 @@ var MorphoService = class {
     const vaultData = await vault.getData();
     const decimals = tokenDecimals ?? await this._resolveDecimals(vaultData.asset, "earn deposit");
     const assetsRaw = parseUnits3(String(amount), decimals);
+    if (depositBuffer !== void 0) {
+      const bps = BigInt(Math.round(depositBuffer * 1e4));
+      const maxAllowed = vaultData.assetBalance * bps / 10000n;
+      if (assetsRaw > maxAllowed) {
+        const maxFormatted = Number(formatUnits3(maxAllowed, decimals));
+        const idleFormatted = Number(formatUnits3(vaultData.assetBalance, decimals));
+        throw new StableValidationError(
+          "amount",
+          amount,
+          `earn deposit: amount ${amount} exceeds deposit buffer \u2014 max ${maxFormatted} (${depositBuffer * 100}% of ${idleFormatted} idle liquidity)`
+        );
+      }
+    }
     const depositAction = vault.deposit({
       amount: assetsRaw,
       userAddress: from,
@@ -1100,6 +1165,7 @@ function createStable({
       deposit: (params) => requireEarn().deposit(params),
       bulkDeposit: (items, options) => requireEarn().bulkDeposit(items, options),
       withdraw: (params) => requireEarn().withdraw(params),
+      bulkWithdraw: (items, options) => requireEarn().bulkWithdraw(items, options),
       redeem: (params) => requireEarn().redeem(params),
       forceWithdraw: (params) => requireEarn().forceWithdraw(params),
       forceRedeem: (params) => requireEarn().forceRedeem(params)
@@ -1110,6 +1176,7 @@ function createStableReader(config) {
   const reader = new EarnReader(config);
   return {
     earn: {
+      getYield: () => reader.getYield(),
       position: () => reader.position(),
       preview: (params) => reader.preview(params),
       withdrawability: (params) => reader.withdrawability(params)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@stablechain/sdk",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "Stable SDK",
     "keywords": ["stable", "usdt", "gasless", "web3", "yield"],
     "license": "MIT",