Target a Stagenet

Stagenet commands — push-contracts, balance, state, impersonate, follow, and friends — need a stagenet to talk to. You pick one once, or override it per command.

`stagenets`

List the active workspace’s stagenets (* marks the active one):


contract.dev stagenets


* base-staging  — fork of 8453
  eth-staging   — fork of 1  (offline)

`stagenet use`

Set the active stagenet. It is stored per workspace, so switching workspaces switches stagenets too. The reference can be a name or id:


contract.dev stagenet use base-staging

`stagenet`

Show the active stagenet and its RPC URL:


contract.dev stagenet

One-off overrides

Any stagenet command accepts:

Flag / env	Description
`--stagenet <name>` / `CONTRACT_DEV_STAGENET`	Resolve a stagenet by name or id for this run only.
`--rpc-url <url>` / `CONTRACT_DEV_RPC_URL`	Hit an RPC URL directly. Works with no login at all — useful for CI and for external teams you’ve shared a stagenet’s RPC URL with.

Resolution order: --rpc-url → --stagenet → the active stagenet set with stagenet use.


contract.dev balance add 0xRecipient "1 ether" --stagenet eth-staging
contract.dev push-contracts --rpc-url https://rpc.contract.dev/abc123