eth_sendTransaction

Sign and send a Tempo transaction using the eth_sendTransaction method with type 118.

POST /v1/wallets/{wallet_id}/rpc

Without sponsorship

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "eth_sendTransaction",
  "caip2": "eip155:4217",
  "chain_type": "ethereum",
  "params": {
    "transaction": {
      "type": 118,
      "calls": [
        {
          "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "value": "0x2386F26FC10000"
        }
      ]
    }
  }
}'

Without sponsorship

{
  "method": "eth_sendTransaction",
  "data": {
    "hash": "0xfc3a736ab2e34e13be2b0b11b39dbc0232a2e755a11aa5a9219890d3b2c6c7d8",
    "caip2": "eip155:4217",
    "transaction_id": "y90vpg3bnkjxhw541c2zc6a9",
    "transaction_request": {
      "chain_id": 4217,
      "type": 118,
      "calls": [
        {
          "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "value": "0x2386F26FC10000"
        }
      ]
    }
  }
}

SDK methods

Learn more about sending Tempo transactions using our SDKs here.

---

Idempotency on errors: On 4xx or 5xx, Privy caches the response and replays it for the same key. Generate a new key to retry after a server error. Policy violations are an exception and allow same-key retries.

Without sponsorship

curl --request POST \
  --url https://api.privy.io/v1/wallets/{wallet_id}/rpc \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "method": "eth_sendTransaction",
  "caip2": "eip155:4217",
  "chain_type": "ethereum",
  "params": {
    "transaction": {
      "type": 118,
      "calls": [
        {
          "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "value": "0x2386F26FC10000"
        }
      ]
    }
  }
}'

Without sponsorship

{
  "method": "eth_sendTransaction",
  "data": {
    "hash": "0xfc3a736ab2e34e13be2b0b11b39dbc0232a2e755a11aa5a9219890d3b2c6c7d8",
    "caip2": "eip155:4217",
    "transaction_id": "y90vpg3bnkjxhw541c2zc6a9",
    "transaction_request": {
      "chain_id": 4217,
      "type": 118,
      "calls": [
        {
          "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
          "value": "0x2386F26FC10000"
        }
      ]
    }
  }
}

The wallet RPC endpoint is a synchronous endpoint, and a successful response indicates that the transaction has been broadcasted to the network. Transactions may get broadcasted but still fail to be confirmed by the network. The endpoint does not wait for confirmation or retry if the transaction fails to be confirmed. To handle these scenarios, see our guide on speeding up transactions.

Headers

privy-app-id · string · required

ID of your Privy app.

privy-authorization-signature · string

Request authorization signature. If multiple signatures are required, they should be comma separated.

privy-request-expiry · string

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Path Parameters

wallet_id · string · required

ID of the wallet to get.

Body

method · string · required

Available options: eth_sendTransaction

caip2 · string · required

The CAIP-2 chain identifier for the Tempo network.

params · object · required

Hide child attributes

transaction · object · required

Hide child attributes

type · number · required

Must be 118 for Tempo transactions.

from · string

chain_id · string | number

nonce · string | number

gas_limit · string | number

max_fee_per_gas · string | number

max_priority_fee_per_gas · string | number

calls · object[] · required

The calls to execute atomically.

Hide child attributes

to · string · required

The target address for the call.

data · string

The calldata for the call.

value · string | number

The value to send with the call in wei.

fee_token · string

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.

nonce_key · string | number

The Tempo 2D nonce key.

valid_before · string | number

Unix timestamp in seconds after which Tempo will reject the transaction.

valid_after · string | number

Unix timestamp in seconds before which Tempo will reject the transaction.

fee_payer_signature · object

A fee payer signature for sponsored Tempo transactions. To have Privy populate this field, pass sponsor: true at the request root.

Show child attributes

r · string · required

s · string · required

y_parity · 0 | 1 · required

access_list · object[]

Show child attributes

address · string · required

storage_keys · string[] · required

aa_authorization_list · object[]

Account abstraction authorizations for Tempo transactions.

Show child attributes

contract · string · required

chain_id · string | number · required

nonce · string | number · required

signature · string · required

sponsor · boolean

Enable gas sponsorship for this transaction. Learn more.

reference_id · string

Optional developer-provided reference ID for transaction reconciliation. Must be unique per transaction and up to 64 characters. Use this to correlate transactions with your own internal records. The reference_id is included in transaction webhook payloads and can be used to look up transactions.

address · string

chain_type · string

Available options: ethereum

Returns

method · enum<string> · required

Available options: eth_sendTransaction

data · object · required

Hide child attributes

hash · string · required

The broadcast transaction hash.

transaction_request · object

The full transaction object that was signed and broadcast.

caip2 · string · required

transaction_id · string

reference_id · string | null

The developer-provided reference ID, if one was provided in the request.