Skip to content

docs: restore set_admin rustdoc in revenue pool#386

Merged
greatest0fallt1me merged 1 commit into
CalloraOrg:mainfrom
Vvictor-commits:task/revenue-pool-rustdoc-fix
May 28, 2026
Merged

docs: restore set_admin rustdoc in revenue pool#386
greatest0fallt1me merged 1 commit into
CalloraOrg:mainfrom
Vvictor-commits:task/revenue-pool-rustdoc-fix

Conversation

@Vvictor-commits
Copy link
Copy Markdown
Contributor

@Vvictor-commits Vvictor-commits commented May 28, 2026

Closes #343


Problem

The set_admin doc block was mis-merged. Its # Events section ran directly into get_usdc_token's docs, and set_admin itself had no dedicated /// block at all.

Changes

contracts/revenue_pool/src/lib.rs — doc-only, zero logic changes:

  • Give set_admin its own /// block documenting args, panics, and both emitted events (admin_changed, admin_transfer_started)
  • Restore get_usdc_token's doc block in the correct position (after set_admin, before claim_admin)
  • Remove the stray doc text that was bleeding across function boundaries

Verification

  • All existing tests continue to pass (no logic touched)
  • cargo doc -p callora-revenue-pool --no-deps builds cleanly
  • cargo clippy -p callora-revenue-pool -- -D warnings passes

The set_admin doc block was mis-merged: its Events section bled
directly into get_usdc_token's docs, and set_admin itself had no
dedicated rustdoc block.

- Give set_admin its own /// block with args, panics, and both
  emitted events (admin_changed, admin_transfer_started)
- Restore get_usdc_token's doc block in the correct position
  (after set_admin, before claim_admin)
- No logic changes
@drips-wave
Copy link
Copy Markdown

drips-wave Bot commented May 28, 2026

@Vvictor-commits 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

@greatest0fallt1me greatest0fallt1me merged commit 03c8330 into CalloraOrg:main May 28, 2026
0 of 3 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.

Revenue pool: complete missing rustdoc for set_admin and add module-level safety docs

3 participants