Skip to content

Conversation

@dguido
Copy link
Member

@dguido dguido commented Jan 20, 2026

Summary

  • Adds support for parsing NatSpec custom tags (@custom:*)
  • Supports both contract-level (DevDoc) and method-level (DevMethod) custom fields
  • Custom fields are stored and exported properly via export()
  • Adds custom property to access custom fields dictionary

Example NatSpec:

/// @custom:security Critical function
/// @custom:oz-upgrades-unsafe-allow constructor

Fixes #295

Test plan

  • Compile a contract with custom NatSpec tags
  • Verify custom fields are accessible via devdoc.custom and method.custom
  • Verify custom fields are included in export() output

🤖 Generated with Claude Code

Add support for parsing custom NatSpec tags (custom:*) at both the
contract level (DevDoc) and method level (DevMethod). Custom fields
are stored in a _custom dict and included in export() output.

Fixes #295

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@smonicas smonicas force-pushed the fix/295-natspec-custom-fields branch from 0fe401f to 256a799 Compare January 23, 2026 19:36
@smonicas smonicas merged commit c8f3cbe into master Jan 23, 2026
126 checks passed
@smonicas smonicas deleted the fix/295-natspec-custom-fields branch January 23, 2026 19:45
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.

Natspec: parse custom fields

3 participants