Quickstart

This guide takes you from a fresh wallet to your first sponsored transaction. The same flow runs in the demo against simulated data, which is the best way to try it until contracts are deployed.

Before you start#

You need three things:

• A wallet that can connect to Robinhood Chain. Supported connectors are MetaMask and other injected browser wallets, Rabby, Coinbase Wallet, Safe, any WalletConnect v2 wallet, and Robinhood Wallet, which connects through WalletConnect.
• Some USDG on Robinhood Chain to pay for your pass.
• Optionally, a little ETH. Sponsored transactions do not need it, but the one-time USDG approval before your first pass is paid by your own wallet.

1. Connect your wallet#

Open the app and choose Connect wallet. The modal groups wallets by how they connect.

• Browser wallets such as MetaMask and Rabby connect directly through the extension.
• Robinhood Wallet has its own row, labelled via WalletConnect. Choose it, then open Robinhood Wallet on your phone and scan the QR code. On mobile, the row deep-links straight into the app.
• Safe connects when you open Therm from inside the Safe interface.

If your wallet is on another network, Therm shows a Switch to Robinhood Chain prompt. If your wallet has never seen Robinhood Chain, use Add Robinhood Chain, which sends the chain's RPC, explorer and currency details to your wallet in a standard wallet_addEthereumChain request. Your wallet will ask you to confirm.

2. Get a quote#

In the Quote panel, enter the amount of USDG you want to spend. The panel updates as you type and shows:

The quote moves every few seconds because it tracks the base fee and the pool's coverage ratio. The rate that counts is the one shown when you confirm; it is written into your pass and never changes after that. See Buying therms for exactly how it is computed.

If coverage is below 0.5×, pass sales are paused and the panel says so. Sales resume on their own as the spike passes and coverage recovers.

3. Buy therms#

Choose Buy pass. On mainnet you will sign two transactions the first time: a USDG approval, then the purchase itself. The purchase call includes a minimum number of therms, so if the quote moves against you by more than your tolerance before the block lands, it reverts instead of filling at a worse rate.

When the pass confirms you will see it in your history with the USDG paid, therms received and the locked rate. Your therm balance updates immediately. Therms are an ERC-20 token, so they also appear in any wallet that tracks custom tokens.

4. Send your first sponsored transaction#

Transact as you normally would. When the transaction targets an eligible contract, your wallet builds it as an ERC-4337 user operation that names the Therm paymaster. The paymaster checks three things before agreeing to pay:

1. You hold enough therms to cover the operation's gas limit.
2. You are under the hourly throughput cap of 50 therms per address.
3. The target contract and call are on the sponsorship allowlist.

The bundler submits the operation, the paymaster pays the base fee in ETH from the pool, and the exact gas used is burned from your therm balance. A typical stock-token swap uses around 320,000 gas and burns about 3.2 therms. You pay nothing further, whatever the base fee was in that block.

In the demo, Simulate a transaction runs this flow and records the gas used, therms burned and what the same transaction would have cost at the live base fee.

Checklist#

• Wallet connected and on Robinhood Chain
• Quote shows a locked rate and a therm amount
• Pass confirmed and visible in history
• First sponsored transaction burned therms from your balance

If something goes wrong#

The paymaster declined my transaction. Your wallet will fall back to paying gas itself if you hold ETH. The most common reasons are an empty balance, the hourly cap, or a target contract outside the allowlist. See Spending therms.

My wallet does not support user operations. You need an ERC-4337 smart account, or a wallet that supports EIP-7702 delegation. Plain EOAs cannot use a paymaster directly.

I bought too many therms. Therms cannot be refunded for USDG. They do not expire, and you can transfer them to another address or another person.