@looksrare/contracts-aggregator

This repo contains an aggregator smart contract system that allows NFT sweepers to buy NFTs from multiple sources in a single transaction (LooksRare, Seaport, X2Y2, Sudoswap, etc).

About this repo

Structure

It is a hybrid Hardhat repo that also requires Foundry to run Solidity tests powered by the ds-test library.

To install Foundry, please follow the instructions here.

Architecture

• LooksRareAggregator is the entrypoint for a batch transaction with orders paid only in ETH. Clients should submit a list of trade data for different marketplaces to the aggregator.

• ERC20EnabledLooksRareAggregator is the entrypoint for a batch transaction with orders paid in ERC20 tokens. Clients should submit a list of trade data for different marketplaces to the aggregator. The purpose of this aggregator is to prevent malicious proxies from stealing client funds since ERC20 approvals are not given to LooksRareAggregator.

• The proxies folder contains the proxy contracts for each marketplace. All proxies should be named in the format of ${Marketplace}Proxy and inherit from the interface IProxy.

• The libraries folder contains various structs and enums required. Objects that are specific to a marketplace should be put inside the ${marketplace} child folder.

• In order to create more realistic tests, real listings from real collections are fetched from each marketplace.

• Any contract that's prefixed with V0 will not go live. They come from our first iteration. We are only keeping them for now for reference.

Run tests

• TypeScript tests are included in the typescript folder in the test folder at the root of the repo.
• Solidity tests are included in the foundry folder in the test folder at the root of the repo.

In order to speed up build time without running into the notorious "stack too deep" issue, use the local Foundry profile to run the tests.

FOUNDRY_PROFILE=local forge test

Gas benchmark

forge test --match-contract GemSwapBenchmarkTest
forge test --match-contract LooksRareProxyBenchmarkTest
forge test --match-contract SeaportProxyBenchmarkTest

Static analysis

pip3 install slither-analyzer
pip3 install solc-select
solc-select install 0.8.17
solc-select use 0.8.17
slither --solc solc-0.8.17 .

Coverage

forge coverage --report lcov
LCOV_EXCLUDE=("test/*" "contracts/prototype/*")
echo $LCOV_EXCLUDE | xargs lcov --output-file lcov-filtered.info --remove lcov.info
genhtml lcov-filtered.info --output-directory out
open out/index.html