Skip to content

客戶端配置

Iroha CLI 和 SDK 客戶使用 TOML 存儲庫將當前的默認設置發送到 defaults/client.toml; 創建的本地網絡也會寫出匹配 client.toml 在它們的輸出目錄中.

客戶端配置模板
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 終點和簽字帳戶:

toml
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這樣的反向代理後使用時,使用它們.

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

交易設置

交易行爲設置爲 [transaction]部分:

toml
[transaction]
time_to_live_ms = 100000
status_timeout_ms = 15000
nonce = false
  • time_to_live_ms是數毫秒的交易壽命.
  • status_timeout_ms 控制客戶等待交易狀態的時間.
  • nonce = true 要求客戶包含一個非如此重複的交易產生不同的哈希.

連接排列設置

目前的 Iroha 客戶端也可以使用可選的 [connect] 部分進行本地隊列狀態:

toml
[connect]
queue_root = "./queue"

如果工作流需要持久的客戶端排隊存儲時,請使用此方法.

創建配置

對於一次性本地網絡,更喜歡 Kagami 因爲它寫出匹配的 Iroha 3 配置,基因,腳本和 README:

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

使用生成的 ./localnet/client.toml與 CLI:

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