Solidity Guide

Applies to: Solidity 0.8.20+, Ethereum, EVM-compatible chains, DeFi, NFTs

Core Principles

1. Security First: Every function is a potential attack surface. Assume adversarial callers.
2. Gas Efficiency: On-chain computation is expensive. Optimize storage access and minimize state changes.
3. Explicit Over Implicit: Use explicit visibility, explicit types, and named return values.
4. Immutability by Default: Prefer immutable and constant for values that do not change after deployment.
5. Standards Compliance: Use OpenZeppelin for ERC standards. Do not roll your own token logic.

Guardrails

Compiler Version

• ALWAYS specify pragma version range: pragma solidity ^0.8.20;
• Do NOT use floating pragmas in production (e.g., >=0.8.0). Pin to a minor range.
• Enable the optimizer with at least 200 runs for production deployments.