From 62aa26e6f3c470f6e1cd35ee775f8016de7d9acf Mon Sep 17 00:00:00 2001 From: Noah Maizels Date: Mon, 16 Mar 2026 14:17:28 +0700 Subject: [PATCH 1/3] Update README.md with `stamp create` instructions Update README.md with `stamp create` instructions --- README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/README.md b/README.md index b6bf6b9a..7593e95d 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,7 @@ the [releases tab](https://github.com/ethersphere/swarm-cli/releases). - [Table of Contents](#table-of-contents) - [Demo](#demo) - [Purchasing a Postage Stamp](#purchasing-a-postage-stamp) + - [Creating a Postage Stamp (Interactive)](#creating-a-postage-stamp-interactive) - [Uploading a File](#uploading-a-file) - [Creating an Identity](#creating-an-identity) - [Uploading to a Feed](#uploading-to-a-feed) @@ -61,6 +62,34 @@ the [releases tab](https://github.com/ethersphere/swarm-cli/releases). ![Swarm CLI Stamp Buy Command](./docs/stamp-buy.gif) +## Creating a Postage Stamp (Interactive) + +The `stamp create` command walks you through purchasing a postage stamp by prompting for just two values: how much data you want to store and how long it should persist. + +``` +swarm-cli stamp create +``` + +You will be prompted for: + +1. **Capacity** — the total size of data the batch can store (e.g. `1GB`, `500MB`, `10GB`) +2. **TTL** — how long the stamps should remain valid (e.g. `1d`, `1w`, `1month`, `6months`) + +After entering both values, `swarm-cli` displays a confirmation summary: + +``` +You have provided the following parameters: +Capacity: 10.737 GB +TTL: 4 weeks +Cost: 10.4367906627780608 xBZZ +Available: 10000.0000000000000000 xBZZ +Type: Immutable +? Confirm the purchase Yes +Stamp ID: 690ec71e2312cf7cfa1b0d32a34fc20c8c249a8ea6f557cee035354135cefaef +``` + +Review the cost, confirm, and the command returns your new Stamp ID. You can then use this ID with the `--stamp` option in any upload or feed command. + ## Uploading a File ![Swarm CLI Upload Command](./docs/upload.gif) From 5030317bd9df4082255e8988ed57d94b7cee5c37 Mon Sep 17 00:00:00 2001 From: Noah Maizels Date: Mon, 16 Mar 2026 14:17:28 +0700 Subject: [PATCH 2/3] docs: add stamp create section to README --- README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/README.md b/README.md index b6bf6b9a..7593e95d 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,7 @@ the [releases tab](https://github.com/ethersphere/swarm-cli/releases). - [Table of Contents](#table-of-contents) - [Demo](#demo) - [Purchasing a Postage Stamp](#purchasing-a-postage-stamp) + - [Creating a Postage Stamp (Interactive)](#creating-a-postage-stamp-interactive) - [Uploading a File](#uploading-a-file) - [Creating an Identity](#creating-an-identity) - [Uploading to a Feed](#uploading-to-a-feed) @@ -61,6 +62,34 @@ the [releases tab](https://github.com/ethersphere/swarm-cli/releases). ![Swarm CLI Stamp Buy Command](./docs/stamp-buy.gif) +## Creating a Postage Stamp (Interactive) + +The `stamp create` command walks you through purchasing a postage stamp by prompting for just two values: how much data you want to store and how long it should persist. + +``` +swarm-cli stamp create +``` + +You will be prompted for: + +1. **Capacity** — the total size of data the batch can store (e.g. `1GB`, `500MB`, `10GB`) +2. **TTL** — how long the stamps should remain valid (e.g. `1d`, `1w`, `1month`, `6months`) + +After entering both values, `swarm-cli` displays a confirmation summary: + +``` +You have provided the following parameters: +Capacity: 10.737 GB +TTL: 4 weeks +Cost: 10.4367906627780608 xBZZ +Available: 10000.0000000000000000 xBZZ +Type: Immutable +? Confirm the purchase Yes +Stamp ID: 690ec71e2312cf7cfa1b0d32a34fc20c8c249a8ea6f557cee035354135cefaef +``` + +Review the cost, confirm, and the command returns your new Stamp ID. You can then use this ID with the `--stamp` option in any upload or feed command. + ## Uploading a File ![Swarm CLI Upload Command](./docs/upload.gif) From d6703cbd2720fd3a139be666e7721716d4e6e548 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Mon, 16 Mar 2026 08:55:21 +0000 Subject: [PATCH 3/3] test: update test coverage