## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.relay.link/llms.txt)

Use this file to discover all available pages before exploring further.

The `executeGaslessBatch` action takes a quote from [getQuote](https://docs.relay.link/references/relay-kit/sdk/actions/getQuote), delegates the user’s EOA to a batch executor using EIP-7702, batches the quote’s transaction steps atomically, and submits via Relay’s execute API with the sponsor covering gas costs. This means the user pays no gas fees.

An API key is required for gasless batch execution. Configure it via `createClient({ apiKey: "..." })`.

## Parameters

| Property | Description | Required |
| --- | --- | --- |
| **quote** | A valid quote retrieved using the [getQuote](https://docs.relay.link/references/relay-kit/sdk/actions/getQuote) action | ✅ |
| **walletClient** | A valid WalletClient from [viem](https://viem.sh/) with an account attached | ✅ |
| **executor** | Batch executor configuration. Defaults to the Calibur executor. | ❌ |
| **subsidizeFees** | Whether the sponsor pays all fees. Defaults to `false`. | ❌ |
| **originGasOverhead** | Gas overhead for the origin chain gasless transaction. Overrides the executor’s default if provided (Calibur default: 80,000). | ❌ |
| **onProgress** | Callback for each stage of the execution flow. Returns `status`, `requestId`, and `details`. See [onProgress statuses](https://docs.relay.link/references/relay-kit/sdk/actions/executeGaslessBatch#handling-onprogress-updates) below. | ❌ |

## Example

```
import { getClient, getQuote, executeGaslessBatch } from "@relayprotocol/relay-sdk";
import { createWalletClient, custom } from "viem";

const walletClient = createWalletClient({
  account: "0x...",
  chain: mainnet,
  transport: custom(window.ethereum),
});

const quote = await getClient().actions.getQuote({
  // ...quote options
});

const result = await executeGaslessBatch({
  quote,
  walletClient,
  onProgress: ({ status, requestId, details }) => {
    console.log(`Status: ${status}`, requestId);
  },
});

console.log("Request ID:", result.requestId);
```

## Example with Subsidized Fees

```
const result = await executeGaslessBatch({
  quote,
  walletClient,
  subsidizeFees: true,
  onProgress: ({ status }) => {
    console.log(`Status: ${status}`);
  },
});
```

## Handling onProgress updates

The `onProgress` callback fires at each stage of the gasless batch execution. The `status` field indicates which stage is currently active:

- **signing_authorization**: The user is being prompted to sign the EIP-7702 authorization to delegate their EOA to the batch executor. This step is skipped if the EOA is already delegated.
- **signing_batch**: The user is being prompted to sign the EIP-712 typed data for the batched calls.
- **submitting**: The signed batch is being submitted to the Relay API.
- **polling**: The request has been submitted and is being polled for completion.
- **success**: The batch execution completed successfully. The `details` field contains the full status response.
- **failure**: The batch execution failed or was refunded. The `details` field contains the full status response.