Alpha Testnet

GoodDollar L2 Testnet Guide

Everything you need to connect, get test tokens, and try all 6 DeFi protocols. Follow the 5 guided scenarios below to explore the full platform.

Prerequisites

MetaMask (or any EVM-compatible wallet)
A desktop browser (Chrome, Firefox, or Brave recommended)

1. Add GoodChain Testnet

One click adds the network to MetaMask (or any EIP-1193 wallet) using the canonical values below.

Network Name	GoodChain Testnet
RPC URL	https://rpc.goodclaw.org
Chain ID	42069
Currency	G$ (GoodDollar)
Explorer	https://explorer.goodclaw.org

Or add it manually

Open MetaMask → Settings → Networks → Add Network
Enter the network details from the table above
Click Save — the network appears in your network selector

2. Get Test G$

Visit the Faucet page to claim free test tokens:

Navigate to the Faucet page in the app
Connect your wallet
Click "Claim Test Tokens"
You'll receive 10,000 G$ and 1 WETH

For developers

Verify the public RPC and look up canonical addresses without leaving the docs. Everything below points to the same registry the frontend uses at runtime.

Test the public RPC

curl -sX POST https://rpc.goodclaw.org -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"eth_blockNumber","id":1}'

Canonical contract addresses: op-stack/addresses.json → (single source of truth for the frontend, backend, and cast scripts)
System architecture & protocol topology: docs/ARCHITECTURE.md →
GitHub-facing testnet entry point: docs/TESTNET_README.md →
Lane 6 release proof page: /live-prices-proof → (live eToro quotes, on-chain oracle reads, recent tx hashes, last demo hedge)

Guided Test Scenarios

Follow these 5 scenarios to test every protocol.

Execute your first token swap on GoodSwap.

Steps

Navigate to Swap (top nav)
Select WETH as the input token
Enter 0.1 WETH
Select G$ as the output token
Click Swap and confirm in MetaMask

Expected outcome

Your WETH balance decreases by 0.1
Your G$ balance increases (amount shown in preview)
A success toast appears with the transaction hash
UBI fee counter on the UBI Impact page increments

✓ What to verify

Check the transaction on the explorer
Verify the UBI fee was routed (33% of swap fee → UBI)

Deposit margin and open a leveraged BTC long position.

Steps

Navigate to Perps
Click Deposit Margin
Enter 1000 G$ and confirm
Select the BTC/USD market
Choose Long, set leverage to 2x
Enter position size: 500 G$
Click Open Position and confirm

Expected outcome

Margin account shows 1000 G$ deposited
An open position appears: BTC Long, 2x leverage, 500 G$ size
Entry price matches the current oracle price
Funding rate is displayed

✓ What to verify

Position details match your inputs
Wait 1 minute — verify funding accrues
Close the position and verify PnL calculation

Create a binary prediction market and place a bet.

Steps

Navigate to Predict
Click Create Market
Enter question: "Will ETH be above $4000 by end of month?"
Set end date to 7 days from now
Deposit 100 G$ as initial collateral
Confirm market creation

Expected outcome

A new market card appears on the Predict page
Market shows your question, end date, and initial odds (50/50)

✓ What to verify

G$ balance decreased by 100
Choose YES on the market and bet 50 G$
Market odds shift from 50/50 after your bet

Supply G$ to earn interest, then borrow WETH against your collateral.

Steps

Navigate to Lend
Click Supply on the G$ market
Enter 5000 G$ and confirm
You receive gGD tokens (receipt tokens)
Click Borrow on the WETH market
Enter 0.1 WETH and confirm

Expected outcome

Supply appears in dashboard with APY (e.g., 3.8%)
WETH borrow appears with borrow APY
Health factor shown (should be > 1.5)

✓ What to verify

gGD token balance matches your supply
Borrow limit reflects your collateral value
After 1 block, interest accrues on supply and borrow

Deposit collateral and mint the stablecoin gUSD.

Steps

Navigate to Stable
Click Mint gUSD
Select WETH as collateral
Enter 0.5 WETH
Review the mint amount (~750 gUSD at 150% ratio)
Click Mint and confirm

Expected outcome

WETH balance decreases by 0.5
gUSD balance increases
A vault position shows your collateral ratio (≥ 150%)

✓ What to verify

Vault details page shows correct collateral and debt
Try repaying some gUSD to reduce your debt
Collateral ratio updates in real time

Troubleshooting

"Transaction reverted" error

Ensure you have enough G$ for the transaction + gas. Check token approvals are set. Try refreshing and reconnecting.

Wallet not connecting

Verify you're on GoodChain Testnet (chain ID 42069). Try disconnecting and reconnecting. Clear MetaMask cache: Settings → Advanced → Reset Account.

Prices showing $0 or stale

The oracle keeper may be syncing — wait 30 seconds and refresh. Check the Status page to verify oracle services are running.

"Insufficient balance" error

Visit the Faucet page to claim more test tokens. Some protocols require approval transactions first.

Feedback

Found a bug or have a suggestion? Use the Feedback button in the bottom-right corner of every page, or open an issue on GitHub →.

Thank you for testing GoodDollar L2! Your feedback directly shapes the protocol.

1. Add GoodChain Testnet

One click adds the network to MetaMask (or any EIP-1193 wallet) using the canonical values below.

Network Name	GoodChain Testnet
RPC URL	https://rpc.goodclaw.org
Chain ID	42069
Currency	G$ (GoodDollar)
Explorer	https://explorer.goodclaw.org

Or add it manually

Open MetaMask → Settings → Networks → Add Network
Enter the network details from the table above
Click Save — the network appears in your network selector

For developers

Verify the public RPC and look up canonical addresses without leaving the docs. Everything below points to the same registry the frontend uses at runtime.

Test the public RPC

curl -sX POST https://rpc.goodclaw.org -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"eth_blockNumber","id":1}'

Canonical contract addresses: op-stack/addresses.json → (single source of truth for the frontend, backend, and cast scripts)

System architecture & protocol topology: docs/ARCHITECTURE.md →

GitHub-facing testnet entry point: docs/TESTNET_README.md →

Lane 6 release proof page: /live-prices-proof → (live eToro quotes, on-chain oracle reads, recent tx hashes, last demo hedge)

Troubleshooting

"Transaction reverted" error

Ensure you have enough G$ for the transaction + gas. Check token approvals are set. Try refreshing and reconnecting.

Wallet not connecting

Verify you're on GoodChain Testnet (chain ID 42069). Try disconnecting and reconnecting. Clear MetaMask cache: Settings → Advanced → Reset Account.

Prices showing $0 or stale

The oracle keeper may be syncing — wait 30 seconds and refresh. Check the Status page to verify oracle services are running.

"Insufficient balance" error

Visit the Faucet page to claim more test tokens. Some protocols require approval transactions first.

GoodDollar L2 Testnet Guide

Prerequisites

1. Add GoodChain Testnet

2. Get Test G$

For developers

Guided Test Scenarios

First Swap (WETH → G$)

Open a Perps Position (Long BTC)

Create a Prediction Market

Supply to GoodLend & Borrow

Mint GoodStable (gUSD)

Troubleshooting

Feedback

GoodDollar L2 Testnet Guide

Prerequisites

1. Add GoodChain Testnet

2. Get Test G$

For developers

Guided Test Scenarios

First Swap (WETH → G$)

Open a Perps Position (Long BTC)

Create a Prediction Market

Supply to GoodLend & Borrow

Mint GoodStable (gUSD)

Troubleshooting

Feedback