RPC Routes

In addition to the standard Ethereum JSON-RPC methods, your Stagenet exposes a dev_* namespace for performing development actions.

Categories

• Import Contracts — push compiled contracts to your Stagenet so deployments get dashboards automatically.
• Balances — add or overwrite native and ERC20 balances.
• State — override code, nonce, balance, and storage on any account.
• Function Overrides — intercept contract reads and return a fixed value.
• Impersonation — send transactions from any address without its private key.
• Mainnet Follow — keep selected state synced to the live chain.
• dev_getStagenetInfo (below) — the Stagenet’s chain IDs and native currency.

Calling conventions

All dev_* methods follow standard JSON-RPC 2.0. POST to your Stagenet RPC URL:

curl -X POST <YOUR_STAGENET_RPC_URL> \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "dev_addBalance",
    "params": ["0x1111111111111111111111111111111111111111", "1000000000000000000"]
  }'

Amounts are passed as strings — either a decimal integer or a 0x-prefixed hex value. This avoids JSON number precision loss for values larger than 2^53.

Addresses are 0x-prefixed Ethereum addresses, case-insensitive.

Errors are returned in the standard JSON-RPC error field. A 200 OK HTTP response with error populated still indicates failure — always check the body.

dev_getStagenetInfo

The Stagenet’s chain IDs and native currency. No parameters. Values do not change for the life of a Stagenet.