Skip to content

Chaves para a implantação da rede

Cada rede precisa de material-chave distinto para clientes, pares, assinatura da gênese e, para perfis NPoS ou Nexus, identidades de validador de BLS.

Onde as chaves são usadas

  • As chaves de assinatura do cliente são armazenadas em client.toml sob [account].
  • As chaves de identidade de pares são armazenadas em cada igual config.toml como public_key e private_key.
  • A peer discovery utiliza a chave pública de cada peer em trusted_peers.
  • Validador BLS As provas de posse são armazenadas em trusted_peers_pop para perfis de NPoS.
  • A assinatura da Gênesis utiliza a [genesis].public_key em configuração de pares e a chave privada correspondente ao assinar o manifesto.

Para implementações locais ou de teste, deixe Kagami gerar todos estes arquivos juntos:

bash
cargo run --bin kagami -- localnet --build-line iroha3 --peers 4 --out-dir ./localnet

Para uma rede ou perfil existente, use o fluxo guiado:

bash
cargo run --bin kagami -- wizard --profile nexus

Gerar pares de chaves individuais

Usar kagami keys para o material de chave independente:

bash
cargo run --bin kagami -- keys --algorithm ed25519 --json

Para o material de validação BLS, inclua uma prova de posse:

bash
cargo run --bin kagami -- keys --algorithm bls_normal --pop --json

Use --seed apenas para dispositivos de desenvolvimento reprodutíveis. Para implantação em produção, gerar chaves novas e armazenar chaves privadas fora do repositório.

Consistência entre pares

Todos os validadores devem concordar na mesma transação de gênese, topologia, chaves públicas confiáveis e validador PoPs. Uma única chave perdida ou incomparável pode impedir a rede de iniciar ou alcançar consenso.

Para uma implantação mínima tolerante às falhas bizantinas, use pelo menos quatro pares. Cada pares deve ter sua própria chave privada, mas cada configuração de pares precisa do mesmo conjunto de pares confiável.

Contas de clientes

A conta do cliente em client.toml deve já existir na cadeia. Pode ser registrada pelo manifesto genético ou por uma transação posterior. Evite usar a identidade de assinatura genética como uma conta de aplicação de longa duração; Os privilégios da Gênesis só se aplicam durante a rodada da Gênese, e os clientes de produção devem utilizar as suas próprias contas e papéis.