@stablechain/sdk 1.0.2 → 1.0.4

package/dist/index.js

@@ -1,11 +1,11 @@
 // src/stable.ts
 import {
-  http as http4,
-  createPublicClient as createPublicClient4,
-  createWalletClient as createWalletClient3,
-  erc20Abi as erc20Abi4,
-  isAddress as isAddress3,
-  parseUnits as parseUnits4
+  http as http6,
+  createPublicClient as createPublicClient6,
+  createWalletClient as createWalletClient5,
+  erc20Abi as erc20Abi5,
+  isAddress as isAddress5,
+  parseUnits as parseUnits5
 } from "viem";
 import { stable as stableMainnet2, stableTestnet as stableTestnet2 } from "viem/chains";
 
@@ -126,7 +126,11 @@ var HttpError = class extends Error {
 };
 function isRetryableError(err) {
   if (err instanceof HttpError) return err.retryable;
-  return err instanceof TypeError;
+  if (err instanceof TypeError) {
+    const msg = err.message.toLowerCase();
+    return !(msg.includes("cors") || msg.includes("blocked"));
+  }
+  return false;
 }
 async function retryWithBackoff(fn, isRetryable = isRetryableError, opts = {}) {
   const maxAttempts = opts.maxAttempts ?? 3;
@@ -166,6 +170,7 @@ var MorphoService = class {
       })
     });
     this.morpho = new MorphoClient(morphoWc, { supportSignature: true });
+    this.morphoNoSig = new MorphoClient(morphoWc, { supportSignature: false });
     this.pc = createPublicClient({
       chain: this.chain,
       transport: http(config.rpc)
@@ -303,6 +308,109 @@ var MorphoService = class {
       () => this._forceRedeem(params)
     );
   }
+  // ─── Calldata preparation (no signing) ───────────────────────────────────
+  async prepareDepositCalldata(params) {
+    this._validateAmount(params.amount, "prepareDepositCalldata");
+    if (params.depositBuffer !== void 0 && (params.depositBuffer <= 0 || params.depositBuffer > 1)) {
+      throw new StableValidationError(
+        "depositBuffer",
+        params.depositBuffer,
+        "prepareDepositCalldata: depositBuffer must be > 0 and \u2264 1"
+      );
+    }
+    const { amount, tokenDecimals, slippageTolerance, depositBuffer } = params;
+    const from = this._requireFrom();
+    const vaultAddr = params.vault ?? this.config.vault;
+    const vault = this.morphoNoSig.vaultV2(vaultAddr, this.config.chainId);
+    const vaultData = await vault.getData();
+    const decimals = tokenDecimals ?? await this._resolveDecimals(vaultData.asset, "prepareDepositCalldata");
+    const assetsRaw = parseUnits(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(formatUnits(maxAllowed, decimals));
+        const idleFormatted = Number(formatUnits(vaultData.assetBalance, decimals));
+        throw new StableValidationError(
+          "amount",
+          amount,
+          `prepareDepositCalldata: amount ${amount} exceeds deposit buffer \u2014 max ${maxFormatted} (${depositBuffer * 100}% of ${idleFormatted} idle liquidity)`
+        );
+      }
+    }
+    const depositAction = vault.deposit({
+      amount: assetsRaw,
+      userAddress: from,
+      accrualVault: vaultData,
+      slippageTolerance: slippageTolerance !== void 0 ? parseUnits(String(slippageTolerance), 18) : void 0
+    });
+    const requirements = await depositAction.getRequirements();
+    const steps = [];
+    for (const req of requirements) {
+      if (isRequirementApproval(req)) {
+        steps.push({ to: req.to, data: req.data, value: req.value });
+      }
+    }
+    const tx = depositAction.buildTx(void 0);
+    steps.push({ to: tx.to, data: tx.data, value: tx.value });
+    return { steps, chainId: this.config.chainId };
+  }
+  async prepareWithdrawCalldata(params) {
+    this._validateAmount(params.amount, "prepareWithdrawCalldata");
+    const { amount, tokenDecimals } = params;
+    const from = this._requireFrom();
+    const vaultAddr = this.config.vault;
+    const vault = this.morpho.vaultV2(vaultAddr, this.config.chainId);
+    const vaultData = await vault.getData();
+    const decimals = tokenDecimals ?? await this._resolveDecimals(vaultData.asset, "prepareWithdrawCalldata");
+    const assetsRaw = parseUnits(String(amount), decimals);
+    const tx = vaultData.assetBalance >= assetsRaw ? vault.withdraw({ amount: assetsRaw, userAddress: from }).buildTx() : vault.forceWithdraw({
+      deallocations: this._buildAutoDeallocs(
+        vaultData.accrualAdapters,
+        assetsRaw - vaultData.assetBalance,
+        amount
+      ),
+      withdraw: { amount: assetsRaw },
+      userAddress: from
+    }).buildTx();
+    return { to: tx.to, data: tx.data, value: tx.value, chainId: this.config.chainId };
+  }
+  async prepareRedeemCalldata(params) {
+    this._validateShares(params.shares, "prepareRedeemCalldata");
+    const { shares, shareDecimals } = params;
+    const from = this._requireFrom();
+    const vaultAddr = this.config.vault;
+    let decimals = shareDecimals;
+    if (decimals === void 0) {
+      try {
+        decimals = await this.pc.readContract({
+          address: vaultAddr,
+          abi: erc20Abi,
+          functionName: "decimals"
+        });
+      } catch {
+        throw new StableValidationError(
+          "shareDecimals",
+          void 0,
+          `prepareRedeemCalldata: could not fetch share decimals for vault "${vaultAddr}" \u2014 pass shareDecimals explicitly`
+        );
+      }
+    }
+    const sharesRaw = parseUnits(String(shares), decimals);
+    const vault = this.morpho.vaultV2(vaultAddr, this.config.chainId);
+    const vaultData = await vault.getData();
+    const assetsEquivalent = vaultData.toAssets(sharesRaw);
+    const tx = vaultData.assetBalance >= assetsEquivalent ? vault.redeem({ shares: sharesRaw, userAddress: from }).buildTx() : vault.forceRedeem({
+      deallocations: this._buildAutoDeallocs(
+        vaultData.accrualAdapters,
+        assetsEquivalent - vaultData.assetBalance,
+        shares
+      ),
+      redeem: { shares: sharesRaw },
+      userAddress: from
+    }).buildTx();
+    return { to: tx.to, data: tx.data, value: tx.value, chainId: this.config.chainId };
+  }
   // ─── Private operations ──────────────────────────────────────────────────
   async _deposit(params) {
     const {
@@ -390,7 +498,15 @@ var MorphoService = class {
     const vaultData = await vault.getData();
     const decimals = tokenDecimals ?? await this._resolveDecimals(vaultData.asset, "earn withdraw");
     const assetsRaw = parseUnits(String(amount), decimals);
-    const tx = vault.withdraw({ amount: assetsRaw, userAddress: from }).buildTx();
+    const tx = vaultData.assetBalance >= assetsRaw ? vault.withdraw({ amount: assetsRaw, userAddress: from }).buildTx() : vault.forceWithdraw({
+      deallocations: this._buildAutoDeallocs(
+        vaultData.accrualAdapters,
+        assetsRaw - vaultData.assetBalance,
+        amount
+      ),
+      withdraw: { amount: assetsRaw },
+      userAddress: from
+    }).buildTx();
     const hash = await this._sendTx(tx.to, tx.data, tx.value, from);
     const receipt = await this.pc.waitForTransactionReceipt({ hash });
     if (receipt.status === "reverted") {
@@ -426,7 +542,17 @@ var MorphoService = class {
     }
     const sharesRaw = parseUnits(String(shares), decimals);
     const vault = this.morpho.vaultV2(vaultAddr, this.config.chainId);
-    const tx = vault.redeem({ shares: sharesRaw, userAddress: from }).buildTx();
+    const vaultData = await vault.getData();
+    const assetsEquivalent = vaultData.toAssets(sharesRaw);
+    const tx = vaultData.assetBalance >= assetsEquivalent ? vault.redeem({ shares: sharesRaw, userAddress: from }).buildTx() : vault.forceRedeem({
+      deallocations: this._buildAutoDeallocs(
+        vaultData.accrualAdapters,
+        assetsEquivalent - vaultData.assetBalance,
+        shares
+      ),
+      redeem: { shares: sharesRaw },
+      userAddress: from
+    }).buildTx();
     const hash = await this._sendTx(tx.to, tx.data, tx.value, from);
     const receipt = await this.pc.waitForTransactionReceipt({ hash });
     if (receipt.status === "reverted") {
@@ -523,6 +649,51 @@ var MorphoService = class {
     }
     return { txHash: receipt.transactionHash, idempotencyKey };
   }
+  // Automatically derives the minimum set of adapter deallocations needed to cover `deficit`
+  // when the vault has insufficient idle cash for a direct withdraw/redeem. Adds a 0.5%
+  // buffer to account for interest accrual between vaultData read and tx execution.
+  _buildAutoDeallocs(adapters, deficit, amount) {
+    const needed = deficit + deficit * 50n / 10000n;
+    const now = BigInt(Math.floor(Date.now() / 1e3));
+    const result = [];
+    let remaining = needed;
+    for (const adapter of adapters) {
+      if (remaining === 0n) break;
+      remaining = this._pullFromAdapter(adapter, remaining, now, result);
+    }
+    if (remaining > 0n) {
+      throw new StableValidationError(
+        "amount",
+        amount,
+        "earn withdraw: insufficient adapter liquidity \u2014 reduce the amount or wait for market liquidity to free up"
+      );
+    }
+    return result;
+  }
+  _pullFromAdapter(adapter, remaining, now, result) {
+    if (adapter.type !== "VaultV2MorphoMarketV1AdapterV2") {
+      const available = adapter.realAssets(now);
+      if (available === 0n) return remaining;
+      const pull = available < remaining ? available : remaining;
+      result.push({ adapter: adapter.address, amount: pull });
+      return remaining - pull;
+    }
+    const a = adapter;
+    return this._pullFromV2Markets(adapter.address, a.markets, a.supplyShares, remaining, result);
+  }
+  _pullFromV2Markets(adapterAddress, markets, supplyShares, remaining, result) {
+    let rem = remaining;
+    for (const mkt of markets) {
+      if (rem === 0n) break;
+      const adapterShares = supplyShares[mkt.id] ?? 0n;
+      const available = mkt.totalSupplyShares > 0n ? adapterShares * mkt.totalSupplyAssets / mkt.totalSupplyShares : 0n;
+      if (available === 0n) continue;
+      const pull = available < rem ? available : rem;
+      result.push({ adapter: adapterAddress, marketParams: mkt.params, amount: pull });
+      rem -= pull;
+    }
+    return rem;
+  }
   _buildDeallocs(deallocations, assetDecimals) {
     return deallocations.map((d) => ({
       adapter: d.adapter,
@@ -636,19 +807,19 @@ import {
 import { stable as stableMainnet, stableTestnet } from "viem/chains";
 
 // src/types.ts
-var Chain = /* @__PURE__ */ ((Chain2) => {
-  Chain2["Sepolia"] = "sepolia";
-  Chain2["StableTestnet"] = "stable-testnet";
-  Chain2["Stable"] = "stable";
-  Chain2["Ethereum"] = "ethereum";
-  Chain2["Arbitrum"] = "arbitrum";
-  Chain2["Ink"] = "ink";
-  Chain2["Bera"] = "bera";
-  Chain2["MegaETH"] = "megaeth";
-  Chain2["Base"] = "base";
-  Chain2["BSC"] = "bsc";
-  Chain2["HyperEVM"] = "hyperevm";
-  return Chain2;
+var Chain = /* @__PURE__ */ ((Chain3) => {
+  Chain3["Sepolia"] = "sepolia";
+  Chain3["StableTestnet"] = "stable-testnet";
+  Chain3["Stable"] = "stable";
+  Chain3["Ethereum"] = "ethereum";
+  Chain3["Arbitrum"] = "arbitrum";
+  Chain3["Ink"] = "ink";
+  Chain3["Bera"] = "bera";
+  Chain3["MegaETH"] = "megaeth";
+  Chain3["Base"] = "base";
+  Chain3["BSC"] = "bsc";
+  Chain3["HyperEVM"] = "hyperevm";
+  return Chain3;
 })(Chain || {});
 var Network = /* @__PURE__ */ ((Network2) => {
   Network2["Mainnet"] = "mainnet";
@@ -843,14 +1014,241 @@ var EarnReader = class {
   }
 };
 
-// src/services/lifi.ts
+// src/earn/merkl.ts
 import {
   http as http3,
   createPublicClient as createPublicClient3,
   createWalletClient as createWalletClient2,
-  erc20Abi as erc20Abi3,
+  encodeFunctionData,
   formatUnits as formatUnits3,
-  isAddress as isAddress2,
+  isAddress as isAddress2
+} from "viem";
+var MERKL_API_BASE_DEFAULT = "https://api.merkl.xyz";
+var DISTRIBUTOR_ADDRESS = "0x3Ef3D8bA38EBe18DB133cEc108f4D14CE00Dd9Ae";
+var DISTRIBUTOR_ABI = [
+  {
+    inputs: [
+      { name: "users", type: "address[]" },
+      { name: "tokens", type: "address[]" },
+      { name: "amounts", type: "uint256[]" },
+      { name: "proofs", type: "bytes32[][]" }
+    ],
+    name: "claim",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+];
+var MerklService = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async fetchRewards(address) {
+    if (!isAddress2(address)) {
+      throw new StableValidationError(
+        "address",
+        address,
+        `merkl: invalid address "${address}"`
+      );
+    }
+    const base = (this.config.merklApiBase ?? MERKL_API_BASE_DEFAULT).replace(/\/$/, "");
+    const url = `${base}/v4/users/${address}/rewards?chainId=${this.config.chainId}`;
+    const data = await this._fetch(url);
+    return this._parseRewards(data);
+  }
+  async claim() {
+    const address = this._requireFrom();
+    const { rewards } = await this.fetchRewards(address);
+    const claimable = rewards.filter(
+      (r) => r.rawAmount !== "0" && r.proofs.length > 0
+    );
+    if (claimable.length === 0) {
+      throw new StableValidationError(
+        "rewards",
+        [],
+        rewards.length > 0 ? "merkl: rewards are pending the next merkle tree update \u2014 try again in ~2 hours" : "merkl: no rewards to claim on this chain"
+      );
+    }
+    const chain = makeChain(this.config.chainId, this.config.rpc);
+    const wc = this.config.walletClient ?? createWalletClient2({
+      account: this.config.account,
+      chain,
+      transport: this.config.transport ?? http3(this.config.rpc)
+    });
+    try {
+      await wc.switchChain({ id: this.config.chainId });
+    } catch (err) {
+      throw new StableTransactionError({
+        phase: "switch_chain",
+        shortMessage: `merkl: wallet rejected or failed to switch to chain ${this.config.chainId}`,
+        chainId: this.config.chainId,
+        cause: err
+      });
+    }
+    const users = claimable.map(() => address);
+    const tokens = claimable.map(
+      (r) => r.token.address
+    );
+    const amounts = claimable.map((r) => BigInt(r.rawAmount));
+    const proofs = claimable.map((r) => r.proofs);
+    let hash;
+    try {
+      hash = await wc.writeContract({
+        address: DISTRIBUTOR_ADDRESS,
+        abi: DISTRIBUTOR_ABI,
+        functionName: "claim",
+        args: [users, tokens, amounts, proofs],
+        account: wc.account,
+        chain
+      });
+    } catch (err) {
+      throw new StableTransactionError({
+        phase: "send",
+        shortMessage: "merkl: claim transaction failed",
+        chainId: this.config.chainId,
+        cause: err
+      });
+    }
+    const pc = createPublicClient3({
+      chain,
+      transport: http3(this.config.rpc)
+    });
+    const receipt = await pc.waitForTransactionReceipt({ hash });
+    if (receipt.status === "reverted") {
+      throw new StableTransactionError({
+        phase: "receipt",
+        shortMessage: "merkl: claim transaction reverted on-chain",
+        txHash: receipt.transactionHash,
+        chainId: this.config.chainId
+      });
+    }
+    return {
+      txHash: receipt.transactionHash,
+      tokenCount: claimable.length
+    };
+  }
+  async prepareClaimCalldata(address) {
+    if (!isAddress2(address)) {
+      throw new StableValidationError(
+        "address",
+        address,
+        `merkl: invalid address "${address}"`
+      );
+    }
+    const { rewards } = await this.fetchRewards(address);
+    const claimable = rewards.filter(
+      (r) => r.rawAmount !== "0" && r.proofs.length > 0
+    );
+    if (claimable.length === 0) {
+      throw new StableValidationError(
+        "rewards",
+        [],
+        rewards.length > 0 ? "merkl: rewards are pending the next merkle tree update \u2014 try again in ~2 hours" : "merkl: no rewards to claim on this chain"
+      );
+    }
+    const users = claimable.map(() => address);
+    const tokens = claimable.map((r) => r.token.address);
+    const amounts = claimable.map((r) => BigInt(r.rawAmount));
+    const proofs = claimable.map((r) => r.proofs);
+    const data = encodeFunctionData({
+      abi: DISTRIBUTOR_ABI,
+      functionName: "claim",
+      args: [users, tokens, amounts, proofs]
+    });
+    return {
+      to: DISTRIBUTOR_ADDRESS,
+      data,
+      chainId: this.config.chainId,
+      rewards: claimable
+    };
+  }
+  _requireFrom() {
+    const from = this.config.walletClient?.account?.address ?? this.config.account?.address;
+    if (!from) {
+      throw new StableValidationError(
+        "signer",
+        void 0,
+        "merkl.claim: requires a signer \u2014 set walletClient or account in StableConfig"
+      );
+    }
+    return from;
+  }
+  _parseRewards(data) {
+    const { chainId } = this.config;
+    const rewards = [];
+    const entries = Array.isArray(data) ? data : [data];
+    for (const entry of entries) {
+      if (entry?.chain?.id !== chainId) continue;
+      for (const reward of entry.rewards ?? []) {
+        const parsed = this._parseReward(reward);
+        if (parsed) rewards.push(parsed);
+      }
+    }
+    return { chainId, rewards };
+  }
+  _parseReward(reward) {
+    if (!reward?.token?.address) return null;
+    const net = BigInt(reward.amount ?? "0") - BigInt(reward.claimed ?? "0");
+    if (net <= 0n) return null;
+    const rawAmount = net.toString();
+    const decimals = reward.token.decimals ?? 18;
+    return {
+      token: {
+        address: reward.token.address,
+        symbol: reward.token.symbol ?? "",
+        decimals
+      },
+      rawAmount,
+      amount: Number(formatUnits3(BigInt(rawAmount), decimals)),
+      proofs: reward.proofs ?? []
+    };
+  }
+  async _fetch(url) {
+    try {
+      return await retryWithBackoff(() => this._fetchOnce(url));
+    } catch (err) {
+      if (err instanceof StableNetworkError) throw err;
+      if (err instanceof HttpError) {
+        throw new StableNetworkError({
+          shortMessage: `merkl: request failed \u2014 ${err.message}`,
+          url,
+          cause: err
+        });
+      }
+      throw new StableNetworkError({
+        shortMessage: "merkl: request failed before reaching the server",
+        url,
+        cause: err
+      });
+    }
+  }
+  async _fetchOnce(url) {
+    const res = await fetch(url);
+    if (!res.ok) {
+      if (res.status === 429 || res.status >= 500) {
+        throw new HttpError(
+          `merkl: ${res.statusText}`,
+          res.status,
+          true
+        );
+      }
+      throw new StableNetworkError({
+        shortMessage: `merkl: API error ${res.status} ${res.statusText}`,
+        url
+      });
+    }
+    return res.json();
+  }
+};
+
+// src/services/lifi.ts
+import {
+  http as http4,
+  createPublicClient as createPublicClient4,
+  createWalletClient as createWalletClient3,
+  erc20Abi as erc20Abi3,
+  formatUnits as formatUnits4,
+  isAddress as isAddress3,
   parseUnits as parseUnits3
 } from "viem";
 
@@ -1055,14 +1453,14 @@ var LiFiService = class {
     amount,
     toAddress
   }) {
-    if (!isAddress2(fromToken)) {
+    if (!isAddress3(fromToken)) {
       throw new StableValidationError(
         "fromToken",
         fromToken,
         `swap: invalid fromToken address "${fromToken}"`
       );
     }
-    if (!isAddress2(toToken)) {
+    if (!isAddress3(toToken)) {
       throw new StableValidationError(
         "toToken",
         toToken,
@@ -1083,7 +1481,7 @@ var LiFiService = class {
         "swap: amount must be a finite positive number"
       );
     }
-    if (toAddress !== void 0 && !isAddress2(toAddress)) {
+    if (toAddress !== void 0 && !isAddress3(toAddress)) {
       throw new StableValidationError(
         "toAddress",
         toAddress,
@@ -1099,14 +1497,14 @@ var LiFiService = class {
     amount,
     recipient
   }) {
-    if (!isAddress2(fromToken)) {
+    if (!isAddress3(fromToken)) {
       throw new StableValidationError(
         "fromToken",
         fromToken,
         `LI.FI bridge: invalid fromToken address "${fromToken}"`
       );
     }
-    if (!isAddress2(toToken)) {
+    if (!isAddress3(toToken)) {
       throw new StableValidationError(
         "toToken",
         toToken,
@@ -1120,7 +1518,7 @@ var LiFiService = class {
         "LI.FI bridge: amount must be a finite positive number"
       );
     }
-    if (recipient !== void 0 && !isAddress2(recipient)) {
+    if (recipient !== void 0 && !isAddress3(recipient)) {
       throw new StableValidationError(
         "recipient",
         recipient,
@@ -1201,7 +1599,7 @@ var LiFiService = class {
   _toSwapQuote(quote) {
     return {
       toAmount: Number(
-        formatUnits3(
+        formatUnits4(
           BigInt(quote.estimate.toAmount),
           quote.action.toToken.decimals
         )
@@ -1225,10 +1623,10 @@ var LiFiService = class {
       });
     }
     const srcChain = makeChain(srcChainId, srcRpc);
-    const wc = this.config.walletClient ?? createWalletClient2({
+    const wc = this.config.walletClient ?? createWalletClient3({
       account: this.config.account,
       chain: srcChain,
-      transport: this.config.transport ?? http3(srcRpc)
+      transport: this.config.transport ?? http4(srcRpc)
     });
     try {
       await wc.switchChain({ id: srcChainId });
@@ -1272,9 +1670,9 @@ var LiFiService = class {
     const tokenAddr = quote.fromToken;
     const isNative = tokenAddr.toLowerCase() === "0x0000000000000000000000000000000000000000" || tokenAddr.toLowerCase() === "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
     if (isNative || !quote.approvalAddress) return;
-    const pc = createPublicClient3({
+    const pc = createPublicClient4({
       chain: srcChain,
-      transport: http3(srcRpc)
+      transport: http4(srcRpc)
     });
     const allowance = await pc.readContract({
       address: tokenAddr,
@@ -1325,14 +1723,311 @@ function isLiFiQuoteShape(v) {
   return isObject(tx) && typeof tx.to === "string" && typeof tx.data === "string" && typeof tx.chainId === "number" && isObject(est) && typeof est.fromAmount === "string" && typeof est.toAmount === "string" && isObject(act) && isObject(act.fromToken) && isObject(act.toToken);
 }
 
+// src/services/layerzero.ts
+import {
+  concat,
+  createPublicClient as createPublicClient5,
+  createWalletClient as createWalletClient4,
+  erc20Abi as erc20Abi4,
+  http as http5,
+  isAddress as isAddress4,
+  numberToHex,
+  padHex,
+  parseUnits as parseUnits4
+} from "viem";
+var C = CHAIN_CONFIGS;
+var BRIDGE_CHAIN_CONFIGS = {
+  // ─── Testnet ───────────────────────────────────────────────────────────────
+  ["sepolia" /* Sepolia */]: { ...C["sepolia" /* Sepolia */], lzEid: 40161, oftAdapter: "0xc099cD946d5efCC35A99D64E808c1430cEf08126" },
+  ["stable-testnet" /* StableTestnet */]: { ...C["stable-testnet" /* StableTestnet */], lzEid: 40374, oftAdapter: "0x779Ded0c9e1022225f8E0630b35a9b54bE713736" },
+  // ─── Mainnet ──────────────────────────────────────────────────────────────
+  ["stable" /* Stable */]: { ...C["stable" /* Stable */], lzEid: 30396, oftAdapter: "0xedaba024be4d87974d5aB11C6Dd586963CcCB027" },
+  ["ethereum" /* Ethereum */]: { ...C["ethereum" /* Ethereum */], lzEid: 30101, oftAdapter: "0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee" },
+  ["arbitrum" /* Arbitrum */]: { ...C["arbitrum" /* Arbitrum */], lzEid: 30110, oftAdapter: "0x14E4A1B13bf7F943c8ff7C51fb60FA964A298D92" },
+  ["ink" /* Ink */]: { ...C["ink" /* Ink */], lzEid: 30339, oftAdapter: "0x1cB6De532588fCA4a21B7209DE7C456AF8434A65" },
+  ["bera" /* Bera */]: { ...C["bera" /* Bera */], lzEid: 30362, oftAdapter: "0x3Dc96399109df5ceb2C226664A086140bD0379cB" },
+  ["megaeth" /* MegaETH */]: { ...C["megaeth" /* MegaETH */], lzEid: 30398, oftAdapter: "0x9151434b16b9763660705744891fa906f660ecc5" },
+  ["hyperevm" /* HyperEVM */]: { ...C["hyperevm" /* HyperEVM */], lzEid: 30367, oftAdapter: "0x904861a24F30EC96ea7CFC3bE9EA4B476d237e98" }
+};
+var OFT_ADAPTER_ABI = [
+  {
+    name: "quoteSend",
+    type: "function",
+    inputs: [
+      {
+        name: "_sendParam",
+        type: "tuple",
+        components: [
+          { name: "dstEid", type: "uint32" },
+          { name: "to", type: "bytes32" },
+          { name: "amountLD", type: "uint256" },
+          { name: "minAmountLD", type: "uint256" },
+          { name: "extraOptions", type: "bytes" },
+          { name: "composeMsg", type: "bytes" },
+          { name: "oftCmd", type: "bytes" }
+        ]
+      },
+      { name: "_payInLzToken", type: "bool" }
+    ],
+    outputs: [
+      {
+        name: "msgFee",
+        type: "tuple",
+        components: [
+          { name: "nativeFee", type: "uint256" },
+          { name: "lzTokenFee", type: "uint256" }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  },
+  {
+    name: "send",
+    type: "function",
+    inputs: [
+      {
+        name: "_sendParam",
+        type: "tuple",
+        components: [
+          { name: "dstEid", type: "uint32" },
+          { name: "to", type: "bytes32" },
+          { name: "amountLD", type: "uint256" },
+          { name: "minAmountLD", type: "uint256" },
+          { name: "extraOptions", type: "bytes" },
+          { name: "composeMsg", type: "bytes" },
+          { name: "oftCmd", type: "bytes" }
+        ]
+      },
+      {
+        name: "_fee",
+        type: "tuple",
+        components: [
+          { name: "nativeFee", type: "uint256" },
+          { name: "lzTokenFee", type: "uint256" }
+        ]
+      },
+      { name: "_refundAddress", type: "address" }
+    ],
+    outputs: [],
+    stateMutability: "payable"
+  }
+];
+function buildLzOptions(gasLimit = 0n) {
+  return concat([
+    numberToHex(3, { size: 2 }),
+    // TYPE_3 header
+    numberToHex(1, { size: 1 }),
+    // Executor worker ID
+    numberToHex(17, { size: 2 }),
+    // option payload length = 17 bytes
+    numberToHex(1, { size: 1 }),
+    // LzReceive option type
+    numberToHex(gasLimit, { size: 16 })
+    // gas limit as uint128
+  ]);
+}
+var LayerZeroService = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async quoteBridge({ fromChain, toChain, fromToken, toToken, amount, recipient }) {
+    const recipientAddr = recipient ?? "0x0000000000000000000000000000000000000000";
+    this.validateBridgeParams({ fromChain, toChain, amount, recipient: recipientAddr }, "quoteBridge");
+    const { src, dst } = this.resolveChains(fromChain, toChain, fromToken, toToken);
+    const oftAdapter = src.oftAdapter;
+    const amountLD = parseUnits4(String(amount), src.decimals);
+    try {
+      const { nativeFee, lzTokenFee } = await createPublicClient5({
+        chain: makeChain(src.id, src.rpc),
+        transport: http5(src.rpc)
+      }).readContract({
+        address: oftAdapter,
+        abi: OFT_ADAPTER_ABI,
+        functionName: "quoteSend",
+        args: [this.buildSendParams(dst, amountLD, recipientAddr), false]
+      });
+      return { nativeFee, lzTokenFee, toAmount: amount };
+    } catch (err) {
+      throw new StableQuoteError({
+        provider: "layerzero",
+        shortMessage: "quoteBridge: quoteSend call failed",
+        cause: err
+      });
+    }
+  }
+  async bridge({ fromChain, toChain, fromToken, toToken, amount, recipient, quote }) {
+    const from = this.config.walletClient?.account?.address ?? this.config.account?.address;
+    if (!from) {
+      throw new StableValidationError(
+        "signer",
+        void 0,
+        "bridge: requires a signer \u2014 set walletClient or account in StableConfig"
+      );
+    }
+    const recipientAddr = recipient ?? from;
+    this.validateBridgeParams({ fromChain, toChain, amount, recipient: recipientAddr }, "bridge");
+    const { src, dst } = this.resolveChains(fromChain, toChain, fromToken, toToken);
+    const oftAdapter = src.oftAdapter;
+    const srcChain = makeChain(src.id, src.rpc);
+    const wc = this.config.walletClient ?? createWalletClient4({
+      account: this.config.account,
+      chain: srcChain,
+      transport: this.config.transport ?? http5(src.rpc)
+    });
+    const pc = createPublicClient5({ chain: srcChain, transport: http5(src.rpc) });
+    try {
+      await wc.switchChain({ id: src.id });
+    } catch (err) {
+      throw new StableTransactionError({
+        phase: "switch_chain",
+        shortMessage: `bridge: wallet rejected or failed to switch to chain ${src.id}`,
+        chainId: src.id,
+        cause: err
+      });
+    }
+    const amountLD = parseUnits4(String(amount), src.decimals);
+    const sendParams = this.buildSendParams(dst, amountLD, recipientAddr);
+    const lzFee = quote?.nativeFee !== void 0 && quote?.lzTokenFee !== void 0 ? { nativeFee: quote.nativeFee, lzTokenFee: quote.lzTokenFee } : await this.quoteBridge({ fromChain, toChain, fromToken, toToken, amount, recipient: recipientAddr });
+    const { nativeFee = 0n, lzTokenFee = 0n } = lzFee;
+    const allowance = await pc.readContract({
+      address: src.usdt,
+      abi: erc20Abi4,
+      functionName: "allowance",
+      args: [from, oftAdapter]
+    });
+    if (allowance < amountLD) {
+      let approveHash;
+      try {
+        approveHash = await wc.writeContract({
+          address: src.usdt,
+          abi: erc20Abi4,
+          functionName: "approve",
+          args: [oftAdapter, amountLD],
+          account: wc.account,
+          chain: srcChain
+        });
+      } catch (err) {
+        throw new StableTransactionError({
+          phase: "approve",
+          shortMessage: "bridge: USDT0 approve failed",
+          chainId: src.id,
+          cause: err
+        });
+      }
+      const approveReceipt = await pc.waitForTransactionReceipt({ hash: approveHash });
+      if (approveReceipt.status === "reverted") {
+        throw new StableTransactionError({
+          phase: "approve",
+          shortMessage: "bridge: USDT0 approve reverted on-chain",
+          txHash: approveReceipt.transactionHash,
+          chainId: src.id
+        });
+      }
+    }
+    try {
+      const hash = await wc.writeContract({
+        address: oftAdapter,
+        abi: OFT_ADAPTER_ABI,
+        functionName: "send",
+        args: [sendParams, { nativeFee, lzTokenFee }, from],
+        value: nativeFee,
+        account: wc.account,
+        chain: srcChain
+      });
+      return { txHash: hash, toAmount: amount };
+    } catch (err) {
+      throw new StableTransactionError({
+        phase: "send",
+        shortMessage: "bridge: OFT send failed",
+        chainId: src.id,
+        cause: err
+      });
+    }
+  }
+  validateBridgeParams(params, method) {
+    if (!isAddress4(params.recipient)) {
+      throw new StableValidationError(
+        "recipient",
+        params.recipient,
+        `${method}: invalid recipient address "${params.recipient}"`
+      );
+    }
+    if (!Number.isFinite(params.amount) || params.amount <= 0) {
+      throw new StableValidationError(
+        "amount",
+        params.amount,
+        `${method}: amount must be a finite positive number`
+      );
+    }
+    if (params.fromChain === params.toChain) {
+      throw new StableValidationError(
+        "toChain",
+        params.toChain,
+        `${method}: fromChain and toChain must differ`
+      );
+    }
+  }
+  resolveChains(fromChain, toChain, fromToken, toToken) {
+    const src = BRIDGE_CHAIN_CONFIGS[fromChain];
+    const dst = BRIDGE_CHAIN_CONFIGS[toChain];
+    if (!src) throw new StableValidationError("fromChain", fromChain, `Unsupported source chain: "${fromChain}"`);
+    if (!dst) throw new StableValidationError("toChain", toChain, `Unsupported destination chain: "${toChain}"`);
+    if (!src.oftAdapter) {
+      throw new StableValidationError("fromChain", fromChain, `No OFT adapter configured for "${fromChain}"`);
+    }
+    if (fromToken.toLowerCase() !== src.usdt.toLowerCase()) {
+      throw new StableValidationError(
+        "fromToken",
+        fromToken,
+        `USDT0 bridge only moves USDT0 \u2014 fromToken must be ${src.usdt} on "${fromChain}", got "${fromToken}". Use route "lifi" to bridge other tokens.`
+      );
+    }
+    if (toToken.toLowerCase() !== dst.usdt.toLowerCase()) {
+      throw new StableValidationError(
+        "toToken",
+        toToken,
+        `USDT0 bridge only moves USDT0 \u2014 toToken must be ${dst.usdt} on "${toChain}", got "${toToken}". Use route "lifi" to bridge other tokens.`
+      );
+    }
+    return { src, dst };
+  }
+  buildSendParams(dst, amountLD, recipient) {
+    return {
+      dstEid: dst.lzEid,
+      to: padHex(recipient, { dir: "left", size: 32 }),
+      amountLD,
+      minAmountLD: amountLD,
+      extraOptions: buildLzOptions(),
+      composeMsg: "0x",
+      oftCmd: "0x"
+    };
+  }
+};
+
 // src/stable.ts
+function isUsdt0Route(fromChain, toChain, fromToken, toToken) {
+  const src = BRIDGE_CHAIN_CONFIGS[fromChain];
+  const dst = BRIDGE_CHAIN_CONFIGS[toChain];
+  return !!src && !!dst && !!src.oftAdapter && src.lzOutbound !== false && src.usdt.toLowerCase() === fromToken.toLowerCase() && dst.usdt.toLowerCase() === toToken.toLowerCase();
+}
+function selectBridge(params) {
+  const route = params.route ?? "auto";
+  if (route === "usdt0") return "usdt0";
+  if (route === "lifi") return "lifi";
+  return isUsdt0Route(
+    params.fromChain,
+    params.toChain,
+    params.fromToken,
+    params.toToken
+  ) ? "usdt0" : "lifi";
+}
 function validateTransferParams({
   to,
   amount,
   token,
   tokenDecimals
 }) {
-  if (!isAddress3(to)) {
+  if (!isAddress5(to)) {
     throw new StableValidationError(
       "to",
       to,
@@ -1346,7 +2041,7 @@ function validateTransferParams({
       "transfer: amount must be a finite positive number"
     );
   }
-  if (token !== void 0 && !isAddress3(token)) {
+  if (token !== void 0 && !isAddress5(token)) {
     throw new StableValidationError(
       "token",
       token,
@@ -1366,7 +2061,7 @@ async function resolveTokenDecimals(publicClient, token, tokenDecimals) {
   try {
     return await publicClient.readContract({
       address: token,
-      abi: erc20Abi4,
+      abi: erc20Abi5,
       functionName: "decimals"
     });
   } catch {
@@ -1393,9 +2088,9 @@ async function executeTokenTransfer(wc, publicClient, token, to, amount, tokenDe
   );
   return wc.writeContract({
     address: token,
-    abi: erc20Abi4,
+    abi: erc20Abi5,
     functionName: "transfer",
-    args: [to, parseUnits4(String(amount), decimals)],
+    args: [to, parseUnits5(String(amount), decimals)],
     account: acc,
     chain
   });
@@ -1406,7 +2101,8 @@ function createStable({
   account,
   transport,
   walletClient,
-  earn: earnConfig
+  earn: earnConfig,
+  merklApiBase
 }) {
   const chain = network === "mainnet" /* Mainnet */ ? stableMainnet2 : stableTestnet2;
   const rpc = (rpcOverride ?? chain.rpcUrls.default.http[0]).replace(
@@ -1415,6 +2111,8 @@ function createStable({
   );
   const signerConfig = { account, transport, walletClient };
   const lifi = new LiFiService({ ...signerConfig, rpc, chainId: chain.id });
+  const lz = new LayerZeroService(signerConfig);
+  const merkl = new MerklService({ ...signerConfig, rpc, chainId: chain.id, merklApiBase });
   const morpho = earnConfig ? new MorphoService({
     ...signerConfig,
     rpc,
@@ -1431,14 +2129,25 @@ function createStable({
     }
     return morpho;
   }
+  function requireSignerAddress() {
+    const from = walletClient?.account?.address ?? account?.address;
+    if (!from) {
+      throw new StableValidationError(
+        "signer",
+        void 0,
+        "stable.rewards.*: requires a signer \u2014 set walletClient or account in StableConfig"
+      );
+    }
+    return from;
+  }
   async function transfer(params) {
     validateTransferParams(params);
     const { from, to, amount, token, tokenDecimals } = params;
     const acc = walletClient?.account ?? account ?? from;
-    const wc = walletClient ?? createWalletClient3({
+    const wc = walletClient ?? createWalletClient5({
       account: acc,
       chain,
-      transport: transport ?? http4(rpc)
+      transport: transport ?? http6(rpc)
     });
     try {
       await wc.switchChain({ id: chain.id });
@@ -1450,9 +2159,9 @@ function createStable({
         cause: err
       });
     }
-    const publicClient = createPublicClient4({
+    const publicClient = createPublicClient6({
       chain,
-      transport: http4(rpc)
+      transport: http6(rpc)
     });
     const hash = token !== void 0 ? await executeTokenTransfer(
       wc,
@@ -1470,7 +2179,7 @@ function createStable({
         account: acc,
         chain,
         to,
-        value: parseUnits4(String(amount), 18)
+        value: parseUnits5(String(amount), 18)
       })
     );
     const receipt = await publicClient.waitForTransactionReceipt({ hash });
@@ -1486,8 +2195,8 @@ function createStable({
   }
   return {
     transfer,
-    quoteBridge: (params) => lifi.quoteBridge(params),
-    bridge: (params) => lifi.bridge(params),
+    quoteBridge: (params) => selectBridge(params) === "usdt0" ? lz.quoteBridge(params) : lifi.quoteBridge(params),
+    bridge: (params) => selectBridge(params) === "usdt0" ? lz.bridge(params) : lifi.bridge(params),
     quoteSwap: (params) => lifi.quoteSwap(params),
     swap: (params) => lifi.swap(params),
     earn: {
@@ -1497,26 +2206,40 @@ function createStable({
       bulkWithdraw: (items, options) => requireEarn().bulkWithdraw(items, options),
       redeem: (params) => requireEarn().redeem(params),
       forceWithdraw: (params) => requireEarn().forceWithdraw(params),
-      forceRedeem: (params) => requireEarn().forceRedeem(params)
+      forceRedeem: (params) => requireEarn().forceRedeem(params),
+      prepareDepositCalldata: (params) => requireEarn().prepareDepositCalldata(params),
+      prepareWithdrawCalldata: (params) => requireEarn().prepareWithdrawCalldata(params),
+      prepareRedeemCalldata: (params) => requireEarn().prepareRedeemCalldata(params),
+      incentiveRewards: {
+        fetch: () => merkl.fetchRewards(requireSignerAddress()),
+        claim: () => merkl.claim()
+      }
     }
   };
 }
 function createStableReader(config) {
   const reader = new EarnReader(config);
+  const chain = config.network === "testnet" /* Testnet */ ? stableTestnet2 : stableMainnet2;
+  const rpc = (config.rpc ?? chain.rpcUrls.default.http[0]).replace(/\/$/, "");
+  const merkl = new MerklService({ chainId: chain.id, rpc, merklApiBase: config.merklApiBase });
   return {
     earn: {
       getYield: () => reader.getYield(),
       position: () => reader.position(),
       preview: (params) => reader.preview(params),
-      withdrawability: (params) => reader.withdrawability(params)
+      withdrawability: (params) => reader.withdrawability(params),
+      incentiveRewards: {
+        fetch: () => merkl.fetchRewards(config.address)
+      }
     }
   };
 }
 
 // src/constants.ts
 var STABLE_USDT_ADDRESS = "0x779ded0c9e1022225f8e0630b35a9b54be713736";
-var STABLE_VAULT_ADDRESS = "0x461eF73F640456138242398a39AB48a557A49293";
+var STABLE_VAULT_ADDRESS = "0xb7Df8db22A5DBBFA9ebeb94b3910aec6a4f05c08";
 export {
+  BRIDGE_CHAIN_CONFIGS,
   CHAIN_CONFIGS,
   Chain,
   Network,