Skip to content

PaulRBerg/prb-contracts

Repository files navigation

PRBContracts GitHub Actions Foundry License: MIT

Off-the-shelf Solidity smart contracts.

  • Designed for Solidity >=0.8.4
  • Uses custom errors instead of revert reason strings
  • Complementary to OpenZeppelin's library
  • Well-documented via NatSpec comments
  • Thoroughly tested with Foundry

I initially created this library to streamline my personal workflow, as I was tired of having to maintain identical contracts across multiple repositories. However, if you find this library beneficial to your own projects, that's a win-win situation for both of us.

Install

Foundry

First, run the install step:

forge install --no-commit PaulRBerg/prb-contracts@v5

Your .gitmodules file should now contain the following entry:

[submodule "lib/prb-contracts"]
  branch = "v5"
  path = "lib/prb-contracts"
  url = "https://github.com/PaulRBerg/prb-contracts"

Finally, add this to your remappings.txt file:

@prb/contracts/=lib/prb-contracts/src/

Hardhat

pnpm add @prb/contracts

Usage

Once installed, you can use the contracts like this:

// SPDX-License-Identifier: MIT
pragma solidity >=0.8.4;

import { ERC20 } from "@prb/contracts/token/erc20/ERC20.sol";
import { ERC20Permit } from "@prb/contracts/token/erc20/ERC20Permit.sol";

contract MyToken is ERC20, ERC20Permit {
  constructor(string memory name_, string memory symbol_, uint8 decimals_) ERC20Permit(name_, symbol_, decimals_) {}
}

Contributing

Feel free to dive in! Open an issue, start a discussion or submit a PR.

Pre Requisites

You will need the following software on your machine:

In addition, familiarity with Solidity is requisite.

Set Up

Clone this repository including submodules:

$ git clone --recurse-submodules -j8 git@github.com:PaulRBerg/prb-contracts.git

Then, inside the project's directory, run this to install the Node.js dependencies:

$ pnpm install

Now you can start making changes.

Syntax Highlighting

You will need the following VSCode extensions:

Security

While I have strict standards for code quality and test coverage, it's important to note that this project may not be entirely risk-free. Although I have taken measures to ensure the security of the contracts, they have not yet been audited by a third-party security researcher.

Caveat Emptor

Please be aware that this software is experimental and is provided on an "as is" and "as available" basis. I do not offer any warranties, and I cannot be held responsible for any direct or indirect loss resulting from the continued use of this codebase.

Contact

If you discover any bugs or security issues, please report them via Telegram.

Related Efforts

License

This project is licensed under MIT.