npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

solady

v0.0.287

Published

Optimized Solidity snippets.

Downloads

103,698

Readme

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
├─ 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"
├─ ERC7821 — "Minimal batch executor mixin"
├─ LibERC6551 — "Library for interacting with ERC6551 accounts"
├─ LibERC7579 — "Library for handling ERC7579 mode and execution data"
├─ Receiver — "Receiver mixin for ETH and safe-transferred ERC721 and ERC1155 tokens"
├─ Timelock — "Simple timelock"
auth
├─ EnumerableRoles — "Enumerable multiroles authorization mixin"
├─ Ownable — "Simple single owner authorization mixin"
├─ OwnableRoles — "Simple single owner and multiroles authorization mixin"
├─ TimedRoles — "Timed multiroles authorization mixin"
tokens
├─ ERC1155 — "Simple ERC1155 implementation"
├─ ERC20 — "Simple ERC20 + EIP-2612 implementation"
├─ ERC20Votes — "ERC20 with votes based on ERC5805 and ERC6372"
├─ ERC2981 — "Simple ERC2981 NFT Royalty Standard implementation"
├─ ERC4626 — "Simple ERC4626 tokenized Vault implementation"
├─ ERC6909 — "Simple EIP-6909 minimal multi-token implementation"
├─ ERC721 — "Simple ERC721 implementation with storage hitchhiking"
├─ WETH — "Simple Wrapped Ether implementation"
utils
├─ Base64 — "Library for Base64 encoding and decoding"
├─ CREATE3 — "Deterministic deployments agnostic to the initialization code"
├─ DateTimeLib — "Library for date time operations"
├─ DeploylessPredeployQueryer — "Deployless queryer for predeploys"
├─ DynamicArrayLib — "Library for memory arrays with automatic capacity resizing"
├─ DynamicBufferLib — "Library for buffers with automatic capacity resizing"
├─ ECDSA — "Library for verification of ECDSA signatures"
├─ EIP712 — "Contract for EIP-712 typed structured data hashing and signing"
├─ ERC1967Factory — "Factory for deploying and managing ERC1967 proxy contracts"
├─ ERC1967FactoryConstants — "The address and bytecode of the canonical ERC1967Factory"
├─ EfficientHashLib — "Library for efficiently performing keccak256 hashes"
├─ EnumerableMapLib — "Library for managing enumerable maps in storage"
├─ EnumerableSetLib — "Library for managing enumerable sets in storage"
├─ FixedPointMathLib — "Arithmetic library with operations for fixed-point numbers"
├─ GasBurnerLib — "Library for burning gas without reverting"
├─ Initializable — "Initializable mixin for the upgradeable contracts"
├─ JSONParserLib — "Library for parsing JSONs"
├─ LibBit — "Library for bit twiddling and boolean operations"
├─ LibBitmap — "Library for storage of packed booleans"
├─ LibClone — "Minimal proxy library"
├─ LibMap — "Library for storage of packed unsigned integers"
├─ LibPRNG — "Library for generating pseudorandom numbers"
├─ LibRLP — "Library for RLP encoding and CREATE address computation"
├─ LibSort — "Library for efficient sorting of memory arrays"
├─ LibString — "Library for converting numbers into strings and other string operations"
├─ LibZip — "Library for compressing and decompressing bytes"
├─ Lifebuoy — "Class that allows for rescue of ETH, ERC20, ERC721 tokens"
├─ MerkleProofLib — "Library for verification of Merkle proofs"
├─ MetadataReaderLib — "Library for reading contract metadata robustly"
├─ MinHeapLib — "Library for managing a min-heap in storage or memory"
├─ Multicallable — "Contract that enables a single call to call multiple methods on itself"
├─ P256 — "Gas optimized P256 wrapper"
├─ RedBlackTreeLib — "Library for managing a red-black-tree in storage"
├─ ReentrancyGuard — "Reentrancy guard mixin"
├─ SSTORE2 — "Library for cheaper reads and writes to persistent storage"
├─ SafeCastLib — "Library for integer casting that reverts on overflow"
├─ SafeTransferLib — "Safe ERC20/ETH transfer lib that handles missing return values"
├─ SignatureCheckerLib — "Library for verification of ECDSA and ERC1271 signatures"
├─ UUPSUpgradeable — "UUPS proxy mixin"
├─ UpgradeableBeacon — "Upgradeable beacon for ERC1967 beacon proxies"
├─ WebAuthn — "WebAuthn helper"
├─ legacy — "Legacy support"
└─ ext — "Utilities for external protocols"

Directories

src — "Solidity smart contracts"
test — "Foundry Forge tests"
js — "Accompanying JavaScript helper library"
ext — "Extra tests"
prep — "Preprocessing scripts"
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: