RPC Routes

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

These are the same methods the contract.dev SDK calls internally. Use them directly when you want to drive the Stagenet from a language other than JavaScript, from curl, or from a tool that doesn’t have a Stagenet adapter.

Categories

• Balances — add or overwrite native and ERC20 balances.
• State — override code, nonce, balance, and storage on any account.
• State Tracking — record balances, ERC20 holdings, storage slots, and view function results over time.
• Impersonation — send transactions from any address without its private key.

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.