Kavramlar & sözlük
Bu sayfa, her temel DIG Network varlığını bir kez, sade bir dille tanımlar ve her birini derinlemesine giden belgeye bağlar. Bu, dokümantasyonun insan tarafından okunabilir omurgasıdır — ve her terim aynı zamanda makine tarafından okunabilir yapılandırılmış veri olarak da yayınlandığından, bir ajanın (agent) ağın kelime dağarcığını öğrenmek için tarayabileceği haritadır. Yönelmek için göz atın; derine inmek için bir bağlantıyı izleyin.
capsule
Bir capsule, tek bir değişmez store nesli (generation)'dir: (storeId, rootHash) çifti, kanonik olarak
storeId:rootHash şeklinde yazılır. Ağın atomik birimidir — derlemenin (tek sabit boyutlu WASM modülü),
fiyatlandırmanın (mint veya commit için $DIG cinsinden ödenen capsule başına
tek tip bir fiyat), almanın (bir URN bir capsule'ü adlandırır), önbelleklemenin ve köken kanıtının. Bir
store capsule dizisidir — her commit için bir tane. Bu tanım dig-store, dig RPC ve DIG
Browser genelinde aynıdır. → capsule, tam olarak
Store
Bir store, bir kimlik artı içeriği ve geçmişidir: capsule'lerin bir dizisi, her commit için bir tane. Kimliği, 64 karakterlik onaltılık bir store id'dir; bu, zincir üzerindeki Chia singleton başlatıcı (launcher) id'sinin ta kendisidir — zincir singleton'ı, store'un güncel kökü için otoritedir. Bir store, DIG'in web sitesi karşılığıdır. → Store yapısı
Generation
Bir generation, bir store'un tek bir commit edilmiş durumudur, bir kök karma (root hash) ile
tanımlanır (generation'ın kaynak-başına yapraklarının bir Merkle kökü). Her commit, mevcut içeriği yeni,
yalnızca-ekleme yapılabilen bir generation'a mühürler — capsule'ün adlandırdığı aynı şeydir. Generation'lar
Git geçmişi gibi monoton olarak büyür. → Generation'lar & kök karmalar
URN
Bir URN, dig-store'un adresi ve anahtarını tek bir dizede birleştirir:
urn:dig:chia:<storeId>[:<rootHash>][/<resource>]. Hem bir kaynağı konumlandırır hem de şifresini çözecek
anahtarı türetir — bir URN'e sahip olmak, genel bir kaynağı okumak için gerekli ve yeterlidir.
Tarayıcıya yönelik kısa yol chia:// protokolüdür. → URN'ler & Şifreleme
Alma anahtarı (Retrieval key)
Alma anahtarı, SHA-256(canonical_urn)'dir — istemciden ayrılan tek adrestir. Bir
kaynağın şifreli metnini, yolunu veya URN'ini ifşa etmeden konumlandırır. Kökten
bağımsızdır, bu yüzden aynı anahtar generation'lar genelinde bir kaynağı bulur; sunulan
baytlar ardından doğru köke karşı Merkle ile doğrulanır. Ayrı
şifre çözme anahtarı, aynı URN'den yerel olarak (HKDF) türetilir ve asla gönderilmez. → Tek dizede iki değer
Merkle kanıtı
Her generation, kaynak başına bir yaprak ile, sunulan tam şifreli metin baytlarına bağlanan bir Merkle ağacı inşa eder. Sunulan bir kaynağa tek bir dahil etme kanıtı (inclusion proof) eşlik eder ve bu baytların tam olarak o köke ait olduğunu kanıtlar — böylece içerik hiç şifresi çözülmeden doğrulanır, ve bir düğüme asla gerçek baytları döndürdüğüne güvenilmez. → Merkle kanıtları
Zincir üzeri sabitleme (On-chain anchoring)
Her store, Chia mainnet üzerinde bir singleton'dır. digs init bunu basar (başlatıcı id'si
store id olur) ve her digs commit, bir CHIP-0035 singleton güncellemesi olarak yeni bir
generation kökünü zincir üzerinde sabitler. İkisi de onaylanana kadar bloklar ve gerçek fon harcar. Zincir, bir
store'un en son kökü için otoritedir. → Zincir üzeri sabitleme
DIG ödemesi
$DIG, DIG Network token'ıdır (bir Chia CAT'i). Bir capsule basmak (init) veya commit etmek,
sabitleme ile aynı zincir üzeri harcamaya atomik olarak dahil edilen, $DIG cinsinden capsule başına tek tip bir
fiyata mal olur — ayrı bir işlem yoktur ve memo store id'yi taşır. → Maliyetler
dig-store CLI
dig-store, store'ları oluşturan, commit eden, paylaşan ve okuyan komut satırı aracıdır — şifrelenmiş,
zincir üzeri store formatı üzerinde Git şekilli bir iş akışı (init, add, commit, log, clone, push, pull).
→ Komut referansı · CLI eğitimi
dig.toml
dig.toml, bir projenin kökündeki commit edilebilir proje manifestosudur — store-id, output-dir,
build-command ve digs dev, digs deploy ile iskeleleme şablonları tarafından paylaşılan diğer proje
yapılandırması. Hiçbir sır içermez (bunlar ortamdan gelir), bu yüzden commit etmek güvenlidir.
→ Proje yapılandırması & derleme zamanı değerleri
create-dig-app
create-dig-app (npm create dig-app), bir DIG projesine başlamak için JS ön kapısıdır: beş
şablondan birinden (static, vite-react, next-static, nft-drop, dapp-window-chia) çalıştırılabilir bir
başlangıç projesi — bir uygulama, bir dig.toml ve (cüzdan şablonları için) bağlanmış DIG SDK —
iskeleler. İskeleleme ücretsizdir — mint yok, zincir yok, harcama yok; yalnızca bir capsule yayınladığınızda
tek tip capsule fiyatını ödersiniz. Rust CLI'ın digs new'inin npm tarafındaki eşdeğeridir.
→ Bir uygulama iskeleleyin
GitHub dağıtım Action'ı
dig-network/deploy-action, git-push-ile-dağıtım GitHub Action'ıdır: runner üzerine
dig-store CLI'ı kurar, store'unuzu ilerletmek için digs deploy çalıştırır (asla
mint yapmaz) ve yayınlanan capsule + URL'ler + maliyeti adım çıktıları, bir PR
yorumu, bir GitHub Deployment'ı ve bir commit durumu olarak geri bildirir. if-changed (varsayılan) ile, bayt-özdeş bir
build hiçbir işlem yapmaz — harcama yok. → GitHub Actions'tan dağıtım
DIG SDK
DIG SDK (@dignetwork/dig-sdk), entegre eden geliştiriciler için tipli npm paketidir: bir
ChiaProvider (enjekte edilen window.chia'yı tercih eder, WalletConnect → Sage'e geri döner),
bir DigClient (dig RPC üzerinden doğrulanmış, şifrelenmiş içerik okur), bir Paywall
(sağlayıcıyı harcama oluşturucusuyla birleştiren yüksek seviyeli bir öde-ve-aç / NFT-korumalı-erişim yardımcısı)
ve /spend alt yolunda yeniden dışa aktarılan kanonik CHIP-0035 harcama oluşturucusu.
→ Chia üzerinde bir dapp inşa edin