Seaport is a marketplace protocol for safely and efficiently buying and selling NFTs. Each order lists the items the offerer will give (the offer) and the items that must be received in return, along with who receives them (the consideration).
This repository holds Seaport's tests, reference implementation, helper contracts, and docs. The core contracts live in seaport-core and the shared types in seaport-types. seaport-sol has Solidity helpers for building orders, and seaport-js is the JavaScript SDK.
Seaport 1.6 is at 0x0000000000000068F116a894984e2DB1123eB395 and the ConduitController at 0x00000000F9490004C11Cef243f5400493c00Ad63, at the same address on every chain where they are deployed. docs/Deployments.md lists the chains, earlier versions, and helper contracts. docs/Deploying.md covers deploying to a new chain.
- Seaport documentation: orders, fulfillment, and conduits
- Zones
- Order validator
- Function signatures
- Diagrams
- Development: building, testing, and linting
- Seaport 1.7 candidates
- OpenSea developer docs
git clone --recurse-submodules https://github.com/ProjectOpenSea/seaport && cd seaport
FOUNDRY_PROFILE=reference forge build
FOUNDRY_PROFILE=optimized forge build
FOUNDRY_PROFILE=test forge testThis needs Foundry v1.9.0. docs/Development.md covers coverage and linting.
These are the public reports on Seaport:
- Trail of Bits reviewed Seaport 1.0 from April 18 to May 12, 2022 and found no significant flaws. Report.
- Code4rena ran a public contest on Seaport 1.0 in May and June 2022. The high and medium findings were fixed in Seaport 1.1. Report.
- Spearbit reviewed Seaport 1.2 in December 2022. Report.
- Code4rena ran a public contest on Seaport 1.2 from January 13 to January 23, 2023. Report.
Report security issues through Bugcrowd, not in public issues or PRs.
Contributions are welcome, especially tests, docs, and readability. A PR should pass CI and keep reference/ in step with any contract change. The deployed Seaport 1.6 bytecode doesn't change, so ideas that would change it go in docs/Seaport-1.7-candidates.md.
MIT Copyright 2023 Ozone Networks, Inc.