@stablechain/sdk 1.0.3 → 1.0.4

package/dist/index.cjs

@@ -807,19 +807,19 @@ var MorphoService = class {
 
 
 // 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";
@@ -1723,7 +1723,304 @@ 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
+
+
+
+
+
+
+
+
+
+
+
+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 _viem.concat.call(void 0, [
+    _viem.numberToHex.call(void 0, 3, { size: 2 }),
+    // TYPE_3 header
+    _viem.numberToHex.call(void 0, 1, { size: 1 }),
+    // Executor worker ID
+    _viem.numberToHex.call(void 0, 17, { size: 2 }),
+    // option payload length = 17 bytes
+    _viem.numberToHex.call(void 0, 1, { size: 1 }),
+    // LzReceive option type
+    _viem.numberToHex.call(void 0, 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 = _nullishCoalesce(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 = _viem.parseUnits.call(void 0, String(amount), src.decimals);
+    try {
+      const { nativeFee, lzTokenFee } = await _viem.createPublicClient.call(void 0, {
+        chain: makeChain(src.id, src.rpc),
+        transport: _viem.http.call(void 0, 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 = _nullishCoalesce(_optionalChain([this, 'access', _37 => _37.config, 'access', _38 => _38.walletClient, 'optionalAccess', _39 => _39.account, 'optionalAccess', _40 => _40.address]), () => ( _optionalChain([this, 'access', _41 => _41.config, 'access', _42 => _42.account, 'optionalAccess', _43 => _43.address])));
+    if (!from) {
+      throw new StableValidationError(
+        "signer",
+        void 0,
+        "bridge: requires a signer \u2014 set walletClient or account in StableConfig"
+      );
+    }
+    const recipientAddr = _nullishCoalesce(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 = _nullishCoalesce(this.config.walletClient, () => ( _viem.createWalletClient.call(void 0, {
+      account: this.config.account,
+      chain: srcChain,
+      transport: _nullishCoalesce(this.config.transport, () => ( _viem.http.call(void 0, src.rpc)))
+    })));
+    const pc = _viem.createPublicClient.call(void 0, { chain: srcChain, transport: _viem.http.call(void 0, 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 = _viem.parseUnits.call(void 0, String(amount), src.decimals);
+    const sendParams = this.buildSendParams(dst, amountLD, recipientAddr);
+    const lzFee = _optionalChain([quote, 'optionalAccess', _44 => _44.nativeFee]) !== void 0 && _optionalChain([quote, 'optionalAccess', _45 => _45.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: _viem.erc20Abi,
+      functionName: "allowance",
+      args: [from, oftAdapter]
+    });
+    if (allowance < amountLD) {
+      let approveHash;
+      try {
+        approveHash = await wc.writeContract({
+          address: src.usdt,
+          abi: _viem.erc20Abi,
+          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 (!_viem.isAddress.call(void 0, 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: _viem.padHex.call(void 0, 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 = _nullishCoalesce(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,
@@ -1814,6 +2111,7 @@ 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,
@@ -1832,7 +2130,7 @@ function createStable({
     return morpho;
   }
   function requireSignerAddress() {
-    const from = _nullishCoalesce(_optionalChain([walletClient, 'optionalAccess', _37 => _37.account, 'optionalAccess', _38 => _38.address]), () => ( _optionalChain([account, 'optionalAccess', _39 => _39.address])));
+    const from = _nullishCoalesce(_optionalChain([walletClient, 'optionalAccess', _46 => _46.account, 'optionalAccess', _47 => _47.address]), () => ( _optionalChain([account, 'optionalAccess', _48 => _48.address])));
     if (!from) {
       throw new StableValidationError(
         "signer",
@@ -1845,7 +2143,7 @@ function createStable({
   async function transfer(params) {
     validateTransferParams(params);
     const { from, to, amount, token, tokenDecimals } = params;
-    const acc = _nullishCoalesce(_nullishCoalesce(_optionalChain([walletClient, 'optionalAccess', _40 => _40.account]), () => ( account)), () => ( from));
+    const acc = _nullishCoalesce(_nullishCoalesce(_optionalChain([walletClient, 'optionalAccess', _49 => _49.account]), () => ( account)), () => ( from));
     const wc = _nullishCoalesce(walletClient, () => ( _viem.createWalletClient.call(void 0, {
       account: acc,
       chain,
@@ -1897,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: {
@@ -1954,4 +2252,5 @@ var STABLE_VAULT_ADDRESS = "0xb7Df8db22A5DBBFA9ebeb94b3910aec6a4f05c08";
 
 
 
-exports.CHAIN_CONFIGS = CHAIN_CONFIGS; exports.Chain = Chain; exports.Network = Network; exports.STABLE_USDT_ADDRESS = STABLE_USDT_ADDRESS; exports.STABLE_VAULT_ADDRESS = STABLE_VAULT_ADDRESS; exports.StableBulkError = StableBulkError; exports.StableError = StableError; exports.StableNetworkError = StableNetworkError; exports.StableQuoteError = StableQuoteError; exports.StableTransactionError = StableTransactionError; exports.StableValidationError = StableValidationError; exports.createStable = createStable; exports.createStableReader = createStableReader;
+
+exports.BRIDGE_CHAIN_CONFIGS = BRIDGE_CHAIN_CONFIGS; exports.CHAIN_CONFIGS = CHAIN_CONFIGS; exports.Chain = Chain; exports.Network = Network; exports.STABLE_USDT_ADDRESS = STABLE_USDT_ADDRESS; exports.STABLE_VAULT_ADDRESS = STABLE_VAULT_ADDRESS; exports.StableBulkError = StableBulkError; exports.StableError = StableError; exports.StableNetworkError = StableNetworkError; exports.StableQuoteError = StableQuoteError; exports.StableTransactionError = StableTransactionError; exports.StableValidationError = StableValidationError; exports.createStable = createStable; exports.createStableReader = createStableReader;

package/dist/index.d.cts

@@ -95,7 +95,20 @@ declare enum Network {
 interface BridgeQuote {
     /** Estimated output amount on the destination chain */
     toAmount?: number;
+    /** LayerZero native messaging fee (wei) — only present for USDT0→USDT0 (OFT) routes */
+    nativeFee?: bigint;
+    /** LayerZero fee paid in LZ token (wei) — only present for USDT0→USDT0 (OFT) routes */
+    lzTokenFee?: bigint;
 }
+/**
+ * Bridge route selection:
+ * - `"usdt0"` — force the USDT0 LayerZero OFT path (no protocol fee, just gas + LZ
+ *   messaging fee; slower). Throws if the chain pair has no USDT0 adapter.
+ * - `"lifi"` — force the LI.FI aggregator path (fast, charges a fee).
+ * - `"auto"` — use USDT0 when both chains support it and tokens match, else LI.FI.
+ *   This is the default.
+ */
+type BridgeRoute = "auto" | "usdt0" | "lifi";
 interface BridgeParams {
     fromChain: Chain;
     toChain: Chain;
@@ -108,6 +121,11 @@ interface BridgeParams {
     fromDecimals?: number;
     /** Recipient address — defaults to the signer */
     recipient?: string;
+    /**
+     * Which bridge to use. Defaults to "auto" (USDT0 OFT when available, else LI.FI).
+     * See {@link BridgeRoute}.
+     */
+    route?: BridgeRoute;
     /** Pre-fetched quote from quoteBridge() — skips the quote fetch when passed to bridge() */
     quote?: BridgeQuote;
 }
@@ -395,6 +413,15 @@ interface ChainConfig {
 }
 declare const CHAIN_CONFIGS: Partial<Record<Chain, ChainConfig>>;
 
+interface BridgeChainConfig extends ChainConfig {
+    lzEid: number;
+    /** Only set on source chains that have an OFT Adapter deployed */
+    oftAdapter?: Address;
+    /** False when the OFT adapter exists but has no outbound send pathways configured */
+    lzOutbound?: boolean;
+}
+declare const BRIDGE_CHAIN_CONFIGS: Partial<Record<Chain, BridgeChainConfig>>;
+
 declare const STABLE_USDT_ADDRESS: Address;
 declare const STABLE_VAULT_ADDRESS: Address;
 
@@ -455,4 +482,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { type BridgeParams, type BridgeQuote, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, 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 };
+export { BRIDGE_CHAIN_CONFIGS, type BridgeChainConfig, type BridgeParams, type BridgeQuote, type BridgeRoute, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, 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

@@ -95,7 +95,20 @@ declare enum Network {
 interface BridgeQuote {
     /** Estimated output amount on the destination chain */
     toAmount?: number;
+    /** LayerZero native messaging fee (wei) — only present for USDT0→USDT0 (OFT) routes */
+    nativeFee?: bigint;
+    /** LayerZero fee paid in LZ token (wei) — only present for USDT0→USDT0 (OFT) routes */
+    lzTokenFee?: bigint;
 }
+/**
+ * Bridge route selection:
+ * - `"usdt0"` — force the USDT0 LayerZero OFT path (no protocol fee, just gas + LZ
+ *   messaging fee; slower). Throws if the chain pair has no USDT0 adapter.
+ * - `"lifi"` — force the LI.FI aggregator path (fast, charges a fee).
+ * - `"auto"` — use USDT0 when both chains support it and tokens match, else LI.FI.
+ *   This is the default.
+ */
+type BridgeRoute = "auto" | "usdt0" | "lifi";
 interface BridgeParams {
     fromChain: Chain;
     toChain: Chain;
@@ -108,6 +121,11 @@ interface BridgeParams {
     fromDecimals?: number;
     /** Recipient address — defaults to the signer */
     recipient?: string;
+    /**
+     * Which bridge to use. Defaults to "auto" (USDT0 OFT when available, else LI.FI).
+     * See {@link BridgeRoute}.
+     */
+    route?: BridgeRoute;
     /** Pre-fetched quote from quoteBridge() — skips the quote fetch when passed to bridge() */
     quote?: BridgeQuote;
 }
@@ -395,6 +413,15 @@ interface ChainConfig {
 }
 declare const CHAIN_CONFIGS: Partial<Record<Chain, ChainConfig>>;
 
+interface BridgeChainConfig extends ChainConfig {
+    lzEid: number;
+    /** Only set on source chains that have an OFT Adapter deployed */
+    oftAdapter?: Address;
+    /** False when the OFT adapter exists but has no outbound send pathways configured */
+    lzOutbound?: boolean;
+}
+declare const BRIDGE_CHAIN_CONFIGS: Partial<Record<Chain, BridgeChainConfig>>;
+
 declare const STABLE_USDT_ADDRESS: Address;
 declare const STABLE_VAULT_ADDRESS: Address;
 
@@ -455,4 +482,4 @@ declare class StableBulkError extends StableError {
     });
 }
 
-export { type BridgeParams, type BridgeQuote, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, 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 };
+export { BRIDGE_CHAIN_CONFIGS, type BridgeChainConfig, type BridgeParams, type BridgeQuote, type BridgeRoute, type BulkDepositOptions, type BulkEarnResult, type BulkEarnResultItem, type BulkWithdrawOptions, CHAIN_CONFIGS, Chain, type ChainConfig, type EarnConfig, type EarnDepositCalldata, type EarnDepositParams, type EarnRedeemParams, type EarnResult, type EarnWithdrawCalldata, type EarnWithdrawParams, type ForceDeallocation, type ForceRedeemParams, type ForceWithdrawParams, type MerklClaimCalldata, type MerklClaimResult, type MerklReward, type MerklRewardToken, type MerklRewardsResult, 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

@@ -1,11 +1,11 @@
 // src/stable.ts
 import {
-  http as http5,
-  createPublicClient as createPublicClient5,
-  createWalletClient as createWalletClient4,
-  erc20Abi as erc20Abi4,
-  isAddress as isAddress4,
-  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";
 
@@ -807,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";
@@ -1723,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 (!isAddress4(to)) {
+  if (!isAddress5(to)) {
     throw new StableValidationError(
       "to",
       to,
@@ -1744,7 +2041,7 @@ function validateTransferParams({
       "transfer: amount must be a finite positive number"
     );
   }
-  if (token !== void 0 && !isAddress4(token)) {
+  if (token !== void 0 && !isAddress5(token)) {
     throw new StableValidationError(
       "token",
       token,
@@ -1764,7 +2061,7 @@ async function resolveTokenDecimals(publicClient, token, tokenDecimals) {
   try {
     return await publicClient.readContract({
       address: token,
-      abi: erc20Abi4,
+      abi: erc20Abi5,
       functionName: "decimals"
     });
   } catch {
@@ -1791,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
   });
@@ -1814,6 +2111,7 @@ 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,
@@ -1846,10 +2144,10 @@ function createStable({
     validateTransferParams(params);
     const { from, to, amount, token, tokenDecimals } = params;
     const acc = walletClient?.account ?? account ?? from;
-    const wc = walletClient ?? createWalletClient4({
+    const wc = walletClient ?? createWalletClient5({
       account: acc,
       chain,
-      transport: transport ?? http5(rpc)
+      transport: transport ?? http6(rpc)
     });
     try {
       await wc.switchChain({ id: chain.id });
@@ -1861,9 +2159,9 @@ function createStable({
         cause: err
       });
     }
-    const publicClient = createPublicClient5({
+    const publicClient = createPublicClient6({
       chain,
-      transport: http5(rpc)
+      transport: http6(rpc)
     });
     const hash = token !== void 0 ? await executeTokenTransfer(
       wc,
@@ -1881,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 });
@@ -1897,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: {
@@ -1941,6 +2239,7 @@ function createStableReader(config) {
 var STABLE_USDT_ADDRESS = "0x779ded0c9e1022225f8e0630b35a9b54be713736";
 var STABLE_VAULT_ADDRESS = "0xb7Df8db22A5DBBFA9ebeb94b3910aec6a4f05c08";
 export {
+  BRIDGE_CHAIN_CONFIGS,
   CHAIN_CONFIGS,
   Chain,
   Network,

package/package.json

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