Iroha 3 аша хәрәкәт итеү CLI

iroha бинар - Iroha 3 өсөн команда һыҙығы клиенты. Уны иҫәп-хисап ҡаҙнаһының торошон һорарға, транзакциялар тапшырырға һәм операторҙың һуңғы нөктәләрен тикшереүгә ҡулланығыҙ.

1. Кәрәкле шарттар

Иң тәүҙә урындағы селтәрҙе ҡуҙғатыу:

• Пуск Iroha 3

Launch Iroha 3 локаль селтәрҙән барлыҡҡа килгән клиент конфигурацияһын түбәндәге миҫалдар ҡабул итә:

./localnet/client.toml

2. Башлыса CLI ҡоролмаһы

Иң юғары кимәлдәге ярҙам күрһәтегеҙ:

cargo run --bin iroha -- --config ./localnet/client.toml --help

CLI түбәндәге юғары кимәлдәге команда төркөмдәренә бүленгән:

• account иҫәпкә йүнәлтелгән ҡыҫҡа юлдар өсөн
• tx транзакция кимәлендәге ярҙамсылар өсөн
• ledger иҫәп-хисап өсөн уҡый һәм яҙа
• ops оператор диагностикаһы өсөн
• app ҡушымта ярҙамсылары өсөн API
• contract контрактты файҙаланыу һәм саҡырыуҙар өсөн
• tools диагностика һәм үҫеш өсөн коммуналь хеҙмәттәр өсөн
• taira өсөн Taira һәм Nexus- йүнәлешле эш ағымдары

ledger төркөмөндә шулай уҡ ledger transaction кеүек доменға ҡағылышлы операцияларҙа ярҙамсылары бар.

Кеше уҡый торған оператор сығыуы өсөн --output-format text һәм ҡәтғи автоматлаштырыу режимы өсөн --machine ҡулланыу.

3. асыҡтан-асыҡ Taira тест селтәрен һынағыҙ

Һеҙ уҡырға ғына тырыша ала Taira локаль тиҫтерҙе эшләткәнгә йәки ҡултамға яһағанға тиклем тикшерә. Был командалар асыҡ ҡулланыла Torii JSON маршруттар һәм ҡулланыу testnet түгел XOR.

Taira һаулығын тикшерегеҙ:

curl -fsS https://taira.sora.org/status \
  | jq '{blocks, txs_approved, txs_rejected, queue_size, peers}'

universal мәғлүмәт киңлегендә асыҡ домендар исемлеген яҙығыҙ:

curl -fsS 'https://taira.sora.org/v1/domains?limit=10' \
  | jq -r '.items[].id'

Бер нисә актив билдәләмәһен һәм уларҙың хәҙерге ҡиммәтлеген әйтеп бирегеҙ:

curl -fsS 'https://taira.sora.org/v1/assets/definitions?limit=10' \
  | jq -r '.items[] | [.id, .name, .mintable, .total_quantity] | @tsv'

Әгәр һеҙҙә хәҙерге iroha бинарлы булһа, Taira диагностика ярҙамсыһын эшләтегеҙ:

iroha taira doctor --public-root https://taira.sora.org --json

Төҙөү taira.client.toml тик ҡул ҡуйылған бойороҡтарҙы һынарға әҙер булғанда ғына. Ҡатнашыу SORA Nexus Мәғлүмәт базалары конфигурация, кран һәм канарий ағымы өсөн. Taira Аҡсаны банкоматҡа түләү иҫәбенә түләгәнгә тиклем.

Һәр түләүле Taira CLI миҫал өсөн, кран ярҙамсыһын һаҡлағыҙ Testnet XOR алыу Taira буйынса taira_faucet_claim.py, һуңынан тәүҙә testnet XOR талап итегеҙ:

export TAIRA_ACCOUNT_ID='<TAIRA_I105_ACCOUNT_ID>'
export TAIRA_FEE_ASSET=6TEAJqbb8oEPmLncoNiMRbLEK6tw

curl -fsS https://taira.sora.org/v1/accounts/faucet/puzzle | jq .
python3 taira_faucet_claim.py "$TAIRA_ACCOUNT_ID"

iroha --config ./taira.client.toml ledger asset get \
  --definition "$TAIRA_FEE_ASSET" \
  --account "$TAIRA_ACCOUNT_ID"

Әгәр кран табышы йәки талап маршруты 502 кире ҡайтарһа, көт һәм тағы ла тырышығыҙ. Был асыҡ тест селтәрҙәре менән тәьмин итеү мәсьәләһе, иҫәбенә асҡыстарҙы тергеҙеү өсөн сигнал түгел.

Баланс күренеп бөткәндән һуң, түләү активтары метамәғлүмәтенә ҡушымта яҙыу:

printf '{"gas_asset_id":"%s"}\n' "$TAIRA_FEE_ASSET" > taira.tx-metadata.json

iroha --config ./taira.client.toml \
  --metadata ./taira.tx-metadata.json \
  ledger transaction ping --msg "hello from faucet-funded taira"

4. Башланғыс иҫәп яҙма командалары

Бөтә домендар исемлеге:

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

ғәҙәти домен булдырыу декларатив псевдоним планер ҡуллана; ledger domain командование юҡ register Подкомандующий, йәшеренһеҙ әҙерләнегеҙ. AliasSetupPlanRequestV1 маҡсаты өсөн docs.universal һеҙҙең менән SDK йәки инеү сервисы, һуңынан уны планлаштырып һәм ҡулланыу:

cargo run --bin iroha -- --config ./localnet/client.toml \
  app alias setup plan \
  --intent-file ./docs-domain.intent.json \
  --plan-file ./docs-domain.plan.json

cargo run --bin iroha -- --config ./localnet/client.toml \
  app alias setup apply --plan-file ./docs-domain.plan.json

Маҡсат пинг мәғлүмәт киңлеге ID, каноник хужаһы иҫәбенә, ҡуртым срогы һәм ағымдағы цитата һаҡлау. планер тере торошон раҫлай һәм тапшырыу өсөн теүәл атом EnsureAlias планын ҡайтара. башҡа селтәрҙән һаҡланыу ҡиммәттәрен ҡулдан күсермәгеҙ.

Ябай Пинг транзакцияһын ебәр:

cargo run --bin iroha -- --config ./localnet/client.toml ledger transaction ping --msg "hello from iroha"

Һуңғы блокты уҡығыҙ йәки блок ваҡиғаларына яҙылығыҙ:

cargo run --bin iroha -- --config ./localnet/client.toml ledger blocks 1 --timeout 30s
cargo run --bin iroha -- --config ./localnet/client.toml ledger events block

5. Операторҙар командаһы

Консенсус торошо:

cargo run --bin iroha -- --config ./localnet/client.toml --output-format text ops sumeragi status

Ваҡыт-ваҡыт задержкаһы:

cargo run --bin iroha -- --config ./localnet/client.toml --output-format text ops sumeragi phases

Ҡулланыу мөмкинлеге, коллектор, RBC запас һәм VRF миҫалдары:

cargo run --bin iroha -- --config ./localnet/client.toml --output-format text ops sumeragi telemetry

Сылбырҙағы консенсус параметрҙары:

cargo run --bin iroha -- --config ./localnet/client.toml ops sumeragi params

6. Артабан ҡайҙа барырға?

• SDK дәреслектәр
• Torii сикләү пункттары
• Iroha бинарҙар менән эшләү
• CLI README

Барлыҡ Markeddown ярҙам фотоһүрәттәрен ҡайтарыу өсөн сығанаҡ иҫәбенә инеү, эшләй:

cargo run -p iroha_cli --bin iroha -- tools markdown-help > crates/iroha_cli/CommandLineHelp.md