Walrus Gateway

NFT-compatible image gateway for Walrus decentralized storage

What is this?

The official Walrus aggregator forces images to download instead of displaying them inline. This breaks NFT compatibility - wallets and explorers can't display the images.

This gateway proxies images from Walrus and serves them inline, making them compatible with NFT metadata standards and displayable everywhere.

How to use

Basic Usage (Testnet)

https://yourdomain.com/api/{blobId}

Mainnet

https://yourdomain.com/api/{blobId}?network=mainnet

In NFT Metadata

{
  "name": "My NFT",
  "description": "Stored on Walrus",
  "image": "https://yourdomain.com/api/rw4fwkscuoAeT5ndbuu4cTT89pYJ3fXmqP1azHtqB3A"
}

Features

  • ✓NFT-compatible - Images render inline in wallets and explorers
  • ✓CDN-cacheable - Aggressive caching for fast global delivery
  • ✓CORS-enabled - Works with all NFT platforms and marketplaces
  • ✓Network-aware - Supports both testnet and mainnet
  • ✓Free & open - Community service, free for everyone

How it works

1

Your NFT metadata points to this gateway URL

2

Gateway fetches the blob from official Walrus aggregator

3

Strips Content-Disposition: attachment header

4

Serves with inline disposition - renders in browser!

Supported Networks

Testnet (Default)

Official Walrus testnet aggregator

aggregator.walrus-testnet.walrus.space

Mainnet

Official Walrus mainnet aggregator

aggregator.walrus.space

Built for the Sui & Walrus ecosystem

Open source • Free for everyone • Deploy your own