Skip to content
A compilation of patterns and best practices for the smart contract programming language Solidity
Branch: master
Clone or download
Latest commit 49e61ce Nov 7, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
AccessRestriction Add disclaimer Apr 17, 2018
EmergencyStop Add disclaimer Apr 17, 2018
EternalStorage Add disclaimer Apr 17, 2018
GuardCheck Add disclaimer Apr 17, 2018
MemoryArrayBuilding Fixed minor typo in getItemsbyOwner function header Jun 1, 2018
Oracle Update oracle.sol May 5, 2019
ProxyDelegate Add disclaimer Apr 17, 2018
PullOverPush Update PullOverPush.sol Apr 17, 2018
Randomness Update randomness for 0.4.22 and close bets at setSeed Apr 19, 2018
SecureEtherTransfer Add disclaimer Apr 17, 2018
StateMachine Add disclaimer Apr 17, 2018
StringEqualityComparison Add disclaimer Apr 17, 2018
TightVariablePacking Add disclaimer Apr 17, 2018
docs Update Nov 7, 2019
.gitattributes Create .gitattributes Feb 14, 2018
LICENSE Initial commit Feb 14, 2018 Update Nov 7, 2019

Solidity Patterns

This repository contains a collection of design and programming patterns for the smart contract programming language Solidity in version 0.4.20. Note that newer versions might have changed some of the functionalities. Each pattern consists of a code sample and a detailed explanation, including background, implications and additional information about the patterns.

Have a look at the documentation site:


  • Behavioral Patterns
    • Guard Check: Ensure that the behavior of a smart contract and its input parameters are as expected.
    • State Machine: Enable a contract to go through different stages with different corresponding functionality exposed.
    • Oracle: Gain access to data stored outside of the blockchain.
    • Randomness: Generate a random number of a predefined interval in the deterministic environment of a blockchain.
  • Security Patterns
    • Access Restriction: Restrict the access to contract functionality according to suitable criteria.
    • Checks Effects Interactions: Reduce the attack surface for malicious contracts trying to hijack control flow after an external call.
    • Secure Ether Transfer: Secure transfer of ether from a contract to another address.
    • Pull over Push: Shift the risk associated with transferring ether to the user.
    • Emergency Stop: Add an option to disable critical contract functionality in case of an emergency.
  • Upgradeability Patterns
    • Proxy Delegate: Introduce the possibility to upgrade smart contracts without breaking any dependencies.
    • Eternal Storage: Keep contract storage after a smart contract upgrade.
  • Economic Patterns
    • String Equality Comparison: Check for the equality of two provided strings in a way that minimizes average gas consumption for a large number of different inputs.
    • Tight Variable Packing: Optimize gas consumption when storing or loading statically-sized variables.
    • Memory Array Building: Aggregate and retrieve data from contract storage in a gas efficient way.


This repository is not under active development anymore and some (if not most) sections might be outdated. There is no liability for any damages caused by the use of one of these patterns.

You can’t perform that action at this time.