<!-- tempo-docs-context -->
> Source: [/docs/protocol/zones/rpc](https://tempo.com/developers/docs/protocol/zones/rpc.md)
> Section: [Zones](https://tempo.com/developers/docs/zones.md). Connect to a Zone and work with private balances, deposits, and withdrawals. Zones is live on Mainnet; see the introduction to set up a Zone. Earlier testnet sandbox guides describe a separate integration.
> [Documentation index](https://tempo.com/developers/llms.txt) · [Docs skill](https://tempo.com/developers/SKILL.md)

> Tempo MCP: Use `search`, `find_pages`, `read_page`, and `code` at `https://mcp.tempo.xyz` for Tempo and related documentation.
> If an indexed page is missing or reflects an older site, read this site’s [documentation index](https://tempo.com/developers/llms.txt) and Markdown pages directly.

# RPC Reference

The Zone RPC is an account-scoped, redacted Ethereum JSON-RPC interface.

## Overview

The Zone RPC reads Zone data and submits transactions. Every request includes an authorization token proving control of a Tempo account. Responses are scoped to that account. Shared data, such as block headers, is redacted. Operator RPC and hosted provider APIs have separate access rules.

## Authorization Tokens

Authorization tokens are credentials signed by the caller's Tempo account key. They expire after at most 30 days, or a shorter operator-configured limit. Tempo accounts support multiple signature types (secp256k1, P256, WebAuthn). Accounts with access keys via the `AccountKeychain` precompile can use those keys to authenticate.

The signed message includes:

* `"TempoZoneRPC"` magic prefix for domain separation
* Spec version, Zone ID, and chain ID for replay protection. Zone ID `0` skips the Zone ID check, but the chain ID must still match.
* Issuance and expiry timestamps

Tokens are sent via the `X-Authorization-Token` HTTP header on every request. WebSocket clients supply the token when opening the connection. Subscriptions remain scoped to that account.

## Method Access Control

The redacted RPC exposes an explicit method allowlist. Authenticating with a sequencer key doesn't bypass its privacy rules. Operator methods belong on the separate operator RPC.

Available to any authenticated caller:

| Method | Access Type | Notes |
|--------|-------------|-------|
| `eth_chainId` | Allowed | Zone chain ID |
| `eth_blockNumber` | Allowed | Latest block number |
| `eth_gasPrice` | Allowed | Current gas price |
| `eth_maxPriorityFeePerGas` | Allowed | Current priority fee |
| `eth_feeHistory` | Allowed | Redacted fee history with fixed base fee, zero rewards, and zero gas-usage ratios |
| `eth_getBlockByNumber` | Allowed | Block headers **without transaction details** |
| `eth_getBlockByHash` | Allowed | Block headers **without transaction details** |
| `eth_subscribe("newHeads")` | Allowed | Redacted block headers (see [Block Responses](https://tempo.com/developers/docs/protocol/zones/rpc#block-responses)) |
| `eth_syncing` | Allowed | Sync status |
| `eth_coinbase` | Allowed | Sequencer address |
| `net_version` | Allowed | Network ID |
| `net_listening` | Allowed | Node status |
| `web3_clientVersion` | Allowed | Client version |
| `web3_sha3` | Allowed | Pure Keccak-256 hash |
| `eth_getBalance` | Scoped | Returns balance for the authenticated account only. Queries for other accounts return `0x0`. |
| `eth_getTransactionCount` | Scoped | Returns nonce for the authenticated account only. Other accounts return `0x0`. |
| `eth_call` | Scoped | Executes with `from` set to the authenticated account. [Execution-level privacy](https://tempo.com/developers/docs/protocol/zones/accounts) enforces `balanceOf` access control at the contract level. |
| `eth_estimateGas` | Scoped | Defaults an omitted `from` to the authenticated account; rejects a mismatch and state overrides. |
| `eth_fillTransaction` | Scoped | Prepares a transaction for the authenticated account using deterministic fee defaults. |
| `eth_getTransactionByHash` | Scoped | Returns the transaction only if the authenticated account is the sender. Returns `null` otherwise. |
| `eth_getTransactionReceipt` | Scoped | Returns the receipt only if the authenticated account is the sender. Logs are filtered (see [Event Filtering](https://tempo.com/developers/docs/protocol/zones/rpc#event-filtering)). |
| `eth_sendRawTransaction` | Scoped | Validates that the transaction sender matches the authenticated account. |
| `eth_sendRawTransactionSync` | Scoped | Same sender check; returns a filtered receipt after inclusion. |
| `eth_getLogs` | Scoped | Filtered to TIP-20 events where the authenticated account is a relevant party (see [Event Filtering](https://tempo.com/developers/docs/protocol/zones/rpc#event-filtering)). |
| `eth_getFilterLogs` | Scoped | Same filtering as `eth_getLogs`. |
| `eth_getFilterChanges` | Scoped | Same filtering. Only returns new events since last poll. |
| `eth_newFilter` | Scoped | Creates an account-owned filter; the supplied topics must include the authenticated account. |
| `eth_subscribe("logs")` | Scoped | Subscription scoped to the authenticated account. |
| `eth_newBlockFilter` | Scoped | Returns new block hashes. |
| `eth_uninstallFilter` | Scoped | Removes a previously created filter. |

Scoped methods either return an error or a silent dummy value:

* **Explicit Errors:** Methods where the user explicitly provides a mismatched parameter return explicit errors. Examples are `eth_sendRawTransaction` with wrong sender and `eth_call` with wrong `from`. The user already knows the address they supplied, so the error leaks nothing.
* **Silent Responses:** Methods that query *about* other accounts return silent dummy values (`0x0`, `null`, empty results) instead of errors. An error would reveal "this data exists but you can't see it."

<span id="restricted-sequencer-only" />

### Restricted and Unavailable Methods

`eth_getBlockByNumber` and `eth_getBlockByHash` with `full=true` return `-32005` on the redacted RPC, including for sequencer accounts.

The redacted RPC doesn't expose these methods. They return `-32601` (method not found):

* Raw storage and code reads.
* Access-list creation.
* Transaction-count and transaction-by-index block methods.
* `eth_getProof`.
* Pending-transaction filters.
* Mining methods.
* The `debug_*`, `admin_*`, and `txpool_*` namespaces.

Operators use a separate RPC endpoint.

<span id="disabled" />

### Disabled Subscriptions

`eth_subscribe("newPendingTransactions")`, `eth_subscribe("syncing")`, and transaction-receipt subscriptions return `-32006` (method disabled). The supported subscriptions are `newHeads` and account-scoped `logs`.

## Timing Side Channels

The Zone RPC doesn't enforce a fixed minimum response time. Silent `null` or zero responses prevent direct disclosure through result values. They don't guarantee indistinguishable timings. Log filters must include the caller in an eligible indexed topic before retrieval. This limits the scope of backend queries.

## Block Responses

All block headers returned through the redacted RPC are sanitized:

* `transactions` is always an empty array.
* `logsBloom`, `stateRoot`, `transactionsRoot`, and `receiptsRoot` are zeroed.
* `gasUsed` and block size are zeroed, and `extraData` is empty. Optional blob-gas fields and the withdrawals root are also zeroed when present.
* Public identifiers such as `number` and `hash` remain available.

Transaction and receipt ordering fields are also redacted:

* Receipt logs include only visible events.
* `transactionIndex` is zero.
* `cumulativeGasUsed` is replaced with that transaction's gas usage.

## Event Filtering

Log queries are restricted to enabled Zone tokens and the receive-policy guard. Filters must include the authenticated address, padded to 32 bytes. It goes in `topics[1]` or `topics[2]` as appropriate for the event. Broad filters without an eligible caller topic return `-32602`. To find both outgoing and incoming transfers, query each indexed position separately.

Returned events are restricted to those where the authenticated account is a relevant party:

| Event | Visible if |
|-------|-----------|
| `Transfer` | `from == caller` OR `to == caller` |
| `Approval` | `owner == caller` OR `spender == caller` |
| `TransferWithMemo` | `from == caller` OR `to == caller` |
| `Mint` | `to == caller` |
| `Burn` | `from == caller` |
| `TransferBlocked` | Caller is the receiver, originator, or recovery authority in the claim receipt. Log queries require the indexed receiver topic; transaction receipts can also expose the event to the other eligible parties. |

All other event topics, such as system, role, and configuration events, are filtered out. Visible `logIndex` values restart at zero for each transaction, hiding the number of preceding private events.

## Zone-Specific RPC Methods

| Method | Access | Description |
|--------|--------|-------------|
| `zone_getAuthorizationTokenInfo` | Any authenticated | Returns the authenticated account address and token expiry |
| `zone_getZoneInfo` | Any authenticated | Returns `zoneId`, `zoneTokens`, `sequencers`, `chainId`, `tempoBlockNumber`, `isAccessEnforced`, and `isGatewayOpen` |
| `zone_getEncryptionKey` | Any authenticated | Returns the portal’s active encryption key from finalized Tempo state |

`zone_getDepositStatus` isn't implemented. For settlement progress, compare a deposit’s number from `DepositMade` with `ZonePortal.lastProcessedDepositNumber()` on Tempo.

## Error Codes

Authentication fails at the HTTP transport layer. These responses have no JSON-RPC error body:

* A missing token returns HTTP `401`.
* An invalid or expired token returns HTTP `403`.
* An internal authentication failure returns HTTP `500`.

Authenticated requests can return:

| Code | Message | Meaning |
|------|---------|---------|
| `-32003` | Transaction rejected | Transaction sender does not match authenticated account |
| `-32004` | Account mismatch | The `from` field does not match the authenticated account |
| `-32005` | Sequencer only | Full-block request rejected on the redacted RPC |
| `-32006` | Method disabled | Method is not available on Zones |
| `-32601` | Method not found | Method is outside the redacted RPC allowlist |
| `-32602` | Invalid params | Unsupported filter, state override, or other invalid argument |

## Related

[Connect to a Zone](https://tempo.com/developers/docs/zones/connect): Use for authorizing your application's access to a Zone deployment.

[Balances and Activity](https://tempo.com/developers/docs/zones/balances): Use for reading private balances and activity with the authenticated client.

[Accounts and Privacy](https://tempo.com/developers/docs/protocol/zones/accounts): Covers private balances, private allowances, and account-scoped access control.

[Bridging](https://tempo.com/developers/docs/protocol/zones/bridging): Covers deposits, withdrawals, encrypted deposits, and composable withdrawal callbacks.
