Core Concepts
Understanding how Tuskr, Walrus Protocol, and the Sui blockchain work together.
Blob IDs
Every file uploaded through Tuskr is stored on Walrus as a blob. Each blob is identified by a unique blob ID — a content-addressable hash derived from the file data. This means identical files always produce the same blob ID.
Epochs & Storage Periods
Walrus stores files for a defined number of epochs. Each epoch lasts approximately one day. When you upload a file, you specify how many epochs to store it for. Before a file expires, you can renew its storage period via the Epoch renewal API.
Metadata Index
Tuskr maintains a queryable metadata index on top of raw Walrus blobs. When you upload a file, you can attach tags, names, and custom metadata. This lets you list and filter files without scanning the blockchain.