@stableflow/bridges 3.0.3 → 3.1.0-rc-d2d5e08ec7-20260706

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import Big from 'big.js';
-import { usdt0Chains, usdcChains, frxusdChains, Service, ExecTime, OpenAPI, getRequest, Csl, numberRemoveEndZero, getPrice, SendType, DefaultAddresses, postRequest, tokens, ServiceBackend, TransactionStatus, StableflowStatus, LayerZeroStatus, OneClickStatus, getRouteStatus } from '@stableflow/core';
+import { usdt0Chains, usdcChains, frxusdChains, Service, ExecTime, OpenAPI, getRequest, Csl, numberRemoveEndZero, getPrice, SendType, DefaultAddresses, postRequest, erc20Abi, tokens, ServiceBackend, TransactionStatus, StableflowStatus, LayerZeroStatus, OneClickStatus, getRouteStatus } from '@stableflow/core';
 import bs58 from 'bs58';
 import { Buffer } from 'buffer';
 import { evmRpcFallbackProvider } from '@stableflow/utils-evm';
@@ -182,6 +182,7 @@ var OneClickService = class {
       appFees = [],
       swapType = "EXACT_INPUT",
       isProxy = true,
+      slippageTolerance,
       ...restParams
     } = params;
     const _quoteType = `OneClickService ${fromToken?.chainName}->${toToken?.chainName}`;
@@ -199,7 +200,8 @@ var OneClickService = class {
         ...appFees
       ],
       referral: "stableflow",
-      amount: amountWei
+      amount: amountWei,
+      slippageTolerance: slippageTolerance * 100
     };
     if (swapType === "EXACT_OUTPUT") {
       quoteParams.amount = Big(amountWei || 0).div(10 ** fromToken.decimals).times(10 ** toToken.decimals).toFixed(0);
@@ -4839,6 +4841,7 @@ var FraxZero2OneClickService = class extends FraxZeroService {
         refundTo: middleChainRecipientAddress,
         wallet: middleChainWallet,
         appFees: [
+          ...params.appFees || [],
           {
             recipient: "reffer.near",
             // No bridge fee will be charged temporarily
@@ -5058,6 +5061,7 @@ var OneClick2FraxZeroService = class extends FraxZeroService {
         isProxy: true,
         recipient: middleChainRecipientAddress,
         appFees: [
+          ...params.appFees || [],
           {
             recipient: "reffer.near",
             // No bridge fee will be charged temporarily
@@ -5413,6 +5417,7 @@ var OneClickUsdt0Service = class {
       isProxy: true,
       recipient: middleChainRecipientAddress,
       appFees: [
+        ...params.appFees || [],
         {
           recipient: "reffer.near",
           // No bridge fee will be charged temporarily
@@ -5660,11 +5665,228 @@ var ServiceMap = {
   [Service.OneClickUsdt0]: from_oneclick_default2,
   [Service.Native]: native_default
 };
+var OVERRIDE_KEYS = /* @__PURE__ */ new Set([
+  "value",
+  "gasLimit",
+  "gasPrice",
+  "maxFeePerGas",
+  "maxPriorityFeePerGas",
+  "nonce",
+  "from",
+  "type",
+  "accessList",
+  "chainId",
+  "customData",
+  "blockTag"
+]);
+var toDecimalString = (v) => {
+  if (v === void 0 || v === null) {
+    return "0";
+  }
+  if (typeof v === "bigint") {
+    return v.toString();
+  }
+  if (typeof v === "number") {
+    return Math.trunc(v).toString();
+  }
+  return String(v);
+};
+var assertEvm = (token) => {
+  if (!token || token.chainType !== "evm") {
+    throw new Error("API-driven custody currently supports EVM chains only");
+  }
+};
+var getSendAmountWei = (serviceType, quote) => {
+  const { isExactOutput } = getQuoteModes({
+    quoteData: quote,
+    bridgeStore: { quoteDataService: serviceType }
+  });
+  if (isExactOutput) {
+    return quote?.quote?.minAmountIn;
+  }
+  return quote?.quoteParam?.amountWei;
+};
+var encodeContractCall = (sendParam) => {
+  const { contract, method, param } = sendParam;
+  if (!contract?.interface || contract?.target === void 0) {
+    throw new Error("Invalid sendParam: missing contract interface/target");
+  }
+  const to = typeof contract.target === "string" ? contract.target : String(contract.target);
+  let args = Array.isArray(param) ? param : [];
+  let value;
+  let gasLimit;
+  if (args.length > 0) {
+    const last = args[args.length - 1];
+    const isOverride = last !== null && typeof last === "object" && !Array.isArray(last) && Object.keys(last).length > 0 && Object.keys(last).every((k) => OVERRIDE_KEYS.has(k));
+    if (isOverride) {
+      args = args.slice(0, -1);
+      value = last.value;
+      gasLimit = last.gasLimit;
+    }
+  }
+  const data = contract.interface.encodeFunctionData(method, args);
+  return {
+    to,
+    data,
+    value: toDecimalString(value),
+    gasLimit: gasLimit === void 0 || gasLimit === null ? void 0 : toDecimalString(gasLimit)
+  };
+};
+var buildTransferTx = (params) => {
+  const { chainId, from, fromToken, depositAddress, amountWei } = params;
+  if (!depositAddress) {
+    throw new Error("Quote has no depositAddress to build transfer transaction");
+  }
+  if (fromToken.contractAddress === "eth") {
+    return {
+      chainId,
+      from,
+      to: depositAddress,
+      data: "0x",
+      value: toDecimalString(amountWei)
+    };
+  }
+  const iface = new ethers.Interface(erc20Abi);
+  const data = iface.encodeFunctionData("transfer", [depositAddress, amountWei]);
+  return {
+    chainId,
+    from,
+    to: fromToken.contractAddress,
+    data,
+    value: "0"
+  };
+};
+var buildSendTx = (serviceType, quote) => {
+  const fromToken = quote?.quoteParam?.fromToken;
+  assertEvm(fromToken);
+  const chainId = fromToken.chainId;
+  const from = quote?.quoteParam?.refundTo;
+  const sendParam = quote?.sendParam;
+  if (sendParam?.txRequest) {
+    const txRequest = sendParam.txRequest;
+    return {
+      chainId,
+      from,
+      to: txRequest.target,
+      data: txRequest.calldata,
+      value: toDecimalString(txRequest.value),
+      gasLimit: txRequest.gasLimit === void 0 || txRequest.gasLimit === null ? void 0 : toDecimalString(txRequest.gasLimit)
+    };
+  }
+  const { isOneClickService } = getQuoteModes({
+    quoteData: quote,
+    bridgeStore: { quoteDataService: serviceType }
+  });
+  if (isOneClickService) {
+    if (sendParam) {
+      return { chainId, from, ...encodeContractCall(sendParam) };
+    }
+    return buildTransferTx({
+      chainId,
+      from,
+      fromToken,
+      depositAddress: quote?.quote?.depositAddress,
+      amountWei: getSendAmountWei(serviceType, quote)
+    });
+  }
+  if (!sendParam) {
+    throw new Error("Quote has no sendParam to build transaction");
+  }
+  return { chainId, from, ...encodeContractCall(sendParam) };
+};
+var buildApproveTx = (serviceType, quote) => {
+  if (!quote?.needApprove) {
+    return {};
+  }
+  const fromToken = quote?.quoteParam?.fromToken;
+  assertEvm(fromToken);
+  if (fromToken.contractAddress === "eth") {
+    return {};
+  }
+  const chainId = fromToken.chainId;
+  const from = quote?.quoteParam?.refundTo;
+  const spender = quote?.approveSpender;
+  if (!spender) {
+    throw new Error("Quote requires approval but has no approveSpender");
+  }
+  const amountWei = getSendAmountWei(serviceType, quote);
+  const iface = new ethers.Interface(erc20Abi);
+  const approveTx = {
+    chainId,
+    from,
+    to: fromToken.contractAddress,
+    data: iface.encodeFunctionData("approve", [spender, amountWei]),
+    value: "0"
+  };
+  const result = { approveTx };
+  if (fromToken.chainName === "Ethereum") {
+    result.approveResetTx = {
+      chainId,
+      from,
+      to: fromToken.contractAddress,
+      data: iface.encodeFunctionData("approve", [spender, "0"]),
+      value: "0"
+    };
+  }
+  return result;
+};
+var buildPermitTypedData = async (params) => {
+  const { permitToken, permitAmountWei, permitSpender, owner } = params;
+  assertEvm(permitToken);
+  if (!owner) {
+    throw new Error("buildPermitTypedData requires the permit owner address");
+  }
+  const provider = evmRpcFallbackProvider(permitToken);
+  const erc20 = new ethers.Contract(permitToken.contractAddress, erc20Abi, provider);
+  const [nonce, name] = await Promise.all([
+    erc20.nonces(owner),
+    erc20.name()
+  ]);
+  const version = permitToken.symbol === "USDC" ? "2" : "1";
+  const deadline = Math.floor(Date.now() / 1e3) + 60 * 60 * 24 * 3;
+  const domain = {
+    name,
+    version,
+    chainId: Number(permitToken.chainId),
+    verifyingContract: permitToken.contractAddress
+  };
+  const types = {
+    Permit: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "nonce", type: "uint256" },
+      { name: "deadline", type: "uint256" }
+    ]
+  };
+  const values = {
+    owner,
+    spender: permitSpender,
+    value: toDecimalString(permitAmountWei),
+    nonce: nonce.toString(),
+    deadline
+  };
+  return {
+    domain,
+    types,
+    values,
+    deadline,
+    nonce: Number(nonce),
+    token: permitToken.contractAddress,
+    spender: permitSpender,
+    owner
+  };
+};
+
+// src/sfa.ts
 var submitOthersTx = (requestBody) => {
   return postRequest("/v0/trade/add", requestBody);
 };
-var BridgeSFA = class {
+var BridgeSFA = class _BridgeSFA {
   static async getAllQuote(params) {
+    const cs = new Csl(OpenAPI.DEBUG);
+    const csl = cs.log;
+    csl("BridgeSFA.getAllQuote", "blue-400", "params: %o", params);
     const results = [];
     let { minInputAmount = "1", disabledServices } = params;
     if (Big(minInputAmount).lte(0)) {
@@ -5694,7 +5916,6 @@ var BridgeSFA = class {
         Service.FraxZeroOneClick,
         Service.OneClickFraxZero
       ].includes(service)) {
-        _params.slippageTolerance = params.slippageTolerance * 100;
         _params.originAsset = params.fromToken.assetId;
         _params.destinationAsset = params.toToken.assetId;
         _params.refundType = "ORIGIN_CHAIN";
@@ -5727,6 +5948,7 @@ var BridgeSFA = class {
         return;
       }
       const quoteParams = formatQuoteParams(_service);
+      csl("BridgeSFA.getAllQuote", "blue-400", "%s quoteParams: %o", _service, quoteParams);
       quoteServices.push({
         service: _service,
         quote: () => {
@@ -5779,6 +6001,7 @@ var BridgeSFA = class {
       }
       return results;
     }
+    csl("BridgeSFA.getAllQuote", "blue-400", "quoteServices: %o", quoteServices);
     const promises = [];
     for (const quoteService of quoteServices) {
       const promise = (async () => {
@@ -5820,12 +6043,11 @@ var BridgeSFA = class {
     const sendParams = {
       wallet
     };
-    const { isExactOutput, isOneClickService, isQuoteParamDepositAddress } = getQuoteModes({
+    const { isExactOutput, isOneClickService } = getQuoteModes({
       quoteData: quote,
       bridgeStore: { quoteDataService: serviceType }
     });
     const fromToken = quote.quoteParam.fromToken;
-    const toToken = quote.quoteParam.toToken;
     const depositAddress = quote.quote?.depositAddress;
     const sendParam = quote.sendParam;
     let _amountWei = quote.quoteParam?.amountWei;
@@ -5845,45 +6067,11 @@ var BridgeSFA = class {
     csl("BridgeSFA.send", "blue-400", "sendParams: %o", sendParams);
     const txhash = await service.send(sendParams);
     try {
-      const reportData = {
-        project: ServiceBackend[serviceType],
-        address: quote.quoteParam?.refundTo,
-        amount: isExactOutput ? quote.quote.amountInFormatted : Big(_amountWei || 0).div(10 ** (fromToken?.decimals || 6)).toFixed(fromToken?.decimals || 6, 0),
-        out_amount: quote.outputAmount,
-        deposit_address: isOneClickService ? quote.quote?.depositAddress : "",
-        receive_address: quote.quoteParam?.recipient,
-        from_chain: fromToken.blockchain,
-        symbol: /^USD₮0$/i.test(fromToken.symbol) ? "USDT" : fromToken.symbol,
-        to_chain: toToken.blockchain,
-        to_symbol: /^USD₮0$/i.test(toToken.symbol) ? "USDT" : toToken.symbol,
-        tx_hash: ""
-      };
-      if (permitSignature) {
-        if ([Service.OneClickUsdt0].includes(serviceType)) {
-          reportData.layer_zero_permit = {
-            ...permitSignature,
-            ...quote.permitAdditionalData
-          };
-        }
-        if ([Service.OneClickFraxZero, Service.FraxZeroOneClick].includes(serviceType)) {
-          reportData.frax_zero_permit = {
-            ...permitSignature,
-            ...quote.permitAdditionalData
-          };
-        }
-      }
-      reportData.tx_hash = txhash;
-      let _depositAddress = txhash;
-      if (isQuoteParamDepositAddress) {
-        _depositAddress = quote.quoteParam?.depositAddress || txhash;
-      }
-      if (!reportData.deposit_address) {
-        reportData.deposit_address = _depositAddress;
-      }
-      if (serviceType === Service.Native) {
-        const quoteIds = quote?.orders?.map?.((order) => order.quoteId) || [];
-        reportData.quoteIds = quoteIds;
-      }
+      const reportData = _BridgeSFA.buildReportData(serviceType, {
+        quote,
+        txhash,
+        permitSignature
+      });
       csl("BridgeSFA.send", "blue-400", "reportData: %o", reportData);
       submitOthersTx(reportData);
     } catch (error) {
@@ -5891,6 +6079,137 @@ var BridgeSFA = class {
     }
     return txhash;
   }
+  /**
+   * Build the backend report payload for a submitted source-chain transaction.
+   * Shared by `send` (fire-and-forget) and `report` (awaited).
+   */
+  static buildReportData(serviceType, params) {
+    const { quote, txhash, permitSignature } = params;
+    const { isExactOutput, isOneClickService, isQuoteParamDepositAddress } = getQuoteModes({
+      quoteData: quote,
+      bridgeStore: { quoteDataService: serviceType }
+    });
+    const fromToken = quote.quoteParam.fromToken;
+    const toToken = quote.quoteParam.toToken;
+    let _amountWei = quote.quoteParam?.amountWei;
+    if (isExactOutput) {
+      _amountWei = quote.quote?.minAmountIn;
+    }
+    const reportData = {
+      project: ServiceBackend[serviceType],
+      address: quote.quoteParam?.refundTo,
+      amount: isExactOutput ? quote.quote.amountInFormatted : Big(_amountWei || 0).div(10 ** (fromToken?.decimals || 6)).toFixed(fromToken?.decimals || 6, 0),
+      out_amount: quote.outputAmount,
+      deposit_address: isOneClickService ? quote.quote?.depositAddress : "",
+      receive_address: quote.quoteParam?.recipient,
+      from_chain: fromToken.blockchain,
+      symbol: /^USD₮0$/i.test(fromToken.symbol) ? "USDT" : fromToken.symbol,
+      to_chain: toToken.blockchain,
+      to_symbol: /^USD₮0$/i.test(toToken.symbol) ? "USDT" : toToken.symbol,
+      tx_hash: ""
+    };
+    if (permitSignature) {
+      if ([Service.OneClickUsdt0].includes(serviceType)) {
+        reportData.layer_zero_permit = {
+          ...permitSignature,
+          ...quote.permitAdditionalData
+        };
+      }
+      if ([Service.OneClickFraxZero, Service.FraxZeroOneClick].includes(serviceType)) {
+        reportData.frax_zero_permit = {
+          ...permitSignature,
+          ...quote.permitAdditionalData
+        };
+      }
+    }
+    reportData.tx_hash = txhash;
+    let _depositAddress = txhash;
+    if (isQuoteParamDepositAddress) {
+      _depositAddress = quote.quoteParam?.depositAddress || txhash;
+    }
+    if (!reportData.deposit_address) {
+      reportData.deposit_address = _depositAddress;
+    }
+    if (serviceType === Service.Native) {
+      const quoteIds = quote?.orders?.map?.((order) => order.quoteId) || [];
+      reportData.quoteIds = quoteIds;
+    }
+    return reportData;
+  }
+  /**
+   * API-driven custody: build the serializable, unsigned transaction data for a
+   * route WITHOUT a signer. Intended for MPC wallets (e.g. Fireblocks) that sign
+   * and broadcast through their own infrastructure.
+   *
+   * Returns any required `approveTx` (and `approveResetTx` on Ethereum), the
+   * `permitTypedData` to sign off-chain when `quote.needPermit`, and the main
+   * `tx`. After the integrator broadcasts `tx`, call `BridgeSFA.report` with the
+   * resulting hash (and the permit signature, if any) so StableFlow can execute
+   * the destination leg.
+   *
+   * EVM only for now; non-EVM source chains throw.
+   */
+  static async buildTransaction(serviceType, params) {
+    const service = ServiceMap[serviceType];
+    if (!service) {
+      throw new Error(`Invalid service type: ${serviceType}`);
+    }
+    const { quote } = params;
+    if (!quote) {
+      throw new Error("Quote data is required");
+    }
+    const tx = buildSendTx(serviceType, quote);
+    const { approveTx, approveResetTx } = buildApproveTx(serviceType, quote);
+    const result = {
+      chainId: tx.chainId,
+      from: tx.from,
+      tx
+    };
+    if (approveTx) {
+      result.approveTx = approveTx;
+    }
+    if (approveResetTx) {
+      result.approveResetTx = approveResetTx;
+    }
+    if (quote.needPermit) {
+      result.permitTypedData = await buildPermitTypedData({
+        permitToken: quote.permitToken,
+        permitAmountWei: quote.permitAmountWei,
+        permitSpender: quote.permitSpender,
+        owner: quote.quoteParam?.evmAddress || quote.quoteParam?.refundTo
+      });
+    }
+    return result;
+  }
+  /**
+   * API-driven custody: report an externally signed & broadcast source-chain
+   * transaction back to StableFlow so it can track and execute the destination
+   * leg. Pair with `BridgeSFA.buildTransaction`.
+   *
+   * When `quote.needPermit === true`, `permitSignature` is required.
+   */
+  static report(serviceType, params) {
+    const service = ServiceMap[serviceType];
+    if (!service) {
+      throw new Error(`Invalid service type: ${serviceType}`);
+    }
+    const { quote, hash, permitSignature } = params;
+    if (!quote) {
+      throw new Error("Quote data is required");
+    }
+    if (!hash) {
+      throw new Error("Transaction hash is required");
+    }
+    if (quote.needPermit && !permitSignature) {
+      throw new Error("Permit signature is required");
+    }
+    const reportData = _BridgeSFA.buildReportData(serviceType, {
+      quote,
+      txhash: hash,
+      permitSignature
+    });
+    return submitOthersTx(reportData);
+  }
   static async getStatus(serviceType, params) {
     const cs = new Csl(OpenAPI.DEBUG);
     const csl = cs.log;
@@ -5998,6 +6317,6 @@ var getHopMsgFee = async (params) => {
   }
 };
 
-export { BridgeSFA, DATA_HEX_PROTOBUF_EXTRA, FRAXZERO_MIDDLE_TOKEN_FRXUSD, FRAXZERO_MIDDLE_TOKEN_USDC, LZ_RECEIVE_VALUE, OFT_ABI, SIGNATURE_SIZE, ServiceMap, USDT0_CONFIG, USDT0_LEGACY_MESH_TRANSFTER_FEE, addressToBytes32, formatNumber, formatQuoteError, getHopMsgFee, getQuoteModes, quoteSignature };
+export { BridgeSFA, DATA_HEX_PROTOBUF_EXTRA, FRAXZERO_MIDDLE_TOKEN_FRXUSD, FRAXZERO_MIDDLE_TOKEN_USDC, LZ_RECEIVE_VALUE, OFT_ABI, SIGNATURE_SIZE, ServiceMap, USDT0_CONFIG, USDT0_LEGACY_MESH_TRANSFTER_FEE, addressToBytes32, buildApproveTx, buildPermitTypedData, buildSendTx, formatNumber, formatQuoteError, getHopMsgFee, getQuoteModes, quoteSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map