A Flask wrapper of Starknet state. Similar in purpose to Ganache.

Aims to mimic Starknet's Alpha testnet, but with simplified functionality.

pip install starknet-devnet

Works with Python versions <=3.9.7.

On Ubuntu/Debian, first run:

sudo apt install -y libgmp3-dev

On Mac, you can use brew:

brew install gmp

• Devnet should not be used as a replacement for Alpha testnet. After testing on Devnet, be sure to test on testnet!
• Hash calculation of transactions and blocks differs from the one used in Alpha testnet.
• Specifying a block by its hash/number is not supported. All interaction is done with the latest block.
• Read more in interaction.

Installing the package adds the starknet-devnet command.

usage: starknet-devnet [-h] [-v] [--host HOST] [--port PORT]

Run a local instance of Starknet Devnet

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         Print the version
  --host HOST           Specify the address to listen at; defaults to localhost (use the address the program outputs on start)
  --port PORT, -p PORT  Specify the port to listen at; defaults to 5000

Devnet is available as a Docker container (shardlabs/starknet-devnet):

docker pull shardlabs/starknet-devnet

The server inside the container listens to the port 5000, which you need to publish to a desired <PORT> on your host machine:

docker run -it -p [HOST:]<PORT>:5000 shardlabs/starknet-devnet

E.g. if you want to use your host machine's 127.0.0.1:5000, you need to run:

docker run -it -p 127.0.0.1:5000:5000 shardlabs/starknet-devnet

You may ignore any address-related output logged on container startup (e.g. Running on all addresses or Running on http:https://172.17.0.2:5000). What you will use is what you specified with the -p argument.

If you don't specify the HOST part, the server will indeed be available on all of your host machine's addresses (localhost, local network IP, etc.), which may present a security issue if you don't want anyone from the local network to access your Devnet instance.

• Interact with Devnet as you would with the official Starknet Alpha testnet.
• The exact underlying API is not exposed for the same reason Alpha testnet does not expose it.
• The following Starknet CLI commands are supported:
  • call
  • deploy
  • get_block
  • get_code
  • get_storage_at
  • get_transaction
  • invoke
  • tx_status
  • get_transaction_receipt
• The following Starknet CLI commands are not supported:
  • get_contract_addresses - L1-L2 interaction is currently not supported

• If you're using the Hardhat plugin, see here on how to edit its config file to integrate Devnet.

If you're a developer willing to contribute, be sure to have installed Poetry.

poetry run starknet-devnet

When running tests locally, do it from the project root.

Setup an example project by running:

./scripts/setup_example.sh

To see if Devnet can interact with starknet CLI commands, run:

python3 -m test.test_cli
python3 -m test.test_cli_auth

To see if Devnet can interact with the Hardhat plugin, run:

python3 -m test.test_plugin

poetry build