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
  }
}