Skip to main content

Postage Stamps


Swarm Desktop must be configured as a light node in order to access stamp related features. If you have not already upgraded from the default ultra-light configuration, complete the upgrade by following the instructions here.

Postage stamps are required in order to upload data to Swarm. Postage stamps are purchased by interacting with the Swarm postage stamp smart contract on Gnosis Chain. Postage stamps are not purchased one by one, rather they are purchased in batches only.

How to Buy a Postage Stamp Batch

Stamps can be purchased by selecting Stamps from the Account tab:

And then clicking the Buy New Postage Stamp button:

Depth and Amount

Batch depth and amount are the two required parameters which must be set when purchasing a postage stamp batch. Depth determines how many chunks can be stamped with a batch while amount determines how much xBZZ is assigned per chunk.

Inputting a value for depth allows you to preview the upper limit of data which can be uploaded for that depth.

Inputting a value for amount and depth together will allow you to also preview the total cost of the postage stamp batch as well as the TTL (time to live - how long the batch can store data on Swarm). Click the Buy New Stamp button to purchase the stamp batch.

After purchasing stamps you can view stamp details from the Postage Stamps drop down menu:

Managing Postage Batches

After purchasing a postage batch, it is important to monitor the usage and TTL (time to live) of your batch.

TTL is shown next to the "Expired in" label in the screenshot below.

For this stamp batch, it has only 6 hours left. Once the TTL has run out completely, the content uploaded using that batch will no longer be kept on Swarm, and will be lost forever. To prevent this from happening, you can "top up" your batch by adding more xBZZ to the batch balance to increase the batch TTL.

Top-up a Batch

To get started, click on the "Topup and Dilute" button.

From the "Action" dropdown menu, make sure that you have "Topup" selected and then fill in the amount by which you wish to top up the batch. Note that the number entered here is in PLUR (1e-16 xBZZ), and it is the same `amount`` parameter described in the section above on purchasing postage stamp batches, it is NOT equal to the total amount of xBZZ spent for this top up transaction.

After inputting the amount, click "Topup" to submit the transaction.

After a few moments, you will see a notice that the transaction was successful in a green alert box. A few moments after that, you will see the updated TTL in the stamp details window.

Dilute a Batch

If our batch begins to come close to becoming fully utilised, we can choose to increase the depth of the batch to increase the amount of data it can store. This is referred to as "dilution", since by increasing the depth without updating the amount, we dilute the amount of xBZZ which is assigned to each chunk. In other words, the dilute transaction will increase the amount which can be uploaded by a batch while also decreasing the TTL. Therefore it is important to both top up and also dilute your stamp batch if you wish to increase the amount stored by the batch without decreasing its TTL.

To get started, click on the "Topup and Dilute" button. Make sure to select "Dilute" from the "Action" dropdown menu.

From here, we can select the new depth value for our postage stamp batch. In this instance, we will increase it from 20 to 21.

After a few moments the transaction will be completed and you should see the updated Depth, Capacity, and TTL.

Note that both the Depth and Capacity have increased while the TTL has decreased.