Skip to content

Repository files navigation

EVM Audit Checklist

A structured checklist for reviewing EVM smart contracts. Built from notes across multiple audit engagements.

How to use

Work through each section during a review. Check items off as you verify them. Not every item applies to every contract — skip what is irrelevant but document why.

Sections

  1. Access Control
  2. Reentrancy
  3. Oracle & Price Feeds
  4. Flash Loan Risks
  5. Upgrade Patterns
  6. Token Integration
  7. Signatures & Replay Protection

Contributing

PRs welcome. Each checklist item should have a one-line rationale and ideally a link to a real-world exploit that motivates it.

License

CC BY 4.0

Real-World References

Each checklist item links to a real incident where the pattern was exploited or nearly exploited. Some notable ones:

  • Reentrancy: Curve pool read-only reentrancy (Jul 2023, ~$70M)
  • Oracle: Mango Markets price manipulation (Oct 2022, $114M)
  • Flash Loan: Euler Finance (Mar 2023, $197M)
  • Access Control: Ronin Bridge (Mar 2022, $625M — compromised validator keys)
  • Upgrades: Wormhole (Feb 2022, $320M — uninitialized implementation)
  • Token: Fee-on-transfer handling failures across multiple DEX forks
  • Signatures: Wintermute/Optimism 20M OP (multi-sig misconfiguration), Wormhole $320M (forged guardian signatures), permit front-running (industry-wide)

Status

Work in progress. Adding more items as new audit patterns emerge.

About

Opinionated checklist for EVM smart contract security reviews. Covers reentrancy, access control, oracle manipulation, flash loan, and upgrade patterns.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors