fix(packaging): pass BEE_NODE_MODE through docker compose and refresh defaults

Add BEE_NODE_MODE to the docker-compose environment passthrough and the
env template, mark BEE_FULL_NODE deprecated, and correct the stale true
defaults documented for BEE_CHEQUEBOOK_ENABLE and
BEE_STORAGE_INCENTIVES_ENABLE. Document in the bee.yaml variants that
full mode implies the swap, chequebook and incentives options and that
an unset node-mode falls back to deprecated inference.

Author: martinconic

packaging/bee.yaml

@@ -2,9 +2,12 @@
 
 ## ── Node mode ────────────────────────────────────────────────────────────────
 ## Selects the operational mode of this node.
-##   full        - participates in storage and incentives; requires swap-enable and blockchain-rpc
+##   full        - participates in storage and incentives; requires blockchain-rpc;
+##                 implies swap-enable, chequebook-enable and storage-incentives-enable
 ##   light       - uploads and downloads only; requires blockchain-rpc
-##   ultra-light - free-tier downloads only; no blockchain connection needed (default)
+##   ultra-light - free-tier downloads only; no blockchain connection needed
+## When unset, the mode is inferred from the deprecated full-node option and
+## blockchain-rpc presence (deprecated, removed in v2.11.0).
 # node-mode: ultra-light
 
 ## ── Blockchain / RPC (required for full and light nodes) ─────────────────────
@@ -23,7 +26,7 @@
 ## ── Swap / chequebook (full and light nodes only) ────────────────────────────
 ## enable swap
 # swap-enable: false
-## enable chequebook
+## enable chequebook (requires swap-enable; implied by node-mode: full)
 # chequebook-enable: false
 ## reject full-node hive/handshake records that carry no chequebook address
 # chequebook-verification: false
@@ -33,7 +36,7 @@
 # swap-initial-deposit: "0"
 
 ## ── Full node only ────────────────────────────────────────────────────────────
-## enable storage incentives feature
+## enable storage incentives feature (implied by node-mode: full)
 # storage-incentives-enable: false
 ## reserve capacity doubling
 # reserve-capacity-doubling: 0

packaging/docker/README.md

@@ -11,7 +11,7 @@ wget -q https://raw.githubusercontent.com/ethersphere/bee/master/packaging/docke
 
 Set all configuration variables inside `.env`
 
-If you want to run node in full mode, set `BEE_FULL_NODE=true`
+Select the node mode with `BEE_NODE_MODE` (`full`, `light`, or `ultra-light`). A full node needs `BEE_BLOCKCHAIN_RPC_ENDPOINT` and implies swap, chequebook and storage incentives.
 
 Bee requires an Ethereum endpoint to function. Obtain a free Infura account and set:
 

packaging/docker/docker-compose.yml

@@ -39,6 +39,7 @@ services:
       - BEE_NAT_WSS_ADDR
       - BEE_NEIGHBORHOOD_SUGGESTER
       - BEE_NETWORK_ID
+      - BEE_NODE_MODE
       - BEE_P2P_ADDR
       - BEE_P2P_WS_ENABLE
       - BEE_P2P_WSS_ADDR

packaging/docker/env

@@ -37,8 +37,8 @@
 # BEE_CACHE_CAPACITY=1000000
 ## enable forwarded content caching (default true)
 # BEE_CACHE_RETRIEVAL=true
-## enable chequebook (default true)
-# BEE_CHEQUEBOOK_ENABLE=true
+## enable chequebook; requires swap; implied by BEE_NODE_MODE=full (default false)
+# BEE_CHEQUEBOOK_ENABLE=false
 ## reject full-node hive/handshake records that carry no chequebook address
 # BEE_CHEQUEBOOK_VERIFICATION=false
 ## origins with CORS headers enabled (default [])
@@ -53,7 +53,7 @@
 # BEE_DB_OPEN_FILES_LIMIT=200
 ## size of the database write buffer in bytes (default 33554432)
 # BEE_DB_WRITE_BUFFER_SIZE=33554432
-## cause the node to start in full mode (default false)
+## cause the node to start in full mode (deprecated: use BEE_NODE_MODE=full) (default false)
 # BEE_FULL_NODE=false
 ## gas limit fallback when estimation fails for contract transactions (default 500000)
 # BEE_GAS_LIMIT_FALLBACK=500000
@@ -71,6 +71,8 @@
 # BEE_NEIGHBORHOOD_SUGGESTER=https://api.swarmscan.io/v1/network/neighborhoods/suggestion
 ## ID of the Swarm network (default mainnet id from bee)
 # BEE_NETWORK_ID=1
+## node operational mode: full, light, or ultra-light; unset infers the mode from BEE_FULL_NODE and BEE_BLOCKCHAIN_RPC_ENDPOINT (deprecated)
+# BEE_NODE_MODE=ultra-light
 ## P2P listen address (default :1634)
 # BEE_P2P_ADDR=:1634
 ## enable P2P WebSocket transport (default false)
@@ -115,8 +117,8 @@
 # BEE_STATIC_NODES=[]
 ## lru memory caching capacity in number of statestore entries (default 100000)
 # BEE_STATESTORE_CACHE_CAPACITY=100000
-## enable storage incentives feature (default true)
-# BEE_STORAGE_INCENTIVES_ENABLE=true
+## enable storage incentives feature; full node only; implied by BEE_NODE_MODE=full (default false)
+# BEE_STORAGE_INCENTIVES_ENABLE=false
 ## enable swap (default false)
 # BEE_SWAP_ENABLE=false
 ## swap factory addresses (default empty)

packaging/homebrew-amd64/bee.yaml

@@ -2,9 +2,12 @@
 
 ## ── Node mode ────────────────────────────────────────────────────────────────
 ## Selects the operational mode of this node.
-##   full        - participates in storage and incentives; requires swap-enable and blockchain-rpc
+##   full        - participates in storage and incentives; requires blockchain-rpc;
+##                 implies swap-enable, chequebook-enable and storage-incentives-enable
 ##   light       - uploads and downloads only; requires blockchain-rpc
-##   ultra-light - free-tier downloads only; no blockchain connection needed (default)
+##   ultra-light - free-tier downloads only; no blockchain connection needed
+## When unset, the mode is inferred from the deprecated full-node option and
+## blockchain-rpc presence (deprecated, removed in v2.11.0).
 # node-mode: ultra-light
 
 ## ── Blockchain / RPC (required for full and light nodes) ─────────────────────
@@ -23,7 +26,7 @@
 ## ── Swap / chequebook (full and light nodes only) ────────────────────────────
 ## enable swap
 # swap-enable: false
-## enable chequebook
+## enable chequebook (requires swap-enable; implied by node-mode: full)
 # chequebook-enable: false
 ## reject full-node hive/handshake records that carry no chequebook address
 # chequebook-verification: false
@@ -33,7 +36,7 @@
 # swap-initial-deposit: "0"
 
 ## ── Full node only ────────────────────────────────────────────────────────────
-## enable storage incentives feature
+## enable storage incentives feature (implied by node-mode: full)
 # storage-incentives-enable: false
 ## reserve capacity doubling
 # reserve-capacity-doubling: 0

packaging/homebrew-arm64/bee.yaml

@@ -2,9 +2,12 @@
 
 ## ── Node mode ────────────────────────────────────────────────────────────────
 ## Selects the operational mode of this node.
-##   full        - participates in storage and incentives; requires swap-enable and blockchain-rpc
+##   full        - participates in storage and incentives; requires blockchain-rpc;
+##                 implies swap-enable, chequebook-enable and storage-incentives-enable
 ##   light       - uploads and downloads only; requires blockchain-rpc
-##   ultra-light - free-tier downloads only; no blockchain connection needed (default)
+##   ultra-light - free-tier downloads only; no blockchain connection needed
+## When unset, the mode is inferred from the deprecated full-node option and
+## blockchain-rpc presence (deprecated, removed in v2.11.0).
 # node-mode: ultra-light
 
 ## ── Blockchain / RPC (required for full and light nodes) ─────────────────────
@@ -23,7 +26,7 @@
 ## ── Swap / chequebook (full and light nodes only) ────────────────────────────
 ## enable swap
 # swap-enable: false
-## enable chequebook
+## enable chequebook (requires swap-enable; implied by node-mode: full)
 # chequebook-enable: false
 ## reject full-node hive/handshake records that carry no chequebook address
 # chequebook-verification: false
@@ -33,7 +36,7 @@
 # swap-initial-deposit: "0"
 
 ## ── Full node only ────────────────────────────────────────────────────────────
-## enable storage incentives feature
+## enable storage incentives feature (implied by node-mode: full)
 # storage-incentives-enable: false
 ## reserve capacity doubling
 # reserve-capacity-doubling: 0

packaging/scoop/bee.yaml

@@ -2,9 +2,12 @@
 
 ## ── Node mode ────────────────────────────────────────────────────────────────
 ## Selects the operational mode of this node.
-##   full        - participates in storage and incentives; requires swap-enable and blockchain-rpc
+##   full        - participates in storage and incentives; requires blockchain-rpc;
+##                 implies swap-enable, chequebook-enable and storage-incentives-enable
 ##   light       - uploads and downloads only; requires blockchain-rpc
-##   ultra-light - free-tier downloads only; no blockchain connection needed (default)
+##   ultra-light - free-tier downloads only; no blockchain connection needed
+## When unset, the mode is inferred from the deprecated full-node option and
+## blockchain-rpc presence (deprecated, removed in v2.11.0).
 # node-mode: ultra-light
 
 ## ── Blockchain / RPC (required for full and light nodes) ─────────────────────
@@ -23,7 +26,7 @@
 ## ── Swap / chequebook (full and light nodes only) ────────────────────────────
 ## enable swap
 # swap-enable: false
-## enable chequebook
+## enable chequebook (requires swap-enable; implied by node-mode: full)
 # chequebook-enable: false
 ## reject full-node hive/handshake records that carry no chequebook address
 # chequebook-verification: false
@@ -33,7 +36,7 @@
 # swap-initial-deposit: "0"
 
 ## ── Full node only ────────────────────────────────────────────────────────────
-## enable storage incentives feature
+## enable storage incentives feature (implied by node-mode: full)
 # storage-incentives-enable: false
 ## reserve capacity doubling
 # reserve-capacity-doubling: 0