POST /v1/testing/fund-wallet

Free — No authentication required. See Test RPCs.

Fund a wallet on a managed test RPC with ETH and/or USDC for pre-production testing. Balances are minted on chain forks only — no real tokens are spent or created. This endpoint is only available on staging and production deployments with testing tools enabled.

Parameters

string

required

Target chain: "ethereum" or "base".

string

required

Wallet address to fund (0x...).

string

Amount of ETH to mint, in wei. Max 20000000000000000 (0.02 ETH) per call.

string

Amount of USDC to mint, in base units (6 decimals). Max 50000000 (50 USDC) per call.

At least one of ethWei or usdcAmount must be provided.

Example

curl -X POST https://api.staging.rhaios.com/v1/testing/fund-wallet \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "base",
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "ethWei": "2000000000000000",
    "usdcAmount": "5000000"
  }'

Response

{
  "success": true,
  "environment": "staging",
  "chain": "base",
  "chainId": 8453,
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "forkId": "fork-abc123",
  "funded": {
    "eth": {
      "requestedAmountWei": "2000000000000000",
      "resultingBalanceWei": "2000000000000000"
    },
    "usdc": {
      "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "requestedAmountBaseUnits": "5000000",
      "resultingBalanceBaseUnits": "5000000"
    }
  },
  "limits": {
    "maxEthWeiPerCall": "20000000000000000",
    "maxUsdcBaseUnitsPerCall": "50000000"
  },
  "allowlistEnforced": false
}

Key fields:

funded.eth / funded.usdc — Requested amounts and resulting on-fork balances
forkId — The test RPC fork that was funded
limits — Current per-call caps
allowlistEnforced — Whether the server restricts funding to an allowlisted set of wallets

Yield Endpoints

Testing Endpoints

POST /v1/testing/fund-wallet

POST /v1/testing/fund-wallet

Parameters

Example

Response

​POST /v1/testing/fund-wallet

​Parameters

​Example

​Response

POST /v1/testing/fund-wallet

Parameters

Example

Response