Configuración del cliente

Iroha CLI y SDK los clientes utilizan TOML Configuración. El repositorio envía el estado predeterminado actual a defaults/client.toml; las redes locales generadas también escriben una correspondencia client.toml en su directorio de salida.

Modelo de configuración del 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"

Los campos centrales

Por lo menos, una configuración de cliente identifica la cadena, el punto final Torii y la cuenta de firma:

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

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

• chain selecciona la cadena a la que pertenecen las operaciones presentadas.
• torii_url puntos en el punto de comparación Torii HTTP API.
• [account].domain es utilizado por los atajos CLI y la codificación del seleccionador de direcciones; el canónico AccountId en sí mismo es sin dominio.
• [account].public_key y [account].private_key firmarán las transacciones.

La cuenta debe ya existir en la cadena. Para la red local predeterminada esto es manejado por el manifiesto de génesis agrupado.

Sensibilidad del caso

Los nombres Iroha son sensibles a los casos después del análisis canónico. Por ejemplo, wonderland.universal, Wonderland.universal y looking_glass.universal son dominios literales distintos.

Autenticación básica

La sección [basic_auth] opcional agrega un encabezado HTTP Authorization a las solicitudes del cliente. Los pares Iroha no interpretan estas credenciales directamente; uselas cuando Torii está detrás de una proxy inversa como Nginx.

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

Configuración de las transacciones

El comportamiento de la transacción se configura con la sección [transaction]:

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

• time_to_live_ms es el período de vida de la transacción en milisegundos.
• status_timeout_ms controla cuánto tiempo espera el cliente para el estado de la transacción.
• nonce = true pide al cliente que incluya un nonce para que las transacciones repetidas produzcan diferentes hashes.

Conectar la configuración de cola

Los clientes Iroha actuales también pueden utilizar la sección opcional [connect] para el estado de cola local:

[connect]
queue_root = "./queue"

Use esto cuando un flujo de trabajo necesita almacenamiento duradero en la cola del lado del cliente.

Generación de configuraciones

Para las redes locales desechables, prefiere Kagami porque escribe configuras, génesis, scripts y un README que coincidan con Iroha 3:

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

Utilice el ./localnet/client.toml generado con el CLI:

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