Skip to content

fix: remove-oa-v3#12

Merged
rongquan1 merged 3 commits into
developfrom
fix/remove-oa-v3
May 21, 2026
Merged

fix: remove-oa-v3#12
rongquan1 merged 3 commits into
developfrom
fix/remove-oa-v3

Conversation

@RishabhS7
Copy link
Copy Markdown
Contributor

@RishabhS7 RishabhS7 commented May 20, 2026

fix: remove OA v3

Removes OpenAttestation v3 references from documentation while retaining OA v3 verification support.

Changes

  • getting-started.md — Updated signOA description to reflect v2 only
  • attachments.md — Removed OA v3 legacy format section and v3 field references
  • implementing-qr-codes.md — Removed OA v3 QR code example and credentialSubject.links.self.href reference
  • decentralized-renderer.md — Removed V3 from supported formats; commented out BillOfLadingSchemaV3 type, v3 import, and TemplateASampleV3 sample usage

OA v3 documents can still be verified via verifyDocument — only wrapping and creation guidance has been removed.

Summary by CodeRabbit

  • Documentation
    • Updated core function documentation to clarify OpenAttestation v2 support
    • Revised attachment handling guidance emphasizing W3C Verifiable Credentials structure, with clarified requirements for filename and mimeType fields
    • Enhanced QR code implementation documentation with corrected OpenAttestation v2 link placement specifications
    • Removed legacy documentation examples for improved clarity

Review Change Stack

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 20, 2026

Warning

Rate limit exceeded

@RishabhS7 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 49 minutes and 41 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 59dece04-d9e4-4e45-9cdd-27ac056b669f

📥 Commits

Reviewing files that changed from the base of the PR and between 086bad7 and e6b24b8.

📒 Files selected for processing (4)
  • docs/getting-started.md
  • docs/how-tos/attachments.md
  • docs/how-tos/verifydocument.md
  • docs/tutorial/decentralized-renderer.md
📝 Walkthrough

Walkthrough

This PR updates TrustVC documentation to narrow OpenAttestation version support from v2/v3 to v2, removes v3 code examples and field paths, and emphasizes W3C Verifiable Credentials attachment structures across three guides: getting-started, attachments, and QR code implementation.

Changes

OpenAttestation v2 Documentation Narrowing

Layer / File(s) Summary
Core function documentation update
docs/getting-started.md
The signOA function description is restricted to v2-only support.
Attachment structure and rendering guidance
docs/how-tos/attachments.md
Legacy format references remove v3, the recommended W3C VC structure table expands with required filename and mimeType fields, renderer parsing and code comments clarify OA v2 behavior, and the entire v3 legacy example section is deleted.
QR code link extraction paths
docs/how-tos/implementing-qr-codes.md
OA v2 QR code field location is clarified, v3 path is removed, and the getQRCodeLink extraction list drops the v3 option.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • TrustVC/TrustVC-Documentation#11: Both PRs modify docs/how-tos/implementing-qr-codes.md to change OpenAttestation v2 vs v3 handling in getQRCodeLink extraction paths.

Suggested reviewers

  • rongquan1

Poem

🐰 Hopping through docs with purpose bright,
v3 paths fade, v2 shines in light,
Attachments refined, QR codes aligned,
W3C structure—TrustVC redesigned!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'fix: remove-oa-v3' accurately describes the main change: removing OpenAttestation v3 references from documentation across multiple files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/remove-oa-v3

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (3)
docs/how-tos/attachments.md (3)

53-53: 💤 Low value

Documentation references only v2 but code handles v3.

Similar to the previous comment, the text mentions "common variations found in OA v2 documents", but the code at lines 65-66 checks for both v2 and v3 documents. Consider mentioning both versions for consistency with the code behavior.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/how-tos/attachments.md` at line 53, Update the sentence in
attachments.md so it documents that the renderer handles both OA v2 and v3
variations (not just v2); specifically mention that it looks for the recommended
fields (data, filename, mimeType) and also checks common variations found in OA
v2 and v3 documents to match the code that checks for both v2 and v3.

72-86: 💤 Low value

Inline comments reference only v2 but code handles both versions.

The inline comments at lines 72-73 and 75 mention field name variations as "(recommended, and OA v2)" and "(common in OA v2)", but the code at line 65 processes both v2 and v3 documents. If these field name variations also apply to v3, consider updating the comments to reflect that (e.g., "and OA v2/v3") for accuracy. If v3 uses different field names, the current comments are correct.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/how-tos/attachments.md` around lines 72 - 86, The inline comments next
to the label and type resolution (the lines that describe fileName/filename and
type/mimeType) inaccurately reference only "OA v2" while the code path that
builds label/type (using the variables label, type and calling
attachmentToComponent(attachment, document)) handles both v2 and v3 documents;
update those comments to accurately reflect that the fallback checks apply to
both OA v2 and v3 (e.g., change "(recommended, and OA v2)" and "(common in OA
v2)" to "(recommended; applies to OA v2/v3)") or, if v3 differs, explicitly call
out the v3 field differences so the comment next to label, type, and
attachmentToComponent is correct.

41-42: ⚡ Quick win

Consider clarifying v3 verification support for reader clarity.

The text states the renderer "can parse attachments from older OpenAttestation (OA) v2 formats", but the code snippet at lines 65-66 explicitly checks for both v2 and v3 documents (isV2Document(document) || isV3Document(document)). Since the PR description confirms v3 documents remain verifiable and this section describes verification/rendering (not creation), consider briefly acknowledging v3 support to avoid reader confusion.

For example: "can parse attachments from older OpenAttestation (OA v2 and v3 for backward compatibility) formats"

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/how-tos/attachments.md` around lines 41 - 42, The text in attachments.md
implies only OA v2 parsing support but the renderer and code check both
isV2Document and isV3Document; update the sentence to explicitly state that the
renderer can parse attachments from both OpenAttestation v2 and v3 formats (for
backward compatibility) so readers know v3 documents are also verifiable; modify
the sentence referencing "older OpenAttestation (OA) v2 formats" to mention "OA
v2 and v3" and/or add a short parenthetical noting that the renderer uses
isV2Document and isV3Document checks for verification/rendering.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@docs/how-tos/attachments.md`:
- Line 53: Update the sentence in attachments.md so it documents that the
renderer handles both OA v2 and v3 variations (not just v2); specifically
mention that it looks for the recommended fields (data, filename, mimeType) and
also checks common variations found in OA v2 and v3 documents to match the code
that checks for both v2 and v3.
- Around line 72-86: The inline comments next to the label and type resolution
(the lines that describe fileName/filename and type/mimeType) inaccurately
reference only "OA v2" while the code path that builds label/type (using the
variables label, type and calling attachmentToComponent(attachment, document))
handles both v2 and v3 documents; update those comments to accurately reflect
that the fallback checks apply to both OA v2 and v3 (e.g., change "(recommended,
and OA v2)" and "(common in OA v2)" to "(recommended; applies to OA v2/v3)") or,
if v3 differs, explicitly call out the v3 field differences so the comment next
to label, type, and attachmentToComponent is correct.
- Around line 41-42: The text in attachments.md implies only OA v2 parsing
support but the renderer and code check both isV2Document and isV3Document;
update the sentence to explicitly state that the renderer can parse attachments
from both OpenAttestation v2 and v3 formats (for backward compatibility) so
readers know v3 documents are also verifiable; modify the sentence referencing
"older OpenAttestation (OA) v2 formats" to mention "OA v2 and v3" and/or add a
short parenthetical noting that the renderer uses isV2Document and isV3Document
checks for verification/rendering.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ea467cb5-74bc-4ad1-8130-8ebe99e80881

📥 Commits

Reviewing files that changed from the base of the PR and between 31ebbcc and 086bad7.

📒 Files selected for processing (4)
  • docs/getting-started.md
  • docs/how-tos/attachments.md
  • docs/how-tos/implementing-qr-codes.md
  • docs/tutorial/decentralized-renderer.md
💤 Files with no reviewable changes (1)
  • docs/how-tos/implementing-qr-codes.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@RishabhS7 RishabhS7 changed the base branch from main to develop May 21, 2026 08:32
@rongquan1 rongquan1 merged commit 9904e94 into develop May 21, 2026
5 checks passed
@rongquan1 rongquan1 deleted the fix/remove-oa-v3 branch May 21, 2026 08:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants