Skip to content

Commit 2963cd7

Browse files
authored
Merge pull request #825 from ethersphere/bot/update-openapi-v2.8.1
Update OpenAPI specs to Bee v2.8.1
2 parents 529bad8 + 03ca2fc commit 2963cd7

9 files changed

Lines changed: 619 additions & 416 deletions

File tree

docs/bee/installation/build-from-source.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Prerequisites for installing directly from source are:
3232
3. Checkout the required version:
3333

3434
```bash
35-
git checkout v2.8.0
35+
git checkout v2.8.1
3636
```
3737

3838
4. Build the binary:
@@ -48,7 +48,7 @@ Prerequisites for installing directly from source are:
4848
```
4949

5050
```
51-
2.8.0
51+
2.8.1
5252
```
5353

5454
6. (optional) Additionally, you may also like to move the Bee binary to somewhere in your `$PATH`

docs/bee/installation/docker.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,9 @@ description: Provides comprehensive steps for deploying Bee nodes using Docker c
99
The following is a guide for installing a Bee node using Docker. Docker images for Bee are hosted at [Docker Hub](https://hub.docker.com/r/ethersphere/bee). Using Docker to operate your Bee node offers many benefits, such as ease of deployment and consistency across environments.
1010

1111
:::caution
12-
In the examples below we specify the exact image version as 2.8.0. It's recommended to only use the exact version number tags. Make sure to check that you're on the latest version of Bee by reviewing the tags for Bee on [Docker Hub](https://hub.docker.com/r/ethersphere/bee/tags), and replace 2.8.0 in the commands below if there is a newer full release.
12+
In the examples below we specify the exact image version as 2.8.1.
13+
It's recommended to only use the exact version number tags.
14+
Make sure to check that you're on the latest version of Bee by reviewing the tags for Bee on [Docker Hub](https://hub.docker.com/r/ethersphere/bee/tags), and replace 2.8.1 in the commands below if there is a newer full release.
1315
:::
1416

1517
:::warning
@@ -39,13 +41,13 @@ docker run -d --name bee-1 \
3941
-e BEE_PASSWORD="flummoxedgranitecarrot" \
4042
-e BEE_BLOCKCHAIN_RPC_ENDPOINT="https://xdai.fairdatasociety.org" \
4143
-v bee-1:/home/bee/.bee \
42-
ethersphere/bee:2.8.0 start
44+
ethersphere/bee:2.8.1 start
4345
```
4446

4547
Here is the same command in a single line in case you run into issues with the line breaks in the command above:
4648

4749
```bash
48-
docker run -d --name bee-1 --restart always -p 127.0.0.1:1633:1633 -p 1634:1634 -e BEE_API_ADDR=":1633" -e BEE_FULL_NODE="true" -e BEE_SWAP_ENABLE="true" -e BEE_PASSWORD="flummoxedgranitecarrot" -e BEE_BLOCKCHAIN_RPC_ENDPOINT="https://xdai.fairdatasociety.org" -v bee-1:/home/bee/.bee ethersphere/bee:2.8.0 start
50+
docker run -d --name bee-1 --restart always -p 127.0.0.1:1633:1633 -p 1634:1634 -e BEE_API_ADDR=":1633" -e BEE_FULL_NODE="true" -e BEE_SWAP_ENABLE="true" -e BEE_PASSWORD="flummoxedgranitecarrot" -e BEE_BLOCKCHAIN_RPC_ENDPOINT="https://xdai.fairdatasociety.org" -v bee-1:/home/bee/.bee ethersphere/bee:2.8.1 start
4951
```
5052

5153
#### Command explained:
@@ -61,7 +63,7 @@ docker run -d --name bee-1 --restart always -p 127.0.0.1:1633:1633 -p 1634:1634
6163
- **`-e BEE_PASSWORD="flummoxedgranitecarrot"`**: Sets the keystore password, make sure to replace with your own.
6264
- **`-e BEE_BLOCKCHAIN_RPC_ENDPOINT="https://xdai.fairdatasociety.org"`**: Connects to the Gnosis Chain.
6365
- **`-v bee-1:/home/bee/.bee`**: Persists node data in the `bee-1` volume.
64-
- **`ethersphere/bee:2.8.0 start`**: Runs Bee version 2.8.0 and starts the node.
66+
- **`ethersphere/bee:2.8.1 start`**: Runs Bee version 2.8.1 and starts the node.
6567

6668
This setup runs the Bee node in a container, with full node functionality, SWAP enabled, and connections to the Gnosis blockchain for chequebook and postage stamp management, while persisting its data using a volume.
6769

@@ -77,7 +79,7 @@ If everything is set up correctly, you should see your Bee node listed:
7779

7880
```bash
7981
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
80-
37f4ad8b4060 ethersphere/bee:2.8.0 "bee start" 6 seconds ago Up 5 seconds 127.0.0.1:1633->1633/tcp, 0.0.0.0:1634->1634/tcp, :::1634->1634/tcp bee-1
82+
37f4ad8b4060 ethersphere/bee:2.8.1 "bee start" 6 seconds ago Up 5 seconds 127.0.0.1:1633->1633/tcp, 0.0.0.0:1634->1634/tcp, :::1634->1634/tcp bee-1
8183
```
8284

8385
And check the logs:
@@ -170,11 +172,10 @@ damage to hardware or loss of funds associated with the Ethereum account connect
170172
No developers or entity involved will be liable for any claims and damages associated with your use,
171173
inability to use, or your interaction with other nodes or the software.
172174

173-
version: 2.8.0-06a0aca7 - planned to be supported until 11 December 2024, please follow https://ethswarm.org/
174-
175-
"time"="2024-09-24 22:21:04.543661" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.0-06a0aca7"
176-
"time"="2024-09-24 22:21:04.590823" "level"="info" "logger"="node" "msg"="swarm public key" "public_key"="02f0e59eafa3c5c06542c0a7a7fe9579c55a163cf1d28d9f6945a34469f88d1b2a"
177-
"time"="2024-09-24 22:21:04.686430" "level"="info" "logger"="node" "msg"="pss public key" "public_key"="02ea739530bbf48eed49197f21660f3b6564709b95bf558dc3b472688c34096418"
175+
"time"="2026-07-07 16:52:59.641444" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.1-7cf53193"
176+
"time"="2026-07-07 16:52:59.793257" "level"="info" "logger"="node" "msg"="swarm public key"
177+
"public_key"="02d8d7e1ca6b3b43653ae27e35a375dd74e3ce2f40587fd264bc7268ed918650ab"
178+
"time"="2026-07-07 16:53:00.087534" "level"="info" "logger"="node" "msg"="pss public key" "public_key"="02aaae4ede42f47f48aa5182df4b94039ca71254f44ebc5383d5a67f71fe7e6156"
178179
"time"="2024-09-24 22:21:04.686464" "level"="info" "logger"="node" "msg"="using ethereum address" "address"="0x8288F1c8e3dE7c3bf42Ae67fa840EC61481D085e"
179180
"time"="2024-09-24 22:21:04.700711" "level"="info" "logger"="node" "msg"="using overlay address" "address"="22dc155fe072e131449ec7ea2f77de16f4735f06257ebaa5daf2fdcf14267fd9"
180181
"time"="2024-09-24 22:21:04.700741" "level"="info" "logger"="node" "msg"="starting with an enabled chain backend"

docs/bee/installation/quick-start.md

Lines changed: 9 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -30,17 +30,17 @@ Run the shell script using `curl` or `wget`:
3030

3131

3232
:::tip
33-
We specify `TAG=v2.8.0` to indicate which Bee version to install. You can find available versions in the ["releases" section](https://github.com/ethersphere/bee/releases) of the Bee GitHub repo.
33+
We specify `TAG=v2.8.1` to indicate which Bee version to install. You can find available versions in the ["releases" section](https://github.com/ethersphere/bee/releases) of the Bee GitHub repo.
3434
:::
3535

3636
```bash
37-
curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.0 bash
37+
curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash
3838
```
3939

4040
OR
4141

4242
```bash
43-
wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.0 bash
43+
wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash
4444
```
4545

4646
Verify installation:
@@ -109,13 +109,10 @@ damage to hardware or loss of funds associated with the Ethereum account connect
109109
No developers or entity involved will be liable for any claims and damages associated with your use,
110110
inability to use, or your interaction with other nodes or the software.
111111

112-
version: 2.8.0-390a402e - planned to be supported until 22 April 2025, please follow https://ethswarm.org/
113-
114-
"time"="2025-03-04 11:13:10.113050" "level"="info" "logger"="node" "msg"="bee version" "version"="2.6.0-390a402e"
115-
"time"="2025-03-04 11:13:10.164801" "level"="info" "logger"="node" "msg"="swarm public key" "public_key"="02b19880b8d024eac3bf8afa3fa85b31b72fcfd491cebc6af78ddd85ff97f65416"
116-
"time"="2025-03-04 11:13:10.216657" "level"="debug" "logger"="node" "msg"="using existing libp2p key"
117-
"time"="2025-03-04 11:13:10.268431" "level"="debug" "logger"="node" "msg"="using existing pss key"
118-
"time"="2025-03-04 11:13:10.268474" "level"="info" "logger"="node" "msg"="pss public key" "public_key"="03a3166e04b749ab3d04fda8a41180598ff2eed01a8096fb72d2c7da393a47c46a"
112+
"time"="2026-07-07 16:52:59.641444" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.1-7cf53193"
113+
"time"="2026-07-07 16:52:59.793257" "level"="info" "logger"="node" "msg"="swarm public key"
114+
"public_key"="02d8d7e1ca6b3b43653ae27e35a375dd74e3ce2f40587fd264bc7268ed918650ab"
115+
"time"="2026-07-07 16:53:00.087534" "level"="info" "logger"="node" "msg"="pss public key" "public_key"="02aaae4ede42f47f48aa5182df4b94039ca71254f44ebc5383d5a67f71fe7e6156"
119116
"time"="2025-03-04 11:13:10.268479" "level"="info" "logger"="node" "msg"="using ethereum address" "address"="0x003842B26B3dB292Cf84d5969E71c0d1e93F5578"
120117
"time"="2025-03-04 11:13:10.288418" "level"="info" "logger"="node" "msg"="using overlay address" "address"="fe38346dd89e4211c0e60195ee73e38d2c2ee2fe2b914b771d4ad503cfedbd3c"
121118
"time"="2025-03-04 11:13:10.288474" "level"="info" "logger"="node" "msg"="starting with an enabled chain backend"
@@ -184,7 +181,7 @@ swarm-cli status
184181
```bash
185182
Bee
186183
API: http://localhost:1633 [OK]
187-
Version: 2.8.0-d0aa8b93
184+
Version: 2.8.1-7cf53193
188185
Mode: light
189186

190187
Chainsync
@@ -214,28 +211,7 @@ swarm-cli status
214211
```bash
215212
Bee
216213
API: http://localhost:1633 [OK]
217-
Version: 2.8.0-d0aa8b93
218-
Mode: light
219-
220-
Chainsync
221-
Block: 41,710,955 / 41,710,962 (Δ 7)
222-
223-
Topology
224-
Connected Peers: 151
225-
Population: 2257
226-
Depth: 10
227-
228-
Wallet
229-
xBZZ: 0.0000000000000000
230-
xDAI: 0.009787142484816165
231-
232-
Chequebook
233-
Available xBZZ: 0.0000000000000000
234-
Total xBZZ: 0.0000000000000000
235-
noah@NoahM16:~$ swarm-cli status
236-
Bee
237-
API: http://localhost:1633 [OK]
238-
Version: 2.8.0-d0aa8b93
214+
Version: 2.8.1-7cf53193
239215
Mode: light
240216

241217
Chainsync
@@ -258,4 +234,3 @@ Total xBZZ: 0.0000000000000000
258234
## Next Steps
259235

260236
With your node now fully synced, you're ready start start learning how to [develop on Swarm](./../../develop/introduction.md).
261-

docs/bee/installation/shell-script.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Below is a step-by-step guide for installing and setting up your Bee node using
2828
Run the install shell script using either `curl` or `wget`:
2929

3030
:::caution
31-
In the example below, the version is specified using `TAG=v2.8.0`. Check the [latest Bee releases](https://github.com/ethersphere/bee/tags) and if needed, update the command to install the most recent version (note that in tags containing "rc," the abbreviation stands for "release candidate", and these versions should be used for testing purposes only).
31+
In the example below, the version is specified using `TAG=v2.8.1`. Check the [latest Bee releases](https://github.com/ethersphere/bee/tags) and if needed, update the command to install the most recent version (note that in tags containing "rc," the abbreviation stands for "release candidate", and these versions should be used for testing purposes only).
3232
:::
3333

3434
:::info
@@ -61,15 +61,15 @@ values={[
6161
<TabItem value="curl">
6262

6363
```bash
64-
curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.0 bash
64+
curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash
6565
```
6666
</TabItem>
6767
<TabItem value="wget">
6868

6969
**wget**
7070

7171
```bash
72-
wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.0 bash
72+
wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash
7373
```
7474
</TabItem>
7575

0 commit comments

Comments
 (0)