Git Product home page Git Product logo

solady's Introduction

solady

NPM CI Solidity

Gas optimized Solidity snippets.

I'm sooooooOooooooooOoooOoooooooooooooooo...

Installation

To install with Foundry:

forge install vectorized/solady

To install with Hardhat:

npm install solady

Contracts

The Solidity smart contracts are located in the src directory.

accounts
├─ Receiver"Receiver mixin for ETH and safe-transferred ERC721 and ERC1155 tokens"
├─ ERC1271"ERC1271 mixin with nested EIP-712 approach"
├─ ERC4337"Simple ERC4337 account implementation"
├─ ERC4337Factory"Simple ERC4337 account factory implementation"
├─ ERC6551"Simple ERC6551 account implementation"
├─ ERC6551Proxy"Relay proxy for upgradeable ERC6551 accounts"
├─ LibERC6551"Library for interacting with ERC6551 accounts"
auth
├─ Ownable"Simple single owner authorization mixin"
├─ OwnableRoles"Simple single owner and multiroles authorization mixin"
tokens
├─ WETH"Simple Wrapped Ether implementation"
├─ ERC20"Simple ERC20 + EIP-2612 implementation"
├─ ERC4626"Simple ERC4626 tokenized Vault implementation"
├─ ERC721"Simple ERC721 implementation with storage hitchhiking"
├─ ERC2981"Simple ERC2981 NFT Royalty Standard implementation"
├─ ERC1155"Simple ERC1155 implementation"
├─ ERC6909"Simple EIP-6909 minimal multi-token implementation"
utils
├─ MerkleProofLib"Library for verification of Merkle proofs"
├─ SignatureCheckerLib"Library for verification of ECDSA and ERC1271 signatures"
├─ ECDSA"Library for verification of ECDSA signatures"
├─ EIP712"Contract for EIP-712 typed structured data hashing and signing"
├─ DeploylessPredeployQueryer"Deployless queryer for predeploys"
├─ ERC1967Factory"Factory for deploying and managing ERC1967 proxy contracts"
├─ ERC1967FactoryConstants"The address and bytecode of the canonical ERC1967Factory"
├─ JSONParserLib"Library for parsing JSONs"
├─ LibSort"Library for efficient sorting of memory arrays"
├─ LibPRNG"Library for generating pseudorandom numbers"
├─ Base64"Library for Base64 encoding and decoding"
├─ SSTORE2"Library for cheaper reads and writes to persistent storage"
├─ CREATE3"Deploy to deterministic addresses without an initcode factor"
├─ LibRLP"Library for computing contract addresses from their deployer and nonce"
├─ LibBit"Library for bit twiddling and boolean operations"
├─ LibZip"Library for compressing and decompressing bytes"
├─ Clone"Class with helper read functions for clone with immutable args"
├─ LibClone"Minimal proxy library"
├─ Initializable"Initializable mixin for the upgradeable contracts"
├─ UUPSUpgradeable"UUPS proxy mixin"
├─ LibString"Library for converting numbers into strings and other string operations"
├─ LibBitmap"Library for storage of packed booleans"
├─ LibMap"Library for storage of packed unsigned integers"
├─ EnumerableSetLib"Library for managing enumerable sets in storage"
├─ MinHeapLib"Library for managing a min-heap in storage or memory"
├─ RedBlackTreeLib"Library for managing a red-black-tree in storage"
├─ ReentrancyGuard"Reentrancy guard mixin"
├─ Multicallable"Contract that enables a single call to call multiple methods on itself"
├─ GasBurnerLib"Library for burning gas without reverting"
├─ SafeTransferLib"Safe ERC20/ETH transfer lib that handles missing return values"
├─ DynamicBufferLib"Library for buffers with automatic capacity resizing"
├─ MetadataReaderLib"Library for reading contract metadata robustly"
├─ FixedPointMathLib"Arithmetic library with operations for fixed-point numbers"
├─ SafeCastLib"Library for integer casting that reverts on overflow"
└─ DateTimeLib"Library for date time operations"

Directories

src — "Solidity smart contracts"
test — "Foundry Forge tests"
js — "Accompanying JavaScript helper library"
ext — "Extra tests"
audits — "Audit reports"

Contributing

This repository serves as a laboratory for cutting edge snippets that may be merged into Solmate.

Feel free to make a pull request.

Do refer to the contribution guidelines for more details.

Safety

This is experimental software and is provided on an "as is" and "as available" basis.

We do not give any warranties and will not be liable for any loss incurred through any use of this codebase.

While Solady has been heavily tested, there may be parts that may exhibit unexpected emergent behavior when used with other code, or may break in future Solidity versions.

Please always include your own thorough tests when using Solady to make sure it works correctly with your code.

Upgradability

Most contracts in Solady are compatible with both upgradeable and non-upgradeable (i.e. regular) contracts.

Please call any required internal initialization methods accordingly.

EVM Compatibility

Some parts of Solady may not be compatible with chains with partial EVM equivalence.

Please always check and test for compatibility accordingly.

Acknowledgements

This repository is inspired by or directly modified from many sources, primarily:

solady's People

Contributors

vectorized avatar atarpara avatar z0r0z avatar jtriley-eth avatar zerosnacks avatar de33 avatar jorgeatpaladin avatar kadenzipfel avatar rogerpodacter avatar outdoteth avatar pcaversaccio avatar 0xkitetsu-dinesh avatar 0xth0mas avatar 8times4 avatar romeroadrian avatar adhusson avatar bizzyvinci avatar colinplatt avatar danipopes avatar 0xbrito avatar eugenioclrc avatar mdehoog avatar philogy avatar sennett-lau avatar mswat5 avatar sevenswen avatar chlwys avatar banteg avatar devtooligan avatar engn33r avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.