This repo is an ongoing collection of useful, and occasionally clever, solidity/EVM patterns that actually get used in the wild. These bite-sized guides are written in approachable terms so engineers of all skill levels can understand them. Every guide comes with a concise, self-contained, working code example and tests to demonstrate the pattern. New patterns are added regularly.
The code examples herein are meant to be educational. While the patterns are sound, the examples are not always designed with utmost security or robustness in mind, and sometimes will even forgo best practices in order to best illustrate a concept. They should not be deployed without an independent security review.
- ABI Decode With Selector
- Techniques for decoding function call data and revert errors.
- Advanced Error Handling
- Write resilient code that intercepts and reacts to errors thrown by other contracts.
- Assembly Tricks (Part 1)
- Short, useful assembly tricks to save some gas and make up for solidity shortcomings.
- Basic Proxies
- Contracts with upgradeable logic.
- Big Data Storage (SSTORE2)
- Cost efficient on-chain storage of multi-word data accessible to contracts.
- Bitmap Nonces
- Efficiently tracking on-chain the state of frequent, consumable operations identifiable by a unique nonce.
- Commit + Reveal
- A two-step process for performing partially obscured on-chain actions that can't be front or back runned.
- EIP712 Signed Messages
- Human-readable off-chain messages that can be consumed on-chain.
- ERC20 (In)Compatibility
- Working with both compliant and non-compliant (which are more common than you think) ERC20 tokens.
- ERC20 (EIP-2612) Permit
- Perform an ERC20 approve and transfer in a single transaction.
eth_call
Tricks- Perform fast, complex queries of on-chain data and simulations with zero deployment cost using
eth_call
.
- Perform fast, complex queries of on-chain data and simulations with zero deployment cost using
- Explicit Storage Buckets
- Safer, guaranteed non-overlapping storage for upgradeable contracts.
- Externally Owned Account Checks
- The consequences of interacting with contracts vs regular wallets, and how to identify them.
- Factory Proofs
- Proving on-chain that a contract was deployed by a trusted deployer.
- Flash Loans
- Designing a basic flash loan mechanism.
- Initializing Upgradeable Contracts
- Methods to safely and efficiently initialize state for proxy contracts.
- Merkle Proofs
- Storage efficient method of proving membership to a potentially large fixed set.
- Multicall
- Allow users to arbitrarily compose and perform multiple operations on your contract in a single transaction.
- NFT Receive Hooks
- Use ERC721/ERC1155 transfer callbacks to avoid having users set an allowance in advance.
- Off-Chain Storage
- Reduce gas costs tremendously by moving contract state off-chain.
- OnlyDelegateCall / NoDelegateCall
- Restrict functions from being called from only within in a delegatecall context or not.
- Packing Storage
- Arranging your storage variables to minimize expensive storage access.
- Permit2
- Transfer tokens securely without a direct allowance, in a way that works for all (legacy and modern) ERC20s.
- Read-Only Delegatecall
- Execute arbitrary delegatecalls in your contract in a read-only manner, without side-effects.
- Reentrancy
- Explaining reentrancy vulnerabilities and patterns for addressing them (Checks-Effects-Interactions and reentrancy guards).
- Separate Allowance Targets
- Avoid having to migrate user allowances between upgrades with a dedicated approval contract.
- Stack-Too-Deep Workarounds
- Clean solutions for getting around and avoiding stack-too-deep errors. So clean that you should do them regardless!
- Stay tuned for more π
Make sure you have foundry installed and up-to-date first.
# Clone the repo
$> git clone [email protected]:dragonfly-xyz/useful-solidity-patterns.git
# Install foundry dependencies
$> forge install
# Run tests
$> forge test -vvv
# Run forked tests
$> forge test -vvv --fork-url $YOUR_NODE_RPC_URL -m testFork