> ## 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 퍼블리셔 API

> Walrus 분산 스토리지 네트워크에 대한 직접 액세스를 제공하여 저장 작업을 완벽하게 제어하고 기본 블록체인 거래에 대한 세부적인 가시성을 제공합니다.

## Walrus 퍼블리셔란 무엇인가요?

**Walrus 퍼블리셔**는 Walrus 분산 스토리지 네트워크에 데이터를 기록하는 서비스입니다. 퍼블리셔는 다음과 같은 복잡한 프로세스를 처리합니다:

* 데이터를 오류 정정 코드 조각으로 인코딩
* 스토리지 노드에 조각 분배
* 스토리지 에포크 및 갱신 관리
* 스토리지의 암호화된 증명 제공

## Nami Cloud 퍼블리셔 서비스

Nami Cloud는 메인넷과 테스트넷에서 고성능 Walrus 퍼블리셔를 운영하며, 다음과 같은 서비스를 제공합니다:

### **관리형 인프라**

* 팀이 유지 관리하는 프로덕션 준비 완료 퍼블리셔
* 99.9% 가동 시간 SLA를 갖춘 높은 가용성
* 자동 장애 조치 및 중복성

### **간단한 REST API**

* 데이터 저장 및 검색을 위한 표준 HTTP 엔드포인트
* JSON 요청/응답 형식
* API 키 인증

### **네트워크 옵션**

* **메인넷** - 프로덕션 데이터 저장용
* **테스트넷** - 개발 및 테스트용

## S3와의 주요 차이점

| 측면        | S3 호환 API | Walrus 퍼블리셔 API |
| --------- | --------- | --------------- |
| **저장 모델** | 키-값 버킷    | 변경 불가능한 블롭      |
| **지연 시간** | \~200ms   | \~10-20s        |
| **사용 사례** | 일반 목적     | 아카이브, Web3 앱    |

## 퍼블리셔 API를 사용할 때

퍼블리셔 API를 선택해야 하는 경우:

* **직접 Walrus 액세스** - 블록체인 작업에 대한 완전한 가시성
* **맞춤형 통합** - Web3 네이티브 애플리케이션 구축
* **블롭 저장소** - 변경 불가능한 콘텐츠 주소 지정 저장소
* **저장 증명** - 데이터 가용성의 암호화된 검증

## 시작하기

<Steps>
  <Step title="API 자격 증명 받기">
    [nami.cloud](https://nami.cloud)에서 가입하여 API 키를 받으세요.
  </Step>

  <Step title="네트워크 선택">
    프로덕션을 위해 메인넷을 선택하거나 개발을 위해 테스트넷을 선택하세요.
  </Step>

  <Step title="첫 번째 블롭 저장">
    [퍼블리셔 API](/api-reference/walrus/publisher-store-blob.ko) 를 사용하여 데이터를 업로드하세요.
  </Step>
</Steps>

## API 문서

<Card title="퍼블리셔 블롭 저장 API" icon="book" href="/api-reference/walrus/publisher-store-blob.ko">
  여러 언어로 된 예제가 포함된 완전한 API 참조
</Card>

## 예제 사용법

```bash theme={null}
# Walrus 메인넷에 파일 저장
curl -X PUT "https://walrus-mainnet-publisher.nami.cloud/${ENDPOINT_KEY}/v1/blobs?epochs=5" \
  --data-binary @myfile.pdf

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