Skip to main content

​
testing_fund_wallet

Free — Requires a testing token. 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 tool is only available on staging and production deployments with testing tools enabled.

​
Parameters

​
chain
string
required
Target chain: "ethereum" or "base".
​
walletAddress
string
required
Wallet address to fund (0x...).
​
ethWei
string
Amount of ETH to mint, in wei. Max 20000000000000000 (0.02 ETH) per call.
​
usdcAmount
string
Amount of USDC to mint, in base units (6 decimals). Max 50000000 (50 USDC) per call.
​
testingToken
string
required
Server-issued testing token. Must match the deployment’s configured RHAIOS_TESTING_TOKEN.
At least one of ethWei or usdcAmount must be provided.

​
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