Run a Local Rollup and Sequencer
This guide will walk you through running a local Geth rollup against the Astria sequencer, using the astria-go
cli to run the required components of the Astria stack locally on your machine.
Setup a Geth Rollup
Requires Go
, just
, and Foundry
:
Open a new terminal window and clone and build Geth:
Create a new genesis account for your Geth rollup:
cast w new
Open the geth-genesis-local.json
file in your Geth repo and update the "alloc"
account with the new address you just created, as well as updating the "chainId"
and "astriaRollupName"
to something of your choosing:
{
"config": {
...
"chainId": <6 digit number>,
"astriaRollupName": "<your rollup name>",
...
"alloc": {
"<your new address>": { "balance": "300000000000000000000" }
}
}
}
You will use the private key for your new account to send test transactions later on.
Start Geth
In your Geth terminal window, run the following to initialize and run the Geth rollup:
# in astria-geth dir
just init
just run
If you need to restart the rollup, you can stop the program with Ctrl+C
and restart with:
just run
If you need to restart the rollup and want to also clear the state data, you can use:
just clean-restart
Configure and Start the Local Astria Sequencer
Open a new terminal window and initialize the cli:
astria-go dev init
Navigate to the ~/.astria
directory. If you have run the commands shown above, you should find a default
directory.
Open the ~/.astria/default/networks-config.toml
file and update the rollup_name
variable in the [local]
sections using the same "astriaRollupName"
you used when setting up your Geth rollup.
[networks.local]
sequencer_chain_id = 'sequencer-test-chain-0'
sequencer_grpc = 'http://127.0.0.1:8080'
sequencer_rpc = 'http://127.0.0.1:26657'
rollup_name = '<your rollup name>' # update this value
default_denom = 'ntia'
Use the cli to run a local Astria Sequencer.
astria-go dev run --network local
TIP
When running an Astria sequencer using the cli, the --network local
setting is the default. astria-go dev run
is effectively an alias for astria-go dev run --network local
.
When running the Astria stack locally, you will see a TUI that displays the logs of the Astria Sequencer, the underlying Cometbft node, the Astria Conductor, and Astria Composer:
Test your Rollup
To test that your rollup and the sequencer are configured and running correctly, you can follow the Test Transactions instructions here.