Gasless Execution

​

How it works

​

Key concepts

• A signature, not a transaction. The user signs, and a Mayan relayer submits the transaction and pays the gas.
• The return value changes. On a normal quote swapFromEvm returns a transaction. On a gasless quote it returns an order hash string. Code that assumes a transaction object will break, so branch on quote.gasless.
• Not every route supports it. Requesting gasless: true narrows the routes the quoter will return. If nothing comes back for a pair, that pair cannot be executed gaslessly.
• Refunds go back to the signer. A gasless Swift order requires the refund address to match the wallet that signed. swiftRefundAddress is rejected on a gasless quote, so request gasless: false if you need a refund to land somewhere else. See executing swaps.

​

Requesting it

const quotes = await fetchQuote({
  amountIn64: "100000000",
  fromChain: "ethereum",
  fromToken: USDC_ETHEREUM,
  toChain: "base",
  toToken: USDC_BASE,
  slippageBps: "auto",
  gasless: true,
});

const quote = quotes[0];
if (!quote) throw new Error("No gasless route for this pair.");

​

Tracking a gasless swap

const orderHash = await swapFromEvm(quote, /* ... */);
// quote.gasless === true  ->  orderHash is a string, not a transaction

const res = await fetch(
  `https://explorer-api.mayan.finance/v3/swap/trx/${orderHash}`
);
const swap = await res.json();

console.log(swap.clientStatus); // INPROGRESS, COMPLETED, or REFUNDED

​

Where it is used

​

Next steps