Hosted Fee Payer

Tempo Labs provides hosted fee payer endpoints for applications that want to sponsor Tempo transaction fees without running fee payer infrastructure.

Hosted fee payer endpoints

The hosted endpoints are JSON-RPC relays that fill, sponsor, and broadcast Tempo Transactions. They are CORS-enabled and return standard JSON-RPC responses.

Hosted fee payer rate limits and policy

Hosted fee payer endpoints are rate-limited and may reject requests that fall outside the configured sponsorship policy.

Clients should avoid retry loops, back off after errors, and treat sponsorship as conditional. If sponsorship is rejected, the client should either let the user pay their own fee or retry through an application-owned fee payer.

Hosted fee payer pricing and access

The public testnet fee payer is free for development and testing.

Mainnet hosted fee payer access is intended for approved integrations and partner programs. Use https://sponsor.tempo.xyz/tp_<api_key> after your integration has been approved and you have been provided an API key. For production use outside the hosted policy, contact Tempo or run your own fee payer.

When provided an API key, you can directly pass it in the request path in order to sponsor requests.

const feePayerUrl = `https://sponsor.tempo.xyz/${feePayerToken}`

Do not send the fee payer token as a bearer token or another request header. The hosted fee payer authenticates the key from the path segment.

Use a fee payer in production

Run your own fee payer when you need:

• Custom allowlists, rate limits, or per-user sponsorship rules
• Dedicated funding, accounting, or reconciliation
• Full control over availability, latency, and operational policy
• Sponsorship for traffic that is not covered by Tempo's hosted policy

See Sponsor User Fees to deploy your own fee payer service.

Configure clients for hosted fee sponsorship

Tempo Wallet fee sponsorship

import { tempo } from 'viem/chains'
import { createConfig, http } from 'wagmi'
import { tempoWallet } from 'wagmi/connectors'
 
export const config = createConfig({
  connectors: [
    tempoWallet({
      feePayer: 'https://sponsor.tempo.xyz/tp_<api_key>',
    }),
  ],
  chains: [tempo],
  transports: {
    [tempo.id]: http(),
  },
})

WebAuthn or custom fee payer transports

Use withRelay to route transaction fill and sponsorship requests through the hosted fee payer.

import { tempo } from 'viem/chains'
import { withRelay } from 'viem/tempo'
import { createConfig, http } from 'wagmi'
import { webAuthn } from 'wagmi/tempo'
 
export const config = createConfig({
  connectors: [webAuthn({ authUrl: '/auth' })],
  chains: [tempo],
  transports: {
    [tempo.id]: withRelay(
      http(),
      http('https://sponsor.tempo.xyz/tp_<api_key>'),
    ),
  },
})

For testnet development, use https://sponsor.moderato.tempo.xyz without an API key.

Query the hosted fee payer

Query the fee payer chain ID

curl -X POST "https://sponsor.tempo.xyz/tp_<api_key>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Fill a sponsored Tempo transaction

eth_fillTransaction returns a filled Tempo transaction plus metadata describing whether the request is sponsored.

curl -X POST "https://sponsor.tempo.xyz/tp_<api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_fillTransaction",
    "params": [{
      "from": "0x0000000000000000000000000000000000000001",
      "calls": [{
        "to": "0x20c0000000000000000000000000000000000000",
        "data": "0x70a08231000000000000000000000000000000000000000000000000000000000000dead"
      }]
    }]
  }'

A sponsored response includes capabilities.sponsored: true and sponsor metadata.

Hosted fee payer API reference

How hosted fee sponsorship works

Tempo Transactions support native fee sponsorship through a separate fee payer signature. The user signs the transaction first, leaving fee token selection to the fee payer. The hosted fee payer validates the request, chooses the fee token, signs the fee payer payload, and either returns the completed transaction or broadcasts it depending on the JSON-RPC method.

No paymaster contract, bundler, or EntryPoint contract is required.

Next steps for fee sponsorship