Awesome Solidity

A curated list of awesome Solidity resources, libraries, tools and more.

Please check the contribution guidelines for information on formatting and writing pull requests.

Contents

• Resources
  • Official
  • Tutorials
  • Articles
  • Security
    • Audits
  • Examples
    • Educational
    • Deployed on Ethereum Mainnet
  • Templates
  • Books
  • Practice
  • Jobs
• Libraries
• Tools
  • General
  • Utility
  • Audit
  • DevOps
• Languages
  • JavaScript
  • TypeScript
  • Rust
  • OCaml
• Editor Plugins
  • Atom
  • Eclipse
  • Emacs
  • IntelliJ
  • Sublime
  • Vim
  • Visual Studio Code
• License

Resources

Official

• Docs - Official documentation.
• Cheatsheet - Cheatsheet from the official docs.
• Ethereum Wiki - The Ethereum Wiki.
• Ethereum Stackexchange - Ethereum's Stackexchange board.
• Gitter - Gitter channel.
• ethereum/solidity - Source code.
• ethereum/solc-bin - Current and historical builds of the compiler.
• ethereum/solidity-examples - Loose collection of example code.

Tutorials

• buildspace.so - Hands-on Web3 course especially for beginners. It is completely free and you get an NFT on completion.
• androlo/solidity-workshop - Comprehensive series of tutorials covering contract-oriented programming and advanced language concepts.
• CryptoZombies - Interactive code school that teaches you to write smart contracts through building your own crypto-collectibles game.
• cryptodevhub.io - Community-driven effort to unite like-minded people interested in Blockchain- and Crypto Technologies.
• Discover Ethereum & Solidity (ludu.co) - Complete course that takes you through the process of creating a decentralized Twitter clone using best practices.
• ExtropyIO/defi-bot - Tutorial for building DeFi arbitrage bots.
• karmacoma-eth/sending-ether-cheat-sheet - Tips and best practices for sending Ether.
• LearnXInY - Learn Solidity in 15 mins (for experienced devs).
• manojpramesh/solidity-cheatsheet - Cheat sheet and best practices.
• Questbook - Questbook is building a University DAO where learning is always free. Starting with crypto-dev courses by leading devs.
• Solidity and Vyper cheat sheet - Review syntax of both languages side-by-side.
• topmonks/solidity_quick_ref - Syntax overview.
• willitscale/learning-solidity - Complete guide on getting started, creating your own crypto, ICOs and deployment.
• useweb3.xyz/tutorials - A curated list of free, community tutorials that are based around specific projects, tasks or challenges.

Articles

• Best Practices for Smart Contract Development (yos.io, Yos Riady, 2019) - Developer handbook for smart contract developers.
• Clean Contracts (wslyvh.com, Wesley van Heije, 2020) - Developer guide to writing clean smart contract code.
• The Complete Guide to Full Stack Ethereum Development (dev.to, Nader Dabit, 2021) - Building Full Stack dApps with React, Ethers.js, Solidity, and Hardhat.
• How to create an ERC20 Token and a Solidity Vendor Contract (medium.com, Emanuele Ricci, 2021) - Create your own ERC20 Token and a Token Vendor Contract that will handle the sell/buy process.
• soliditydeveloper.com/blog - Concepts, guides, design patterns and more.

Security

• Capture the Ether - Game in which you hack Ethereum smart contracts to learn about security.
• crytic/awesome-ethereum-security - Curated list of awesome Ethereum security references, guidance, tools, and more.
• crytic/building-secure-contracts - Guidelines and training material to write secure smart contracts.
• crytic/not-so-smart-contracts - Examples of common vulnerabilities, including code from real smart contracts.
• Crypto-Virus/cream-finance-exploit-example - Example implementation of the Cream Finance flashloan exploit.
• d-xo/weird-erc20 - Minimal example implementations of ERC20 tokens with surprising/unexpected behaviour.
• Ethereum Smart Contract Security Best Practices (Consensys) - General security philosophy, known attacks, and sample code.
• OriginProtocol/security - Materials related to security: docs, checklists, processes.
• Rari-Capital/security-checklist - Opinionated security and code quality checklist for smart contracts.
• securing/SCSVS - Smart Contract Security Verification Standard.
• sigp/solidity-security-blog - Comprehensive list of known attack vectors and common anti-patterns.

Audits

• Trail of Bits - Public security audits by the Trail of Bits Team.
• OpenZeppelin - Public security audits by the OpenZeppelin Security Team.
• Consensys Diligence - Public security audits by the Consensys Diligence Team.
• MixBytes - Public security audits by the MixBytes Team.

Examples

Educational

• cyrusadkisson/solidity-baby-steps - Comprehensive collection of contract examples.
• flashbots/simple-arbitrage - Example arbitrage bot using Flashbots.
• fravoll/solidity-patterns - A collection of patterns and best practices for smart contract development.
• libevm/subway - A practical example on how to perform sandwich attacks on Ethereum.
• lsaether/bonding-curves - Smart contracts for bonding curves (aka curve bonded tokens).
• kauri.io - Archive of kauri community's content created with the goal to foster the spread of Ethereum development knowledge far and wide.
• miguelmota/solidity-idiosyncrasies - Common gotchas, pitfalls, limitations, and idiosyncrasies.
• m1guelpf/lil-web3 - Simple, intentionally-limited versions of web3 protocols & apps.
• pedrobergamini/flashloaner-contract - Smart contracts that operate arbitrages between Sushiswap and Uniswap.
• raineorshine/solidity-by-example - A collection of short yet fully-functional contracts that demonstrate language features.
• Solidity By Example - An introduction to the language with simple examples.
• useWeb3 - Learn web3 development - A curated overview of the best and latest resources on Ethereum, Solidity and Web3 development.

Deployed on Ethereum Mainnet

• Abracadabra-money/magic-internet-money - Magic Internet Money (MIM) contracts.
• andrecronje/rarity - D20srd reference implementation.
• axieinfinity/ronin-smart-contracts - Axie Infinity Ronin contracts.
• bancorprotocol/contract-solidity - Bancor Protocol contracts.
• compound-finance/compound-protocol - Compound Protocol contracts.
• dharma-eng/dharma-smart-wallet - Smart wallet for earning interest on stablecoins while retaining custody of funds, with an added security backstop provided by Dharma Labs.
• ensdomains/ens-contracts - Ethereum Name Service (ENS) contracts.
• graphprotocol/contracts - Graph Protocol Contracts.
• OlympusDAO/olympus-contracts - OlympusDAO contracts.
• smartcontractkit/LinkToken - LINK token contracts for the Chainlink Network.
• sushiswap/kashi-lending - Kashi Lending platform contracts.
• sushiswap/sushiswap - Sushiswap smart contracts.
• Synthetixio/synthetix - Synthetix smart contracts.
• trusttoken/smart-contracts - TrustToken smart contracts.
• Uniswap/uniswap-v3-core - Core smart contracts of Uniswap v3.
• wyvernprotocol/wyvern-v3 - Core smart contracts for Wyvern v3, a decentralized digital asset exchange protocol.

Templates

• austintgriffith/scaffold-eth - Github template providing an Ethereum dev stack focused on fast product iterations.
• ethereum-boilerplate/ethereum-boilerplate - React components and hooks to build dApps fast without running your own backend.
• gakonst/dapptools-template - Forkable template to get you started with Dapp Tools.
• NodeFactoryIo/solidity-node-docker-starter - Github template with Docker containers for building dApps with Truffle and Node.js as backend server.
• paulrberg/solidity-template - Github template for writing contracts (uses: Hardhat, TypeChain, Ethers, Waffle, Solhint, Solcover, Prettier Plugin Solidity).
• rhlsthrm/typescript-solidity-dev-starter-kit - Starter kit for developing, testing, and deploying smart contracts with a full Typescript environment.
• tomhirst/solidity-nextjs-starter - A full-stack dApp starter built with Next.js (React).
• wighawag/template-ethereum-contracts - Template to develop smart contracts.
• ZumZoom/solidity-template - Hardhat template with preconfigured Github Actions and Coveralls support.

Books

• Blockchain in Action - Book that teaches the essential principles of blockchain and how to create your own decentralized apps.
• Mastering Ethereum - Mastering Ethereum is a book for developers, offering a guide to the operation and use of the Ethereum, Ethereum Classic, RootStock (RSK) and other compatible EVM-based open blockchains.

Practice

• ChainShot - Hands-on learning with challenging coding tutorials.
• OpenZeppelin/damn-vulnerable-defi - A set of challenges to hack implementations of DeFi in Ethereum.
• OpenZeppelin/ethernaut - Ethernaut is a Web3/Solidity based wargame to be played in the Ethereum Virtual Machine. Each level is a smart contract that needs to be 'hacked'.

Jobs

• cryptocurrencyjobs.co - Job board for blockchain and cryptocurrency jobs.
• cryptojobslist.com - Job board for blockchain and cryptocurrency jobs.
• web3.career - Job board for web3 jobs.

Libraries

• 0age/AttributeRegistry ERC-1616 Attribute Registry Standard - interface, tests and implementation.
• 0age/HomeWork - An autonomous utility for finding, sharing and reusing home addresses for contracts.
• 0age/Spawner - Spawn EIP 1167 minimal proxies with an included initialization step during contract creation.
• 0xcert/ethereum-erc721 - Non-fungible token implementation for Ethereum-based blockchains.
• alexvansande/ENSTools - A set of contracts to extend ENS functionality to other smart contracts.
• Arachnid/solidity-stringutils - Basic string utilities for Solidity.
• create-truffle-dapp - CLI to create and deploy Truffle projects with no configuration.
• dapp-bin - Ethereum repo providing implementations for many common data structures and utilities in Solidity, Serpent and LLL.
• dapp-scratch - CLI for generating javascript modules from Contracts for Decentralized Apps.
• dapphub/dappsys - Contract system framework for flexible multi-contract dapps.
• dapphub/dapptools - Command-line-friendly tools for blockchain development.
• dmihal/hardhat-interface-generator - Hardhat plugin to automatically generate interfaces from code.
• EthWorks/Waffle - Library for writing and testing smart contracts.
• gakonst/foundry - Blazing fast, portable and modular toolkit for Ethereum application development written in Rust.
• gelatodigital/auto-top-up - Automatically top up multiple ETH addresses once their ETH balance falls below a certain threshold.
• hifi-finance/prb-math - Smart contract library for advanced fixed-point math.
• ItsNickBarry/hardhat-abi-exporter - Export contract ABIs on compilation via Hardhat.
• instant-dapp-ide - Complete Dapp and Solidity development environment as a docker image you can run from command line.
• Keydonix/uniswap-oracle - General purpose price feed oracle built on Uniswap v2 that uses merkle proofs under the hood.
• makerdao/multicall - Aggregate multiple constant function call results into one.
• maple-labs/erc-20 - Maple implementation of the ERC-20 standard.
• mattdf/RingCrypto - Ring signature related implementations for Ethereum.
• mds1/solidity-trigonometry - Library with basic trigonometry functions.
• Modular Libraries - Deployed utility libraries to use in your smart contracts.
• mzhu25/sol2string - LibUintToString library for efficiently converting uint256 values to strings.
• OpenZeppelin - Framework to build secure smart contracts.
• OpenZeppelin/openzeppelin-contracts - A library for secure smart contract development.
• OpenZeppelin/openzeppelin-contracts-upgradeable - Upgradeable variant of OpenZeppelin Contracts, meant for use in upgradeable contracts.
• optionality/clone-factory - Simple clone contract factory. Install a master copy of a contract, then easily (cheaply) create clones with separate state.
• pcaversaccio/xdeployer - Hardhat plugin to deploy your smart contracts across multiple EVM chains with the same deterministic address.
• rugpullindex/indexed-sparse-merkle-tree - Dapptools-ready and gas-optimized implementation of a sparse merkle tree.
• Smart Contracts Skeleton - Preconfigured skeleton repository for building or starting with development of Smart contracts.
• solana-labs/solana-solidity.js - Compile, deploy, and use contracts on Solana.
• Solidity Collections - Collections of code snippets and utility libraries.
• Solidity Standard Library - Standard library (Array, random, math, string).
• solidstate-network/solidstate-solidity - Upgradeable-first smart contract development library.
• studydefi/money-legos - NPM package that provides you with the mainnet addresses, ABIs, and Solidity interfaces for popular DeFi protocols.
• Truffle - Development environment, testing framework and asset pipeline for Ethereum.
• truffle-assertions - Adds additional assertions and utilities used in testing smart contracts with truffle.
• Rari-Capital/solmate - Modern, opinionated and gas optimized building blocks for smart contract development.
• Uniswap/merkle-distributor - Smart contract that distributes a balance of tokens according to a merkle root.
• Uniswap/uniswap-v2-periphery - Peripheral smart contracts for interacting with Uniswap V2.
• Uniswap/uniswap-v3-periphery - Peripheral smart contracts for interacting with Uniswap V3.
• wbobeirne/eth-balance-checker - Smart contract and library pair that allows you to check for multiple ERC20 and Ether balances across multiple addresses in a single RPC call.
• weiroll/weiroll - A simple and efficient operation-chaining/scripting language for the EVM.

Tools

General

• Anish-Agnihotri/MultiFaucet - MultiFaucet drips ETH, tokens, and NFTs across many testnet networks, at once.
• Cryptofex - Standalone IDE and compiler.
• dethcrypto/ethereum-code-viewer - View the source of deployed Ethereum contracts in VSCode.
• EthFiddle - Find, share and embed contracts.
• eth-brownie/brownie - Python-based development and testing framework for smart contracts targeting the Ethereum Virtual Machine.
• Hardhat - Development environment to compile, deploy, test, and debug your Ethereum software.
• Remix - Online realtime compiler and runtime.
• EthereumStudio - Standalone desktop IDE.
• raineorshine/solidity-repl - REPL CLI.
• SIF - Code generation from the AST, analyse and instrument source code.
• Smart Contract Sanctuary - A home for ethereum smart contracts, all verified smart contracts from Etherscan.
• naddison36/sol2uml - Unified Modeling Language (UML) class diagram generator for smart contracts.
• solgraph - Visualize control flows for smart contract security analysis.
• sol-merger - Merges all imports into single file for contracts.
• solidity-docgen - Documentation generator for Solidity projects.
• Tenderly - Easily monitor your smart contracts with error tracking, alerting, performance metrics, and detailed contract analytics.
• tintinweb/solidity-shell - An interactive Solidity shell with lightweight session recording.
• Laika - Make requests to smart contracts without the hassle of writing a single line of code.

Utility

• Aniket-Engg/sol-profiler - CLI tool to list & store solidity smart contract methods attributes.
• Aniket-Engg/sol-verifier - Verify solidity smart contracts on Etherscan.
• cleanunicorn/abi2signature - Use the ABI of a smart contract to find out the function signatures.
• crytic/solc-select - CLI to quickly switch between compiler versions.
• duaraghav8/Ethlint - Linter to identify and fix style & security issues in Solidity smart contracts.
• prettier-solidity/prettier-plugin-solidity - Prettier plugin for automatically formatting your code.
• protofire/solhint - Solidity linter that provides security, style guide and best practice rules for smart contract validation.
• rkalis/truffle-plugin-verify - Truffle plugin to verify smart contracts on Etherscan from the Truffle command line.
• sambacha/prettier-config-solidity - Prettier config optimized to reduce AST churn & conform to the Solidity spec.
• sc-forks/solidity-coverage - Code coverage tool.
• Tenderly/tenderly-cli - Speed up your development with error stack traces.
• tintinweb/solgrep - A scriptable semantic grep utility for Solidity.

Audit

• Echidna - Define properties for your smart contract then use fuzzing to catch security bugs.
• Manticore - Detects many common bug types, and can prove correctness properties with symbolic execution.
• Mythril - Security analysis tool for smart contracts.
• ethereum/sourcify - Re-compiler that can be used to verify that bytecode corresponds to certain source code.
• eth-sri/securify2 - Tool for analyzing smart contracts for vulnerabilities and insecure coding.
• Slither - Static analyzer with support for many common bug types, including visualization tools for security-relevant information.
• MythX - Detection for security vulnerabilities in Ethereum smart contracts throughout the development life cycle

DevOps

• Embark - Framework that allows you to easily develop and deploy DApps.
• Moesif - Service that provides Ethereum smart contract analytics and anomaly detection for DApps and DAPIs.

Languages

JavaScript

• deno-web3/solc - Solidity bindings for Deno.
• solc-js - JavaScript bindings for the Solidity compiler.
• solidity-parser - Solidity parser built in JavaScript.
• sulk - Configurable contract compilation.

TypeScript

• Soltsice - Generates strongly-typed TypeScript classes for contracts from Truffle artifacts with a single command.
• TypeChain - TypeScript bindings for Ethereum smart contracts.

Rust

• hyperledger-labs/solang - A Solidity-to-WASM-and-BPF compiler written in Rust.
• rust-ethereum/ethabi -Encode and decode smart contract invocations.

OCaml

• ocaml-solidity - OCaml library providing a parser, a typechecker and miscellaneous utilities for manipulating contracts.

Editor Plugins

Atom

• autocomplete-solidity - Parses Solidity files to give you contextual autocomplete suggestions.
• Etheratom - Compile and deploy Solidity code from atom editor.
• language-ethereum - Adds syntax highlighting and snippets to Solidity and Serpent files in Atom.
• linter-solidity - Linter.

Eclipse

• uml2solidity - Model smart contracts with UML.

Emacs

• emacs-solidity - Solidity mode for Emacs.
• company-solidity - Autocomplete with company-mode.

IntelliJ

• intellij-solidity - Solidity plugin for IntelliJ.

Sublime

• SublimeEthereum - Solidity syntax for SublimeText.

Vim

• solidity.vim - Vim compiler plugin.
• vim-solidity - Vim syntax file.

Visual Studio Code

👉 For a comprehensive list, see results for "Solidity" on Visual Studio Marketplace.

• sol-profiler-vscode - Visual Code Extension to generate & store smart contract methods profile.
• vscode-solidity - Visual Studio Code language support extension.
• Solidity Visual Developer - Visual Security audit, Security centric syntax and semantic highlighting, detailed class outline, UML diagram generator, and many more features.
• Solidity Contract Flattener - Flatten Solidity Contracts using truffle-flattener
• Ethereum Security Bundle - A meta-extension bundling marketplace plugins for secure Ethereum smart contract development.

---

License

To the extent possible under law, Ben Kremer has waived all copyright and related or neighboring rights to this work.