> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Splitting sign & send

> Pre-sign a sponsored intent, relay it, and poll relay status for custom transaction flows.

[`sendSponsoredTransaction`](/docs/javascript/reference/evm/send-sponsored-transaction) bundles signing, relaying, and waiting into one call. When you need more control — pre-signing an intent to send later, relaying without blocking, or driving your own progress UI — split those steps with the functions below.

The full flow is: **sign** → **relay** (get a `requestId`) → **poll status** until the relay reports a transaction hash.

## signSponsoredTransaction

Signs an EIP-712 intent for a batch of calls without sending it. Returns a serializable payload you can hand to [`sendSponsoredTransaction`](/docs/javascript/reference/evm/send-sponsored-transaction) or [`relaySponsoredTransaction`](#relaysponsoredtransaction) later.

```javascript theme={"system"}
import {
  signSponsoredTransaction,
  sendSponsoredTransaction,
} from '@dynamic-labs-sdk/evm';

const signedTransaction = await signSponsoredTransaction({
  walletAccount,
  calls,
});

// ...later, or from another process:
const { transactionHash } = await sendSponsoredTransaction({ signedTransaction });
```

### Parameters

| Parameter         | Type                                     | Description                                                                                                                               |
| ----------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `walletAccount`   | `EvmWalletAccount`                       | The V3 MPC embedded wallet to sign with.                                                                                                  |
| `calls`           | `SponsoredTransactionCall[]`             | The batch of calls to execute.                                                                                                            |
| `authorization`   | `SignAuthorizationReturnType` (optional) | A pre-signed EIP-7702 authorization. Takes priority over `autoDelegate`.                                                                  |
| `autoDelegate`    | `boolean` (optional)                     | Whether to auto-sign an EIP-7702 authorization when the wallet isn't delegated yet. Defaults to `true`.                                   |
| `nonce`           | `bigint` (optional)                      | A bitmap nonce to sign with. When provided, nonce generation and its on-chain check are skipped. See [Reusing a nonce](#reusing-a-nonce). |
| `validForSeconds` | `number` (optional)                      | How long the intent stays valid. Defaults to `600` (10 minutes).                                                                          |

### Returns

`Promise<SignedSponsoredTransaction>`:

| Field           | Type                                   | Description                                               |
| --------------- | -------------------------------------- | --------------------------------------------------------- |
| `authorization` | `SerializedAuthorization \| undefined` | The serialized EIP-7702 authorization, if one was needed. |
| `calls`         | `SponsoredTransactionCall[]`           | The batch of calls that was signed.                       |
| `chainId`       | `number`                               | Target chain ID.                                          |
| `deadline`      | `string`                               | Intent expiration as a unix-timestamp string.             |
| `nonce`         | `string`                               | The bitmap nonce, as a `uint256` string.                  |
| `relayer`       | `Hex`                                  | The relayer address signed into the intent.               |
| `signature`     | `Hex`                                  | The EIP-712 signature over the intent.                    |
| `walletAddress` | `Hex`                                  | The user's wallet address.                                |

### Custom validity window

```javascript theme={"system"}
const signedTransaction = await signSponsoredTransaction({
  walletAccount,
  calls,
  validForSeconds: 60, // valid for 1 minute instead of the default 10
});
```

## relaySponsoredTransaction

Relays an intent to the sponsorship backend and returns a `requestId` **without waiting** for on-chain inclusion. Accepts either unsigned `calls` (it signs them for you) or a pre-signed `signedTransaction`.

```javascript theme={"system"}
import { relaySponsoredTransaction } from '@dynamic-labs-sdk/evm';

const { requestId } = await relaySponsoredTransaction({ walletAccount, calls });
```

The `requestId` — not a transaction hash — is the stable identifier for a sponsored transaction, because the relay may retry the on-chain submission. Use it to track status below.

### Parameters

Same as [`signSponsoredTransaction`](#signsponsoredtransaction) (unsigned form), or `{ signedTransaction }`.

### Returns

`Promise<{ requestId: string }>`.

## Tracking status

### getEVMSponsoredTransactionStatus

Fetches the current relay state for a `requestId`. Use it as the building block for custom polling — for example, a progress indicator.

```javascript theme={"system"}
import {
  relaySponsoredTransaction,
  getEVMSponsoredTransactionStatus,
} from '@dynamic-labs-sdk/evm';

const { requestId } = await relaySponsoredTransaction({ walletAccount, calls });

const { status, transactionHash, errorMessage } =
  await getEVMSponsoredTransactionStatus({ requestId });
```

**Returns** `Promise<SponsoredTransactionStatusResult>`:

| Field             | Type                         | Description                                                     |
| ----------------- | ---------------------------- | --------------------------------------------------------------- |
| `status`          | `SponsoredTransactionStatus` | One of `'pending'`, `'submitted'`, `'success'`, or `'failure'`. |
| `transactionHash` | `Hex \| undefined`           | Set once the relay has broadcast the transaction.               |
| `errorMessage`    | `string \| undefined`        | Present when `status` is the terminal `'failure'`.              |

The `status` lifecycle:

| Status      | Meaning                                                  |
| ----------- | -------------------------------------------------------- |
| `pending`   | Accepted by the relayer, not yet broadcast to the chain. |
| `submitted` | Broadcast to the chain, awaiting confirmation.           |
| `success`   | Finalized successfully on-chain.                         |
| `failure`   | Terminal failure — see `errorMessage`.                   |

### waitForSponsoredTransaction

For the common "wait until done" case, `waitForSponsoredTransaction` polls `getEVMSponsoredTransactionStatus` every 2 seconds and resolves as soon as the relay reports a transaction hash. It throws a `SponsorTransactionError` on a terminal `failure` or after a 60-second timeout.

```javascript theme={"system"}
import { waitForSponsoredTransaction } from '@dynamic-labs-sdk/evm';

const { transactionHash } = await waitForSponsoredTransaction({ requestId });
```

**Returns** `Promise<{ transactionHash: Hex }>`.

## Reusing a nonce

By default each signed intent gets a fresh single-use bitmap nonce. Pass `nonce` (a `bigint`, matching the `nonce` on the signed result) to reuse one across intents — sign several intents with the same nonce so at most one can ever land on-chain (cancel-replace). The value is used as-is, with no on-chain validation:

```javascript theme={"system"}
const signedTransaction = await signSponsoredTransaction({
  walletAccount,
  calls,
  nonce: 42n,
});
```

`nonce` works the same way on `relaySponsoredTransaction` and [`sendSponsoredTransaction`](/docs/javascript/reference/evm/send-sponsored-transaction).

## Related functions

* [sendSponsoredTransaction](/docs/javascript/reference/evm/send-sponsored-transaction) — sign, relay, and wait in one call
* [EVM Gas Sponsorship overview](/docs/javascript/reference/evm/evm-gas-sponsorship) — setup and the common path
* [Managing EIP-7702 delegation](/docs/javascript/reference/evm/managing-7702-delegation) — control the one-time delegation step