Skip to main content
Version: Next

Forking

To interact with contracts deployed on mainnet or testnet, you can use forking. Simulate the origin and experiment with it locally, making no changes to the origin itself.

$ starknet-devnet --fork-network <URL> [--fork-block <BLOCK_NUMBER>]

The value passed to --fork-network should be the URL to a Starknet JSON-RPC API provider. Specifying a --fork-block is optional; it defaults to the "latest" block at the time of Devnet's start-up. All calls will first try Devnet's state and then fall back to the forking block.

How it works

When you send a request to a forked Devnet instance, it first queries Devnet's local state, then it tries the forking origin. The forking is not simply performed on Devnet startup, but happens continuously while the Devnet instance is alive.

Account impersonation

Here you can read more about acting as an account deployed on the origin.

Deploying an undeclared account

Here you can read about deploying an account not declared on Devnet.

Checking forking status

To see if your Devnet instance is using forking or not, fetch the current configuration, and check the url property of its fork_config property. If Devnet is forked, this property contains the string of the origin URL specified on startup.