Torii Хөгжлийн түвшин
Torii Энэ бол HTTP, SSE, болон WebSocket нэвтрүүлэг Iroha 3. Энэ нь аль алинд нь номын сан руу чиглэсэн APIs болон операторын төгсгөлийн цэгүүд.
Одоогийн протоколын дүрэм нь:
- Каноникийн бинар хэлбэр нь Norito
- олон төгсгөл нь ч дэмждэг JSON та илгээх үед
Accept: application/json - метрик нь Prometheus хэлбэрээр илрүүлэгдсэн
Форматын дэлгэрэнгүй мэдээллийг, агуулгын хэлэлцээр, зохион байгуулалтын тэмдэг, схемын хэшиг, Norito RPC заавар, үзнэ үү Norito дуудлага.
Нэгдсэн төгсгөл
| Эцэст нь . | Формат | Зорилго |
|---|---|---|
POST /transaction | Norito | Гарын үсэг зурсан гүйлгээг хүргүүлнэ |
POST /query | Norito | Гарын үсэг зурсан асуултыг хүргүүлнэ |
GET /events | WebSocket | Үйл ажиллагааны урсгалыг бүртгэнэ |
GET /block/stream | WebSocket | Захиргааны үүрэг гүйцэтгэгч блок |
GET /peers | JSON | Torii дэргэдэх ижил хүйсийн жагсаалт |
GET /health | JSON | Өргөн амьжиргааны төгсгөл . |
GET /api_version | JSON | Үндсэн API хувилбар |
GET /status | JSON | Үйл ажиллагаа эрхлэгчдийн өндөр түвшний нөхцөл байдлын товч танилцуулга |
GET /metrics | Прометей | Prometheus харааны төгсгөл . |
GET /schema | JSON | Мэдээллийн загварын схэмийн хүйцэтгэл . |
GET /openapi эсвэл GET /openapi.json | JSON | OpenAPI баримт бичиг идэвхтэй Torii HTTP замын хувьд |
GET /v1/parameters | JSON | Хадгарын параметр хувилбар |
GET /v1/node/capabilities | JSON | Нот-ын хүчин чадал, мэдээллийн загварын метабараа |
GET /v1/api/versions | JSON | Torii API хувилбарыг дэмжиж байна |
GET /v1/events/sse | SSE | Олон жил ажилласан үйлчлүүлэгчдэд зориулсан арга хэмжээний урсгал |
GET /v1/time/now | JSON | Хүрэлтийн сүлжээний цагийн зураг |
GET /v1/time/status | JSON | Цаг хугацааны синхрончлалын байдал |
/openapi Энэ нь гүйлгээний түймрийн бүрэн төгсгөлийн жагсаалт юм. Тухайн дагуул нь бүтээн байгуулалтын хувилбар болон гүйлгээний configuring, тул үүсгэсэн үйлчлүүлэгчид амьд OpenAPI Хөлийн жагсаалтын гарын үсэг зурсан баримт бичиг. Torii API консоль Энэ амьд баримтыг борлуулахын тулд шалгалт JSON зам, хувилбар curl хүсэлтүүд, өнөөгийн схемаас үйлчлүүлэгчний код бий болгох.
Амьдрал Taira замыг туршиж үзээрэй
Олон нийтийн Taira туршилтын сүлжээ нь зөвхөн уншдаг хайгуулын тулд хэрэглэлийн үйлчлүүлэгчид ашиглаж буй ижил Torii JSON гадаргыг илрүүлж байна. Эдгээр захирамжийн хувьд түлхүүр шаардлагагүй:
TAIRA_ROOT=https://taira.sora.org
curl -fsS "$TAIRA_ROOT/status" \
| jq '{blocks, txs_approved, txs_rejected, queue_size, peers}'
curl -fsS "$TAIRA_ROOT/openapi.json" \
| jq -r '.paths | keys[]' \
| grep '^/v1/' \
| head -n 20
curl -fsS "$TAIRA_ROOT/v1/node/capabilities" \
| jq '{abi_version, data_model_version, query: .query.aggregate.supported_resources}'Дэлхийн өнөөгийн байдалтай харьцуулахад ресурс уншдаг:
curl -fsS "$TAIRA_ROOT/v1/domains?limit=5" \
| jq -r '.items[].id'
curl -fsS "$TAIRA_ROOT/v1/assets/definitions?limit=5" \
| jq -r '.items[] | [.id, .name, .total_quantity] | @tsv'Хэрэв олон нийтийн тестний замаар 502, цаг хугацааг дуусгах, эсвэл дүүрэн шугам мэдээлэх бол эцсийн цэглэлийн хүртээмжтэй асуудлаар авч үзээрэй, дараа нь үйлчлүүлэгчдийн кодгоо засварлах өмнө дахин туршиж үзээрэй.
Үндсэн санал нэгдмэл болон гүйлтийн цаг хугацааны төгсгөл
| Эцэст нь . | Формат | Зорилго |
|---|---|---|
GET /v1/sumeragi/commit-certificates | JSON | Сүүлийн үеийн үүрэг гүйцэтгэх гэрчилгээний товч танилцуулга |
GET /v1/sumeragi/validator-sets | JSON | Үнэлгээгчийн түүхийг байгуулсан |
GET /v1/sumeragi/validator-sets/{height} | JSON | Блок өндөрт тохируулж байна. |
GET /v1/sumeragi/status | Norito эсвэл JSON | Тус зөвшилцлийн нөхцөл байдлын дэлгэрэнгүй илрүүлэл |
GET /v1/sumeragi/status/sse | SSE | Үргэлж буй санал нэгдлийн байдлын урсгал |
GET /v1/sumeragi/leader | JSON | Одоогийн удирдагчийн мэдээлэл |
GET /v1/sumeragi/qc | Norito эсвэл JSON | Хамгийн сүүлийн үеийн кворум-сертификатын дүгнэлт |
GET /v1/sumeragi/checkpoints | JSON | Үндсэн ойлголцлын хяналтын цэгүүдийн товчлолт |
GET /v1/sumeragi/consensus-keys | JSON | Ажилтай тохиролцооны товч . |
GET /v1/sumeragi/bls_keys | JSON | Актив BLS тохиролцооны товчоо |
GET /v1/sumeragi/phases | JSON | Хамгийн сүүлийн үеийн үе шатны хориотой байдлын үзлэг |
GET /v1/sumeragi/rbc | JSON | RBC хуралдаан болон дамжуулалт үзүүлэлтүүд |
GET /v1/sumeragi/rbc/sessions | JSON | Ажилтай RBC хуралдааны хүйтэн зураг |
GET /v1/sumeragi/pacemaker | JSON | Хөрөгдөлний хөдөлгөөн үзүүлэгчийн байдал |
GET /v1/sumeragi/params | JSON | Цахилгаан зах зээлийн одоогийн Sumeragi параметри |
GET /v1/sumeragi/collectors | JSON | Дэтерминист цуглуулчийн төлөвлөгөөний хүйтэн зураг |
GET /v1/sumeragi/key-lifecycle | JSON | Эрдэм шинжилгээний гол амьдралын мөрийн байдал |
GET /v1/sumeragi/telemetry | JSON | Консенсусын телеметрийн хүйцэтгэл |
GET /v1/sumeragi/evidence | JSON | Дашрамд дурдах баримтын бүртгэл, сонгон шалгаруулалтаар хайлтын шугамгаар филтрлэгдсэн |
GET /v1/sumeragi/evidence/count | JSON | Гэрэл баримтын тоо |
POST /v1/sumeragi/evidence/submit | JSON | Үндсэн ойлголцлын баримт бичгийг хүргүүлнэ |
GET /v1/sumeragi/commit_qc/{hash} | Norito эсвэл JSON | Блок хэшийн QC бүртгүүлэх үүрэг гүйцэтгэх |
GET /v1/runtime/abi/active | JSON | Хөдөлмөрийн гүйцэтгэх хугацаа ABI тодорхойлогч |
GET /v1/runtime/abi/hash | JSON | Үйл ажиллагааны цаг хугацаа ABI хаш |
GET /v1/runtime/metrics | JSON | Хөдөлмөрийн цагийн үзүүлэлтийн товчлогын зураг |
GET /v1/runtime/upgrades | JSON | Хөдөлмөрийн цагийн шинэчлэл жагсаалт |
POST /v1/runtime/upgrades/propose | JSON | Хөдөлмөрийн цаг хугацааг шинэчлэн боловсруулахыг санал болгож байна. |
POST /v1/runtime/upgrades/activate/{id} | JSON | Үйл ажиллагааны цаг хугацааг шинэчлэх саналыг идэвхжүүлнэ |
POST /v1/runtime/upgrades/cancel/{id} | JSON | Хөдөлмөрийн цагийн шинэчлэлийг хүчингүй болгох |
App болон SORA замын гэр бүл
Torii нь аппликейшнээр чиглэсэн функцийн багцтай баригдсанаар хайгуулагч, SORA үйлчилгээ, гүүр урсгал, баталгаажуулалт, хадгаламжлалтын нэмэлт JSON гэр бүлүүдийг илрүүлнэ. Эдгээр гэр бүлүүд нь бүх сүлжээний профил дээр хүчинтэй байдаггүй юм.
| Замын гэр бүл | Зорилго |
|---|---|
/v1/accounts/*, /v1/domains/*, /v1/assets/* | JSON уншигч, хайлтын туслах, борлуулалтын туслах, портфель эсвэл эзэмшигчийн үзлэг |
/v1/nfts/*, /v1/rwas/*, /v1/confidential/* | NFT, бодит хөрөнгийн болон нууц хөрөнгийн үзлэг |
/v1/aliases/*, /v1/assets/aliases/*, /v1/sns/*, /v1/identifiers/* | Нэр, нууц нэр, тодруулгын тодорхойлолт |
/v1/explorer/* | Эксплорын чиглэлээр бүртгэл, актив, блок, гүйлгээ, заавар, метрик, урсгалын үзлэг |
/v1/transactions/*, /v1/pipeline/*, /v1/iso20022/* | Транзакцын түүх, галт тэрэгний нөхөн сэргээлтийн байдал болон ISO 20022 туслах |
/v1/contracts/* | Гэрээний код, нэвтрүүлэг, бандл, дуудлага, үзэл баримт, үйл явдал, үйл ажиллагаа, Rollup болон улсын замыг |
/v1/multisig/*, /v1/controls/* | Олон нийтийн санал, зөвшөөрөл болон шилжүүлэн суулгах хяналтын туслах |
/v1/bridge/*, /v1/ledger/*, /v1/proofs/* | Эцсийн хугацаа, мэдүүлэг батлах, блок батлах, баталгаа хадгалах, батлах асуултын замаар . |
/v1/da/* | Мэдээллийн хүртээмж, манфист, баталгааны бодлого, үүрэг гүйцэтгэл, нэрийн санаачлал |
/v1/zk/* | ZK суурь, нотлох баримтын баталгаажуулалт, IVM нотолгоо, сонгон шалгаруулалтын тооллолт, санхүүжилтийн түлхүүр, нотолгооны тэмдэглэл, хавсралт |
/v1/gov/*, /v1/ministry/* | Засаг захиргааны саналууд, санал хураалт, зөвлөлийн засаглал, хамгаалалттай нэр дэвшилтүүд, мөрийн хөтөлбөрийн саналуудыг батлах, эцэслэн боловсруулах . |
/v1/nexus/*, /v1/sccp/* | Nexus замын, өгөгдлийн орон зай, хяналтын сүлжээний батлан хамгаалах туслагчдыг |
/v1/musubi/* | Musubi багц бүртгэлийн уншигч, зааварч |
/v1/subscriptions/* | Ашиглалын төлөвлөгөө, ашиглалтын амьдралын мөчлөг, хэрэглээ, зардлыг төлөх туслах |
/v1/sorafs/*, /sorafs/*, /.well-known/sorafs/* | SoraFS нийлүүлэгч илрүүлэх, хүчин чадалны баталгаажуулах, хатуулах, хадгаламж авах, олон нийтийн агуулгын үйлчилгээ . |
/v1/soracloud/*, /v1/soradns/*, /soradns/*, /api/* | SoraCloud үйлчилгээний амьдралын мөчлөг, хувийн тооцоо / загварын урсгал, олон нийтийн илрүүлэлт, хостын аппликейшнүүдийн чиглэлд . |
/v1/connect/*, /v1/vpn/* | Iroha Холбоо хуралдаан, WebSocket тээврийн, VPN хуралдаанууд, профилүүд, хүлээн зөвшөөрөгддөг |
/v1/app-api/*, /v1/api/*, /v1/content/* | App API -ийн холболт, бандл/CID-ийн дэмжлэгтэй агуулгын чиглэлд . |
/v1/operator/*, /v1/mcp | Үйлчлүүлэгчний баталгаажуулалт, MCP JSON-RPC үндэсний гүүр |
/v1/offline/*, /v1/repo/*, /v1/space-directory/*, /v1/ram-lfe/* | Онлайн бэлэн байдал, хадгаламжийн гэрээ, өгөгдлийн орон тооны манфистүүд, RAM-LFE туслах нар |
/v1/kaigi/*, /v1/webhooks/*, /v1/notify/*, /v1/telemetry/* | Хамтын ажиллагаа, webhook, push мэдэгдэл, амьд телеметрийн интеграц |
ISO 20022 гүүр
Torii нь ISO 20022 гүүрг /v1/iso20022/* -ийн дүнд байрлуулж байгаа бол аппликейшнээр чиглэсэн API болон гүүрний гүйлгээний цаг хугацаа идэвхтэй байдаг. Энэ нь ерөнхий зориулалттай ISO 20022 хийнэлийн хаалга биш, сонгогдсон төлбөрийн мэдээллийг Iroha гарын үсэг зурсан шилжүүлэн суулгах болон тэдгээрийн томоохон номын жагсаалтын байдлыг дагаж мөрдөнө гэсэн дэмжлэгтэй дэд баг юм.
Torii ISO 20022 Хөгжлийн бодлого
| Хэрэглээ, төгсгөл нь | Зорилго |
|---|---|
POST /v1/iso20022/pacs008 | FI-ээс FI үйлчлүүлэгчдэд зориулсан кредит шилжүүлэн суулгах, нийцсэн Iroha хөрөнгийн шилжүүлэлтийг бүтээн байгуулах |
POST /v1/iso20022/pacs009 | FI-ээс FI-д PvP эсвэл үнэт цаастай холбоотой бэлэн мөнгөний санхүүжилтийн зориулалттай кредит шилжүүлэн суулгана |
POST /v1/iso20022/pacs002 | Төлбөрийн байдлын тайлан хүргүүлнэ |
POST /v1/iso20022/pacs004 | Хөдөлмөрийн төлбөрийг буцааж өгөх |
POST /v1/iso20022/camt056 | Төлбөрийг цуцлах хүсэлтийг өргөн мэдүүлэх |
POST /v1/iso20022/sese023 | Үнэт цаасны зохицуулалтын чиглэлийг хүргүүлнэ |
POST /v1/iso20022/sese024 | Үнэт цаасны зохицуулалтын төлөв байдлын мэдээллийг хүргүүлнэ |
POST /v1/iso20022/sese025 | Үнэт цаасны зохицуулалтын батламжийг хүргүүлнэ |
POST /v1/iso20022/colr012 | Гаалийн орлогын мэдээллийг хүргүүлнэ |
GET /v1/iso20022/messages/{msg_id} | Нэг илтгэлийг хүлээн авахын тулд Каноникийн гүүрний бичгийг уншина уу |
GET /v1/iso20022/audit/messages | Хэлэлцээрийн хяналтын мэдээллийг уншина уу |
GET /v1/iso20022/messages/{msg_id}/pacs002 | Одоогийн төлбөрийн байдал pacs.002 XML гэж өгөөч. |
GET /v1/iso20022/messages/{msg_id}/pacs004 | Одоогийн төлбөрийн тайланг pacs.004 XML гэж өгөх. |
GET /v1/iso20022/messages/{msg_id}/camt029 | Одоогийн цуцлах тогтоолыг camt.029 XML гэж өгөөч. |
GET /v1/iso20022/messages/{msg_id}/sese024 | Одоогийн тооцооны байдлыг sese.024 XML гэж өгөөч. |
GET /v1/iso20022/messages/{msg_id}/sese025 | Одоогийн тооцооны баталгааг sese.025 XML гэж өгөх. |
pacs.008 өргөн мэдүүлэгт ID, банк хоорондын зохицуулалтын хэмжээ, валют, зохицуулын өдөр, өрийн болон итгэмжлэгчийн IBANs болон өрийн болон батлан өгөгдлийн BICs мэдээллийг хүргэж байна. Сэргээлийн өгөгдлийг конфигуруулбал, шугам нь үүсгэсэн гүйлгээний урсгалд орж ирэхээс өмнө BIC, IBAN болон ISO 4217 валютын хилжилтийг шалгаж байна.
pacs.009 өргөн мэдүүлэгт бизнесийн мэдэгдэл ID, мэдээллийн тодорхойлолт ID, бүтээлийн цаг хугацаа, банк хоорондын зохицуулалтын хэмжээ, валют, зохицуулын өдрийг тусгаж өгөх ёстой. BICs захиалгын агент, захиалгын төлөөлөгч, өрийн халдагч болон итгэмжлэгчийн төлөөлөл IBANs. Мэдээлэлд Purp ордог бол цахилгаан нь одоогоор зөвхөн үнэт цаасны зориулалттай санхүүжилтийг хүлээн зөвшөөрдөг: Purp=SECU.
pacs.008 болон pacs.009 өргөн мэдүүлгийн төгсгөлийн цэгүүд нь XML ISO загварыг хүлээн зөвшөөрч, эсвэл гүүрний туршилт хийхэд хэрэглэгддэг тайван талбайн хэлбэрээр ашиглана. сонголттой SplmtryData талбай нь зорилтын Iroha номын санг татаж болно. эх үүсвэр, зорилтот данс IDs эсвэл хаяг, хөрөнгийн тодорхойлолт ID. Хариулт нь 202 Accepted буюу message_id, transaction_hash, status, pacs002_code болон шийдвэрлэсэн томоохон бүртгэл/хувь сан/гөвийн хүрээнд байна.
Үндэсний шинжилгээ, газрын зурагчлалын дэмжлэг
IVM ISO туслах нь дараах мэдээний гэр бүлүүдийг мөн хуримтлагыг баталгаажуулах, орлогын газрын зураг хийх эсвэл урсгалын доод замаар зохицуулахад баталгаажуулдаг бөгөөд тэдгээр нь бие даасан Torii замгүй.
| Мэдээллийн гэр бүл | Одоогийн дэмжлэг |
|---|---|
head.001 | BizMsgIdr, MsgDefIdr, бүтээлийн цаг болон сонголттой илгээгч/ хүлээн авагч BIC талбайдыг хамруулсан ISO конвертийн бизнес аппликацын цэглэмийн баталгаажуулалт. |
pacs.007, pacs.028, pacs.029 | Хөдөлмөрийн төлбөрийг буулгасан, статусын хүсэлт гаргасан, шалгалтын шийдвэрлэлээ / статусын шинжилгээ хийсэн |
pain.001, pain.002 | Хэрэглэгчийн төлбөрийг эхлүүлэх болон төлбөрийн байдлын тайланг баталгаажуулах |
camt.052, camt.053, camt.054 | Нягтлан бодох бүртгэл, мэдүүлэг, мэдэгдэл батлах |
Kaigi Уулзалтууд
Kaigi нь төлбөртэй, бодит цаг хугацааны аудио / видео өрөөнүүдийг SORA Nexus дээр хангадаг. Хэрэглэгт хэрэглээний бүртгэлээр дэмжлэг үзүүлэх сессийг бий болгох, жагсаалтыг өөрчлөх, ээлжит манифестүүд, шифрлэсэн сигнал өгөх, ашиглалтын хэмжилтийг хийх оронд бүх зөвлөлдөх хэсгийг гараагүй байлгахад ашиглаарай.
Тогтлан бодох бүртгэлийн амьдралын мөчлөг нь:
CreateKaigi: доменийн хүрээнд дуудлагыг бий болгож, түүний бодлого, хуваарийн хугацаа, метабараа болон сонголттой ээлжит манифст хадгалах.JoinKaigiболонLeaveKaigi: дуудлагын жагсаалтыг шинэчлэн найруулж байна. Хувийн хэвээр оролцогчид оролцогчдын бүртгэл IDs-ийг шууд илрүүлэхийн оронд үүрэг гүйцэтгэх, хүчингүй болгох, жагсаалтын баталгааг ашиглана.RecordKaigiUsage: хэмжигдсэн хугацаа, газын нийт хэмжээг нэмнэ.EndKaigi: чуулганыг дуусгаж, эцсийн цаг мөрийг бүртгэж байна.
Torii цахилгаан дамжуулагчдын телеметрийг /v1/kaigi/relays, /v1/kaigi/relays/{relay_id}, /v1/kaigi/relays/health, болон /v1/kaigi/relays/events хэрэгсэл API Уулзалтын нөхцөл байдал нь Kaigi Тухайлбал, KaigiRosterSummary, KaigiRelayManifestUpdated, KaigiRelayHealthUpdated, болон KaigiUsageSummary.
CLI Дамхины шинжилгээ
Үүнээс эхлээд iroha kaigi CLI хэрэв та Torii төгсгөл нь хүлээн зөвшөөрдөг Kaigi бүтээн байгуулалтын өмнө UI. Удахгүй эхлэх команд нь идэвхтэй эсэргүүцлийн түр байранд ордог Torii төгсгөлийн цэг, дуудлагын тодруулгын товчлогыг хэвлэж, командлагыг нэгтгэх; ба SoraNet дугуйны илтгэл:
iroha kaigi quickstart --auto-join-host --summary-out kaigi-summary.jsonСкриптийн урсгалын хувьд өрөөний амьдралын мөрийг тодорхой удирдаж үзээрэй:
iroha kaigi create \
--domain streaming \
--call-name daily \
--host <i105-account-id> \
--privacy-mode transparent \
--room-policy authenticated
iroha kaigi join --domain streaming --call-name daily --participant <i105-account-id>
iroha kaigi leave --domain streaming --call-name daily --participant <i105-account-id>
iroha kaigi record-usage \
--domain streaming \
--call-name daily \
--duration-ms 120000 \
--billed-gas 1500
iroha kaigi end --domain streaming --call-name dailyХэрэглээ --room-policy public үзэгчдийн төлбөргүйгээр дамжуулах боломжтой өрөөнүүдийн хувьд, эсвэл --room-policy authenticated нэвтрүүлэгчид үзэгчний баталгаажуулалтыг шаардагдах тохиолдолд --privacy-mode zk-roster-v1 зөвхөн сүлжээ нь Kaigi жагсаалт, хэрэглээний баталгаажуулах түлхүүр тохируулсан; өөрөөр хэлбэл холболт, хуудас, болон хувийн хэрэглээний бүртгэл нь тодорхойлолтын шалгалтаар алдаатай байна.
JavaScript дэммоор шинжилгээ хийх
soramitsu/iroha-demo-javascript ширээний дэмог төгсгөл ба түлхүүр гарцааны туршилт хийхэд ашигла. Демо нь цахилгаан болон Vue аппликейшн юм бөгөөд орон нутгийн @iroha/iroha-js холбоос дамжуулан шууд Torii -д ярилцаж, браузерт үүссэн нэгээс нэг хэвлэл мэдээллийн хэрэгслийн /kaigi замыг багтаадаг.
Demo-ийг ашигла @iroha/iroha-js УИХ-ын Iroha Эх сурвалжийн агууламж. SDK дамжуулан file:../iroha/javascript/iroha_js, Тиймээс хоёр төлбөрийг энэ ах дүүгийн зураг төхөөрөмжээр хадгалах:
mkdir iroha-wallet-workspace
cd iroha-wallet-workspace
git clone https://github.com/hyperledger-iroha/iroha.git
git clone https://github.com/soramitsu/iroha-demo-javascript.git
cd iroha/javascript/iroha_js
npm install
npm run build:native
npm run build:dist
cd ../../../iroha-demo-javascript
npm install
npm run devХэрэглээ Node.js 20 болон шинэ, Rust тоног төхөөрөмжийн сүлжээний тул эх орон iroha_js_host Модулын бүтээн байгуулалт хийж болно. SDK ах дүүгийн хувьд Iroha эх үүсвэрийг өөрчлөсний дараа төлөх; цэвэр багцын зураг төсөл нь npm run build:native.
Хяналтын шинжилгээний хувьд Kaigi -ийн чадвартай Torii төгсгөлийн цэг дээр дэмо үзүүлэлтийг зааж өгөх:
SORA/Kaigi хэрэглээнд чиглэсэн APIs нэгийг ашиглаж Iroha түймрийг эхлүүлж, эсвэл танд хэрэгтэй Kaigi гадаргуудыг илрүүлэх олон нийтийн төгсгөлийг ашигла.
Үндэсний хүртээмжтэй байдлыг шалгах
/health, Дараа нь амьд замын давхаргыг шалгах/openapiэсвэл/openapi.json. Зарим нэвтрүүлэгүүд нь бас илрүүлэх/v1/health, Гэхдээ/healthЭнэ бол гар утасны амьжиргааны шалгалт юм.Үүнд TAIRA, шууд уулзалт хийхээс өмнө ээлжит телеметрийн замыг шалгах:
bashTAIRA=https://taira.sora.org curl -fsS "$TAIRA/health" curl -fsS "$TAIRA/v1/kaigi/relays" curl -fsS "$TAIRA/v1/kaigi/relays/health"
Эдгээр шалгалтууд нь Torii болон Kaigi ээлжит телеметрийн хүрэлцээг баталгаажуулдаг. Тэд уулзалт үүсгэдэггүй; CreateKaigi ба JoinKaigi-д аливаа санхүүжилттэй мөнгөний ханш, гарын үсэг зурсан гүйлгээ өргөн мэдүүлэг шаардлагатай байна. 4. Демо дэлгэцээ нээх, Тансагварын хэсгээр зайлах, Torii URL-ийг байгуулж, хэрэгслийн ID зангилаа болон сүлжээний префиксийг эцсийн цэгээс ачаалан гаргана. 5. Дэммо дээр хоёр орон нутгийн хөрөнгийг бий болгох, сэргээх. Үйлчлүүлэгч болон зочид буудлын байдал нь тусдаа байхын тулд өөр хоорондын аппликейшнүүд, хувилбар эсвэл машин ашиглах.
Kaigi UI-ийн шинжилгээ хийхэд:
- Хост дэлгэцэнд Kaigi нээж, уулзалт эхлүүлэх сонгогдон нэрээ байгуулж, хувийн уриалгыг эсвэл ил тод уриалтыг сонгох.
- WebRTC нь орон нутгийн хэвлэл мэдээллийн хэрэгсэлтэй байхын тулд камер, микрофонг идэвхжүүлнэ.
- Хуралдааны холбоосыг бий болгоороо сонгоно. Амьд хөрөнгийн сан
CreateKaigi-ийг ирүүлнэ; дараа ньiroha://kaigi/join?call=...&secret=...дуудлага болон#/kaigi?...-ийн эргэлтийн замыг үзүүлнэ. - Үйлчлүүлэгч цонхны дэлгэцээ нээлттэй байлгаж, уриалгыг зочидтай хуваалцаарай.
- зочид буудлын үзэсгэлэнд урьлыг нээж, уулзалт дээр элсүүлж, орон нутгийн хэвлэл мэдээллийн хэрэгслийг идэвхжүүлэн хуралдаанд оролцохыг сонгоно. Амьдрал санхүүжилт нь Torii-ээс шифрлэгдсэн хостийн санал авдаг бөгөөд
JoinKaigi-ийг шифрлэгдсэн хариултын мета өгөгдөлтэй хүргэнэ. - Үйлчлөгч нь Kaigi дуудлагын сигналыг дамжуулан эсвэл санал асуулга явуулж анхны хариултыг автомат хэрэглэх ёстой. Хоёр цонх нь холбогдсон хэвлэл мэдээллийн хэрэгсэл болон холбооны шинэчилсэн мэдээллийг харуулна.
- Үйлчлүүлэгчээс уулзалт дуусгавал CLI
iroha kaigi endкоманд нь ижил дуудлага ID дээр ашиглана.
Хувийн Kaigi хэрэгцээг хамгаалах XOR нь хувийн нэвтрүүлгийн цэгтийн төлбөрийг төлүүлэхэд шаардлагатай. Хэрэв демо нь хувийн Kaigi хэрэгцээгийг хамгаалах XOR гэж мэдээлвэл, аппликейшн дэх өөрийгөө хамгаалах илтгэлийг ашиглаж, бүтээх эсвэл нэгдэх үйлдлийг дахин туршиж үзээрэй. Хэрэв баталгаа үүсгэх, хувийн санхүүжилт, эсвэл амьд сигнал өгөх боломжгүй бол демо нь ил тод / дасан зохиолын урсгалд буцаж ирэх боломжтой.
Demo repo-д автомат хяналт шалгахын тулд:
npm test -- tests/kaigiView.spec.ts tests/preloadKaigiBridge.spec.ts
npm run e2e:ui
npm run verifyVitest-ийн төвлөрсөн Suite нь Kaigi уулзалтын холбоосыг бий болгох, компакт уриалгыг борлуулах, хувийн бүтээх / нэгдэн оруулах / төгсгөх модны дуудлага, бие даасан хамгаалалтын илтгэлийг, гарын авлигуудыг хангах, хариултын санал асуулгаг хамруулдаг. UI хоолой шинжилгээний туршилтад ширээний болон гар утасны хэмжээний үзэсгэлэн дээр /kaigi замыг багтаадаг. Хоёр хөрөнгийн сангийн хооронд амьд хэвлэл мэдээллийн хэрэгсэл нь цахилгаан камер/микрофоны зөвшөөрөл болон дундаж хэвлэлийн урсгал нь байгаль орчинд тодорхой байдаг тул хоёр ширээний дасан зохицуулалт шинжилгээ хийх шаардлагатай байна.
Үлгэрийн интеграцийн код г үзнэ үү Kaigi-ийг JavaScript-ийн App-д багтаажээ.
Статус, үзүүлэлт
Статус болон метрикийн төгсгөл нь хамгийн түрүүнд дашборд руу холбогдсон зүйл юм:
/statusнь дээд түвшний өрсөлдөгч, блок, шуурхай, тохиролцооны талбайг илрүүлнэ/metricsнь Prometheus-ийн тооллогч, хэмжүүлэгч, хистограммыг илрүүлж байна
Nexus-ийн хүчин чадалтай түймрүүд дээр, статусын гарааны хувьд замын хөдөлгөөн болон өгөгдлийн орон зайг мэддэг хэсгүүд ч байдаг. nexus.enabled = false бол эдгээр хэсгүүд орхигддог.
JSON v. Norito
Хөдөлмөрийн хэрэгслийн хэд хэдэн эцсийн цэг нь буцаадаг Norito Үндсэн хэсгээр: JSON, ирүүлнэ:
Accept: application/jsonЭнэ нь:
/v1/sumeragi/status/v1/sumeragi/qc/v1/sumeragi/commit_qc/{hash}
Хөгжлийн тоног төхөөрөмж нь Norito-ийг шууд хүлээн зөвшөөрөх эсвэл буцаадаг бол application/x-norito -г агуулгын төрөл болон Accept -ийн сонгосон үнэ цэнэ болгон ашиглаарай. Тээврийн дэлгэрэнгүй мэдээллийг Norito-д үзнэ үү.
Telemetry Profiles
Төгсгөлийн цэгүүдийн харагдац нь зангилааны telemetry.profile тохиргооноос хамаарна. Одоогийн тохиргоонд профайлын таван түвшин байдаг:
| Профиль | /status | /metrics | Хөгжлийн чиглэлүүд |
|---|---|---|---|
disabled | үгүй | үгүй | үгүй |
operator | тийм | үгүй | үгүй |
extended | тийм | тийм | үгүй |
developer | тийм | үгүй | тийм |
full | тийм | тийм | тийм |
CLI Урьдчилсан зам
iroha CLI нь эдгээр төгсгөлийн олон зүйлийг аль хэдийнээ багтааж байна:
iroha --config ./localnet/client.toml --output-format text ops sumeragi status
iroha --config ./localnet/client.toml --output-format text ops sumeragi phases
iroha --config ./localnet/client.toml ops sumeragi params
iroha --config ./localnet/client.toml --output-format text ops sumeragi telemetry