Documentação do Zycord

Tudo o que foi publicado sobre o Zycord, em ordem de leitura — o argumento de projeto, a especificação de engenharia e os guias de operação para de fato executá-lo.

O Zycord é uma rede, minerada sob proof of work até que a era 2 a passe para proof of stake, na qual cada transação — chamada de certificado — carrega o estado que leu e o estado que escreveu. Verificar uma é, portanto, uma função pura de seus bytes: sem disco, sem histórico, sem estado compartilhado, e sem limite para quantas máquinas a verificam ao mesmo tempo. A cadeia nunca executa nada. Ela ordena certificados e os compromete com um fold determinístico que aplica cada certificado cujas entradas declaradas ainda valem, e omite o restante, cobrando cada omissão do depósito que o certificado nomeou. Um contrato com estado disputado é servido por um sequenciador, que executa fora da cadeia os intents assinados dos usuários e publica os resultados como certificados; um caminho forçado permite que qualquer usuário alcance qualquer contrato sem um.

Estas páginas são a documentação desse sistema: o argumento de design, a especificação de engenharia, e os guias operacionais para rodá-lo. Elas são escritas a partir das mesmas fontes das quais a implementação de referência é construída, e onde qualquer uma delas divergir do repositório, o repositório é que está certo.

Comece por aqui#

Rode#

Referência#

O caminho útil mais curto#

Se você quer estar na rede hoje em vez de ler sobre ela, isto é tudo. O exemplo entra na testnet pública, que roda a mesma versão da mainnet sob seu próprio arquivo de parâmetros e chain id; sem --testnet, e com um diretório próprio, o mesmo comando entra na mainnet.

# Build the binary that can join a RandomX network.
# `make build` produces a devnet-only binary -- see Installation, "Two tiers".
make build-randomx

# A payout address. The node never sees the key behind it.
./bin/zcd-randomx wallet new --out miner.json

# Join, and mine to yourself. Coins come from mining; on testnet there is
# also a faucet at zycord.com/faucet/ for a first, small balance.
./bin/zycordd-randomx --testnet --dir ./testnet \
  --mine --payout $(./bin/zcd-randomx wallet address --key miner.json)

Inicie quando quiser, inclusive antes de o primeiro bloco de uma rede estar previsto: o nó se recusa a construir um bloco que seu próprio relógio não alcançou, diz quanto tempo falta, e começa a minerar sozinho. Não há nada a agendar nem nada a reiniciar. A versão completa disto é Testnet pública, e quanto custa rodar está em Mineração.

O que é autoritativo, e o que é apenas explicação#

Isto importa mais aqui do que na maioria dos projetos, porque a rede não tem chave de administração e portanto não tem como corrigir um erro depois do fato. Os documentos são hierarquizados, e a hierarquia não é uma formalidade:

Onde quaisquer dois divergirem, o mais preciso vence e a divergência é um bug que vale reportar. Nenhum número escrito à mão nas camadas explicativas é fonte de verdade; ele é gerado a partir do código, afirmado por um teste nomeado, ou uma ilustração que nada mais pode citar.

Confira você mesmo#

Para um projeto cujo autor não vai atestar por ele pessoalmente, nada aqui vale mais do que aquilo que você pode conferir sem pedir a ninguém. O protocolo é um diretório de arquivos: os arquivos de parâmetros congelados na gênese, e vetores de referência que dão a cada regra de fold, de bloco e de validade o seu próprio caso. Uma implementação que passa por eles é um par, não um fork.