Quickstart

Install and configure

pnpm install
cp .env.example .env.local

Set at least the following in .env.local (full list in Environment variables):

SKIP_ENV_VALIDATION=1            # skips DB/auth/email validation for local UI work
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_NETWORK=robinhood    # testnet; use robinhood-mainnet only for a real mainnet deployment
NEXT_PUBLIC_CHAIN_ID=46630
NEXT_PUBLIC_RPC_URL=https://rpc.testnet.chain.robinhood.com/rpc
NEXT_PUBLIC_REOWN_PROJECT_ID=your_reown_project_id
# plus the NEXT_PUBLIC_* contract addresses (including NEXT_PUBLIC_payment token_ADDRESS) from your deployment

Leave NEXT_PUBLIC_BACKEND_URL empty unless you run your own backend.

Start the app

pnpm dev

Open http://localhost:3000 for the landing page, or http://localhost:3000/app for the web app (its own dashboard layout; use the language toggle in the top bar to switch between English and 中文). If any contract address is missing, a banner lists the missing variables. Because NEXT_PUBLIC_NETWORK is not robinhood-mainnet, a red/amber "Testnet / unaudited" banner is shown; that is expected.

Connect a wallet

Use Connect Wallet (Reown AppKit / WalletConnect, or an injected wallet like MetaMask). Switch to Robinhood Chain Testnet when prompted. See Reown AppKit and Networks.

Get test funds

• Gas (ETH): https://faucet.testnet.chain.robinhood.com
• Mock payment token (testnet only): MockERC20.mint(address,uint256) has no access control, so any account can mint itself test payment token. Mind the token's decimals: the app reads decimals() of NEXT_PUBLIC_payment token_ADDRESS. Mainnet has no mock and no faucet.
• Credits: there is no free-credit path. The app has no starter pack; credits exist only when an authorized issuer has issued them to your wallet (or you buy them on the marketplace).

Try a flow

Follow Buy credits, Sell credits or Run an auction.