Configuração do cliente

Iroha CLI e SDK Clientes utilizam TOML Configuração. O repositório envia o atual padrão em defaults/client.toml; gerado redes locais também escrever uma correspondência client.toml para o seu diretório de saída.

Modelo de configuração do cliente

chain = "00000000-0000-0000-0000-000000000000"
torii_url = "http://127.0.0.1:8080/"

[basic_auth]
web_login = "mad_hatter"
password = "ilovetea"

[account]
domain = "wonderland.universal"
public_key = "ed0120CE7FA46C9DCE7EA4B125E2E36BDB63EA33073E7590AC92816AE1E861B7048B03"
private_key = "802620CCF31D85E3B32A4BEA59987CE0C78E3B8E2DB93881468AB2435FE45D5C9DCD53"

[connect]
# Root directory for Connect queue diagnostics and evidence export. Defaults to `~/.iroha/connect`.
# queue_root = "/home/alice/.iroha/connect"

Campos do núcleo

Uma configuração de cliente identifica, no mínimo, a cadeia, o ponto final Torii e a conta de assinatura:

chain = "00000000-0000-0000-0000-000000000000"
torii_url = "http://127.0.0.1:8080"

[account]
domain = "wonderland.universal"
public_key = "ed0120..."
private_key = "802620..."

• O chain seleciona a cadeia à qual pertencem as transações apresentadas.
• torii_url pontos no ponto de comparação Torii HTTP API.
• O [account].domain é utilizado por atalhos CLI e codificação do selector de endereço; o canônico AccountId em si é sem domínio.
• As transações de assinatura [account].public_key e [account].private_key.

A conta deve já existir na cadeia. Para a rede local padrão, isso é tratado pelo manifesto de gênese em conjunto.

Sensibilidade do caso

Os nomes Iroha são sensíveis ao caso após a análise canônica. Por exemplo, wonderland.universal, Wonderland.universal e looking_glass.universal são dominios literários distintos.

A autenticação básica

A seção opcional [basic_auth] adiciona um cabeçalho HTTP Authorization às solicitações do cliente. Os pares Iroha não interpretam essas credenciais diretamente; use-as quando Torii está por trás de um proxy inverso, como o Nginx.

[basic_auth]
web_login = "mad_hatter"
password = "ilovetea"

Configuração de transações

O comportamento da transação é configurado com a secção [transaction]:

[transaction]
time_to_live_ms = 100000
status_timeout_ms = 15000
nonce = false

• time_to_live_ms é a duração da transacção em milissegundos.
• status_timeout_ms controla o tempo de espera do cliente pelo status da transacção.
• nonce = true pede ao cliente que inclua um não para que as transações repetidas produzam hashes diferentes.

Conectar as configurações de fila

Os clientes atuais Iroha podem também usar a seção opcional [connect] para o estado local da fila:

[connect]
queue_root = "./queue"

Use isto quando um fluxo de trabalho precisa de armazenamento duradouro na fila do lado do cliente.

Geração de configurações

Para redes locais descartáveis, preferir: Kagami Porque ele escreve coincidência Iroha 3 Configuras, gênese, scripts e um README:

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

Utilize o ./localnet/client.toml gerado com o CLI:

cargo run --bin iroha -- --config ./localnet/client.toml ledger domain list all