https://github.com/0xsequence/contracts-library
Sequence Contracts Standard Library for ERC20, ERC721, ERC1155
https://github.com/0xsequence/contracts-library
Last synced: 12 months ago
JSON representation
Sequence Contracts Standard Library for ERC20, ERC721, ERC1155
- Host: GitHub
- URL: https://github.com/0xsequence/contracts-library
- Owner: 0xsequence
- License: other
- Created: 2023-04-25T19:57:16.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-06-15T19:39:16.000Z (12 months ago)
- Last Synced: 2025-06-15T21:12:39.575Z (12 months ago)
- Language: Solidity
- Homepage:
- Size: 1.66 MB
- Stars: 8
- Watchers: 16
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Audit: audits/2023-12-20-Quantstamp.pdf
Awesome Lists containing this project
README
# Sequence Contracts Library
This repository provides a set of smart contracts to facilitate the creation and management of contracts deployable on EVM compatible chains, including ERC20, ERC721, and ERC1155 token standards. These contracts are designed for gas efficiency and reuse via proxy deployments.
## Features
Base and preset **implementations of common token standards**:
- ERC-20
- ERC-721
- ERC-1155
**Common token functionality**, such as the `ERC2981-Controlled` contract which provides a way to handle royalties in NFTs.
**Proxy** contracts and factories implementing ERC-1967 and with upgradeability.
## Usage
### Installation
Clone the repository, including git submodules.
Install dependencies with `yarn`.
Compile the contracts with `yarn build`.
### Testing
Run tests with `yarn test`.
Run coverage report with `yarn coverage`. View coverage report with `genhtml -o report --branch-coverage --ignore-errors category lcov.info && py -m http.server`. Viewing the report with this command requires Python to be installed.
Compare gas usage with `yarn snapshot:compare`. Note as some test use random values, the gas usage may vary slightly between runs.
### Deployment
Copy `.env.example` to `.env` and set your wallet configuration.
```sh
cp .env.example .env
```
Then run the deployment script.
```sh
yarn deploy --rpc-url $RPC_URL --broadcast
```
## Dependencies
The contracts in this repository are built with Solidity ^0.8.19 and use 0xSequence, OpenZeppelin and Solady contracts for standards implementation and additional functionalities such as access control.
## Audits
The contracts in this repository have been audited by [Quantstamp](https://quantstamp.com). Audit reports are available in the [audits](./audits) folder.
## License
All contracts in this repository are released under the Apache-2.0 license.