Skip to content

Конфигурация параметрлері

[toc]

Тамыр деңгейі

chain required

ID тізбегі әрбір транзакцияға енгізілуі тиіс. Қайта ойнау шабуылдарын болдырмау үшін қолданылады.

Қайта ойнату атағы - жарамды транзакцияны басқа желіге жіберу әрекеті. Себебі chain қол қойылған транзакцияның пайдалы жүктемесінің бөлігі болып табылады, бір тізбекке қол қойылған трансакцияны басқа тізбекті пайдаланатын әріптестері бас тартады. ID.

Type: String
Env:CHAIN
toml
chain = "00000000-0000-0000-0000-000000000000"
shell
CHAIN="00000000-0000-0000-0000-000000000000"

public_key required

Консенсус құлақтандырушы жұртшылық кілті BLS-Нормалды кілттерді қолдануы тиіс.

Type: String, public key multihash
Env:PUBLIC_KEY
toml
public_key = "ea01309060D021340617E9554CCBC2CF3CC3DB922A9BA323ABDF7C271FCC6EF69BE7A8DEBCA7D9E96C0F0089ABA22CDAADE4A2"
shell
PUBLIC_KEY="ea01309060D021340617E9554CCBC2CF3CC3DB922A9BA323ABDF7C271FCC6EF69BE7A8DEBCA7D9E96C0F0089ABA22CDAADE4A2"

private_key required

Салыстырманың жеке кілті: ол public_key сәйкес келуі тиіс; келісімді растаушы теңгерімдер BLS-Әдеттегі кілттерді қолдануы керек.

Type:todo private-key
Env:PRIVATE_KEY
toml
private_key = "8926201CA347641228C3B79AA43839DEDC85FA51C0E8B9B6A00F6B0D6B0423E902973F"
shell
PRIVATE_KEY="8926201CA347641228C3B79AA43839DEDC85FA51C0E8B9B6A00F6B0D6B0423E902973F"

trusted_peers

Алдын-ала анықталған сенімді әріптестер тізімі.

Келiсiмдiк бекiтушiлер BLS-Нормалды теңгершiлiк кілттерiн пайдалануы тиiс. Әрбiр бекiтуші үшiн, сондай-ақ сәйкес келетiн trusted_peers_pop жазуын беріңіз.

Type:

Жақсылар жіптерінің қатары. PUBLIC_KEY@ADDRESS адресі белгілі болған кезде P2P қолданыңыз; бос PUBLIC_KEY де қабылданады және жаңсақтар мекенжайы масқарадан анықталады.

Env:TRUSTED_PEERS
toml
trusted_peers = [
    "ea01309060D021340617E9554CCBC2CF3CC3DB922A9BA323ABDF7C271FCC6EF69BE7A8DEBCA7D9E96C0F0089ABA22CDAADE4A2@127.0.0.1:1337",
    "ea0130A7E9D016D723F72942FCF4B988FB599EA0E092F73C8B68E69F4E8B3FE542A3F7E48AD6CD15F3EB484E45F79399071F77@127.0.0.1:1338",
]
shell
# as JSON
TRUSTED_PEERS='[
  "ea01309060D021340617E9554CCBC2CF3CC3DB922A9BA323ABDF7C271FCC6EF69BE7A8DEBCA7D9E96C0F0089ABA22CDAADE4A2@127.0.0.1:1337",
  "ea0130A7E9D016D723F72942FCF4B988FB599EA0E092F73C8B68E69F4E8B3FE542A3F7E48AD6CD15F3EB484E45F79399071F77@127.0.0.1:1338"
]'

trusted_peers_pop

BLS растаушының сенімді әріптестері үшін иелік дәлелдемесі.

Type:

public_key және pop_hex өрістері бар нысандар тізімі

Env:TRUSTED_PEERS_POP
toml
trusted_peers_pop = [
  { public_key = "ea01309060D021340617E9554CCBC2CF3CC3DB922A9BA323ABDF7C271FCC6EF69BE7A8DEBCA7D9E96C0F0089ABA22CDAADE4A2", pop_hex = "8515da750f81182aaba5c22fc9f03a01e81ed85e4495a2ca6b29a71c0c8549537e31e79cddf6ff285b9e22d0d9dc17ce0f46e7d0cf78b2ef9feab50c849a1ea8e1e4f07e966f6113faa8a999317545d9f111b8e08a7273913710b43a20b19c08" },
  { public_key = "ea0130A7E9D016D723F72942FCF4B988FB599EA0E092F73C8B68E69F4E8B3FE542A3F7E48AD6CD15F3EB484E45F79399071F77", pop_hex = "a14eb180f0d78c55d2c034e91ccf691378e9c3ceed8e0b81d3e4b7c215c0dbb633bb9f1c5063911c31af4610016c164015f0f93db3c7df6a2ad0c39338fe7695b976a59fd13797615f229fbd77276a8bb2842e4e44fadcafdb7b37f4a143b913" },
]
shell
# as JSON
TRUSTED_PEERS_POP='[
  {"public_key":"ea01309060D021340617E9554CCBC2CF3CC3DB922A9BA323ABDF7C271FCC6EF69BE7A8DEBCA7D9E96C0F0089ABA22CDAADE4A2","pop_hex":"0x8515da750f81182aaba5c22fc9f03a01e81ed85e4495a2ca6b29a71c0c8549537e31e79cddf6ff285b9e22d0d9dc17ce0f46e7d0cf78b2ef9feab50c849a1ea8e1e4f07e966f6113faa8a999317545d9f111b8e08a7273913710b43a20b19c08"},
  {"public_key":"ea0130A7E9D016D723F72942FCF4B988FB599EA0E092F73C8B68E69F4E8B3FE542A3F7E48AD6CD15F3EB484E45F79399071F77","pop_hex":"0xa14eb180f0d78c55d2c034e91ccf691378e9c3ceed8e0b81d3e4b7c215c0dbb633bb9f1c5063911c31af4610016c164015f0f93db3c7df6a2ad0c39338fe7695b976a59fd13797615f229fbd77276a8bb2842e4e44fadcafdb7b37f4a143b913"}
]'

Жаратылыс

genesis.file

kagami genesis sign тудырған қол қойылған генез блогының пайдалы жүктемесіне файл жолы. Жаратылған профильдер әдетте оны Norito .nrt файлы ретінде жазады.

Type: String, file path (relative to the config file or CWD)
Env:GENESIS
toml
[genesis]
file = "./genesis.signed.nrt"
shell
GENESIS="./genesis.signed.nrt"

genesis.public_key required

Жаратылыс кілтінің қоғамдық кілті.

Type: String, public key multihash
Env:GENESIS_PUBLIC_KEY
toml
[genesis]
public_key = "ed01208BA62848CF767D72E7F7F4B9D2D7BA07FEE33760F79ABE5597A51520E292A0CB"
shell
GENESIS_PUBLIC_KEY="ed01208BA62848CF767D72E7F7F4B9D2D7BA07FEE33760F79ABE5597A51520E292A0CB"

Желі

network.address required

Консенсус (sumeragi) және блок синхронизациясы (block_sync) мақсаттары үшін p2p байланыс адресі.

Type: String, socket address (host/IPv4/IPv6 + port)
Env:P2P_ADDRESS
toml
[network]
address = "0.0.0.0:1337"
shell
P2P_ADDRESS=0.0.0.0:1337

network.public_address required

Бір-бірімен байланысқан мекенжай (басқа бір-бірінен көрінетін сыртқы).

Жақсы достармен әңгімелесуге болады, сонда олар басқа достармен сөйлесе алады.

Type: String, socket address (host/IPv4/IPv6 + port)
Env:P2P_PUBLIC_ADDRESS
toml
[network]
public_address = "0.0.0.0:5000"
shell
P2P_PUBLIC_ADDRESS=0.0.0.0:5000

network.block_gossip_size

Бір синхрондық хабарламада жіберілетін блоктардың саны.

Type: Number
Default:4
toml
[network]
block_gossip_size = 256

network.block_gossip_period_ms

Соңғы блок үшін әріптестерге сұраулар арасындағы уақыт аралығы.

Көбірек әңгімелесу синхронлау уақытын қысқартады, бірақ желіге артық жүктеме әкелуі мүмкін.

Type: Number, duration in milliseconds
Default:10_000 (10 seconds)
toml
[network]
block_gossip_period_ms = 1_000

network.transaction_gossip_size

Ақыл-кеңес туралы хабардың ең көп транзакциялары.

Кішкентай өлшемі ұзағырақ уақытқа әкеледі, бірақ егер пакеттерді жоғалту көп болса пайдалы.

Type: Number
Default:500
toml
[network]
transaction_gossip_size = 256

network.transaction_gossip_period_ms

Бір-бірімен қарым-қатынас жасауды күтіп тұрып, әңгімелесу кезеңі.

Көбірек әңгімелесу синхронлау уақытын қысқартады, бірақ желіге артық жүктеме әкелуі мүмкін.

Type: Number, duration in milliseconds
Default:1_000 (1 second)
toml
[network]
transaction_gossip_period_ms = 5_000

network.idle_timeout_ms

Егер теңгерімсіз болса, теңгеріммен байланыс тоқтатылатын уақыт.

Type: Number, duration in milliseconds
Default:300_000 (5 minutes)
toml
[network]
idle_timeout_ms = 300_000

Torii

torii.address required

Torii сервері тыңдауға тиіс және клиент өз өтініштерін қояды.

Type: String, socket address (host/IPv4/IPv6 + port)
Env:API_ADDRESS
toml
[torii]
address = "0.0.0.0:8080"
shell
API_ADDRESS=0.0.0.0:8080

torii.max_content_len

Torii аяқтық нүктелері қабылдаған шикі өтiнiш органындағы байттардың ең көп саны.

Бұл шегі DOS шабуылын болдырмау үшін қолданылады.

Type:

Байт саны (байттер)

Default:

64_000_000 (64 млн. байт)

toml
[torii]
max_content_len = 64_000_000

torii.query_idle_time_ms

Сұрау салуға қол жеткізбеген жағдайда дүкенде болуы мүмкін уақыт.

Type: Number, duration in milliseconds
Default:10_000 (10 seconds)
toml
[torii]
query_idle_time_ms = 10_000

torii.query_store_capacity

Тікелей сұрау салғандардың санының жоғарғы шегі.

Type: Number
Default:128
toml
[torii]
query_store_capacity = 128

torii.query_store_capacity_per_user

Бір пайдаланушы үшін тікелей сұрау салулар санының жоғарғы шегі.

Type: Number
Default:128
toml
[torii]
query_store_capacity_per_user = 128

Ағаш кесуші

logger.level

Жалпы тіркелу сөзбе-сөзділігі (жақсыланған конфигурация үшін logger.filter қараңыз).

Type:

Стринг, мүмкін мәндер:

  • TRACE: Төменгі деңгейдегі операцияларды қоса алғанда, барлық іс-шаралар.
  • DEBUG: Дебог деңгейіндегі хабарламалар, диагностика үшін пайдалы.
  • INFO: Жалпы ақпараттық хабарлар.
  • WARN: Әлеуетті мәселелерді көрсететін ескертулер.
  • ERROR: Әдеттегі жұмыс істеуіне кедергі келтіретін, бірақ жалғастыруға мүмкіндік беретін қателер.

Сіздің пайдалану жағдайыңызға ең қолайлы деңгейді таңдаңыз. Әртүрлі журналды пайдалану деңгейі туралы қосымша мәліметтер үшін Stack Overflow дегенге жүгініңіз.

Default:INFO
Env:LOG_LEVEL
toml
[logger]
level = "INFO"
shell
LOG_LEVEL=INFO

Жүргізу уақытын жаңарту

Бұл параметр Torii операторының аяқтық нүктелері арқылы жұмыс уақытының конфигурациясын жаңартуға жатады.

logger.filter

logger.level қосымшасы бойынша тазартылған журналды сүзгілер. Арнайы мақсат бойынша жазу сөзділігін баптауға мүмкіндік береді.

Type:

Стринг, бiр немесе бiрнеше сызықпен бөлiнген директивтерден тұрады. Әрбiр директиваға сәйкес келген ең жоғары сөздiк деңгейi болуы мүмкiн, ол (мысалы, таңдап алады) соған сәйкестi аралықтар мен оқиғаларға мүмкіндік береді. Iroha кем эксклюзивті деңгейлерді (мысалы, trace немесе info) көбірек эксклюзівті деңгейлерге (мысалы error немесе warn) қарағанда сөзбе-сөзді деп есептейді.

Жоғары деңгейдегі директивалар синтаксисі бірнеше бөлімнен тұрады:

target[span{field=value}]=level

Қосымша мәлімет үшін tracing-subscriber құжаттамасын қараңыз .

Env:LOG_FILTER
toml
[logger]
filter = "iroha_core=debug,iroha_p2p=debug"
shell
LOG_FILTER=iroha_core=debug,iroha_p2p=debug

logger.levelмен үйлестіру

logger.filter logger.levelмен бірге жұмыс істейді және екеуі де бірін-бірі өшіріп тастамайды.

Мысалы, егер logger.level белгіленеді INFO және logger.filter белгіленеді iroha_core=debug, нәтижелі сүзгі жиынтығы: info,iroha_core=debug (мысалы, info барлық модульдер үшін, debug үшін iroha_core).

Жүргізу уақытын жаңарту

Бұл параметр Torii операторының аяқтық нүктелері арқылы жұмыс уақытының конфигурациясын жаңартуға жатады.

logger.format

Журнал форматы.

Type:

Стринг, мүмкін мәндер:

  • full: Әдеттегі форматтаушы. Бұл оқиғаның пішімделген бейнелеуінен бұрын ағымдағы аралық контексті көрсетіле отырып, әрбір оқиға үшін адам оқитын, біржолғы журналды шығарады.
  • compact: Қысқа сызық ұзындығы үшін оңтайландырылған әдеттегі форматтаушының нұсқасы. Назардағы аралық контекстіндегі өрістер форматталған оқиғаның өрістерімен қоса беріледі, ал аралық атаулары көрсетілмейді; сөздік деңгейі бір таңбаға қысқартылады.
  • pretty: Өте әдемі, көп сызықты журналды шығарады, адам оқырмандығы үшін оңтайландырылған. Бұл негізінен жергілікті дамуда және дебэглеуде немесе командалық сызық қолданбаларында пайдалануға арналған. мұнда автоматтандырылған талдау және журналдарды компакт сақтау оқу қабілеті мен көрнекі тартымдылығына қарағанда басымдыққа ие емес.
  • json: Жаңа сызықпен шектелген JSON журналдарды шығарады. Бұл құрылымдалған журналды талдау және қарау құралдары арқылы JSON ретінде тұтыну жүйелерімен өндірістік пайдалануға арналған. JSON шығысы адамның оқуға қабілеттілігі үшін оңтайландырылмайды.

Қосымша мәліметтер мен үлгінің шығыстары үшін tracing-subscriber құжаттамасын қараңыз .

Default:full
Env:LOG_FORMAT
toml
[logger]
format = "json"
shell
LOG_FORMAT=json

Kura

Kura - Iroha тұрақты сақтау қозғалтқышы (шатыр үшін жапон).

kura.blocks_in_memory

Ең көп дегенде N соңғы блоктар жадында сақталады.

Бұрынғы блоктар естуден шығарылады және қажет болған жағдайда дисктен жүктеледі.

Type: Number
Default:1024
Env:KURA_BLOCKS_IN_MEMORY
toml
[kura]
blocks_in_memory = 1024
shell
KURA_BLOCKS_IN_MEMORY=1024

kura.init_mode

Kura бастау режимі

Type:

Стринг, мүмкін мәндер:

  • strict: барлық блоктарды қатаң түрде растау
  • fast: Тек негізгі тексерулер арқылы жылдам бастау
Default:strict
Env:KURA_INIT_MODE
toml
[kura]
init_mode = "fast"
shell
KURA_INIT_MODE=fast

kura.store_dir

Блоктардың сақталған каталогы[^paths] анықталады.

Сондай-ақ, қараңыз: snapshot.store_dir.

Type: String, file path (relative to the config file or CWD)
Default:./storage
Env:KURA_STORE_DIR
toml
[kura]
store_dir = "/path/to/storage"
shell
KURA_STORE_DIR=/path/to/storage

kura.debug.output_new_blocks debug

Консольге жаңа блоктарды басып шығаруға мүмкіндік беретін байрақ.

Type:todo bool
Default:false
Env:KURA_DEBUG_OUTPUT_NEW_BLOCKS
toml
[kura.debug]
output_new_blocks = true
shell
KURA_DEBUG_OUTPUT_NEW_BLOCKS=true

Кезек

queue.capacity

Кезекте тұрған транзакциялардың санының жоғарғы шегі.

Type: Number
Default:65_536
toml
[queue]
capacity = 1_048_576

queue.capacity_per_user

Бір пайдаланушы үшін кезекте тұрған транзакциялардың санының жоғарғы шегі.

Бұл параметрді құю үшін пайдаланыңыз.

Type: Number
Default:65_536
toml
[queue]
capacity_per_user = 1_048_576

queue.transaction_time_to_live_ms

Егер транзакция әлі кезекте тұрса, ол осы уақыттан кейін тоқтатылады.

Type: Number, duration in milliseconds
Default:86_400_000 (24 hours)
toml
[queue]
transaction_time_to_live_ms = 43_200_000

Sumeragi

sumeragi.debug.force_soft_fork debug

Sumeragi жұмсақ бұрышты басқару жолдарын жүзеге асыру үшін дебог-тек коммутатор. Оны бақылаулы сынақтардың сыртында өшіріңіз; оны жұмыс істеп тұрған өндірістік желіде өзгерту әріптестерінің консенсус мінез-құлқы туралы келіспеушілікке әкелуі мүмкін.

Type:todo bool
Default:false
toml
[sumeragi.debug]
force_soft_fork = true

Кескесім

Бұл модуль World State View фотосуреттерін оқу және жазу үшін жауапты.

Снэп-шоттар World State View сериялы бақылау нүктесін сақтайды, сондықтан достар Kura блогының әрбір блогын қайта ойнамай-ақ қайта бастауы мүмкін. Kura тұрақты блок тарихын және қайта ойнау үшін шындық көзі болып қала береді; снэп-шоттар жеделдету жолы болып табылады. Бастау кезінде Iroha слайдтың метамәдени деректерін конфигурацияланған тізбек пен сақталған блоктармен тексеріп, слайдты жүктеуге немесе қайта ойнауға шешім қабылдауға кіріседі.

Кескіндерді өшіру

Егер шұғыл суреттер жүйесінде бірдеңе дұрыс болмаса және сіз бос беттен бастағыңыз келсе (сұғыл Суреттер бойынша), сіз snapshot.store_dir белгілеген каталогты алып тастауыңызға болады.

snapshot.mode

Сnapshot жүйесінің режимі.

Type:

Стринг, мүмкін мәндер:

  • read_write: Iroha слайдтар арқылы келтірілген мерзімге слайдтарды құру snapshot.create_every_ms. Бастау кезінде, Iroha Қолданыстағы шұғыл кескінді (бар болса) оқып, блоктардың сақталуымен өзекті екендігін тексереді.
  • readonly: read_write-ға ұқсас, бірақ Iroha кездейсоқ суреттер туғызбайды.
  • disabled: Iroha жаңа фотосуреттерді пайда етпейді және бастапқыда бар суреттерді оқымайды.
Default:read_write
Env:SNAPSHOT_MODE
toml
[snapshot]
mode = "readonly"
shell
SNAPSHOT_MODE=readonly

snapshot.create_every_ms

Суреттер жиілігі.

Type: Number, duration in milliseconds
Default:600_000 (10 minutes)
toml
[snapshot]
create_every_ms = 60_000

snapshot.store_dir

Кескіндерді сақтау үшін каталог.

Сондай-ақ қараңыз: kura.store_dir

Type: String, file path (relative to the config file or CWD)
Default:./storage/snapshot
Env:SNAPSHOT_STORE_DIR
toml
[snapshot]
store_dir = "/path/to/storage"
shell
SNAPSHOT_STORE_DIR="/path/to/storage"

Телеметрия

Телеметрия теңгерімдік диагностикаларды сыртқы телеметриялық коллекторға экспорттайды. telemetry.name және telemetry.url теңгерімді коллекторға хабарлағанда орнату; телеметрия қолданылмайтын жағдайда бөлімді қалдыру.

name және url жұпталуы тиіс.

Барлық telemetry бөлім ерікті.

telemetry.name

Телеметрияда көрсетiлетiн түйiннің аты.

Type: String
toml
[telemetry]
name = "iroha"

telemetry.url

Телеметрия жинағыштың WebSocket URL

Type: String
toml
[telemetry]
url = "ws://telemetry.example.com/submit"

telemetry.min_retry_period_ms

Қайта қосылудан бұрын күтудің ең аз уақыты.

Type: Number, duration in milliseconds
Default:1_000 (1 second)
toml
[telemetry]
min_retry_period_ms = 5_000

telemetry.max_retry_delay_exponent

Қайта қосылулар арасындағы кешіктіруді арттыру үшін пайдаланылатын 2 максималдық экспоненті.

Type: Number
Default:4
toml
[telemetry]
max_retry_delay_exponent = 4

dev_telemetry.out_file

Деве-телеметрияны жазудың файл жолы

Type: String, file path (relative to the config file or CWD)
toml
[dev_telemetry]
out_file = "/path/to/file.json"