Skip to content

Конфигурация параметрҙары

Төп кимәле

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

Иҫәпкә алынған ышаныслы хеҙмәттәштәре исемлеге

Консенсус валидаторҙары BLS-Нормаль тиҫтер асҡыстарын ҡулланырға тейеш. Һәр валидаторы өсөн шулай уҡ trusted_peers_pop яҙыуын күрһәтергә кәрәк.

Type:

P2P адресы билдәле булғас, PUBLIC_KEY@ADDRESS ҡулланығыҙ; шулай уҡ 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) һәм блок-синхронлаштырыу (блок_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 һуңғы нөктәләре тарафынан ҡабул ителгән сыма заявка корпусында байттарҙың максималь һаны.

Был сикләү 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:

Стринг, бер йәки бер нисә ҡыҫала менән айырылған директиванан тора.Һәр директиваға тейешле максималь вербоситет кимәле булырға мөмкин, был мөмкинлек бирә (мәҫәлән, һайлай) оҙонлоғо һәм ваҡиғалар тап килә. 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 йомшаҡ киҫәк менән идара итеү юлдарын башҡарыу өсөн деbug-тан ғына коммутатор. Уны контроль һынауҙарҙан ситтә эшләтеп ҡалдырығыҙ; уны эшләүсе производство селтәрендә үҙгәртеү үҙ-ара килешеү тәртибе тураһында фекер алышыусанлыҡ тыуҙыра ала.

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

Snapshot системаһының режимы.

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

Телеметрҙа күрһәтелә торған узел исеме.

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"