მომხმარებლის კონფიგურაცია

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