Skip to content

Commit 6356e62

Browse files
authored
feat: update tutorial to use quick start instead of GM (#481)
1 parent 1f673fb commit 6356e62

File tree

1 file changed

+18
-76
lines changed

1 file changed

+18
-76
lines changed

tutorials/celestia-da.md

Lines changed: 18 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ import constants from '../.vitepress/constants/constants.js'
99

1010
This tutorial serves as a comprehensive guide for deploying your rollup on Celestia's data availability (DA) network. From the Rollkit perspective, there's no difference in posting blocks to Celestia's testnets or Mainnet Beta.
1111

12-
Before proceeding, ensure that you have completed the [GM world rollup](/tutorials/gm-world) tutorial, which covers setting up a local sovereign `gm-world` rollup and connecting it to a local DA node.
12+
Before proceeding, ensure that you have completed the [quick start](/tutorials/quick-start) tutorial, which covers installing the rollkit CLI and running a rollup against a local DA network.
1313

1414
## 🪶 Running a Celestia light node
1515

16-
Before you can start your rollup node, you need to initiate, sync, and possibly fund a light node on one of Celestia's networks:
16+
Before you can start your rollup node, you need to initiate, sync, and fund a light node on one of Celestia's networks:
1717

1818
- [Arabica Devnet](https://docs.celestia.org/nodes/arabica-devnet)
1919
- [Mocha Testnet](https://docs.celestia.org/nodes/mocha-testnet)
@@ -25,99 +25,39 @@ After successfully starting a light node, it's time to start posting the batches
2525

2626
## 🏗️ Prerequisites {#prerequisites}
2727

28-
* `rollkit` CLI installed from the [GM world rollup](/tutorials/gm-world) tutorial.
29-
* `ignite` CLI v28.4.0 installed `curl https://get.ignite.com/[email protected]! | bash`
28+
* `rollkit` CLI installed from the [quick start](/tutorials/quick-start) tutorial.
3029

31-
## 🏗️ Building your sovereign rollup {#building-your-sovereign-rollup}
32-
33-
Remove the existing `gm` project and create a new one using ignite:
34-
35-
```bash
36-
cd $HOME && rm -rf gm
37-
ignite scaffold chain gm --address-prefix gm --no-module
38-
```
39-
40-
Install the Rollkit app to ignite:
41-
42-
```bash-vue
43-
cd $HOME/gm
44-
ignite app install github.com/ignite/apps/rollkit@rollkit/{{constants.rollkitIgniteAppVersion}}
45-
```
46-
47-
Add the Rollkit app:
48-
49-
```bash
50-
ignite rollkit add
51-
```
52-
53-
Build the rollup node binary to use it for the chain configuration and to initialize:
54-
55-
```bash
56-
ignite chain build
57-
```
58-
59-
Initialize the Rollkit chain configuration:
60-
61-
```bash
62-
ignite rollkit init
63-
```
64-
65-
This will create a `$HOME/.gm` directory with the chain configuration files.
66-
67-
## 🧰 Configuring your sovereign rollup {#configuring-your-sovereign-rollup}
68-
69-
From the `$HOME/gm` directory, generate a `rollkit.toml` file by running:
70-
71-
```bash
72-
rollkit toml init
73-
```
74-
75-
The output should be similar to this (`$HOME` in the below example is `/root`):
76-
77-
```
78-
Found rollup entrypoint: /root/gm/cmd/gmd/main.go, adding to rollkit.toml
79-
Found rollup configuration under /root/.gm, adding to rollkit.toml
80-
Initialized rollkit.toml file in the current directory.
81-
```
82-
8330
## 🛠️ Configuring flags for DA
8431

85-
Now, we're prepared to initiate our rollup and establish a connection with the Celestia light node. The `rollkit start` command requires three DA configuration flags:
32+
Now that we are posting to the Celestia DA instead of the local DA, the `rollkit start` command requires three DA configuration flags:
8633

8734
- `--rollkit.da_start_height`
8835
- `--rollkit.da_auth_token`
8936
- `--rollkit.da_namespace`
9037

91-
Let's determine which values to provide for each of them.
92-
93-
First, let's query the DA layer start height using an RPC endpoint provided by Celestia's documentation.
94-
95-
::: tip
38+
:::tip
9639
Optionally, you could also set the `--rollkit.da_block_time` flag. This should be set to the finality time of the DA layer, not its actual block time, as Rollkit does not handle reorganization logic. The default value is 15 seconds.
9740
:::
9841

99-
Let's determine what to provide for each of them.
100-
101-
- Mocha testnet: [https://rpc-mocha.pops.one/block](https://rpc-mocha.pops.one/block)
102-
- Mainnet Beta: [https://rpc.lunaroasis.net/block](https://rpc.lunaroasis.net/block)
42+
Let's determine which values to provide for each of them.
10343

104-
Here is an example for the Mocha testnet (replace URL for Mainnet Beta accordingly):
44+
First, let's query the DA layer start height using our light node.
10545

10646
```bash
107-
DA_BLOCK_HEIGHT=$(curl https://rpc-mocha.pops.one/block | jq -r '.result.block.header.height')
47+
DA_BLOCK_HEIGHT=$(celestia header network-head | jq -r '.result.header.height')
10848
echo -e "\n Your DA_BLOCK_HEIGHT is $DA_BLOCK_HEIGHT \n"
10949
```
11050

11151
The output of the command above will look similar to this:
11252

11353
```bash
114-
Your DA_BLOCK_HEIGHT is 1777655
54+
Your DA_BLOCK_HEIGHT is 2127672
11555
```
11656

11757
Now, let's obtain the authentication token of your light node using the following command (omit the --p2p.network flag for Mainnet Beta):
11858

11959
```bash
120-
AUTH_TOKEN=$(celestia light auth write --p2p.network mocha)
60+
AUTH_TOKEN=$(celestia light auth write --p2p.network arabica)
12161
echo -e "\n Your DA AUTH_TOKEN is $AUTH_TOKEN \n"
12262
```
12363

@@ -162,15 +102,17 @@ rollkit start \
162102
--rollkit.da_auth_token $AUTH_TOKEN \
163103
--rollkit.da_namespace $DA_NAMESPACE \
164104
--rollkit.da_start_height $DA_BLOCK_HEIGHT \
165-
--rollkit.da_address $DA_ADDRESS \
166-
--minimum-gas-prices="0.025stake"
105+
--rollkit.da_address $DA_ADDRESS
167106
```
168107

169-
Now, the rollup is running and posting blocks (aggregated in batches) to Celestia. You can view your rollup by using your namespace or account on [Mocha testnet](https://docs.celestia.org/nodes/mocha-testnet#explorers) or [Mainnet Beta](https://docs.celestia.org/nodes/mainnet#explorers) explorers.
108+
Now, the rollup is running and posting blocks (aggregated in batches) to Celestia. You can view your rollup by using your namespace or account on one of Celestia's block explorers.
170109

171-
::: info
172-
For details on configuring gas prices, specifically for the Celestia network, see the [DA Network Gas Price Guide](/guides/gas-price). The Celestia gas price is separate from the `--minimum-gas-prices="0.025stake"` setting, which is used for the rollup network operations.
173-
:::
110+
For example, [here on Celenium for Arabica](https://arabica.celenium.io/).
111+
112+
Other explorers:
113+
- [Arabica testnet](https://docs.celestia.org/nodes/arabica-testnet#explorers)
114+
- [Mocha testnet](https://docs.celestia.org/nodes/mocha-testnet#explorers)
115+
- [Mainnet Beta](https://docs.celestia.org/nodes/mainnet#explorers)
174116

175117
## 🎉 Next steps
176118

0 commit comments

Comments
 (0)