https://github.com/looksrare/contracts-exchange-v2
LooksRare exchange contracts (v2)
https://github.com/looksrare/contracts-exchange-v2
ethereum looksrare nft solidity
Last synced: about 2 months ago
JSON representation
LooksRare exchange contracts (v2)
- Host: GitHub
- URL: https://github.com/looksrare/contracts-exchange-v2
- Owner: LooksRare
- License: mit
- Created: 2022-06-08T03:02:00.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-10-16T15:13:11.000Z (over 1 year ago)
- Last Synced: 2025-04-13T07:53:04.676Z (about 2 months ago)
- Topics: ethereum, looksrare, nft, solidity
- Language: Solidity
- Homepage:
- Size: 1.95 MB
- Stars: 10
- Watchers: 4
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# @looksrare/contracts-exchange-v2
[](https://github.com/LooksRare/contracts-exchange-v2/actions/workflows/tests.yaml)
[](https://opensource.org/licenses/MIT)
[](https://github.com/LooksRare/sdk-v2)
## Description
This project contains core smart contracts used for the LooksRare exchange protocol ("v2").
It also contains a peripheral contract (`OrderValidatorV2A`) that is used to verify the validity of (maker) orders.
## Installation
```shell
# Yarn
yarn add @looksrare/contracts-exchange-v2
# NPM
npm install @looksrare/contracts-exchange-v2
```
## Deployments
| Network | LooksRareProtocol | TransferManager | OrderV2AValidator |
| :------- | :--------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
| Ethereum | [0x0000000000E655fAe4d56241588680F86E3b2377](https://etherscan.io/address/0x0000000000E655fAe4d56241588680F86E3b2377#code) | [0x000000000060C4Ca14CfC4325359062ace33Fe3D](https://etherscan.io/address/0x000000000060C4Ca14CfC4325359062ace33Fe3D#code) | [0x2a784a5b5C8AE0bd738FBc67E4C069dB4F4961B7](https://etherscan.io/address/0x2a784a5b5C8AE0bd738FBc67E4C069dB4F4961B7#code) |
| Goerli | [0x35C2215F2FFe8917B06454eEEaba189877F200cf](https://goerli.etherscan.io/address/0x35C2215F2FFe8917B06454eEEaba189877F200cf#code) | [0xC20E0CeAD98abBBEb626B77efb8Dc1E5D781f90c](https://goerli.etherscan.io/address/0xC20E0CeAD98abBBEb626B77efb8Dc1E5D781f90c#code) | [0x7454Cc9AEB024bcE6A2CDC49ad4733B4D8215fb8](https://goerli.etherscan.io/address/0x7454Cc9AEB024bcE6A2CDC49ad4733B4D8215fb8#code) |
| Sepolia | [0x34098cc15a8a48Da9d3f31CC0F63F01f9aa3D9F3](https://sepolia.etherscan.io/address/0x34098cc15a8a48Da9d3f31CC0F63F01f9aa3D9F3#code) | [0xb46f116ecBa8451E661189F4b2B63aC60a618092](https://sepolia.etherscan.io/address/0xb46f116ecBa8451E661189F4b2B63aC60a618092#code) | [0x0bc129E4c1f8D7b5583eAbAeb1F7468935B6ec0C](https://sepolia.etherscan.io/address/0x0bc129E4c1f8D7b5583eAbAeb1F7468935B6ec0C#code) |
## NPM package
The NPM package contains the following:
- Solidity smart contracts (_".sol"_)
- ABIs (_".json"_)
ABIs are also distributed in the `@looksrare/sdk-v2` package.
## Documentation
The documentation for the exchange smart contracts will be available [here](https://docs.looksrare.org/developers/welcome).
## Architecture
## Setup
- Run `yarn`
- Install [Forge](https://book.getfoundry.sh/getting-started/installation.html)
- Run `forge update`
- Run `git submodule update`
## About this repo
### Structure
It is a hybrid [Hardhat](https://hardhat.org/) repo that also requires [Foundry](https://book.getfoundry.sh/index.html) to run Solidity tests powered by the [ds-test library](https://github.com/dapphub/ds-test/).
> To install Foundry, please follow the instructions [here](https://book.getfoundry.sh/getting-started/installation.html).
### Run tests
- Solidity tests are included in the `foundry` folder in the `test` folder at the root of the repo.
### Example of Foundry/Forge commands
```shell
forge build
forge test
forge test -vv
forge tree
```
### Example of shell commands
```shell
npx eslint '**/*.{js,ts}'
npx eslint '**/*.{js,ts}' --fix
npx prettier '**/*.{json,sol,md}' --check
npx prettier '**/*.{json,sol,md}' --write
npx solhint 'contracts/**/*.sol'
npx solhint 'contracts/**/*.sol' --fix
```
### Coverage
It is required to install lcov.
```shell
brew install lcov
```
To run the coverage report, the below command can be executed.
```
forge coverage --report lcov
LCOV_EXCLUDE=("test/*" "contracts/libraries/*" "contracts/helpers/ProtocolHelpers.sol")
echo $LCOV_EXCLUDE | xargs lcov --output-file lcov-filtered.info --remove lcov.info
genhtml lcov-filtered.info --output-directory out
open out/index.html
```