Mainnet and testnet

Floatless runs on two Monad networks. This page explains the difference, what works on each, how the app and its API stay on one network, and where to look up transactions and tokens.

Mainnet and testnet in plain words

Monad mainnet is the live network, where tokens are real money. Its chain ID, the number that identifies a network, is 143. Monad testnet is a practice network with chain ID 10143. Its tokens are for testing and aren't real money.

The two networks work the same way. On each one you need MON, Monad's own token, to pay network fees, and each has its own explorer. A dollar on testnet and a dollar on mainnet are different tokens on different networks, and nothing moves between them.

What works on each network

Morpho isn't deployed on Monad testnet, so the testnet Save tab applies the live mainnet vault's rate to your testnet AUSD and labels it Preview. Nothing is deposited on testnet.

Regulated dollars run on Monad testnet with Cleanverse's sandbox. The mainnet app doesn't list aUSDC, and the mainnet API has no Cleanverse connection.

How the app picks its network

Each Floatless app build is set to one network when it's built, and mainnet is the default. There's no network switch inside the app. A build talks only to its own network's API:

If you build the app yourself, EXPO_PUBLIC_MONAD_NETWORK picks the network, mainnet or testnet, and EXPO_PUBLIC_API_BASE_URL points the build at a different API. Each API reads MONAD_CHAIN_ID, which is 143 or 10143.

Each network keeps its own records

The mainnet and testnet APIs are separate services, each with its own database. Your payments, spending-rule records, goals and savings history on one network never mix with the other. History entries for transactions record the chain they happened on.

Your phone keeps the networks apart too. Passkey sessions, your saved account details and any payment waiting for confirmation are stored separately for each network.

If you sign in with a passkey, your wallet address is the same on mainnet and testnet, because it comes from your passkey. Your balances aren't shared, since each network has its own tokens.

The network check on every response

Every response from a Floatless API carries an x-floatless-chain-id header with that API's chain ID. The app compares it with its own network before using the response. If they differ, the app stops with a message that names both networks, for example:

This app is on Monad mainnet, but the server it reached is on Monad testnet. Nothing was changed.

A response without the header is accepted, so older servers still work.

The app checks again before you sign anything. A payment quote must name the app's chain, and the app confirms that its own connection to Monad is on that chain too. Spending rules prepared for another network are refused before you sign them.

You can read the header yourself:

curl -si https://api-mainnet.floatless.xyz/health/ready | grep -i '^x-floatless-chain-id'
curl -si https://api.floatless.xyz/health/ready | grep -i '^x-floatless-chain-id'

x-floatless-chain-id: 143
x-floatless-chain-id: 10143

The same endpoint reports the chain in its JSON body as checks.chainId.

Explorers

An explorer is a website that shows what's on a blockchain: balances, transactions and contracts. The app's links open Monadscan. MonadVision is another explorer for the same networks, and Floatless's contracts are source-verified on both.

Tokens on each network

These are the tokens the app shows for each network.

MON has no token address on either network. It's the network's own currency, and your Wallet balance includes it.

Testnet tokens and faucets

A faucet hands out free test tokens. Here's what Floatless's code points to for each test token:

• Test USDC. In the testnet app, once Cleanverse has verified you, the Get aUSDC, verified dollars card in Add money shows your Cleanverse deposit address and links to Circle's faucet with Get free test USDC. Choose Monad testnet there and paste that address. The card says Cleanverse locks USDC sent there from a Cleanverse-approved source and adds the same amount of aUSDC to your wallet.
• Test AUSD. Floatless's testnet records list Agora's AUSD faucet contract at 0xd236c18D274E54FAccC3dd9DDA4b27965a73ee6C. The app doesn't link to it.
• Test MON. Floatless doesn't provide testnet MON, and the app doesn't link to a faucet for it. You'll need some from a Monad testnet faucet to pay network fees.