Skip to content

Commit ab2d3a5

Browse files
committed
revise intro and sync sections
1 parent 048465c commit ab2d3a5

1 file changed

Lines changed: 63 additions & 17 deletions

File tree

docs/bee/installation/quick-start.md

Lines changed: 63 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Quickstart
33
id: quick-start
44
---
55

6-
This guide will help you install and run a Bee [light node](/docs/bee/working-with-bee/node-types) using the [shell script](/docs/bee/installation/shell-script-install) install method. After explaining how to install and start the node, the guide then explains how to use the [`swarm-cli` command line tool](/docs/bee/working-with-bee/swarm-cli) to find your node's address, fund your node, and buy a batch of postage stamps. Finally it explains how to upload data using a postage stamp batch and how to download that data.
6+
This guide will help you install and run a Bee [light node](/docs/bee/working-with-bee/node-types) using the [shell script](/docs/bee/installation/shell-script-install) install method. After explaining how to install and start the node, the guide then explains how to use the [`swarm-cli` command line tool](/docs/bee/working-with-bee/swarm-cli) to find your node's address, fund your node, and finally wait for it to sync.
77

88
:::tip
99
A "light" node can download and upload data from Swarm but does not share its disk space with the network and does not earn rewards. [Learn more](/docs/bee/working-with-bee/node-types).
@@ -168,11 +168,11 @@ Learn how to [get xDAI and xBZZ](/docs/bee/installation/fund-your-node#getting-t
168168
If you wait too long to fund your node it may shut itself down. In that case, simply use the same startup command to start the node again.
169169
:::
170170
171-
## Wait to Sync (~30 Minutes)
171+
## Wait to Sync (~5 Minutes)
172172
173173
After starting and funding a Bee light node for the first time, the node will automatically issue a [transaction](https://gnosisscan.io/tx/0xf8048c4e8020ccef842c9a901e6262e9c06d6f5926ff31bdb7dd9d7274dcf19c) on Gnosis Chain to deploy the node's [chequebook contract](/docs/concepts/incentives/bandwidth-incentives#chequebook-contract).
174174
175-
The node then needs to sync blockchain data before it can buy a postage stamp batch. The process may take ***half an hour or longer*** depending on your RPC provider and network speed.
175+
The node then needs to sync blockchain data before it can buy a postage stamp batch. The process may take **~5 minutes** depending on your RPC provider and network speed.
176176
177177
You can check your node's syncing progress with the `swarm-cli status` command:
178178
@@ -183,32 +183,78 @@ swarm-cli status
183183
```bash
184184
Bee
185185
API: http://localhost:1633 [OK]
186-
Version: 2.6.0-390a402e
186+
Version: 2.6.0-d0aa8b93
187187
Mode: light
188188
189+
Chainsync
190+
Block: 39,566,742 / 41,710,807 (Δ 2,144,065)
191+
189192
Topology
190-
Connected Peers: 143
191-
Population: 6991
192-
Depth: 11
193+
ERROR Request failed with status code 503
193194
194-
Wallet
195-
xBZZ: 0.0000000000000000
196-
xDAI: 0.009829728398864856
195+
There may be additional information in the Bee logs.
196+
```
197+
198+
The `Chainsync` section tells us how many blocks our node has synced so far out of the total Gnosis Chain blocks (and the number after the Δ symbol shows how many blocks still need to be synced):
197199
200+
```bash
198201
Chainsync
199202
Block: 33,515,656 / 38,855,407 (Δ 5,339,751)
203+
```
204+
205+
The `Topology` section will show information about which other nodes your own node is connected with. It will display an `ERROR` until the node is fully initialized.
206+
207+
After several minutes, your node will be fully synced, and can now interact with the Swarm network - we can use `swarm-cli status` again to confirm:
208+
209+
```bash
210+
swarm-cli status
211+
```
212+
213+
```bash
214+
Bee
215+
API: http://localhost:1633 [OK]
216+
Version: 2.6.0-d0aa8b93
217+
Mode: light
218+
219+
Chainsync
220+
Block: 41,710,955 / 41,710,962 (Δ 7)
221+
222+
Topology
223+
Connected Peers: 151
224+
Population: 2257
225+
Depth: 10
226+
227+
Wallet
228+
xBZZ: 0.0000000000000000
229+
xDAI: 0.009787142484816165
200230
201231
Chequebook
202232
Available xBZZ: 0.0000000000000000
203233
Total xBZZ: 0.0000000000000000
234+
noah@NoahM16:~$ swarm-cli status
235+
Bee
236+
API: http://localhost:1633 [OK]
237+
Version: 2.6.0-d0aa8b93
238+
Mode: light
204239
205-
Staking
206-
Staked xBZZ: 0.0000000000000000
207-
```
240+
Chainsync
241+
Block: 41,711,260 / 41,711,268 (Δ 8)
208242
209-
The `Chainsync` section tells us how many blocks our node has synced so far out of the total Gnosis Chain blocks (and the number after the Δ symbol shows how many blocks still need to be synced):
243+
Topology
244+
Connected Peers: 156
245+
Population: 2693
246+
Depth: 10
210247
211-
```bash
212-
Chainsync
213-
Block: 33,515,656 / 38,855,407 (Δ 5,339,751)
248+
Wallet
249+
xBZZ: 0.0000000000000000
250+
xDAI: 0.009787142484816165
251+
252+
Chequebook
253+
Available xBZZ: 0.0000000000000000
254+
Total xBZZ: 0.0000000000000000
214255
```
256+
257+
## Next Steps
258+
259+
With your node now fully synced, you're ready start [uploading and downloading](/docs/develop/access-the-swarm/upload-and-download) or start learning how to [develop on Swarm](/docs/develop/introduction).
260+

0 commit comments

Comments
 (0)