Sponsor Gas with Gas Tank

Sponsor gas fees for your users using Gelato’s cross-chain Gas Tank. Deposit funds once and sponsor transactions across all supported networks.

Before sponsoring transactions, make sure your Gas Tank is funded. See Setting Up Gas Tank for instructions on depositing funds, and Gas Tank Balance & Alerts to monitor your balance.

Implementations

Gelato Gasless SDK
With 7702 Smart Account
Relay API Endpoints

npm install @gelatocloud/gasless viem

Create an API Key

Check out our How-To Guide for detailed instructions on generating an API key.

Initialize Relayer Client

import { createGelatoEvmRelayerClient } from '@gelatocloud/gasless';
import { baseSepolia } from 'viem/chains';

const relayer = createGelatoEvmRelayerClient({
  apiKey: process.env.GELATO_API_KEY,
  testnet: baseSepolia.testnet
});

Generate Payload

Generate the payload for your target contract function:

import { encodeFunctionData } from 'viem';

const data = encodeFunctionData({
  abi: [{ name: 'increment', type: 'function', inputs: [], outputs: [] }],
  functionName: 'increment'
});

Send Transaction

const id = await relayer.sendTransaction({
  chainId: baseSepolia.id,
  data: data,
  to: '0xE27C1359cf02B49acC6474311Bd79d1f10b1f8De'
});

console.log(`Gelato transaction id: ${id}`);

try {
  const receipt = await relayer.waitForReceipt({ id });
  console.log(`Transaction hash: ${receipt.transactionHash}`);
} catch (error) {
  console.log(`Transaction failed: ${error.message}`);
}

npm install @gelatocloud/gasless viem

Create an API Key

Check out our How-To Guide for detailed instructions on generating an API key.

Create Smart Account

import {
  createGelatoSmartAccountClient,
  toGelatoSmartAccount,
} from "@gelatocloud/gasless";
import { createPublicClient, http, type Hex } from "viem";
import { baseSepolia } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const owner = privateKeyToAccount(process.env.PRIVATE_KEY as Hex);

const client = createPublicClient({
  chain: baseSepolia,
  transport: http(),
});

const account = toGelatoSmartAccount({
  client,
  owner,
});

Create Relayer Client

const relayer = await createGelatoSmartAccountClient({
  account,
  apiKey: process.env.GELATO_API_KEY,
});

Send Transaction

const receipt = await relayer.sendTransactionSync({
  calls: [
    {
      to: "0xE27C1359cf02B49acC6474311Bd79d1f10b1f8De",
      data: "0xd09de08a",
    },
  ],
});

console.log(`Transaction hash: ${receipt.transactionHash}`);

Pass the API key in the X-API-Key header.

Create an API Key

Check out our How-To Guide for detailed instructions on generating an API key.

Send Relay Request

const response = await fetch('https://api.gelato.cloud/rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': API_KEY
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'relayer_sendTransaction',
    params: {
      chainId: '84532',
      to: '0x...',
      data: '0x...',
      payment: { type: 'sponsored' }
    }
  })
});

const data = await response.json();
const taskId = data.result;
console.log(`Task ID: ${taskId}`);

Check Task Status

Poll for the transaction status using relayer_getStatus:

const statusResponse = await fetch('https://api.gelato.cloud/rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': API_KEY
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'relayer_getStatus',
    params: { id: taskId }
  })
});

const statusData = await statusResponse.json();
const status = statusData.result.status;

// 200 = Included, 400 = Rejected, 500 = Reverted
if (status === 200) {
  console.log(`Transaction hash: ${statusData.result.receipt.transactionHash}`);
} else if (status >= 400) {
  console.log(`Failed: ${statusData.result.message}`);
}

Additional Resources

Supported Networks - Full list of supported chains
Relayer API - Direct API integration

Gelato Turbo Relayer

EVM Gasless Features

How-To Guides

Relayer API Endpoints

Additional Resources

Sponsor Gas with Gas Tank

Implementations

Additional Resources

Gelato Turbo Relayer

EVM Gasless Features

How-To Guides

Relayer API Endpoints

Additional Resources

​Implementations

​Sponsor Gas Playground

​Additional Resources

Implementations

Sponsor Gas Playground

Additional Resources