Referência de comandos CLI · Wiki Chia-Network / chia-blockchain · GitHub

Esta página deve fornecer documentação adicional de alto nível e explicação além de apenas chia -h.

Isso não pretende ser abrangente, porque muitas vezes o -h (ajuda) o texto é claro o suficiente. Recomendamos uma investigação completa com o -h mude antes de olhar para outro lugar.

Se quiser saber quais são as opções de um comando, anexe -h no final para ver opções e explicações.

Alguns exemplos:

  • chia -h
  • chia plots -h
  • chia plots check -h
  • chia start -h

Tal como acontece com o resto deste projeto, este documento é um trabalho em andamento. Sinta-se à vontade para navegar pelo código-fonte ou pelo Documento de Prova de Construção do Espaço Chia para obter mais informações enquanto isso.

Mac

Se você instalou Chia.app na tua /Applications diretório, você pode encontrar o chia binário em /Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/chia.

Faça uma verificação de integridade Terminal.app com

/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/chia -h

Você pode usar isso se aumentar seu PATH com

PATH=/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon:$PATH

e depois chia -h Deveria trabalhar.

janelas

Há mais de um chia.exe binário; a GUI é Chia.exe (dois desses!) e a CLI é chia.exe. Eles são encontrados em lugares diferentes. Observe o grande C versus o pequeno c.

O CLI é o referido neste documento, e para a versão 1.1.3 pode ser encontrado em

~AppDataLocalchia-blockchainapp-1.1.3resourcesapp.asar.unpackeddaemonchia.exe

Comando: chia init

Primeiro, init verifica se há versões antigas do chia instaladas no diretório ~ / .chia.

Se for assim, init migra esses arquivos antigos para a nova versão:

  • configuração (incluindo arquivos SSL antigos)
  • db
  • carteira
  • Usando o config.yaml, atualiza as chaves da carteira e garante que as recompensas da base de moedas vão para o puzzlehash da carteira certa.

Se não houver uma versão antiga, init:

  • Cria uma configuração chia padrão
  • Inicializa uma nova chave SSL e certificado (para comunicação segura com a GUI)

Comando: chia start {service}

  • Serviço node iniciará apenas o nó completo.
  • Serviço farmer iniciará o agricultor, a colheitadeira, um nó completo e a carteira.
  • argumentos posicionais: {all, node, harvester, farmer, farmer-no-wallet, farmer-only, timelord, timelord-only, timelord-launcher-only, wallet, wallet-only, introdutor, simulador}

Bandeiras

-r, --restart: Reinício de processos em execução

Comando: chia plots create [add flags and parameters]

Bandeiras

-k [size]: Defina o tamanho da (s) parcela (s). Para obter uma lista de k-tamanhos e tempos de criação em vários sistemas, verifique: k-Sizes

-n [number of plots]: A quantidade de plotagens que serão feitas, em seqüência. Assim que o lote for concluído, ele será movido para o local final -d, antes de iniciar o próximo gráfico na sequência.

-b [memory buffer size MiB]: Defina o uso de memória / RAM. O padrão é 4608 (4,6 GiB). Mais RAM aumentará marginalmente a velocidade de criação do gráfico. Lembre-se de que isso é o que é alocado apenas para o algoritmo de plotagem. Código, contêiner, bibliotecas etc. exigirão RAM adicional de seu sistema.

-f [farmer pk]: Esta é a sua “Chave Pública do Fazendeiro”. Utilize-o quando quiser criar plotagens em outras máquinas para as quais não deseja conceder acesso total à conta chia. Para encontrar sua chave pública Chia Farmer, use o seguinte comando: chia keys show

-p [pool pk]: Esta é a sua “Chave Pública do Pool”. Utilize-o quando quiser criar plotagens em outras máquinas para as quais não deseja conceder acesso total à conta chia. Para encontrar a sua chave pública Chia Pool, use o seguinte comando: chia keys show

-a [fingerprint]: Esta é a impressão digital chave usada para selecionar as chaves públicas do fazendeiro e do pool a serem usadas. Use-o quando quiser selecionar uma das várias chaves do seu chaveiro. Para encontrar sua impressão digital Chia Key, use o seguinte comando: chia keys show

-t [tmp dir]: Defina o diretório temporário para a criação do gráfico. É aqui que a Fase 1 de Plotagem (Propagação para frente) e a Fase 2 (Propagação para trás) ocorrem. O -t dir requer o maior espaço de trabalho: normalmente cerca de 2,5 vezes o tamanho do lote final.

-2 [tmp dir 2]: Defina um diretório temporário secundário para a criação do gráfico. É aqui que ocorre a Fase 3 de Plotagem (Compressão) e a Fase 4 (Pontos de Verificação). Dependendo do seu sistema operacional, -2 pode ser padronizado para qualquer um -t ou -d. Portanto, se qualquer um -t ou -d estão com pouco espaço, é recomendável definir -2 manualmente. O -2 dir requer uma quantidade de espaço de trabalho igual ao tamanho final da plotagem.

-d [final dir]: Defina a localização final para os lotes. Claro, -d deve ter espaço livre suficiente como o tamanho final do lote. Este diretório é adicionado automaticamente ao seu ~/.chia/VERSION/config/config.yaml Arquivo. Você pode usar chia plots remove -d para remover um diretório final da configuração.

-r [number of threads]: 2 geralmente é ideal. Multithreading está apenas na fase 1 atualmente.

-u [number of buckets]: Mais depósitos requerem menos RAM, mas mais buscas aleatórias no disco. Com discos giratórios você quer menos baldes e com NVMe mais baldes. Não há nenhum benefício significativo em usar baldes menores – apenas use 128.

-e [bitfield plotting]: Usando o -e O sinalizador desabilitará o algoritmo de plotagem de campo de bits e reverterá para o estilo de plotagem b17 mais antigo. Após 1.0.4 é melhor usar bitfield para a maioria dos casos (não usando -e) Antes de 1.0.4 (obsoleto) usando o -e sinalizador (campo de bits desativado) reduz o requisito de memória, mas também grava cerca de 12% a mais de dados durante a criação do gráfico. Por enquanto, o espaço temporário SSD provavelmente será plotado mais rápido com -e (propagação de bitfield back desativada) e para discos giratórios mais lentos, ou seja, SATA 5400/7200 rpm, não usando -e (bitfield habilitado) é uma opção melhor.

-x [exclude final dir]: Pula a adição [final dir] para colheitadeira para agricultura.

Exemplos de comandos de plotagem

O exemplo abaixo criará um gráfico K32 e usará 4 GB (nota – não GiB) de memória.

chia plots create -k 32 -b 4000 -t /path/to/temporary/directory -d /path/to/final/directory

O exemplo 2 abaixo criará um gráfico k34 e usará 8 GB de memória, 2 threads e 64 baldes

chia plots create -k 34 -e -b 8000 -r 2 -u 64 -t /path/to/temporary/directory -d /path/to/final/directory

O Exemplo 3 abaixo criará cinco plotagens K32 (-n 5) um de cada vez usando 4 GB -b 4000 (nota – não GiB) de memória e usa um diretório temporário secundário (-2 /path/to/secondary/temp/directory)

chia plots create -k 32 -b 4000 -n 5 -t /path/to/temporary/directory -2 /path/to/secondary/temp/directory -d /path/to/final/directory

Notas adicionais de plotagem

  • Durante a plotagem, a Fase 1 (Propagação para frente) e a Fase 3 (Compressão) tendem a levar mais tempo. Portanto, para maximizar a velocidade de plotagem, -t e -2 deve estar em suas unidades mais rápidas, e -d pode estar em uma movimentação lenta.

  • Existem 4 fases principais para traçar. A fase 1 da plotagem pode utilizar multi-threading. As fases 2-3, não. Você pode otimizar melhor sua plotagem usando o -r sinalizar em seu comando e defini-lo como maior que 2, por exemplo ,. -r 2. Acima de 4 tópicos, há retornos decrescentes. Muitos usuários de Chia determinaram que é mais eficiente plotar em paralelo, em vez de em série. Você pode fazer isso apenas tendo várias instâncias de plotagem abertas, mas surpreendentes quando começam 30 minutos ou mais.

  • É objetivamente mais rápido plotar em SSDs em vez de HDDs. No entanto, os SSDs têm longevidade significativamente mais limitada, e os primeiros testes de Chia parecem indicar que traçar um SSD os desgasta muito rapidamente. Portanto, muitos usuários de Chia decidiram que é mais “verde” plotar em paralelo em vários HDDs ao mesmo tempo.

  • A plotagem é projetada para ser o mais eficiente possível. No entanto, para evitar ataques de trituração, os agricultores não devem ser capazes de criar uma parcela dentro do intervalo médio do bloco. É por isso que o tamanho k mínimo é k32 no mainnet.

Comando: chia plots check -n [num checks] -l -g [substring]

Primeiro, ele verifica todos os diretórios de plotagem de seu config.yaml. Você pode verificar esses diretórios com chia plots show. Este comando verificará se os gráficos são válidos, dadas as chaves associadas ao gráfico e as chaves Chia armazenadas em sua máquina, bem como testará o gráfico com desafios para identificar os gráficos encontrados versus o número esperado de lotes.

-g verifique apenas os gráficos com diretório ou nome de arquivo com distinção entre maiúsculas e minúsculas [substring].
Se -g não é especificado, todos os gráficos em cada diretório de gráfico em seu config.yaml serão verificados.

Exemplos de uso -g

  • Verifique os gráficos dentro de um nome de diretório longo, como /mnt/chia/DriveA pode usar chia plots check -g DriveA
  • Verifique se apenas os gráficos k33 podem usar chia plots check -g k33
  • Parcelas de verificação criadas em 31 de outubro de 2020 podem usar chia plots check -g 2020-10-31

-l permite que você encontre plotagens duplicadas por ID. Ele verifica todos os diretórios de plotagem listados em config.yaml e lista todos os nomes de arquivos de plotagem com o mesmo fim de nome de arquivo; *-[64 char plot ID].plot. Você deveria usar -l -n 0 se você deseja apenas verificar se há duplicatas.

-n representa o número de desafios apresentados. Se você não incluir um -n inteiro, o padrão é 30. Por exemplo, se -n é 30, então 30 desafios serão dados a cada parcela. Os desafios contam de 5 (mínimo) a -n, e não são aleatórios.

Cada enredo terá cada desafio e:

  • Obtenha a qualidade para o desafio (há uma prova de espaço? Você deve esperar 1 prova por desafio, mas pode haver 0 ou mais de 1.)
  • Obtenha a (s) prova (s) completa (s) para o desafio, se houver uma prova
  • Valide se o número de provas completas corresponde ao número de provas de qualidade esperadas.

Finalmente, você verá um relatório das provas verdadeiras finais versus provas esperadas.

Portanto, se -n é 20, você esperaria 20 provas, mas seu gráfico pode ter mais ou menos.

Executando o comando com -n 10 ou -n 20 é bom para uma verificação muito pequena, mas não fornece muitas informações sobre se os gráficos são realmente de alta qualidade ou não.

Considere usar -n 30 para ter uma ideia estatisticamente melhor.

Para obter mais detalhes, você pode ler sobre os comandos DiskProver em chiapos

O que significa a proporção de provas completas vs provas esperadas?

  • Se a proporção for> 1, seu enredo foi relativamente sortudo para esta série de desafios.
  • Se a proporção for <1, ​​seu gráfico teve relativamente azar.
    • Isso não deve preocupá-lo, a menos que sua proporção seja <0,70 # Se for assim, faça um exame mais completo chia plots check aumentando o seu -n

O desafio de verificação de plotagem é um desafio estático. Por exemplo, se você executar uma verificação de plotagem 20 vezes, com 30 tentativas no mesmo arquivo, produzirá o mesmo resultado todas as vezes. Portanto, embora você possa ver uma proporção do gráfico << 1 para uma verificação do gráfico com x número de tentativas, isso não significa que a trama em si seja inútil. Significa apenas que, dados esses desafios estáticos, o enredo está produzindo muitas provas. Como o número de tentativas (-n) aumenta, esperaríamos que a proporção não fosse << 1. Como a Mainnet está no ar, e dado que o blockchain tem novos desafios com cada ponto de sinalização - só porque um enredo está tendo problemas com um desafio específico, não significa tem os mesmos resultados em comparação com outro desafio. "Número de parcelas" e "tamanho k" são fatores muito mais influentes na vitória de blocos do que "provas produzidas por desafio".

Em teoria, um enredo com uma razão >> 1 teria mais probabilidade de vencer desafios no blockchain. Da mesma forma, um gráfico com uma proporção << 1 teria menos probabilidade de vencer. No entanto, na prática, isso não será realmente perceptível. Portanto, não se preocupe se as taxas de verificação do gráfico forem menores que 1, a menos que sejam significativamente menos de 1 para vários -n.

$ chia

Options:
  --root-path PATH  Config file root  [default: /home/mariano/.chia/mainnet]
  -h, --help        Show this message and exit.

Commands:
  configure   Modify configuration
  farm        Manage your farm
  init        Create or migrate the configuration
  keys        Manage your keys
  netspace    Estimate total farmed space on the network
  plots       Manage your plots
  run_daemon  Runs chia daemon
  show        Show node information
  start       Start service groups
  stop        Stop services
  version     Show chia version
  wallet      Manage your wallet

Para ver o que você pode fazer com cada um desses comandos, use o sinalizador de ajuda -h. Por exemplo, chia show -h.

Para verificar o status completo do seu nó, faça chia show -s e você verá algo assim. Para descobrir o quão perto você está, observe sua altura. Depois de totalmente sincronizado, ele dirá Full Node Synced no topo.

Current Blockchain Status: Full Node Synced

Peak: Hash: 34554a10aff6b52545623e18667c9487758fa93a3b2345974da0d263939189dc
      Time: Tue Mar 23 2021 20:54:46 JST                  Height:      19882

Estimated network space: 136.225 PiB
Current difficulty: 9
Current VDF sub_slot_iters: 112197632
Total iterations since the start of the blockchain: 63291534050

  Height: |   Hash:
    19882 | 34554a10aff6b52545623e18667c9487758fa93a3b2345974da0d263939189dc
    19881 | f53c052cd7ac58539ff5c35cb9d515bc521308a49cec7566b23dba84f76009d8
    19880 | 924d825a7fdbfd61e4582efbbe1d977bb554b368eea58c349a71e688e43fcc49

Você pode adicionar e remover diretórios para seus lotes com chia plots add -d 'your_dir' ou chia plots remove -d 'your_dir', pode ser encontrada ajuda para adicionar / remover com chia plots add/remove -h

Verificando registros e status

Você pode verificar o conteúdo da sua carteira com: chia wallet, e o status do seu agricultor com chia farm summary.

Verifique os registros da colheitadeira e do fazendeiro: grep ~/.chia/mainnet/log/debug.log -e harvester

Resultado da amostra:

17:08:03.191 harvester harvester_server        : INFO     <- harvester_handshake from peer 214b269a425b8223cb50fbd458dab056599348e255f07a018c13ea9efb509ee5 127.0.0.1
17:08:03.194 farmer farmer_server              : INFO     -> harvester_handshake to peer 127.0.0.1 65f3fa0b0407a07da8ccf04dfa0f64c28f714726312aa051d3a8529390db4d7a
17:08:03.218 harvester src.plotting.plot_tools : INFO     Searching directories ['/home/user/slab1/plots']
17:08:03.227 harvester src.plotting.plot_tools : INFO     Found plot /home/user/slab1/plots/plot-k32-2021-01-11-17-26-bf2363828e469a3417b89eb98cfa9d694809e1ce8bef0ffd1d12853d4227aa0a.plot of size 32
17:08:03.227 harvester src.plotting.plot_tools : INFO     Loaded a total of 1 plots of size 0.09895819725716137 TiB

Talvez siga os registros: tail -F ~/.chia/mainnet/log/debug.log. Chia é bom o suficiente para girar toras para você.

source: https://github.com/Chia-Network/chia-blockchain/wiki/CLI-Commands-Reference

Deixe uma resposta

O seu endereço de email não será publicado. Campos obrigatórios marcados com *