通過 CLI 運行 Iroha 3
iroha二進制是 Iroha 3 的命令行客戶端. 使用它查詢賬本狀態,提交交易和檢查操作員終點.
1.先決條件
首先啓動一個本地網絡:
在 啓動 Iroha 3中創建的本地網絡中生成的客戶端配置:
./localnet/client.toml2. 基本的 CLI 設置
展示最高水平的幫助:
cargo run --bin iroha -- --config ./localnet/client.toml --helpCLI 分爲以下最高級別指揮組:
account針對賬戶指導的快捷方式tx對於交易級助理ledger用於賬本閱讀和寫作ops用於操作員診斷app用於應用程序的 API 助手contract關於合同部署和調用tools用於診斷和開發者公用事業taira對於 Taira 和 Nexus- 工作流程
ledger集團還包含特定領域的交易助理,如ledger transaction.
使用 --output-format text用於人可讀操作員輸出和 --machine用於嚴格的自動化模式.
3. 嘗試公共測試網 Taira
在運行本地同行或創建簽名器之前,您可以嘗試僅閱讀的 Taira 檢查.這些命令使用公共的 Torii JSON 路線,並且不使用測試網 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 例如,拯救水龍頭輔助器 獲取測試網 XOR 在 Taira 作爲 taira_faucet_claim.py, 然後索賠測試網 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計劃.不要手動複製其他網絡的保護值.
發送一個簡單的ping交易:
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 block5. 操作員指揮
意見共識狀態:
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 params6. 接下來要去哪裏
爲了從源檢查中恢復一個完整的Markdown幫助快照,運行:
cargo run -p iroha_cli --bin iroha -- tools markdown-help > crates/iroha_cli/CommandLineHelp.md