Ana içeriğe geç

Komut biçimi

Her zNS işlemi, kayıt operatörünün protokol adresine gönderilen korumalı bir ZCash işlemidir; burada tutar ödemeyi, memo ise imzalı komutu oluşturur. İkisi de aynı notta yolculuk eder, böylece niyet ve ödeme ayrılmaz biçimde bağlanır — eşleştirilecek ayrı bir referans ya da fatura yoktur.

Bu sayfa, tam aktarım biçimini anlatır. Buna göre kurulmuş bir komutu hem kayıt operatörü hem de sıfır bilgi devresi kabul eder.

Yapı​

Tüm komutlar iki nokta üst üste ile ayrılmış ASCII'dir ve protokol işaretçisi ile sürümle başlar:

zNS:1:{OP}:{name}:…:{ed25519_pubkey_hex}:…:{nonce}:{signature_hex}

Aradaki alanlar işleme göre değişir:

İşlemMemo yapısıÖdenen tutar
REG kaydetzNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig}isim uzunluğuna göre kayıt ücreti
UPD adres değiştirzNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig}değişiklik ücreti
CHG sahibi devretzNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig}değişiklik ücreti
LST satışa çıkarzNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig}değişiklik ücreti
ULT satıştan kaldırzNS:1:ULT:{name}:{pubkey}:{nonce}:{sig}değişiklik ücreti
BUY satın alzNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig}tam olarak ilan fiyatı

CHG için {new_pubkey}, devralan sahibin anahtarıdır; imza ise devreden sahip tarafından atılır — bir devri yetkilendiren, mevcut sahiptir.

İmzalanan mesaj​

İmza, komutu sondaki :{signature} olmadan kapsar; yani işaretçiden nonce dâhil olmak üzere her şeyi:

zNS:1:REG:richard.zcash:u1…:0101…0101:1780000001

Kurallar kesindir ve bunlardan herhangi birini yanlış uygulayan bir istemci, devrenin reddettiği bir imza üretir:

  • pubkey küçük harf hex'tir, 64 karakter.
  • price yalnızca LST için bulunur.
  • address yalnızca REG, UPD ve BUY için bulunur.
  • price ve nonce ondalıktır; başında sıfır, işaret veya dolgu olmaz.
  • İmza, tam olarak bu baytlar üzerinde Ed25519'dur; hex kodlu, 128 karakter.

Doğrulama katıdır: kanonik olmayan imzalar ve küçük mertebeli anahtarlar reddedilir.

Alan kuralları​

İsim​

KuralDeğer
Karakterlera-z, 0-9, tire
Uzunlukbölge dâhil 1–64 karakter
Büyük/küçük harfyalnızca küçük harf — isim küçük harfle saklanır ve hash'lenir
Tirelerbaşta olmaz, sonda olmaz, asla çift olmaz
Bölgeler.zcash, .zec, .private, .secure, .safe

Etiketi bölgeden ayıran tam olarak bir noktaya izin verilir.

Hedef adres​

Bir ismin çözümlendiği adres, Orchard alıcısı taşıyan bir mainnet Unified Address olmalıdır. Bu alıcıya sahip olmayan adresler kabul edilmez.

Nedeni keyfî değil, pratiktir: kayıt operatörü tahsilat ve ödemelerini Orchard anahtar materyali üzerinden yapar; bu materyal ZIP 229 uyarınca Ironwood havuzunu da kapsar. Orchard alıcısı olmayan bir adrese ödeme yapılamaz, dolayısıyla ne iadeler ne de satış gelirleri için kullanılabilir.

ipucu

Ironwood yeni bir alıcı eklemez

Ironwood yeni bir değer havuzudur, yeni bir adres biçimi değil. Cüzdanlar notları oraya taşır, alım adresi ise bir Orchard adresi olarak kalır. Güncel bir cüzdanın Unified Address'i olduğu gibi çalışır.

Nonce​

Nonce, imzaladığınız andaki saniye cinsinden Unix zaman damgasıdır.

  • O isim için hâlihazırda kayıtlı olan nonce'tan kesin olarak büyük olmalıdır. Eski bir imzalı komutun yeniden kullanılmasını önleyen budur.
  • Kendisini taşıyan bloğun 300 saniyeden fazla önüne geçemez; bu pay, olağan saat kaymasını soğurur ama bir nonce'un çok ileri bir tarihe park edilmesine izin vermez.

İlk kayıt için güncel herhangi bir zaman damgası yeterlidir.

Fiyat​

Fiyatı yalnızca LST taşır. Tam sayı zatoshi cinsindendir (1 ZEC = 100.000.000 zatoshi) ve sıfırdan büyük olmalıdır.

Hâlihazırda listelenmiş bir ismi yeni bir fiyatla yeniden listelemek serbesttir — başka bir LST gönderin. En sonuncusu geçerlidir.

Boyut sınırı​

Bir ZCash memo'su tam olarak 512 bayttır ve komutun tamamı buraya sığmalıdır. Sabit kısımlar öngörülebilir bir yer tutar:

zNS:1:{OP}: … marker, version, operation 10 bytes
{pubkey} 64 hex characters 65 bytes with separator
{nonce} 10 digits today 11 bytes with separator
{signature} 128 hex characters 128 bytes

Geriye isim ile hedef adresin, her birinin ardından gelen ayırıcıyla birlikte paylaşacağı 296 bayt kalır. En uzun isim, 64 karakter, bile adrese 232 karakter bırakır: bu, yalnızca Orchard alıcısı olan bir adresin ihtiyacından (106 karakter) fazladır, ancak birden çok alıcısı olan bir Unified Address uzun olabilir; dolayısıyla çok uzun bir isimle çok uzun bir adres sığmayabilir. İstemciler bu bütçeyi hesaplayıp kullanıcı ödeme yapmadan önce uyarmalı, işlemin sonradan başarısız olmasına izin vermemelidir.

Ödeme​

Geçerliliği memo kadar tutar da belirler:

  • REG, isim uzunluğuna karşılık gelen kayıt ücretini tam olarak ödemelidir.
  • UPD, CHG, LST, ULT, değişiklik ücretini tam olarak ödemelidir.
  • BUY, ilan fiyatını tam olarak ödemelidir.

Uzunluk, bölge hariç etiket üzerinden ölçülür: ab.zcash, 2 karakterlik bir isimdir.

Eksik ya da fazla ödenmiş bir komut işlenmez; biçim ya da imza denetiminden geçemeyen bir memo da işlenmez. İkisi de en az 0.005 ZEC ödüyorsa ve hâlâ şu kadarı okunabiliyorsa iç bakiyenize iade edilir: zNS:1: başlığı, bilinen bir işlem ve geçerli bir açık anahtar — bir CHG için var olan bir isim. CHG imzalayanı değil yeni sahibi belirttiğinden iadesi onu imzalayan isim sahibine gider; hiçbir sahibin imzalamadığı bir CHG iade edilmez. İadeler 120 onaydan sonra yazılır ve ardından çekilebilir — bkz. Soru & Cevap.

Sıralama​

Komutlar, ZCash'in ürettiği sırayla işlenir: blok yüksekliği, sonra blok içindeki işlem indeksi. Kayıt operatörü sırayı seçmez ve her bağımsız indeksleyicinin farklı bir kök hesaplamasına yol açmadan sırayı değiştiremez.

Bir işlem tek bir komut taşır: kayıt operatörüne giden notlarından (notes), eylem (action) sırasına göre, memo'su iyi biçimlenmiş bir komut olan ilki. Aynı işlemde kayıt operatörüne giden diğer notlar ne işlenir ne de otomatik olarak iade edilir; bu yüzden her komutu ayrı bir işlemle gönderin.

Çekişmeli işlemlerde — aynı isim için iki REG ya da aynı ilan için iki BUY — bu sıradaki ilk işlem kazanır, diğerlerine tutar iç bakiyeye iade edilir.

Adım adım örnek​

richard.zcash kaydı:

1. Generate an Ed25519 keypair. The public key is your identity across all your names.

2. Build the message to sign (note: no trailing signature field):

zNS:1:REG:richard.zcash:u1mvnsq85wane…:3757ee1a…a53:1780000001

3. Sign it with the private key; hex-encode the 64-byte signature.

4. Append it to form the memo:

zNS:1:REG:richard.zcash:u1mvnsq85wane…:3757ee1a…a53:1780000001:cfec7a58…04

5. Send a shielded transaction to the registrar address, with that memo, paying the
registration fee for a 7-character name.

Ödeme 20 onaya ulaştığında — yaklaşık 25 dakika — komut bir sonraki toplu işe girer; toplu iş yaklaşık on dakika sonra kapanır, ardından ispatlanır ve çıpalanır. Bundan sonra richard.zcash, kendiniz denetleyebileceğiniz bir Merkle ispatıyla birlikte herhangi bir indeksleyici üzerinden çözümlenir.