Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Quick Start: verifier steps name response IDs absent from Agent 2.0.0

オープン 初心者向け
  • 何か問題がありますか？
#294 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
83/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
領域
documentation

調査の方向性

documentation/develop/quick-start.md の接続あり応答、接続なし応答、ポーリングコマンドの各セクションを編集してください。issue でリンクされている固定バージョンの Agent 2.0.0 の PresentationStatus および OOBPresentationInvitation スキーマとフィールド名を比較し、それに合わせて両方のブランチとポーリングの手順を更新してください。各ブランチで応答に存在するフィールドが示され、ポーリングで presentation レコードの ID が使われ、invitation ID と URL が別々に特定されていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

bug documentation ready-for-agent

User impact

Verifier developers are told to extract nonexistent fields, then use one to poll a presentation record; the connectionless branch also leaves the actual invitation URL field unclear.

Affected documentation and ownership

  • Page: Quick Start Guide, GET 200 at 2026-10-28 20:48:50 UTC; affected source text is also deployed.
  • Editable owner: hyperledger-identus/docs, local hand-authored documentation/develop/quick-start.md at fa985dfa33caefa45bf1e9009e1f6f5a445344fb; not imported SDK content or generated API output.
  • Intended versions: page environment pins select Agent 2.0.0 (5865d9470dc5ce6631aec780e7cf63d4f454555a); SDK checkout selects v6.6.0 (1a9da8135ec5745bca182904f0a1703d7be6d1a2). Matching pins, not latest releases, govern this comparison.
  • Affected text: Connected response, connectionless response, and polling command.

Observed versus expected

The guide says POST /present-proof/presentations returns presentationRequestId, then uses that name for polling. It says POST /presentations/invitation returns invitationId. Both pinned endpoints actually return PresentationStatus, with presentationId; the OOB invitation is nested as invitation.id / invitation.invitationUrl. Expected: identify the actual response fields and carry the presentation record ID into polling separately from the invitation ID/URL.

Evidence and reproduction

Statically compare:

No live Agent response was obtained; names follow pinned case classes/derived JSON encoders and API schema.

Verification used Python 3.13.15 text/HTML inspection of immutable public sources and deployed text. No repository code, compiler/build, service request or browser test was run; deployment commit identity is not exposed.

Existing work checked

Fully paginated open/closed issue-and-PR inventories in docs, cloud-agent and sdk-ts, plus title/body/comment searches by page/component/root cause and relevant discussion/patch reads. Searched Quick Start/path, presentationRequestId, invitationId, schemaId and presentation root causes. docs PR #54, #159, and later Quick Start patches introduce/retain these names rather than repair them. cloud-agent #1485 is a closed unreproduced HTTP 500 report; its discussion shows presentationId but does not own this portal-text correction. This is not a recurrence of that server error. No matching open repair was found.

Acceptance criteria

  • Both verifier branches identify output fields present in Agent 2.0.0 responses.
  • The polling command uses the returned presentation-record ID, while OOB instructions identify the separate nested invitation URL/ID.
  • Check revised text against matching response schemas and safe local response fixtures or the pinned Agent.
主要言語
TypeScript
スター
15
フォーク
8
平均マージ
3日 14時間
マージ済み PR（30日）
2

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

hyperledger-identus/docs のほかの issue

hyperledger-identus/docs の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。