How-to guides > Request test USDC

Request test USDC

Mint devnet-only test USDC to a wallet through Quovra's faucet endpoint.

Request test USDC

Quovra includes a devnet faucet for demo deposits. The faucet mints 100 test USDC to a wallet when the server has a mint authority configured.

Endpoint

http
POST /api/faucet

Request

bash
curl -X POST https://quovra.xyz/api/faucet \
  -H 'Content-Type: application/json' \
  -d '{"wallet":"<SOLANA_WALLET_ADDRESS>"}'

Response

json
{
  "signature": "<devnet transaction signature>",
  "amount": 100000000,
  "mint": "C4ERwQWEttoeawS5wy1NGZRhqphK7PeGtM4mPAHvcf4b"
}

Error responses

StatusCauseResolution
400Missing or invalid wallet addressSend a valid Solana public key
429Wallet cooldown activeWait for the reported number of seconds
503Faucet not configuredSet QUOVRA_FAUCET_SECRET on the server
500Mint transaction failedCheck RPC, mint authority, and server logs

TypeScript example

ts
import { requestFaucet } from "./src/lib/quovra-client"

const signature = await requestFaucet(wallet.publicKey.toBase58())
console.log(signature)

Best practices

  • Keep QUOVRA_FAUCET_SECRET server-only.
  • Rate-limit by wallet and IP in production.
  • Use a devnet mint only.
  • Never reuse a real treasury key as faucet authority.

Related pages

Search keywords

faucet, devnet USDC, mint, cooldown, API endpoint

Last updated: [YYYY-MM-DD]