Skip to content

fix(releases): split fullnode vs validator-set node versions#1610

Draft
gregnazario wants to merge 3 commits into
mainfrom
cursor/fullnode-vs-validator-git-hash-e8d1
Draft

fix(releases): split fullnode vs validator-set node versions#1610
gregnazario wants to merge 3 commits into
mainfrom
cursor/fullnode-vs-validator-git-hash-e8d1

Conversation

@gregnazario
Copy link
Copy Markdown
Contributor

@gregnazario gregnazario commented May 1, 2026

Summary

Network cards on /releases/networks previously showed a single Node Release / Node Commit pair sourced from GET …/v1/ on the configured Aptos REST URL. That git_hash reflects the gateway fullnode, not active validators.

This change:

  • Keeps Fullnode Release / Fullnode Commit tied to the explorer’s configured REST base URL (fullnodeGitHash, still exposed as gitHash for backward compatibility).
  • Adds Validator Set Release / Validator Set Commit by sampling the on-chain ValidatorSet: extract DNS hostnames from network_addresses / fullnode_addresses blobs for the first validators, probe common REST URL shapes (https://host/v1, http://host:8080/v1, http://host:8180/v1), take the mode among successful git_hash responses, and resolve both rows via the existing GitHub commit-message parser.

Operator endpoints may be unreachable from browsers (firewall, TLS, non-standard ports, or CORS). In those cases the validator rows stay empty rather than reusing the gateway hash; tooltips explain the sampling.

Tests / verification

  • Added app/utils/aptosValidatorAdvertisedHosts.test.ts (hostname extraction, hash normalization, mode).
  • Extended useGetNetworkStatus.test.ts with a probe mock.

CI initially failed Biome on aptosValidatorAdvertisedHosts.ts (non-null assertions, assignment-in-while). Follow-up commit fixes those.

Docs

  • Updated docs/FEATURES_SPECIFICATION.md (FEAT-RELEASES-001), CHANGELOG.md, public/llms.txt, and public/llms-full.txt.
  • Bumped React Query key to ["deployments","networkStatus","v2",network] and increased stale time to 5 minutes to reduce repeated third-party probing.
Open in Web Open in Cursor 

@netlify
Copy link
Copy Markdown

netlify Bot commented May 1, 2026

Deploy Preview for aptos-explorer ready!

Name Link
🔨 Latest commit 2b183ed
🔍 Latest deploy log https://app.netlify.com/projects/aptos-explorer/deploys/69f95ad076455a00082d35cc
😎 Deploy Preview https://deploy-preview-1610--aptos-explorer.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

cursoragent and others added 3 commits May 4, 2026 19:49
…rk cards

Fullnode git_hash stays tied to the configured REST gateway; validator-set
hash is sampled from ValidatorSet advertised hostnames with GitHub release
resolution for both rows when hashes exist.

Co-authored-by: Greg Nazario <greg@gnazar.io>
@gregnazario gregnazario force-pushed the cursor/fullnode-vs-validator-git-hash-e8d1 branch from e84ea39 to 2b183ed Compare May 5, 2026 02:49
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