Skip to content

Conversation

@AdekunleBamz
Copy link

Summary

This PR adds README documentation to contract directories that were missing them, complementing the existing documentation coverage in the repository.

Changes Added

New Files (6 READMEs)

  1. contracts/contracts/automation/README.md

    • Documents Safe Module contracts for protocol automation
    • Covers bridge helpers and operational modules
    • Explains operator role and access control architecture
  2. contracts/contracts/beacon/README.md

    • Documents Beacon Chain proof verification contracts
    • Explains use cases for native staking (validator verification, withdrawal proofs)
    • Lists all Merkle proof and utility contracts
  3. contracts/contracts/bridges/README.md

    • Documents LayerZero Omnichain adapters
    • Explains lock/unlock (mainnet) vs mint/burn (L2) architecture
    • Cross-chain token bridging mechanism
  4. contracts/contracts/buyback/README.md

    • Documents protocol buyback mechanism
    • Explains OGN/CVX token distribution
    • Covers configuration options and access control
  5. contracts/contracts/poolBooster/README.md

    • Documents liquidity incentive distribution contracts
    • Covers Merkl, Metropolis, and Swapx integrations
    • Explains factory and registry architecture
  6. contracts/contracts/zapper/README.md

    • Documents WOETHCCIPZapper for cross-chain operations
    • Explains ETH → WOETH L2 flow in single transaction

Why This Change

Several contract directories lacked README documentation. This PR fills those gaps to help developers understand each module's purpose and architecture.

- Add automation/README.md documenting Safe modules for protocol operations
- Add beacon/README.md explaining Beacon Chain proof verification
- Add bridges/README.md documenting LayerZero OFT adapters
- Add buyback/README.md explaining yield buyback mechanisms
- Add poolBooster/README.md documenting liquidity incentive contracts
- Add zapper/README.md explaining cross-chain zapper utilities
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.

1 participant