Skip to main content
The Walrus Publisher API provides direct access to the Walrus decentralized storage network, giving you full control over storage operations and detailed visibility into the underlying blockchain transactions.

​
What is a Walrus Publisher?

A Walrus Publisher is a service that writes data to the Walrus decentralized storage network. Publishers handle the complex process of:
  • Encoding data into erasure-coded shards
  • Distributing shards across storage nodes
  • Managing storage epochs and renewals
  • Providing cryptographic proofs of storage

​
Nami Cloud Publisher Service

Nami Cloud operates high-performance Walrus publishers on both mainnet and testnet, providing:

​
Managed Infrastructure

  • Production-ready publishers maintained by our team
  • High availability with 99.9% uptime SLA
  • Automatic failover and redundancy

​
Simple REST API

  • Standard HTTP endpoints for storing and retrieving data
  • JSON request/response format
  • API key authentication

​
Network Options

  • Mainnet - For production data storage
  • Testnet - For development and testing

​
Key Differences from S3

AspectS3-Compatible APIWalrus Publisher API
Storage ModelKey-value bucketsImmutable blobs
Latency~200ms~10-20s
Use CaseGeneral purposeArchival, Web3 apps

​
When to Use Publisher API

Choose the Publisher API when you need:
  • Direct Walrus Access - Full visibility into blockchain operations
  • Custom Integration - Building Web3-native applications
  • Blob Storage - Immutable content-addressed storage
  • Proof of Storage - Cryptographic verification of data availability

​
Getting Started

1

Get API Credentials

Sign up at nami.cloud to get your API key
2

Choose Network

Select mainnet for production or testnet for development
3

Store Your First Blob

Use the Publisher API to upload data

​
API Documentation

Publisher Store Blob API

Complete API reference with examples in multiple languages

​
Example Usage

# Store a file on Walrus mainnet
curl -X PUT "https://walrus-mainnet-publisher.nami.cloud/${ENDPOINT_KEY}/v1/blobs?epochs=5" \
  --data-binary @myfile.pdf

# Response
{
  "newlyCreated": {
    "blobObject": {
      "blobId": "4BKtDnvDVeicNDiT3LEwYmx44bVKyEPr3gyVTNRqe7fF",
      "storage": {
        "endEpoch": 15450
      }
    },
    "cost": 132300
  }
}