Skip to content

docs(reference): add third-party audit summary page - #119

Merged
truthixify merged 2 commits into
wraith-protocol:developfrom
theo372001:feat/issue-86-audit-summary-page
Aug 6, 2026
Merged

docs(reference): add third-party audit summary page#119
truthixify merged 2 commits into
wraith-protocol:developfrom
theo372001:feat/issue-86-audit-summary-page

Conversation

@theo372001

Copy link
Copy Markdown
Contributor

Summary

Adds a curated, non-technical summary page for Wraith Protocol's contract audits, per #86.

  • New reference/audits.mdx — one section per audit with firm, date, scope, findings summary (severity + description per finding), and remediation status, linking to the raw report.
  • Note: the repo currently has exactly one completed audit — a Stellar Asset Contract (SAC) compatibility review conducted internally by the Wraith Protocol security team, not by a third-party firm. The page states this explicitly rather than overstating it, per the "copy reviewed for accuracy vs raw reports" acceptance criterion. Additional third-party audits are noted as planned, with a pointer to the roadmap.
  • Nav entry added under "Reference" in docs.json.
  • While editing that nav array I found (and fixed) a pre-existing invalid-JSON syntax error in the same "Reference" group — a duplicate/malformed pages key left over from a bad merge in 5c5c7f1/23d0a1f, which broke docs.json parsing entirely (unrelated content, e.g. contracts/evm/contracts/stellar/etc., remains reachable via the separate, untouched "Contracts" group). Had to fix it since it's the exact object this PR's nav entry needed to go into.

Type

  • Documentation

Related Issue

Closes #86

Testing

  • node -e "JSON.parse(...)" on docs.json: now valid (was failing before this fix).
  • mint validate: the only remaining failures are pre-existing and unrelated, confirmed via git stash comparison against clean develop — a genuine MDX parse error in contracts/stellar.mdx (stray ! character) and a dangling nav reference to reference/stellar-event-schemas, a file that has never existed in the repo. My new reference/audits entry produces zero warnings.
  • mint broken-links couldn't complete, blocked by the same pre-existing contracts/stellar.mdx parse error.
  • Findings summary cross-checked against the raw report (contracts/stellar/audits/2026-06-sac-compatibility.md) for firm name, date, and all 7 finding IDs/severities.

…otocol#86)

Summarizes the Stellar Asset Contract (SAC) compatibility review for
non-technical readers, with severity, findings, and remediation status
per finding, and a link to the raw report in contracts/stellar/audits.

Also fixes a pre-existing invalid-JSON syntax error in the docs.json
Reference nav group (duplicate/malformed pages key from a bad merge in
5c5c7f1 / 23d0a1f) and adds the new audits page's nav entry.
@theo372001

Copy link
Copy Markdown
Contributor Author

please review issue PR, request has been
submitted more than 4 days.

@drips-wave

drips-wave Bot commented Aug 5, 2026

Copy link
Copy Markdown

@theo372001 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@truthixify
truthixify merged commit 5ad06ef into wraith-protocol:develop Aug 6, 2026
2 checks passed
@truthixify

truthixify commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Merged. Thanks @theo372001. Clear audit summary and good fix for the broken Reference nav JSON.

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.

Third-party audit summary page

2 participants