Enhance IERC6372 NatSpec following the ERC definitions

[gonzaotc]

Alternative to #6648.

The IERC6372 NatSpec was grabbed back then directly from Votes.sol, where it's NatSpec does fit: clock() is virtual there and the context is voting checkpoints. Neither holds in the interface, and ERC-6372 never mentions checkpoints or voting.

It also dropped the normative part of the spec: clock() must be non-decreasing, and CLOCK_MODE() must return a URL-query-string descriptor with specified values. That is where I think the doc matters, since the return type is just string.

This rewrites both to describe the standard, and adds a contract-level @dev for consistency with the other interfaces under contracts/interfaces/ (IERC5313, IERC6093).

[changeset-bot]

⚠️ No Changeset found

Latest commit: f3647f4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: e402a944-6ed4-480b-b09c-b2aa5fc83376

📥 Commits

Reviewing files that changed from the base of the PR and between dd1d7df and 8eac813.

📒 Files selected for processing (1)

• contracts/interfaces/IERC6372.sol

---

Walkthrough

Expanded the IERC6372 interface and clock() NatSpec documentation to describe non-decreasing timepoints, timestamp and block-number modes, URL-query formatting, CAIP-2 chain ID handling, and the NUMBER opcode default. No interface or function declarations changed.

Possibly related PRs

• OpenZeppelin/openzeppelin-contracts#6648: Updates the same IERC6372.clock() NatSpec with related behavior details.

Suggested labels: ignore-changeset

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: improving IERC6372 NatSpec to match the ERC definition.
Description check	✅ Passed	The description directly explains the NatSpec rewrite and its alignment with ERC-6372.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}