diff --git a/docs/bee/installation/build-from-source.md b/docs/bee/installation/build-from-source.md index f69d78720..509ead9ba 100644 --- a/docs/bee/installation/build-from-source.md +++ b/docs/bee/installation/build-from-source.md @@ -32,7 +32,7 @@ Prerequisites for installing directly from source are: 3. Checkout the required version: ```bash - git checkout v2.8.1 + git checkout v2.8.2 ``` 4. Build the binary: @@ -48,7 +48,7 @@ Prerequisites for installing directly from source are: ``` ``` - 2.8.1 + 2.8.2 ``` 6. (optional) Additionally, you may also like to move the Bee binary to somewhere in your `$PATH` diff --git a/docs/bee/installation/docker.md b/docs/bee/installation/docker.md index c997f784f..1a75ee29b 100644 --- a/docs/bee/installation/docker.md +++ b/docs/bee/installation/docker.md @@ -7,9 +7,9 @@ description: Provides comprehensive steps for deploying Bee nodes using Docker c 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. :::caution -In the examples below we specify the exact image version as 2.8.1. +In the examples below we specify the exact image version as 2.8.2. 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.1 in the commands below if there is a newer full release. +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.2 in the commands below if there is a newer full release. ::: :::warning @@ -39,13 +39,13 @@ docker run -d --name bee-1 \ -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 + ethersphere/bee:2.8.2 start ``` Here is the same command in a single line in case you run into issues with the line breaks in the command above: ```bash -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 +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.2 start ``` #### Command explained: @@ -61,7 +61,7 @@ docker run -d --name bee-1 --restart always -p 127.0.0.1:1633:1633 -p 1634:1634 - **`-e BEE_PASSWORD="flummoxedgranitecarrot"`**: Sets the keystore password, make sure to replace with your own. - **`-e BEE_BLOCKCHAIN_RPC_ENDPOINT="https://xdai.fairdatasociety.org"`**: Connects to the Gnosis Chain. - **`-v bee-1:/home/bee/.bee`**: Persists node data in the `bee-1` volume. -- **`ethersphere/bee:2.8.1 start`**: Runs Bee version 2.8.1 and starts the node. +- **`ethersphere/bee:2.8.2 start`**: Runs Bee version 2.8.2 and starts the node. 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. @@ -77,7 +77,7 @@ If everything is set up correctly, you should see your Bee node listed: ```bash CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -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 +37f4ad8b4060 ethersphere/bee:2.8.2 "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 ``` And check the logs: @@ -170,7 +170,7 @@ damage to hardware or loss of funds associated with the Ethereum account connect No developers or entity involved will be liable for any claims and damages associated with your use, inability to use, or your interaction with other nodes or the software. -"time"="2026-07-07 16:52:59.641444" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.1-7cf53193" +"time"="2026-07-07 16:52:59.641444" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.2-7cf53193" "time"="2026-07-07 16:52:59.793257" "level"="info" "logger"="node" "msg"="swarm public key" "public_key"="02d8d7e1ca6b3b43653ae27e35a375dd74e3ce2f40587fd264bc7268ed918650ab" "time"="2026-07-07 16:53:00.087534" "level"="info" "logger"="node" "msg"="pss public key" "public_key"="02aaae4ede42f47f48aa5182df4b94039ca71254f44ebc5383d5a67f71fe7e6156" diff --git a/docs/bee/installation/quick-start.md b/docs/bee/installation/quick-start.md index 7a1933dfc..67cc5ca7b 100644 --- a/docs/bee/installation/quick-start.md +++ b/docs/bee/installation/quick-start.md @@ -30,17 +30,17 @@ Run the shell script using `curl` or `wget`: :::tip -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. +We specify `TAG=v2.8.2` 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. ::: ```bash -curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash +curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.2 bash ``` OR ```bash -wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash +wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.2 bash ``` Verify installation: @@ -109,7 +109,7 @@ damage to hardware or loss of funds associated with the Ethereum account connect No developers or entity involved will be liable for any claims and damages associated with your use, inability to use, or your interaction with other nodes or the software. -"time"="2026-07-07 16:52:59.641444" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.1-7cf53193" +"time"="2026-07-07 16:52:59.641444" "level"="info" "logger"="node" "msg"="bee version" "version"="2.8.2-7cf53193" "time"="2026-07-07 16:52:59.793257" "level"="info" "logger"="node" "msg"="swarm public key" "public_key"="02d8d7e1ca6b3b43653ae27e35a375dd74e3ce2f40587fd264bc7268ed918650ab" "time"="2026-07-07 16:53:00.087534" "level"="info" "logger"="node" "msg"="pss public key" "public_key"="02aaae4ede42f47f48aa5182df4b94039ca71254f44ebc5383d5a67f71fe7e6156" @@ -181,7 +181,7 @@ swarm-cli status ```bash Bee API: http://localhost:1633 [OK] -Version: 2.8.1-7cf53193 +Version: 2.8.2-7cf53193 Mode: light Chainsync @@ -211,7 +211,7 @@ swarm-cli status ```bash Bee API: http://localhost:1633 [OK] -Version: 2.8.1-7cf53193 +Version: 2.8.2-7cf53193 Mode: light Chainsync diff --git a/docs/bee/installation/shell-script.md b/docs/bee/installation/shell-script.md index 8ecd3537a..c582c4485 100644 --- a/docs/bee/installation/shell-script.md +++ b/docs/bee/installation/shell-script.md @@ -26,7 +26,7 @@ Below is a step-by-step guide for installing and setting up your Bee node using Run the install shell script using either `curl` or `wget`: :::caution -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). +In the example below, the version is specified using `TAG=v2.8.2`. 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). ::: :::info @@ -59,7 +59,7 @@ values={[ ```bash -curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash +curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.2 bash ``` @@ -67,7 +67,7 @@ curl -s https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TA **wget** ```bash -wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.1 bash +wget -q -O - https://raw.githubusercontent.com/ethersphere/bee/master/install.sh | TAG=v2.8.2 bash ``` diff --git a/docs/bee/working-with-bee/bee-api.md b/docs/bee/working-with-bee/bee-api.md index 9ee0cbb46..6decc6d8c 100644 --- a/docs/bee/working-with-bee/bee-api.md +++ b/docs/bee/working-with-bee/bee-api.md @@ -584,7 +584,7 @@ curl -s http://localhost:1633/health | jq ```json { "status": "ok", - "version": "2.8.1-7cf53193", + "version": "2.8.2-7cf53193", "apiVersion": "8.1.0" } ``` diff --git a/docs/bee/working-with-bee/staking.md b/docs/bee/working-with-bee/staking.md index fa1f8b844..9ea3fe09e 100644 --- a/docs/bee/working-with-bee/staking.md +++ b/docs/bee/working-with-bee/staking.md @@ -481,12 +481,12 @@ curl -s http://localhost:1633/health | jq To confirm a successful update, check that the value for the `"version"` field in the results corresponds to the version number of the [latest](https://github.com/ethersphere/bee/releases/latest) Bee release. -For example, if the latest version was 2.8.1, it would look like this: +For example, if the latest version was 2.8.2, it would look like this: ```json { "status": "ok", - "version": "2.8.1-7cf53193", + "version": "2.8.2-7cf53193", "apiVersion": "8.1.0" } ``` diff --git a/openapi/Swarm.yaml b/openapi/Swarm.yaml index a0b3e296b..c320410b4 100644 --- a/openapi/Swarm.yaml +++ b/openapi/Swarm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: - version: 8.1.0 + version: 8.1.1 title: Bee API description: "API endpoints for interacting with the Swarm network, supporting file operations, messaging, and node management" @@ -246,6 +246,9 @@ paths: description: Default response head: summary: Retrieve headers containing the content type and length for the reference + description: > + Identical to GET on the same reference except that no content is sent, + so Range and conditional request headers are honored the same way. tags: - Bytes parameters: @@ -255,12 +258,17 @@ paths: $ref: "SwarmCommon.yaml#/components/schemas/SwarmAddress" required: true description: Swarm address of chunk + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmCache" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmRedundancyStrategyParameter" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmRedundancyFallbackModeParameter" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmRedundancyLevelParameter" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmChunkRetrievalTimeoutParameter" - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActTimestamp" - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActPublisher" - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActHistoryAddress" responses: "200": - description: The chunk exists. + description: Headers for the content at the reference. headers: Content-Type: description: The MIME type of the resource (e.g., application/octet-stream). @@ -268,19 +276,59 @@ paths: type: string example: application/octet-stream Content-Length: - description: The size of the chunk in bytes. + description: The size of the retrievable content in bytes. schema: type: integer example: 1024 + Accept-Ranges: + description: Indicates that ranged requests are supported for the reference. + schema: + type: string + example: bytes + ETag: + description: The reference, as an entity tag. + schema: + type: string + Last-Modified: + description: The time the response was generated. + schema: + type: string Access-Control-Expose-Headers: description: Headers exposed for CORS. schema: type: string - example: Accept-Ranges, Content-Encoding + example: Content-Disposition + "206": + description: Headers for the range requested via the Range header. + headers: + Content-Range: + description: The range covered, and the total size of the content. + schema: + type: string + example: bytes 0-1023/4096 + Content-Length: + description: The size of the requested range in bytes. + schema: + type: integer + example: 1024 + "304": + description: The entity tag in If-None-Match matches the reference. "400": $ref: "SwarmCommon.yaml#/components/responses/400" "404": $ref: "SwarmCommon.yaml#/components/responses/404" + "412": + description: A conditional request header was not satisfied. + "416": + description: The requested range cannot be satisfied. + headers: + Content-Range: + description: The total size of the content. + schema: + type: string + example: bytes */4096 + "500": + $ref: "SwarmCommon.yaml#/components/responses/500" default: description: Default response @@ -469,6 +517,9 @@ paths: description: Default response head: summary: Retrieve headers with content type and length for the reference + description: > + Identical to GET on the same reference except that no content is sent, + so Range and conditional request headers are honored the same way. tags: - BZZ parameters: @@ -478,16 +529,77 @@ paths: $ref: "SwarmCommon.yaml#/components/schemas/SwarmAddress" required: true description: Swarm address of chunk + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmCache" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmRedundancyStrategyParameter" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmRedundancyFallbackModeParameter" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmRedundancyLevelParameter" + - $ref: "SwarmCommon.yaml#/components/parameters/SwarmChunkRetrievalTimeoutParameter" - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActTimestamp" - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActPublisher" - $ref: "SwarmCommon.yaml#/components/parameters/SwarmActHistoryAddress" responses: "200": - description: Chunk exists + description: Headers for the content at the reference. + headers: + Content-Type: + description: The MIME type of the resource. + schema: + type: string + example: application/octet-stream + Content-Length: + description: The size of the retrievable content in bytes. + schema: + type: integer + example: 1024 + Accept-Ranges: + description: Indicates that ranged requests are supported for the reference. + schema: + type: string + example: bytes + ETag: + description: The reference, as an entity tag. + schema: + type: string + Last-Modified: + description: The time the response was generated. + schema: + type: string + Access-Control-Expose-Headers: + description: Headers exposed for CORS. + schema: + type: string + example: Content-Disposition + "206": + description: Headers for the range requested via the Range header. + headers: + Content-Range: + description: The range covered, and the total size of the content. + schema: + type: string + example: bytes 0-1023/4096 + Content-Length: + description: The size of the requested range in bytes. + schema: + type: integer + example: 1024 + "304": + description: The entity tag in If-None-Match matches the reference. "400": $ref: "SwarmCommon.yaml#/components/responses/400" "404": $ref: "SwarmCommon.yaml#/components/responses/404" + "412": + description: A conditional request header was not satisfied. + "416": + description: The requested range cannot be satisfied. + headers: + Content-Range: + description: The total size of the content. + schema: + type: string + example: bytes */4096 + "500": + $ref: "SwarmCommon.yaml#/components/responses/500" default: description: Default response