> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nami.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Walrus Publisher API

> Direct access to Walrus network storage operations

<Note>
  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.
</Note>

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

| Aspect            | S3-Compatible API | Walrus Publisher API |
| ----------------- | ----------------- | -------------------- |
| **Storage Model** | Key-value buckets | Immutable blobs      |
| **Latency**       | \~200ms           | \~10-20s             |
| **Use Case**      | General purpose   | Archival, 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

<Steps>
  <Step title="Get API Credentials">
    Sign up at [nami.cloud](https://nami.cloud) to get your API key
  </Step>

  <Step title="Choose Network">
    Select mainnet for production or testnet for development
  </Step>

  <Step title="Store Your First Blob">
    Use the [Publisher API](/api-reference/walrus/publisher-store-blob) to upload data
  </Step>
</Steps>

## API Documentation

<Card title="Publisher Store Blob API" icon="book" href="/api-reference/walrus/publisher-store-blob">
  Complete API reference with examples in multiple languages
</Card>

## Example Usage

```bash theme={null}
# 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
  }
}
```