Skip to content

docs: dependency audit, Helios pinning rationale, ethereum_hashing fork rationale - #175

Merged
Th0rgal merged 1 commit into
mainfrom
docs/dependency-audit-and-pinning-rationale
Feb 25, 2026
Merged

docs: dependency audit, Helios pinning rationale, ethereum_hashing fork rationale#175
Th0rgal merged 1 commit into
mainfrom
docs/dependency-audit-and-pinning-rationale

Conversation

@Th0rgal

@Th0rgal Th0rgal commented Feb 25, 2026

Copy link
Copy Markdown
Owner

Summary

  • Audit and minimize dependency count for verifiability #165 – Dependency audit: New DEPENDENCIES.md documenting every direct dependency across all packages, split into verification-path (security-critical: viem, zod, helios, alloy, revm, etc.) and UI/tooling (non-critical: React, Tailwind, Next.js, etc.) with per-dependency justification.
  • Pin Helios dependency to a tagged release instead of git rev #166 – Helios pinning rationale: Inline Cargo.toml comment explaining why helios-consensus-core is pinned to git rev 582fda3 (includes a16z/helios#776 fix for hex-encoded beacon API fields, not yet in a tagged release past 0.11.0). Includes action item to migrate to a version pin once a new Helios release ships.
  • Document rationale for ethereum_hashing fork in Cargo.toml #167 – ethereum_hashing fork rationale: Inline Cargo.toml comment explaining why ethereum_hashing uses the ncitron fork (removes ring C dependency, uses pure-Rust sha2 unconditionally). ncitron is the top Helios contributor. Includes action item to drop the patch once upstream releases a version with the sha2 feature flag.
  • README.md: Links to DEPENDENCIES.md from the architecture section.

Test plan

  • All 634 tests pass (docs-only + comment-only changes)
  • Type-check clean
  • CI passes on this PR

Closes #165
Closes #166
Closes #167

🤖 Generated with Claude Code


Note

Low Risk
Docs-only changes plus Cargo.toml comments; no runtime behavior or dependency versions change. Low risk aside from potentially stale documentation if future pins/patches diverge.

Overview
Adds a new DEPENDENCIES.md that documents why each direct dependency exists, explicitly separating verification-path (security-critical) dependencies from UI/tooling ones.

Updates README.md to link to the new dependency audit, and expands apps/desktop/src-tauri/Cargo.toml with rationale comments for the helios-consensus-core git rev pin and the ethereum_hashing fork/patch (including guidance to migrate back to tagged upstream releases when available).

Written by Cursor Bugbot for commit 2b41421. This will update automatically on new commits. Configure here.

…rk rationale (#165, #166, #167)

- DEPENDENCIES.md: audit every direct dependency across all packages,
  split into verification-path (security-critical) and UI/tooling
  (non-critical) categories with per-dependency justification.
- Cargo.toml: add inline comments explaining why helios-consensus-core
  is pinned to git rev 582fda3 (a16z/helios#776 not yet in a tagged
  release) and why ethereum_hashing uses the ncitron fork (removes
  ring C dependency in favor of pure-Rust sha2).
- README.md: link to DEPENDENCIES.md from the architecture section.

Closes #165
Closes #166
Closes #167

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel

vercel Bot commented Feb 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
safe-lens-generator Building Building Preview, Comment Feb 25, 2026 4:01pm

Request Review

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@Th0rgal

Th0rgal commented Feb 25, 2026

Copy link
Copy Markdown
Owner Author

@BugBot review

@Th0rgal
Th0rgal merged commit c021d1f into main Feb 25, 2026
3 checks passed

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant