Skip to content

chore: unify interface NatSpec - #666

Closed
zerosnacks wants to merge 3 commits into
masterfrom
zerosnacks/chore-unify-interface-natspec
Closed

chore: unify interface NatSpec#666
zerosnacks wants to merge 3 commits into
masterfrom
zerosnacks/chore-unify-interface-natspec

Conversation

@zerosnacks

Copy link
Copy Markdown
Contributor

The formatting for the interfaces was inconsistent and missing details, this should make it more unified.

@zerosnacks
zerosnacks enabled auto-merge (squash) March 3, 2025 10:20
/// @dev MUST emit when approval for a second party/operator address to manage all tokens for an owner address is enabled or disabled (absence of an event assumes disabled).
/// @dev
/// - MUST emit when approval for a second party/operator address to manage all tokens for an owner address is
/// enabled or disabled (absence of an event assumes disabled).

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I think it should be indented here and other comments

@zerosnacks
zerosnacks disabled auto-merge January 5, 2026 10:44
@zerosnacks zerosnacks closed this Jan 5, 2026

@7zkm7b8gw9-web 7zkm7b8gw9-web 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.

Is this everything?

zerosnacks pushed a commit that referenced this pull request Apr 13, 2026
Part of #653. Two more of the files listed in the NatSpec docs
checklist.

## StdMath.sol

Added \`@notice\`, \`@param\`, and \`@return\` tags to the library and
all five internal functions:

- \`abs(int256)\`
- \`delta(uint256, uint256)\`
- \`delta(int256, int256)\`
- \`percentDelta(uint256, uint256)\`
- \`percentDelta(int256, int256)\`

I did not rename \`INT256_MIN\` to \`_INT256_MIN\` even though the issue
mentions the underscore-prefix convention for private variables. The
already-merged StdAssertions.sol work (PR #666 / StdInvariant) left its
private constants without the underscore prefix (for example
\`FAILED_SLOT\`), so I matched that pattern to keep this PR purely
additive. Happy to apply the rename in a follow-up or in this PR if you
prefer the underscore convention going forward. Let me know which way
you want to settle it.

## StdError.sol

Added \`@notice\` to each of the nine public panic-code constants
describing what Solidity panic it corresponds to. Panic codes
cross-checked against the Solidity docs.

## What is not in this PR

- No logic changes
- No interface changes
- No file reordering (internal up, private down was also listed in #653
- can do that in a follow-up if you want)
- No tests touched

## Testing

I do not have Foundry set up on this machine so I have not run \`forge
fmt --check\` or \`forge test\` locally. The diff is 38 insertions and 0
deletions, all inside NatSpec comment blocks above existing
declarations, so behavior is unchanged. CI should cover the formatting
and test pass. If CI flags anything I will fix it in this branch.

Happy to split this into two PRs (one per file) if that is easier to
review.

@7zkm7b8gw9-web 7zkm7b8gw9-web 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.

Why is my solana accounts only showing on my app and my genesis and not in the middle?

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.

4 participants