Skip to content

docs: recommend gov_action_id variant for proposal metadata#452

Merged
slowbackspace merged 1 commit intomasterfrom
docs/proposal-metadata-recommend-gov-action-id
May 1, 2026
Merged

docs: recommend gov_action_id variant for proposal metadata#452
slowbackspace merged 1 commit intomasterfrom
docs/proposal-metadata-recommend-gov-action-id

Conversation

@slowbackspace
Copy link
Copy Markdown
Contributor

Summary

  • Updates the description of GET /governance/proposals/{tx_hash}/{cert_index}/metadata to point users to the /governance/proposals/{gov_action_id}/metadata variant when the off-chain metadata cannot be fetched.
  • The gov_action_id variant returns the anchor url, hash, and an error object describing the fetch failure (e.g. hash mismatch, unreachable URL), letting users retrieve the metadata manually even when validation fails.

Context

A customer reported a 404/empty metadata response on the tx_hash/cert_index endpoint for a proposal whose off-chain anchor is broken (hash mismatch on a real mainnet proposal). The newer gov_action_id endpoint exposes the failure details, but this wasn't surfaced anywhere in the docs.

Test plan

  • Render docs locally and confirm the cross-link resolves to the gov_action_id metadata endpoint
  • Verify markdown formatting in Scalar API Reference

🤖 Generated with Claude Code

@vercel
Copy link
Copy Markdown

vercel Bot commented May 1, 2026

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

Project Deployment Actions Updated (UTC)
openapi Ready Ready Preview, Comment May 1, 2026 11:43am

Request Review

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@slowbackspace slowbackspace force-pushed the docs/proposal-metadata-recommend-gov-action-id branch from 9c83e34 to 1c73fbb Compare May 1, 2026 11:43
@slowbackspace slowbackspace merged commit fa9a8cb into master May 1, 2026
6 checks passed
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.

1 participant