> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meshconnect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox & Testnets

By the end of this guide, you'll be set up to test your full Mesh integration against sandbox exchange accounts and wallet testnets — without touching real funds.

<Check>
  **Before you start**

  * You have a Mesh dashboard account with a sandbox API key (see [Prepare to build](/build/prepare-to-build))
</Check>

## Overview

The Mesh sandbox is a fully functional replica of production — same API, same flows, same SDK — but using simulated exchange data and testnets so you can build and test your integration without touching real funds.

All sandbox API calls should go to: `https://sandbox-integration-api.meshconnect.com`

## Testing exchange (CEX) flows

The sandbox includes simulated exchange accounts that behave like their production counterparts, complete with real-time market pricing and stateful portfolios. A set of pre-built test accounts covers a range of scenarios out of the box.

### Test credentials

All test accounts share the same password and MFA code:

* **Password:** `Pass123`
* **MFA / OTP code:** `123456`

But the username differs depending on the scenarios you'd like to test.

| Username   | Portfolio                                            | USD Balance | Best for                         |
| ---------- | ---------------------------------------------------- | ----------- | -------------------------------- |
| `Mesh`     | Full (BTC, ETH, BNB, USDC, USDT, SOL, XRP, and more) | \$10M       | General testing                  |
| `Mesh2`    | Empty                                                | \$0         | Empty state / zero balance flows |
| `Mesh3`    | No crypto, cash only                                 | \$10M       | Buy / onramp flows               |
| `Mesh4`    | Full                                                 | \$100M      | Large transaction testing        |
| `MeshBTC`  | BTC only                                             | \$0         | BTC-specific flows               |
| `MeshUSDC` | USDC only                                            | \$0         | USDC-specific flows              |
| `MeshUSDT` | USDT only                                            | \$0         | USDT-specific flows              |
| `MeshETH`  | ETH only                                             | \$0         | ETH-specific flows               |
| `MeshSOL`  | SOL only                                             | \$0         | SOL-specific flows               |

## Testing wallet flows

For self-custody wallet testing, the sandbox connects to real testnets. Transactions are real on-chain events — just on test networks, not mainnet.

| Wallet   | Testnet                                                         | Test token                                      | Instructions                                                                                                  |
| -------- | --------------------------------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| MetaMask | Sepolia (Ethereum testnet)<br />Base Sepolia                    | `SEPOLIAETH`<br />`SEPOLIAETH`                  |                                                                                                               |
| Phantom  | Sepolia (Ethereum testnet)<br />Base Sepolia<br />Solana Devnet | `SEPOLIAETH`<br />`SEPOLIAETH`<br />`DEVNETSOL` | Your wallet must be in testnet mode:<br />1. Go to Settings > Developer Settings<br />2. Turn on Testnet mode |

### Getting testnet tokens

You'll need testnet tokens in your wallet before you can initiate a transfer. Two ways to get them:

1. **From a public faucet** — e.g. the [Ethereum Sepolia Faucet](https://cloud.google.com/application/web3/faucet/ethereum/sepolia) for Sepolia ETH.
2. **From Mesh** — reach out to your Mesh representative to request tokens directly.

## Limitations

A few things to keep in mind as you test:

* **Exchanges:** Coinbase and a legacy Binance integration are currently the only exchanges available in sandbox. Other production exchanges are not currently replicated.
* **Mesh Managed Tokens (MMT):** Not supported in sandbox.
* **Wallets:** Only MetaMask (Sepolia) and Phantom (Sepolia & Solana Devnet) are currently supported for testnet flows.
* **Pending webhooks:** The `pending` webhook event is not guaranteed in sandbox — transfers may go directly to `succeeded` or `failed`. Don't build logic that depends on receiving `pending` during testing.
* **Testnet expansion:** Additional testnet support is on the roadmap. Reach out to your Mesh representative if you have specific testnet needs.

## What's next

Once you're happy with how everything behaves in sandbox, see [Prepare for go-live](/build/go-live) to set up your production credentials and flip the switch.

***

<Accordion title="AI coding reference (llms.txt)">
  *AI coding reference — a compact summary of this page's APIs, parameters, and patterns for use by AI coding assistants (following the [llms.txt standard](https://llmstxt.org/)). Human readers can safely ignore this.*

  **llms.txt — Sandbox & Testnets**

  Full production replica for testing. Uses simulated exchange accounts and real blockchain testnets. No real assets move.

  **Sandbox base URL**: `https://sandbox-integration-api.meshconnect.com`

  **CEX test accounts** (all use password `Pass123`, MFA/OTP `123456`):

  * `Mesh`: Full portfolio (BTC, ETH, BNB, USDC, USDT, SOL, XRP+), \$10M USD → general testing
  * `Mesh2`: Empty portfolio, \$0 → empty state / zero balance testing
  * `Mesh3`: No crypto, \$10M USD → buy/onramp testing
  * `Mesh4`: Full portfolio, \$100M USD → large transaction testing
  * `MeshBTC` / `MeshUSDC` / `MeshUSDT` / `MeshETH` / `MeshSOL`: Single-asset portfolios

  **Wallet testnets**:

  * MetaMask: Sepolia ETH (`SEPOLIAETH`), Base Sepolia (`SEPOLIAETH`)
  * Phantom: Sepolia ETH, Base Sepolia, Solana Devnet (`DEVNETSOL`). Enable testnet: Settings > Developer Settings > Testnet mode.
  * Get testnet tokens: Ethereum Sepolia Faucet, or ask your Mesh representative.

  **Sandbox limitations**: Only Coinbase + legacy Binance available. MMT not supported. `pending` webhook not guaranteed. Only MetaMask + Phantom for wallet flows.
</Accordion>
