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ção | Estrutura do memo | Montante pago |
|---|---|---|
REG registar | zNS:1:REG:{name}:{address}:{pubkey}:{nonce}:{sig} | taxa de registo para o comprimento do nome |
UPD alterar endereço | zNS:1:UPD:{name}:{address}:{pubkey}:{nonce}:{sig} | taxa de alteração |
CHG transferir titular | zNS:1:CHG:{name}:{new_pubkey}:{nonce}:{sig} | taxa de alteração |
LST colocar à venda | zNS:1:LST:{name}:{pubkey}:{price}:{nonce}:{sig} | taxa de alteração |
ULT retirar da venda | zNS:1:ULT:{name}:{pubkey}:{nonce}:{sig} | taxa de alteração |
BUY comprar | zNS: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.priceaparece apenas emLST.addressaparece apenas emREG,UPDeBUY.priceenoncesã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
| Regra | Valor |
|---|---|
| Carateres | a-z, 0-9, hífen |
| Comprimento | 1–64 carateres incluindo a zona |
| Maiúsculas | apenas minúsculas — um nome é guardado e sujeito a hash em minúsculas |
| Hífenes | nã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.
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:
REGtem de pagar exatamente a taxa de registo correspondente ao comprimento do nome.UPD,CHG,LST,ULTtêm de pagar exatamente a taxa de alteração.BUYtem 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.