Send a Tempo transaction

Send a Tempo transaction using Privy embedded wallets

Tempo transactions enable your app to take advantage of Tempo’s native features:

• Configurable fee tokens: set feeToken to pay fees with a supported TIP-20 token. Learn more
• Fee sponsorship: set sponsor: true to use Privy gas sponsorship on Tempo
• Concurrent transactions: set nonceKey to send parallel transactions. Most apps can omit this since Privy uses expiring nonces by default
• Batched calls: batch multiple calls in the transaction’s calls array
• Scheduled transactions: set validBefore or validAfter to control when the network can include the transaction

View the Tempo transaction recipe for full examples.

Unlike standard EVM transactions, Tempo transactions use a calls array instead of top-level to and data fields. This enables multiple contract calls to execute atomically in one transaction.

import {useWallets} from '@privy-io/react-auth';
import {useSendTransaction} from '@privy-io/react-auth/tempo';

const {wallets} = useWallets();
const {sendTransaction} = useSendTransaction();

const {hash} = await sendTransaction({
  transaction: {
    type: 118,
    chainId: 4217, // use 42431 for Tempo Moderato (testnet)
    feeToken: '0x20c000000000000000000000b9537d11c60e8b50', // pay Tempo fees in USDC-e
    calls: [{to: '0xRecipientAddress', data: '0x...'}]
  },
  wallet: wallets[0]
});

Parameters

transaction.type · 118 · required

Transaction type for Tempo’s native envelope.

transaction.chainId · number · required

The Tempo chain ID. Use 4217 for mainnet or 42431 for Moderato (testnet).

transaction.calls · TempoCall[] · required

An array of calls to execute atomically. At least one call is required. Each call has to (required), data, and value.

transaction.feeToken · Hex

Address of the supported TIP-20 token used to pay Tempo fees. If omitted, Tempo’s fee-token preference rules apply. Tempo has no native gas token.

transaction.nonceKey · bigint

2D nonce key. Use 0 for the protocol-managed sequential nonce, or a non-zero value to use a parallel user nonce slot, enabling concurrent transactions.

transaction.nonce · bigint

Sequential nonce within the nonce key slot. Populated automatically if omitted.

transaction.validBefore · bigint

Transaction expiration as a Unix timestamp in seconds. The transaction will not be included after this time.

transaction.validAfter · bigint

Earliest inclusion time as a Unix timestamp in seconds. The transaction will not be included before this time.

transaction.gasLimit · bigint

Gas limit for the transaction. Estimated automatically if omitted.

transaction.maxFeePerGas · bigint

Maximum total fee per gas unit in wei. Estimated automatically if omitted.

transaction.maxPriorityFeePerGas · bigint

Maximum priority fee per gas unit in wei. Estimated automatically if omitted.

wallet · ConnectedWallet · required

The wallet to send the transaction from.

options.sponsor · boolean

Optional parameter to enable gas sponsorship for this Tempo transaction. Learn more.

Returns

hash · HexString

The hash for the broadcasted transaction.

For full examples including viem tempoActions integration, view the Tempo transaction recipe.