Skip to content

book: Regenerate RPC reference snapshot for z_exportviewingkey (main is red)#656

Open
pacu wants to merge 1 commit into
mainfrom
fix/rpc-reference-snapshot
Open

book: Regenerate RPC reference snapshot for z_exportviewingkey (main is red)#656
pacu wants to merge 1 commit into
mainfrom
fix/rpc-reference-snapshot

Conversation

@pacu

@pacu pacu commented Jul 18, 2026

Copy link
Copy Markdown
Collaborator

Summary

main is currently red: the book_rpc_reference_is_current pinning test (added in #627) fails because book/src/rpc/methods.md is missing the z_exportviewingkey method, which is present in the Rpc/WalletRpc trait rustdoc.

How it slipped in: z_exportviewingkey was added by #461 and merged to main after #627's branch point. #627 generated the snapshot from the older main and merged cleanly (the two PRs touch different files, so no textual conflict), landing a snapshot that no longer matches the trait. The test therefore fails on main and on every open PR whose CI merges main — e.g. #631, whose tutorial diff doesn't touch any RPC code but still hits this.

Fix: regenerated the snapshot with ZALLET_BLESS=1 cargo test -p zallet-core --test book_rpc_reference. The diff is purely the added z_exportviewingkey section — no other method changed.

Closes #655.

Test plan

  • cargo test -p zallet-core --test book_rpc_reference passes against current main
  • Diff is additive only (the one new method)

Note for maintainers

This is the snapshot analogue of the classic "two PRs, no textual conflict, semantic conflict" gap: a PR adding an RPC method and the snapshot PR can each pass CI independently and merge clean, yet leave main red. Prevention options: (a) generate methods.md at build time into OUT_DIR and compare there (no committed artifact to go stale), or (b) require the snapshot regen to accompany any RPC-doc change. Tracked in #655.

AI disclosure

Prepared with AI assistance (Claude Opus 4.8, via Claude Code); Co-Authored-By metadata is on the commit. Reviewed by the PR author.

🤖 Generated with Claude Code

The book_rpc_reference pinning test is failing on main: z_exportviewingkey
(added by #461, merged after the #627 branch point) is present in the Rpc
trait rustdoc but missing from the committed book/src/rpc/methods.md. #627
generated the snapshot from an earlier main and merged cleanly (different
files, no conflict), so the snapshot landed stale and the test now fails on
main and on every open PR that merges main (e.g. #631).

Regenerated with ZALLET_BLESS=1; the diff is purely the added
z_exportviewingkey section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@pacu
pacu enabled auto-merge July 18, 2026 22: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.

ci: book_rpc_reference snapshot is stale on main (missing z_exportviewingkey)

1 participant