nu-proto/CLAUDE.md

nu-proto — CLAUDE.md

Tüm ekosistemin canonical tip ve RPC API tanımları. Değişince diğer repolar kırılır.

Kritik Kural

v0.1 tag'i atıldıktan sonra field silemezsin, field tipi değiştiremezsin. Yeni field eklemek non-breaking — sıra numarası bir kez atandıktan sonra değişmez.

// BREAKING: field silindi/tipi değişti — bunu yapma v0.1 sonrası
// Yeni field ekle, eski field'ı deprecated bırak

Dosya Yapısı

types/
  transaction.proto   ← TxPayload enum; tüm sistemi kilitler
  block.proto         ← BlockHeader, Block, BlockReceipt
  story_node.proto    ← StoryNode, Story, NodeStatus
  nft.proto           ← Nft, Collection
rpc/
  api.proto           ← Platform ↔ Node JSON-RPC sözleşmesi

Derleme

# Rust crate üret
protoc --rust_out=src/ types/*.proto rpc/*.proto

# TypeScript (platform için)
protoc --ts_out=../nu-platform/src/proto/ types/*.proto rpc/*.proto

Versiyon

Şu an: v0.1-dev (henüz dondurulmadı)
v0.1 lock sonrası paralel geliştirme başlar.