From 10ae35d8487d07ba28c44166d8918d31e7b22903 Mon Sep 17 00:00:00 2001 From: Cafe137 Date: Wed, 20 May 2026 15:30:05 +0200 Subject: [PATCH 1/2] docs: document cheque and rchash --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 3ecd217..350994b 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,18 @@ bee-factory stop # Stop and remove all containers Contract addresses are printed on startup. +## Pre-wired state + +After all nodes are up, bee-factory performs two extra setup steps so the stack is ready for common Swarm development scenarios: + +### Cheque / SWAP testing + +Worker 1 (`:11633`) buys a postage batch and uploads random data in a loop until Worker 2 (`:21633`) has received at least one SWAP cheque from it. By the time `bee-factory start` finishes, `:21633` already has a claimable cheque issued by `:11633`, so you can immediately exercise cheque cashing, balance queries, and SWAP accounting without having to generate traffic yourself. + +### Reserve sampling / `rchash` + +Once the cheque is in place, the chain is advanced by 160 blocks (more than one full redistribution round of 152 blocks). This moves the consensus timestamp forward so that the uploaded chunks are no longer considered "too new" by the reserve sampler. After a short wait for Bee nodes to catch up, `rchash` (reserve commitment hash) can be called successfully. + ## Notes - Each node is funded with 1 ETH and 100 BZZ. From 92230c43bf49ae78c078e710b4a2dd949cd14912 Mon Sep 17 00:00:00 2001 From: Cafe137 Date: Wed, 20 May 2026 15:32:52 +0200 Subject: [PATCH 2/2] docs: also mention withdrawal address --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 350994b..c0a001a 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,19 @@ After all nodes are up, bee-factory performs two extra setup steps so the stack Worker 1 (`:11633`) buys a postage batch and uploads random data in a loop until Worker 2 (`:21633`) has received at least one SWAP cheque from it. By the time `bee-factory start` finishes, `:21633` already has a claimable cheque issued by `:11633`, so you can immediately exercise cheque cashing, balance queries, and SWAP accounting without having to generate traffic yourself. +### Withdrawal address whitelist + +All nodes are started with a single pre-whitelisted withdrawal address: + +``` +0xd238ff944bacb478cbed5efcae784d7bf4f2ff80 +``` + +This lets you test both sides of the withdrawal API (exposed by every node): + +- **Authorized withdrawal** — call `withdrawBZZ` or `withdrawNativeToken` with the address above and the request goes through. +- **Unauthorized withdrawal** — use any other address and Bee rejects it with HTTP 400 (`provided address not whitelisted`). + ### Reserve sampling / `rchash` Once the cheque is in place, the chain is advanced by 160 blocks (more than one full redistribution round of 152 blocks). This moves the consensus timestamp forward so that the uploaded chunks are no longer considered "too new" by the reserve sampler. After a short wait for Bee nodes to catch up, `rchash` (reserve commitment hash) can be called successfully.