Skip to main content

Docs

Get started with Walrus CLI tools, set up your environment, and learn core storage operations for developers.

Walrus Sites

Deploy decentralized websites using Walrus Sites and host static sites with true decentralization.

Design

Explore Walrus architecture, security properties, and decentralized storage design principles.

Blog

Read the latest updates, announcements, and technical insights about the Walrus decentralized storage protocol.

Walrus Docs

Walrus is a decentralized storage protocol designed specifically to enable data markets for the AI era and make data reliable, valuable, and governable. Walrus focuses on providing a robust but affordable solution for storing unstructured content on decentralized storage nodes while ensuring high availability and reliability even in the presence of Byzantine faults.

Features

  • Storage and retrieval: Walrus supports storage operations to write and read blobs. It also allows anyone to prove that a blob has been stored and is available for retrieval at a later time.

  • Cost efficiency: By utilizing advanced erasure coding, Walrus maintains storage costs at approximately 5 times the size of the stored blobs, and encoded parts of each blob are stored on each storage node. This is significantly more cost-effective than traditional full-replication methods and much more robust against failures than protocols that only store each blob on a subset of storage nodes.

  • Integration with the Sui blockchain: Walrus leverages Sui for coordination, attesting availability, and payments. Storage space is represented as a resource on Sui, which can be owned, split, merged, and transferred. Stored blobs are also represented by objects on Sui, which means that smart contracts can check whether a blob is available and for how long, extend its lifetime, or optionally delete it.

  • Epochs, tokenomics, and delegated proof-of-stake: Walrus is operated by a committee of storage nodes that evolve between epochs. A native token, WAL (and its subdivision FROST, where 1 WAL is equal to 1 billion FROST), is used to delegate stake to storage nodes, and those with high stake become part of the epoch committee. The WAL token is also used for payments for storage. At the end of each epoch, rewards for selecting storage nodes, storing, and serving blobs are distributed to storage nodes and those that stake with them. All these processes are mediated by smart contracts on the Sui platform.

  • Flexible access: You can interact with Walrus through a command-line interface (CLI), software development kits (SDKs), and Web2 HTTP technologies. Walrus is designed to work well with traditional caches and content distribution networks (CDNs), while ensuring all operations can also be run using local tools to maximize decentralization.

Architecture and operations

Walrus's architecture ensures that content remains accessible and retrievable even when many storage nodes are unavailable or malicious. Under the hood it uses modern error correction techniques based on fast linear fountain codes, augmented to ensure resilience against Byzantine faults, and a dynamically changing set of storage nodes. The core of Walrus remains simple, and storage node management and blob certification leverages Sui smart contracts.