Конфигурация клиента

Iroha CLI и SDK клиенты используют TOML Репозиторий отправляет текущий по умолчанию на defaults/client.toml; генерируемые локальные сети также пишут совпадение client.toml в их исходный каталог.

Шаблон конфигурации клиента

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"

Основные поля

По крайней мере, конфигурация клиента определяет цепочку, конечную точку Torii и подписывающийся счет:

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 выбирает цепочку, к которой относятся представленные сделки.
• torii_url пункты на уровне Torii HTTP API.
• [account].domain используется сокращениями CLI и кодированием адреса-селектора; сам канонический AccountId не имеет доменов.
• [account].public_key и [account].private_key подписывают сделки.

Счет должен уже существовать в цепочке. Для дефолта локальной сети это обрабатывается с помощью объединенного генезисного манифеста.

Чувствительность случая

Названия Iroha чувствительны к случаям после канонического анализа. Например, wonderland.universal, Wonderland.universal и looking_glass.universal являются отдельными доменными буквалями.

Основная аутентификация

Необходимо [basic_auth] в разделе добавляется HTTP Authorization Заголовок к запросам клиентов. Iroha не интерпретируют эти учетные данные напрямую; используйте их, когда Torii стоит за таким реверсным прокси, как Nginx.

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

Настройки транзакций

Действие транзакции конфигурировано в разделе [transaction]:

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

• time_to_live_ms - срок действия транзакции в миллисекундах.
• status_timeout_ms контролирует, как долго клиент ожидает состояния сделки.
• nonce = true просит клиента включить нечто, так что повторяющиеся транзакции производят разные хэши.

Подключить настройки очереди

Текущие клиенты Iroha также могут использовать дополнительный раздел [connect] для состояния местной очереди:

[connect]
queue_root = "./queue"

Используйте это, когда рабочий процесс требует длительного хранения в очереди с стороны клиента.

Создание конфигураций

Для одноразовых локальных сетей предпочтительнее Kagami потому что там написано совпадение. Iroha 3 Конфигурации, генезис, сценарии, и README:

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

Используйте генерируемый ./localnet/client.toml с CLI:

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