メインコンテンツまでスキップ

コマンド形式

zNS のすべての操作は、レジストラのプロトコルアドレス宛のシールドされた ZCash トランザクションであり、 金額が支払いで、メモが署名済みのコマンドです。どちらも同じノートの中を運ばれるので、意図と支払いが不可分に 結びつきます — 突き合わせるべき別の参照番号や請求書はありません。

このページは正確なワイヤ形式を示します。これに沿って組み立てたコマンドは、レジストラとゼロ知識回路の どちらにも受け入れられます。

構造​

すべてのコマンドはコロン区切りの ASCII で、プロトコルマーカーとバージョンから始まります:

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

その間のフィールドは操作によって変わります:

操作メモの構成支払額
REG 登録zNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig}名前の長さに応じた登録料
UPD アドレス変更zNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig}変更料
CHG 保有者の移転zNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig}変更料
LST 出品zNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig}変更料
ULT 取り下げzNS:1:ULT:{name}:{pubkey}:{nonce}:{sig}変更料
BUY 購入zNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig}ちょうど出品価格

CHG では {new_pubkey} が受け取る側の保有者の鍵で、署名は渡す側の保有者が行います — 移転を 承認するのは現在の保有者です。

署名対象のメッセージ​

署名は末尾の :{signature} を除いたコマンドを対象とします。つまりマーカーから nonce までを含む全体です:

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

ルールは厳密で、クライアントがどれか 1 つでも誤れば、回路が拒否する署名ができてしまいます:

  • pubkey は小文字の 16 進数、64 文字です。
  • price は LST にのみ現れます。
  • address は REG、UPD、BUY にのみ現れます。
  • price と nonce は 10 進数で、先頭のゼロ・符号・パディングはいずれも不可です。
  • 署名はまさにそのバイト列に対する Ed25519 署名で、16 進数エンコードの 128 文字です。

検証は厳格です。正準でない署名や小さな位数の鍵は拒否されます。

フィールドのルール​

名前​

ルール値
文字a-z、0-9、ハイフン
長さゾーンを含めて 1〜64 文字
大文字・小文字小文字のみ — 名前は小文字で保存・ハッシュされます
ハイフン先頭不可、末尾不可、連続も不可
ゾーン.zcash、.zec、.private、.secure、.safe

ドットはラベルとゾーンを分けるちょうど 1 つだけが許されます。

宛先アドレス​

名前が解決される先のアドレスは、Orchard レシーバーを備えたメインネットの Unified Address でなければ なりません。それを持たないアドレスは拒否されます。

理由は恣意的ではなく実務的です。レジストラは Orchard の鍵素材を通じて受け取りと支払いを行い、その素材は ZIP 229 により Ironwood プールもカバーします。Orchard レシーバーのない アドレスへは支払えないので、返金にも売上にも使えません。

ヒント

Ironwood は新しいレシーバーを追加しません

Ironwood は新しい価値プールであって、新しいアドレス形式ではありません。ウォレットはノートをそちらへ移し ますが、受け取りアドレスは Orchard アドレスのままです。現行ウォレットの Unified Address はそのまま使えます。

Nonce​

nonce は署名した時点の秒単位の Unix タイムスタンプです。

  • その名前について現在記録されている nonce より厳密に大きくなければなりません。これが古い署名済み コマンドの再利用を防ぎます。
  • それを運ぶブロックより 300 秒を超えて先行することはできません。この余裕は通常の時計のずれを吸収しつつ、 nonce を遠い未来に据え置くことは許しません。

初回登録なら、現在時刻のタイムスタンプであれば何でも構いません。

価格​

価格を持つのは LST だけです。整数の zatoshi(1 ZEC = 100,000,000 zatoshi)で、ゼロより大きくなければ なりません。

すでに出品済みの名前を新しい価格で出し直すことは許されています — もう 1 度 LST を送ってください。最も 新しいものが有効になります。

サイズの上限​

ZCash のメモはちょうど 512 バイトで、コマンド全体がその中に収まらなければなりません。固定部分が占める 量は予測できます:

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

残る 296 バイトを、それぞれの後に続く区切り文字も含めて名前と宛先アドレスで分け合います。最長の 64 文字の名前でも アドレスには 232 文字が残り、Orchard レシーバーだけのアドレスに必要な長さ(106 文字)より多くなりますが、レシーバーが 複数ある Unified Address は長くなり得るので、名前がとても長い場合、とても長いアドレスは収まらないかもしれません。 クライアントはこの予算を計算し、ユーザーが支払う前に警告すべきで、後からトランザクションを失敗させるべきではありません。

支払い​

有効性はメモと同じくらい金額によって決まります:

  • REG は名前の長さに応じた登録料をちょうど支払わなければなりません。
  • UPD、CHG、LST、ULT は変更料をちょうど支払わなければなりません。
  • BUY は出品価格をちょうど支払わなければなりません。

長さはゾーンを除いたラベルで数えます:ab.zcash は 2 文字の名前です。

支払いが不足または超過したコマンドは処理されません。形式または署名の検査に通らないメモも同様です。どちらも、0.005 ZEC 以上が支払われ、かつ zNS:1: の先頭部分・既知の操作・有効な公開鍵(CHG の場合は存在する名前)まで読み取れるなら、内部残高に返金されます。CHG は署名者ではなく新しい所有者を指定するため、その返金は署名した名前の所有者に届き、どの所有者も署名していない CHG は返金されません。返金は 120 回の承認の後に計上され、その後出金できます — 質問と回答を参照してください。

順序​

コマンドは ZCash が生成した順序で処理されます。ブロック高、次にブロック内のトランザクションインデックスの順です。レジストラは順序を選べませんし、すべての独立したインデクサーに別のルートを計算させることなく並べ替えることもできません。

1 つのトランザクションが運ぶコマンドは 1 つです。レジストラへのノート(note)のうち、アクション(action)順で最初の、メモが正しい形式のコマンドになっているものがそれです。同じトランザクション内のレジストラへのほかのノートは処理されず、自動的に返金されることもないため、コマンドは 1 つずつ別のトランザクションで送ってください。

競合する操作 — 同じ名前に対する 2 つの REG、または同じ出品に対する 2 つの BUY — では、その順序で最初の ものが勝ち、残りの金額は内部残高へ返金されます。

具体例​

richard.zcash の登録:

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.

支払いが 20 回の承認(約 25 分)に達すると、コマンドは次のバッチに入ります。バッチは約 10 分後に締め切られ、その後証明され、アンカーされます。それ以降 richard.zcash はどのインデクサー経由でも解決でき、しかもあなた自身で検証できるマークル証明が添えられます。