Add Tempo to your wallet
MetaMask and most wallets ship with Ethereum, Base, and a handful of other chains preset. Tempo (chain id 4217) is newer, so you need to add it once. After that it shows up in your network dropdown like any other chain.
Add Tempo automatically
Click the button below. Your wallet will pop up a confirmation listing the network parameters; review and approve. This works in MetaMask (extension or in-app browser), Rabby, OKX Wallet, Coinbase Wallet, and most EIP-1193 wallets.
Under the hood this calls wallet_addEthereumChain (EIP-3085) with the parameters in the table below. We never see or store anything.
Or copy the parameters into your wallet
If the one-click button doesn't work (mobile Safari without an injected wallet, hardware wallet, custom UI, etc.), open your wallet's “Add custom network” screen and paste:
| Network name | Tempo |
| New RPC URL | https://rpc.tempo.xyz |
| Chain ID | 4217 hex: 0x1079 |
| Currency symbol | pUSD MetaMask only allows 1–6 character symbols, so pathUSD (7 chars) won't fit. Use the short alias pUSD for the symbol field; the on-chain token name is still pathUSD. |
| Currency decimals | 18 MetaMask hardcodes 18 even though pathUSD is actually 6 decimals on-chain. Transactions still work; MM's native balance label will be off by a factor of 10^12 — use tempopay.pro for the real balance. |
| Block explorer URL | https://explorer.tempo.xyz |
Manual flow inside MetaMask
MetaMask extension: top-left, click the network name (e.g. 'Ethereum Mainnet'). MetaMask Mobile: tap the menu (☰), then 'Networks'.
Scroll to the bottom of the network list and click 'Add a network' or 'Add network'. MetaMask may show a list of popular chains — ignore them and click 'Add a network manually' (extension) or 'Add custom network' (mobile).
Use the values in the table above. Network name = Tempo, RPC URL = https://rpc.tempo.xyz, Chain ID = 4217, Currency symbol = pUSD (MM caps symbols at 6 chars), Decimals = 18 (MM rejects anything else), Block explorer = https://explorer.tempo.xyz.
Click Save. MetaMask asks if you want to switch to the new network — say yes. The network selector now shows 'Tempo'.
Reload tempopay.pro. The topbar pill should show 'Tempo · 4217' in green. Your balance reads should now resolve.
If something goes wrong
MetaMask says "could not detect network" or "RPC error"+
https://rpc.tempo.xyz — no typos, no trailing slash. If the public RPC is rate-limited at the moment, wait 30 seconds and retry. If you have a private RPC, you can use that instead — chain id stays 4217.MetaMask says "chain id mismatch"+
4217. If you used a different RPC URL by accident (e.g. a different EVM chain's endpoint) the form will reject. Re-check the value against the table.The one-click button does nothing on mobile Safari+
window.ethereum available, so the button can't inject the network. Either install MetaMask Mobile and open this page inside its in-app browser, or use the manual flow inside the MetaMask Mobile app (Menu → Networks → Add custom network).Balance still shows zero after switching+
MetaMask shows my pathUSD balance as 0.00000…01 or some absurd number+
decimalsfield of a network's native currency to equal 18 (it rejects any other value with the error you may have seen: “Expected the number 18”). pathUSD actually has 6 decimals on-chain. We register the chain with decimals=18 to satisfy MetaMask, but the result is that MM displays your native balance off by a factor of 1012. Transactions still execute correctly (amounts are wire-encoded in the token's real decimals). For the correct balance, use the TempoPay dashboard at tempopay.pro — it reads pathUSD via ERC-20 balanceOf with the proper 6 decimals.I don't trust adding a custom network — what risks does it carry?+
https://rpc.tempo.xyz. If in doubt, run your own Tempo node (validator or RPC) and point your wallet there.Ready to use TempoPay
With Tempo added to your wallet, you can connect on tempopay.pro and start sending. New here? Read the walkthrough first.