クライアントの設定

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の署名取引.

口座は既に存在しているはずデフォルトローカルネットワークでは,この処理はbundled genesis manifestによって行われます.

ケース敏感性

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