Introduction

In July 2025, the Walrus team introduced Quilt, a standard for efficiently uploading blobs in batches. Since this time Tusky has been publishing files to Walrus using Quilt. If you are Tusky user from before July 2025, you may now have files that were uploaded in Quilts and some that were not.

We have implemented Quilts in such a way that this will not change anything about how you use Tusky, but it may impact how you use public aggregators, other than Tusky’s own public aggregator, if you do use them at all. Please read the following sections to gain a better understanding of how Quilts work and how they affect other public aggregators.

Quilt ID & Quilt Patch ID
Every Quilt has a quilt-id and every blob inside a Quilt has a quilt-patch-id. These IDs are not necessarily permanent and can change. For example, a blob inside a Quilt could be republished to Walrus inside another Quilt if a number of blobs inside a Quilt are deleted, and the remaining blobs published to Walrus in a new Quilt.

Any Walrus aggregator can support Quilts. Here is an example of a public Walrus aggregator that resolves a blob by its quilt-patch-id:

https:// aggregator.walrus-mainnet.walrus.space/v1/blobs/by-quilt-patch-id/AgPoSUF17KzmRDpho_7BVwBKF5L6fosAGTHDcqKb2MMB-gH8AQ

(Since the content-type is by default not resolved by Walrus aggregators for security reasons, your browser will not render it and instead download the file locally. You can change the name of the downloaded file by appending .webp to the file name to view it.)

Here is the same file on Tusky's aggregator:

https://walrus.tusky.io/by-quilt-patch-id/AgPoSUF17KzmRDpho_7BVwBKF5L6fosAGTHDcqKb2MMB-gH8AQ

On Tusky, the blob-id is encoded at the point of upload, as was done before Quilt, and stored as an attribute of the Quilt patch. The Tusky aggregator is setup to resolve Quilt patches by the fixed blob-id. This allows Tusky to keep permanent content identification for files stored in Quilts. Currently, this method only works if you use Tusky's aggregator. To serve quilted files from other aggregators, you will need to use the following url scheme: aggregator.com/v1/blobs/by-quilt-patch-id/[quilt-patch-id]. We are advocating in the ecosystem to make blob-id a standard tag for Quilts and searchable by any Walrus aggregator.