Pular para o conteúdo principal

Formato dos comandos

Todas as operações do zNS são uma transação blindada ZCash dirigida ao endereço de protocolo do registador, em que o montante é o pagamento e o memo é o comando assinado. Ambos viajam na mesma nota, pelo que intenção e pagamento ficam ligados de forma atómica — não há qualquer referência ou fatura separada a correlacionar.

Esta página descreve o formato de transmissão exato. Um comando construído segundo ele será aceite tanto pelo registador como pelo circuito de conhecimento zero.

Anatomia​

Todos os comandos são ASCII separado por dois pontos e começam pelo marcador de protocolo e pela versão:

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

Os campos intermédios dependem da operação:

OperaçãoEstrutura do memoMontante pago
REG registarzNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig}taxa de registo para o comprimento do nome
UPD alterar endereçozNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig}taxa de alteração
CHG transferir titularzNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig}taxa de alteração
LST colocar à vendazNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig}taxa de alteração
ULT retirar da vendazNS:1:ULT:{name}:{pubkey}:{nonce}:{sig}taxa de alteração
BUY comprarzNS:1:BUY:{name}:{address}:{pubkey}:{nonce}:{sig}exatamente o preço listado

Em CHG, {new_pubkey} é a chave do titular que recebe, e a assinatura é feita pelo titular que cede — é o titular atual quem autoriza uma transferência.

A mensagem assinada​

A assinatura cobre o comando sem o :{signature} final — isto é, tudo desde o marcador até ao nonce inclusive:

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

As regras são exatas, e um cliente que falhe qualquer uma delas produz uma assinatura que o circuito rejeita:

  • pubkey é hex em minúsculas, 64 carateres.
  • price aparece apenas em LST.
  • address aparece apenas em REG, UPD e BUY.
  • price e nonce são decimais, sem zeros à esquerda, sem sinal e sem preenchimento.
  • A assinatura é Ed25519 sobre exatamente esses bytes, codificada em hex, 128 carateres.

A verificação é estrita: assinaturas não canónicas e chaves de ordem pequena são rejeitadas.

Regras dos campos​

Nome​

RegraValor
Carateresa-z, 0-9, hífen
Comprimento1–64 carateres incluindo a zona
Maiúsculasapenas minúsculas — um nome é guardado e sujeito a hash em minúsculas
Hífenesnão no início, não no fim, nunca duplos
Zonas.zcash, .zec, .private, .secure, .safe

É permitido exatamente um ponto, que separa a etiqueta da zona.

Endereço de destino​

O endereço para o qual um nome é resolvido tem de ser um Unified Address na mainnet com um recetor Orchard. Endereços sem ele são recusados.

A razão é prática e não arbitrária: o registador recebe e paga através de material de chaves Orchard, que segundo o ZIP 229 cobre também o pool Ironwood. Um endereço sem recetor Orchard não pode ser pago, logo não serve nem para reembolsos nem para receitas de vendas.

dica

O Ironwood não acrescenta um recetor

O Ironwood é um novo pool de valor, não um novo formato de endereço. As carteiras migram notas para ele enquanto o endereço de receção continua a ser um endereço Orchard. O Unified Address de uma carteira atual funciona sem alterações.

Nonce​

O nonce é uma marca temporal Unix em segundos no momento da assinatura.

  • Tem de ser estritamente maior do que o nonce atualmente registado para esse nome. É isso que impede a repetição de um comando assinado antigo.
  • Não pode adiantar-se mais de 300 segundos ao bloco que o transporta, margem que absorve o desvio habitual dos relógios sem permitir deixar um nonce muito no futuro.

Para um primeiro registo serve qualquer marca temporal atual.

Preço​

Só o LST traz preço. É um número inteiro de zatoshis (1 ZEC = 100 000 000 zatoshis) e tem de ser maior que zero.

Voltar a listar um nome já listado a um novo preço é permitido — envie outro LST. Vence o mais recente.

Limite de tamanho​

Um memo ZCash ocupa exatamente 512 bytes, e o comando inteiro tem de caber. As partes fixas consomem uma quantidade previsível:

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

Sobram 296 bytes a repartir entre o nome e o endereço de destino, com o separador que se segue a cada um. Mesmo o nome mais longo, de 64 caracteres, deixa 232 para o endereço: mais do que precisa um endereço só com um recetor Orchard (106 caracteres), mas um Unified Address com vários recetores pode ser longo, pelo que, com um nome muito longo, um endereço muito longo pode não caber. Os clientes deveriam calcular esse orçamento e avisar antes de o utilizador pagar, em vez de deixarem a transação falhar depois do facto.

Pagamento​

O montante determina a validade tanto quanto o memo:

  • REG tem de pagar exatamente a taxa de registo correspondente ao comprimento do nome.
  • UPD, CHG, LST, ULT têm de pagar exatamente a taxa de alteração.
  • BUY tem de pagar exatamente o preço listado.

O comprimento é medido na etiqueta, sem a zona: ab.zcash é um nome de 2 carateres.

Um comando pago a menos ou a mais não é processado, tal como um memo que não passe a verificação de formato ou de assinatura. Ambos são reembolsados no seu saldo interno se pagarem pelo menos 0.005 ZEC e ainda puderem ser lidos até esse ponto: o cabeçalho zNS:1:, uma operação conhecida e uma chave pública válida — num CHG, um nome que existe. Um CHG indica o novo proprietário e não quem o assina, por isso o seu reembolso vai para o proprietário do nome que o assinou, e um CHG que nenhum proprietário assinou não é reembolsado. Os reembolsos são creditados após 120 confirmações e podem depois ser levantados — ver Perguntas e respostas.

Ordem​

Os comandos são processados pela ordem em que o ZCash os produziu: altura do bloco, depois índice da transação dentro do bloco. O registador não escolhe a ordem e não pode reordenar sem que todos os indexadores independentes calculem uma raiz diferente.

Uma transação transporta um comando: a primeira das suas notas (notes) para o registador, pela ordem das ações (actions), cujo memo seja um comando bem formado. Qualquer outra nota para o registador na mesma transação não é processada nem reembolsada automaticamente, por isso envie cada comando numa transação própria.

Nas operações disputadas — dois REG para o mesmo nome, ou dois BUY sobre a mesma listagem — vence o primeiro nessa ordem e aos restantes é devolvido o montante para o saldo interno.

Exemplo resolvido​

Registo de 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.

Quando o pagamento tem 20 confirmações — cerca de 25 minutos —, o comando entra no lote seguinte, que fecha cerca de dez minutos depois e é então provado e ancorado. A partir daí, richard.zcash é resolvido através de qualquer indexador, com uma prova de Merkle que pode verificar por si.