Skip to content

Add Aegis Contracts test-first contribution guide #141

Description

@El-swaggerito

Description

Difficulty: Expert

Type: Documentation

Summary

Create a test-first contribution guide for Aegis Contracts.

Current Behaviour

Contributors may update compliance registry, RWA assets, minting, transfer restrictions, roles, metadata, and events without adding meaningful tests.

Expected Behaviour

The repo should explain when tests are required, what type of tests are expected, and how contributors should prove the behaviour works.

Suggested Implementation

Add documentation with testing examples, no-test justification rules, negative-path expectations, and local commands.

Files or Areas Likely Affected

  • src/
  • tests/
  • docs/
  • README.md
  • Makefile

Acceptance Criteria

  • Test-first contribution guide is added.
  • Testing expectations for compliance registry, RWA assets, minting, transfer restrictions, roles, metadata, and events are documented.
  • Happy-path and negative-path test expectations are included.
  • No-test justification rules are documented.
  • Local test commands are included.
  • README links to the guide.

Additional Notes

This addresses under-tested merged PRs.

Metadata

Metadata

Labels

GrantFox OSSIssue tracked for GrantFox OSS contributionMaybe RewardedIssue may be eligible for a GrantFox rewardOfficial Campaign | FWC26Official GrantFox campaign labelaegisAegis RWA Protocol related workdocumentationDocumentation workexpertExpert difficultyrwa-contractsRWA smart contract worktestTesting work

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions