Mineração

Proof of work com RandomX, no processador que já está no seu computador. Sem fazenda de ASIC para competir e sem premine — as moedas vêm da mineração e de mais nenhum lugar.

Tudo o que há#

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

# Mine to it.
zycordd --testnet --dir ./testnet \
  --mine --payout $(zcd wallet address --key miner.json)

Na testnet pública e na mainnet esses são os binários -randomx — zcd-randomx e zycordd-randomx. Um binário construído sem a tag se recusa a iniciar em vez de recorrer ao motor de desenvolvimento. Veja Instalação.

Inicie quando quiser#

Um nó iniciado antes de o primeiro bloco de sua rede estar previsto não minera cedo demais e não precisa ser iniciado de novo na hora marcada. Ele se recusa a construir um bloco cujo timestamp seu próprio relógio ainda não alcançou, espera, e começa sozinho. Ele avisa isso enquanto espera, com o horário pelo qual está esperando e quanto falta:

waiting to mine: the next block cannot be dated before 2026-10-01T00:00:01Z
(unix 1790812801), and this node's clock reads 2026-09-30T20:12:31Z - 3h47m30s
to wait. Leave this running: mining starts on its own and there is nothing to
restart or reconfigure.

Isso é uma recusa a minerar, não uma recusa a rodar: o nó mantém pares, sincroniza e serve seu RPC o tempo todo. A mensagem se repete a cada dez minutos para que uma espera longa não pareça um travamento.

Essa recusa é também o motivo pelo qual é seguro publicar um horário de início. Sem ela o minerador datava seu cabeçalho adiante até o piso mediano, que antes da gênese é o próprio genesis_time — então um início antecipado produzia uma cadeia privada que ninguém mais podia julgar e, como a regra de dificuldade mede os tempos de solução declarados, uma cujo alvo endurecia a cada bloco contra intervalos que nada tinham a ver com tempo real decorrido. Ninguém precisava ser desonesto para isso; era o que deixá-lo rodando durante a noite costumava fazer.

O endereço de pagamento precisa ser persistente#

Ele precisa ser um endereço persistente (0x02) — o zcd wallet address imprime um por padrão — e o zycordd recusa qualquer outro em vez de avisar. O nó nunca vê a chave que o controla, e não poderia gastar a recompensa nem se quisesse.

Maturidade do coinbase#

As recompensas amadurecem após coinbase_maturity blocos — 100 tanto na mainnet quanto na testnet pública. Até lá elas ficam visíveis no estado e não gastáveis, que é o que financia os primeiros depósitos em uma cadeia sem premine: pelos primeiros cem blocos, aproximadamente, apenas mineradores podem transacionar.

A mainnet não tem faucet e não terá um, então na mainnet essa rampa é toda a distribuição: minere para participar. A testnet pública tem um faucet, financiado pela mineração como todo o resto nela, porque uma rede cujas moedas não valem nada não perde nada ao deixar alguém ensaiar uma carteira antes de ensaiar um minerador.

Quanto custa rodar#

A função de trabalho é um parâmetro de consenso, não uma configuração. O zcd params a imprime:

proof of work    randomx-v1 (re-keyed every 2048 blocks, 64-block lag)

Memória#

Verificar precisa de cerca de 256 MiB por época de chave mantida, e a tabela mantém duas para que uma reorganização atravessando uma fronteira de chave não reconstrua uma por bloco. Orçe mais do que essa tabela, porque a tabela não é o limite. Um cache fica residente a partir do momento em que é alocado e o preenchimento Argon2 que o torna caro vem depois — então até mais dois ficam vivos enquanto estão sendo construídos — e uma entrada despejada enquanto algo ainda a usa retém tudo o que tem até que esse usuário a solte, que é o que um minerador faz ao longo de um preenchimento de dataset.

Uma máquina que consegue verificar confortavelmente não consegue necessariamente minerar.

Threads#

O --mine-threads tem como padrão uma por núcleo. Ele não muda nada quanto à validade; é a velocidade com que este nó procura uma solução.

O que acontece em uma troca de chave#

A função de trabalho recebe uma nova chave a cada randomx_key_interval blocos. Um nó minerador reconstrói o dataset de ~2 GiB então e para de minerar enquanto o faz — algo da ordem de dez segundos, dependente da máquina; meça o da sua a partir da primeira fronteira no log.

Ele continua verificando o tempo todo, e uma reconstrução não pode travá-lo: um cabeçalho de qualquer época de chave que não seja a que está sendo minerada é verificado no cache de 256 MiB da própria época, que o dataset não toca. Os dois computam digests idênticos, então a única diferença que uma reconstrução faz para a verificação é a velocidade. O cache da próxima época é aquecido ao longo dos últimos randomx_key_lag blocos da época.

O intervalo mais curto da testnet é deliberado: ensaiar essa fronteira com mais frequência faz parte do que a rede existe para medir. Construir o dataset da próxima época com antecedência é possível — a chave vem da altura, então é conhecida bem antes da fronteira — e deliberadamente não é feito: significaria manter dois deles, 4 GiB, para poupar uma pausa que custa a um minerador alguns segundos por dia.

Parando um nó minerador#

O SIGTERM (ou Ctrl-C) o para, e ele para prontamente: um sinal alcança todos os laços, não apenas aquele que por acaso estiver esperando no canal.

Uma parada que acontece durante uma troca de chave espera o preenchimento do dataset terminar — o motor não libera um buffer de ~2 GiB enquanto chamadas de hash ainda o estiverem lendo, o que é um use-after-free em C que nenhuma ferramenta Go reportaria. É uma parada esperando um evento fixo em vez de uma disputando com ele: medido ao longo de dez execuções, o instante de saída não se moveu por mais cedo que o sinal chegasse, enquanto a espera encolheu de 4,5 s para 0,7 s, sem nenhum SIGSEGV.

Então orçe um tempo limite de parada acima do tempo de preenchimento da sua máquina. Um segundo SIGTERM não espera — o primeiro devolve o sinal ao sistema operacional, então pressionar Ctrl-C de novo durante essa pausa mata o processo imediatamente.

Pools, e por que não há nenhuma#

Nenhuma existe no lançamento e nenhuma é oficial. O nó minera sozinho por padrão, e na dificuldade de gênese essa é a forma sensata de entrar. Se pools aparecerem, elas são terceiros; aplique o ceticismo que você aplicaria em qualquer lugar.

Botnets, nomeadas em vez de negadas#

A mineração por CPU as convida. Toda moeda minerável por CPU já as combateu e este projeto não espera ser a exceção. A troca é feita de olhos abertos: uma distribuição enviesada por botnets ainda é mais ampla do que uma decidida em uma venda, e manter competitivo o notebook que você já tem é toda a razão de o RandomX existir.

Vendo funcionar#

O explorador da testnet renderiza cada bloco e cada certificado, inclusive a página que o explorador de nenhuma outra cadeia consegue renderizar: se cada certificado foi aplicado, ou sofreu omissão e foi cobrado, e qual leitura declarada deixou de valer. Seu próprio nó responde às mesmas perguntas em /status, /head e /metrics — veja a superfície somente leitura.