Testnet Help

Testnet Mode

Learn about testnet operations and how to safely experiment with PUSD without real funds.

What is Testnet?

The testnet is a testing environment that simulates the mainnet PUSD stablecoin system. It allows developers and users to test functionality without using real assets.

Important: Testnet tokens have no real value. Do not use testnet for production purposes.

Testnet vs Mainnet

Testnet

Runs on Pi Testnet with play‑money Pi and PUSD.
Used to test wallet flows, mint/redeem UX, and account management.
No real USD, no bank connections.

Mainnet (Future)

Will connect PUSD to an off‑chain USD reserve (cash + T‑bills).
Same Soroban contracts, but with real banking/treasury integrations.
Subject to stricter operational and compliance controls.

Troubleshooting

Common issues and solutions

Backend not reachable

If you see errors loading balances or reserve data, check that the backend is running and NEXT_PUBLIC_SERVER_URL is correctly set.

Wrong network

Ensure that NEXT_PUBLIC_NETWORK=testnet is set when using testnet, or "mainnet" when connecting to production.

Environment Variables

Required configuration for testnet

NEXT_PUBLIC_NETWORK=testnet

# Set to 'testnet' or 'mainnet'

NEXT_PUBLIC_SERVER_URL=http://localhost:8001

# Backend API URL

NEXT_PUBLIC_USD_TEST_ASSET_CODE=USDTEST

# USD-TEST asset code (optional)