From 39f826cadc73be5fe0ddb28bcf2eecd59f101d5d Mon Sep 17 00:00:00 2001 From: Ryan Ghods Date: Sun, 8 Nov 2026 22:19:53 -0800 Subject: [PATCH 1/5] Replace the PNG diagram with Mermaid and refresh the docs Co-Authored-By: Claude Opus 5.5 --- README.md | 15 ++++++++++++--- docs/SeaDropTokenDeployment.md | 6 +++--- img/seadrop-diagram.png | Bin 131192 -> 0 bytes 3 files changed, 15 insertions(+), 6 deletions(-) delete mode 100644 img/seadrop-diagram.png diff --git a/README.md b/README.md index 785e79b1..973369cd 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ SeaDrop is a contract for conducting primary NFT drops on evm-compatible blockch SeaDrop is a contract to perform primary drops on evm-compatible blockchains. The types of drops supported are public drops, allow list stages, token gated drops, and server-side signed mints. An implementing token contract should contain the methods to interface with `SeaDrop` through an authorized user such as an Owner or Administrator. -Future SeaDrop contracts are envisioned to contain additional functionality like descending dutch auction mechanisms and payment in ERC20 tokens. +[SeaDrop v2](https://github.com/ProjectOpenSea/seadrop/tree/v2) adds ERC-1155 tokens, ERC-20 payments and several public stages per token. ## Deployments @@ -39,9 +39,18 @@ See [Deployments](docs/Deployments.md) for the clone factories, every network, a ## Diagram -![SeaDrop Diagram](img/seadrop-diagram.png) +```mermaid +flowchart LR + creator([Creator]) -->|"updatePublicDrop(), updateSignedMintValidationParams(),
multiConfigure() and other settings"| token["ERC721SeaDrop token"] + token -->|"forwards drop settings"| seadrop["SeaDrop"] + minter([Minter]) -->|"mintPublic(), mintSigned(),
mintAllowList() or mintAllowedTokenHolder()
with payment"| seadrop + seadrop -->|"mintSeaDrop(minter, quantity)"| token + seadrop -->|"fee"| fee["Fee recipient"] + seadrop -->|"rest of the payment"| payout["Creator payout address"] + seadrop -.->|"events"| indexer["Indexers such as OpenSea"] +``` -This diagram shows the logic flow in the case that a drop is hosted on OpenSea, with an optional mint hosted elsewhere. Note that a fee recipient is not required to integrate with SeaDrop, and a fee recipient may be any address. +The creator configures a drop by calling the token, which forwards the settings to `SeaDrop`. A minter calls `SeaDrop` with the payment. `SeaDrop` checks the stage, the wallet limit and the max supply, pays the fee recipient and the creator's payout address, and calls `mintSeaDrop` on the token. The fee recipient can be any address the token allows, and drops don't need one. ## Docs diff --git a/docs/SeaDropTokenDeployment.md b/docs/SeaDropTokenDeployment.md index 3a866e05..142e37ec 100644 --- a/docs/SeaDropTokenDeployment.md +++ b/docs/SeaDropTokenDeployment.md @@ -2,12 +2,12 @@ An example script to deploy a token contract is located at [DeployAndConfigureExampleToken.s.sol](../script/DeployAndConfigureExampleToken.s.sol). It can be run with `forge script script/DeployAndConfigureExampleToken.s.sol --rpc-url ${RPC_URL} --broadcast -vvvv --private-key ${PK} --etherscan-api-key ${ETHERSCAN_API_KEY} --verify --retries 10` -### ERC721SeaDrop +## ERC721SeaDrop `ERC721SeaDrop` contains only an Owner role (assigned to the deployer of the contract) that has authorization for all methods. 1. Deploy `src/ERC721SeaDrop.sol` with constructor args `string name, string symbol, address[] allowedSeaDrop` - 1. e.g. `forge create --rpc-url ${RPC_URL} src/ERC721SeaDrop.sol:ERC721SeaDrop --constructor-args "TokenTest1" "TEST1" \[${SEADROP_ADDRESS}\] --private-key ${PK} --etherscan-api-key ${ETHERSCAN_API_KEY} --verify` + 1. e.g. `forge create --rpc-url ${RPC_URL} src/ERC721SeaDrop.sol:ERC721SeaDrop --constructor-args "TokenTest1" "TEST1" \[${SEADROP_ADDRESS}\] --private-key ${PK} --broadcast --etherscan-api-key ${ETHERSCAN_API_KEY} --verify` 1. Set the token max supply with `token.setMaxSupply()` 1. Set the creator payout address with `token.updateCreatorPayoutAddress()` 1. Set the contract URI with `token.setContractURI()` @@ -26,7 +26,7 @@ An example script to deploy a token contract is located at [DeployAndConfigureEx ### Format of Drop URI -Follows the pattern of `tokenURI` — could be either on-chain data blob or external URI (IPFS) — that contains the metadata related to the drop and corresponding drop stages. +Like `tokenURI`, the drop URI points to the drop's metadata and its stages, either as onchain data or as an external URI such as IPFS. #### Example diff --git a/img/seadrop-diagram.png b/img/seadrop-diagram.png deleted file mode 100644 index 5126a67f59a7d39210795544c7b615259ef8ece1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 131192 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ΝDF~wKbw{o5!U;t2OP6TULhsC4%NFajjE9!HBdo9$xtRoNM7kHSQ;f zK(0NpNth0~s+8`5O^|3gjV4xz7SbOTrr0^20L z$Fx3!G?4zRuzUk+BE*ZrfddiK%}mPE97W<2 z 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 Date: Sun, 8 Nov 2026 22:20:38 -0800 Subject: [PATCH 2/5] Shorten the diagram labels Co-Authored-By: Claude Opus 5.5 --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 973369cd..8cc4bba0 100644 --- a/README.md +++ b/README.md @@ -41,16 +41,16 @@ See [Deployments](docs/Deployments.md) for the clone factories, every network, a ```mermaid flowchart LR - creator([Creator]) -->|"updatePublicDrop(), updateSignedMintValidationParams(),
multiConfigure() and other settings"| token["ERC721SeaDrop token"] - token -->|"forwards drop settings"| seadrop["SeaDrop"] - minter([Minter]) -->|"mintPublic(), mintSigned(),
mintAllowList() or mintAllowedTokenHolder()
with payment"| seadrop - seadrop -->|"mintSeaDrop(minter, quantity)"| token + creator([Creator]) -->|"drop settings"| token["ERC721SeaDrop
token"] + token -->|"forwards settings"| seadrop["SeaDrop"] + minter([Minter]) -->|"mint + payment"| seadrop + seadrop -->|"mintSeaDrop()"| token seadrop -->|"fee"| fee["Fee recipient"] - seadrop -->|"rest of the payment"| payout["Creator payout address"] - seadrop -.->|"events"| indexer["Indexers such as OpenSea"] + seadrop -->|"payout"| payout["Creator payout
address"] + seadrop -.->|"events"| indexer["Indexers"] ``` -The creator configures a drop by calling the token, which forwards the settings to `SeaDrop`. A minter calls `SeaDrop` with the payment. `SeaDrop` checks the stage, the wallet limit and the max supply, pays the fee recipient and the creator's payout address, and calls `mintSeaDrop` on the token. The fee recipient can be any address the token allows, and drops don't need one. +The creator configures a drop by calling the token, for example `updatePublicDrop()` or `multiConfigure()`, and the token forwards the settings to `SeaDrop`. A minter calls `SeaDrop` with the payment, through `mintPublic()`, `mintSigned()`, `mintAllowList()` or `mintAllowedTokenHolder()`. `SeaDrop` checks the stage, the wallet limit and the max supply, pays the fee recipient and the creator's payout address, and calls `mintSeaDrop()` on the token. The fee recipient can be any address the token allows, and drops don't need one. ## Docs From 038ae573be3a47254ee6da64caa4fb83f1af56f5 Mon Sep 17 00:00:00 2001 From: Ryan Ghods Date: Sun, 8 Nov 2026 22:21:03 -0800 Subject: [PATCH 3/5] Drop the overlapping diagram label Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8cc4bba0..6ae399f9 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,7 @@ See [Deployments](docs/Deployments.md) for the clone factories, every network, a ```mermaid flowchart LR creator([Creator]) -->|"drop settings"| token["ERC721SeaDrop
token"] - token -->|"forwards settings"| seadrop["SeaDrop"] + token --> seadrop["SeaDrop"] minter([Minter]) -->|"mint + payment"| seadrop seadrop -->|"mintSeaDrop()"| token seadrop -->|"fee"| fee["Fee recipient"] From adae4c6d1f04defff27e7650305891abfa93de13 Mon Sep 17 00:00:00 2001 From: Ryan Ghods Date: Sun, 8 Nov 2026 22:29:11 -0800 Subject: [PATCH 4/5] Say that every mint names a nonzero fee recipient Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6ae399f9..03b60c47 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ flowchart LR seadrop -.->|"events"| indexer["Indexers"] ``` -The creator configures a drop by calling the token, for example `updatePublicDrop()` or `multiConfigure()`, and the token forwards the settings to `SeaDrop`. A minter calls `SeaDrop` with the payment, through `mintPublic()`, `mintSigned()`, `mintAllowList()` or `mintAllowedTokenHolder()`. `SeaDrop` checks the stage, the wallet limit and the max supply, pays the fee recipient and the creator's payout address, and calls `mintSeaDrop()` on the token. The fee recipient can be any address the token allows, and drops don't need one. +The creator configures a drop by calling the token, for example `updatePublicDrop()` or `multiConfigure()`, and the token forwards the settings to `SeaDrop`. A minter calls `SeaDrop` with the payment, through `mintPublic()`, `mintSigned()`, `mintAllowList()` or `mintAllowedTokenHolder()`. `SeaDrop` checks the stage, the wallet limit and the max supply, pays the fee recipient and the creator's payout address, and calls `mintSeaDrop()` on the token. Every mint names a fee recipient, which can't be the zero address. When a drop restricts fee recipients, it must be one the token allows. The fee itself can be zero. ## Docs From 2cd6ab4b02349da9e86eb5d8cf76322fafb23467 Mon Sep 17 00:00:00 2001 From: Ryan Ghods Date: Sun, 8 Nov 2026 22:33:39 -0800 Subject: [PATCH 5/5] Shorten the README and move development details to docs/Development.md Co-Authored-By: Claude Opus 5.5 --- README.md | 78 ++++----------------------------------------- docs/Development.md | 41 ++++++++++++++++++++++++ 2 files changed, 48 insertions(+), 71 deletions(-) create mode 100644 docs/Development.md diff --git a/README.md b/README.md index 03b60c47..bff2d23d 100644 --- a/README.md +++ b/README.md @@ -9,33 +9,17 @@ # SeaDrop -SeaDrop is a contract for conducting primary NFT drops on evm-compatible blockchains. - -## Table of Contents - -- [SeaDrop](#seadrop) - - [Table of Contents](#table-of-contents) - - [Background](#background) - - [Deployments](#deployments) - - [Diagram](#diagram) - - [Docs](#docs) - - [Install](#install) - - [Usage](#usage) - - [Audits](#audits) - - [Contributing](#contributing) - - [License](#license) +SeaDrop is a contract for primary NFT drops on EVM chains. ## Background -SeaDrop is a contract to perform primary drops on evm-compatible blockchains. The types of drops supported are public drops, allow list stages, token gated drops, and server-side signed mints. An implementing token contract should contain the methods to interface with `SeaDrop` through an authorized user such as an Owner or Administrator. +SeaDrop runs primary NFT drops: public drops, allow lists, server-side signed mints and token-gated mints. A token contract configures its drop through `SeaDrop`, and minters mint through `SeaDrop`. -[SeaDrop v2](https://github.com/ProjectOpenSea/seadrop/tree/v2) adds ERC-1155 tokens, ERC-20 payments and several public stages per token. +This branch is SeaDrop v1, which powers OpenSea's ERC-721 drops. [SeaDrop v2](https://github.com/ProjectOpenSea/seadrop/tree/v2) adds ERC-1155 tokens, ERC-20 payments and several public stages per token, and powers OpenSea's ERC-1155 open collections. ## Deployments -`SeaDrop` 1.0 is deployed at [`0x00005EA00Ac477B1030CE78506496e8C2dE24bf5`](https://etherscan.io/address/0x00005EA00Ac477B1030CE78506496e8C2dE24bf5#code) on Ethereum and most other networks OpenSea supports. On OpenSea, SeaDrop v1 from this branch powers drops. SeaDrop v2, on the [`v2`](https://github.com/ProjectOpenSea/seadrop/tree/v2) branch, currently powers ERC-1155 open collections, which the collection owner mints. - -See [Deployments](docs/Deployments.md) for the clone factories, every network, and the legacy contracts. To deploy to a new network, follow [SeaDrop Deployment](docs/SeaDropDeployment.md). +`SeaDrop` 1.0 is at [`0x00005EA00Ac477B1030CE78506496e8C2dE24bf5`](https://etherscan.io/address/0x00005EA00Ac477B1030CE78506496e8C2dE24bf5#code) on Ethereum and most networks OpenSea supports. [Deployments](docs/Deployments.md) lists every network, the clone factories and the legacy contracts, and [SeaDrop Deployment](docs/SeaDropDeployment.md) covers a new network. ## Diagram @@ -61,67 +45,19 @@ The creator configures a drop by calling the token, for example `updatePublicDro - [Provenance Hash](docs/ProvenanceHash.md) - [Upgradeable Contracts](docs/UpgradeableContracts.md) -## Install - -SeaDrop builds and tests with [Foundry](https://getfoundry.sh). To install Foundry (Linux or macOS): - -```bash -curl -L https://foundry.paradigm.xyz | bash -foundryup -``` - -To clone the repo with its dependencies and compile the contracts: +## Development ```bash git clone --recurse-submodules https://github.com/ProjectOpenSea/seadrop && cd seadrop forge build -``` - -Node.js (see `.nvmrc`) is only needed for the formatting and git hook tooling. `npm install` installs [Biome](https://biomejs.dev) and sets up the [lefthook](https://lefthook.dev) pre-commit hook, which runs `forge fmt` and Biome on staged files. - -```bash -npm install -``` - -## Usage - -To run the tests: - -```bash forge test ``` -This runs the upgradeable contracts' tests too. `src/upgradeable` compiles with its deployable settings (via-IR, 1000 optimizer runs) in the same build; see [Upgradeable Contracts](docs/UpgradeableContracts.md). - -To run coverage: - -```bash -npm run coverage -``` - -To run a gas snapshot: - -```bash -forge snapshot -``` - -Add `-vv` through `-vvvvv` to `forge test` for logs, traces for failing tests, and setup traces. See the [Foundry Book](https://getfoundry.sh/forge/tests/overview) for more. - -To run lint checks (`forge fmt --check`, `forge lint`, and Biome): - -```bash -npm run lint -``` - -To fix formatting: - -```bash -npm run lint:fix -``` +[Development](docs/Development.md) covers installing Foundry, coverage, gas snapshots, linting, size checks and what a pull request needs. ## Audits -SeaDrop was audited after development by [Spearbit](https://spearbit.com/), read the report [here](./assets/spearbit-seadrop-audit.pdf). +[Spearbit](https://spearbit.com/) audited SeaDrop. Read [the report](./assets/spearbit-seadrop-audit.pdf). ## Contributing diff --git a/docs/Development.md b/docs/Development.md new file mode 100644 index 00000000..ea56c205 --- /dev/null +++ b/docs/Development.md @@ -0,0 +1,41 @@ +# Development + +## Install + +SeaDrop builds and tests with [Foundry](https://getfoundry.sh). CI pins the version in `.github/workflows/test.yml` (`FOUNDRY_VERSION`), and `forge fmt` output can differ between versions, so match it. To install Foundry on Linux or macOS: + +```bash +curl -L https://foundry.paradigm.xyz | bash +foundryup --install v1.9.0 +``` + +Clone the repo with its submodules and build: + +```bash +git clone --recurse-submodules https://github.com/ProjectOpenSea/seadrop && cd seadrop +forge build +``` + +Node.js (see `.nvmrc`) is only needed for formatting and the git hook. `npm install` installs [Biome](https://biomejs.dev) and sets up the [lefthook](https://lefthook.dev) pre-commit hook, which runs `forge fmt` and Biome on staged files. + +## Commands + +| Task | Command | +| -------------------------------------------------- | -------------------------- | +| Run the tests | `forge test` | +| Run coverage | `npm run coverage` | +| Gas snapshot | `forge snapshot` | +| Lint (`forge fmt --check`, `forge lint` and Biome) | `npm run lint` | +| Fix formatting | `npm run lint:fix` | +| Check contract sizes against EIP-170 and EIP-3860 | `./scripts/check_sizes.sh` | + +`forge test` also runs the upgradeable contracts' tests: `src/upgradeable` compiles with its deployable settings (via-IR, 1000 optimizer runs) in the same build. See [Upgradeable Contracts](UpgradeableContracts.md). Add `-vv` through `-vvvvv` for logs and traces. + +## Pull requests + +- All tests and lint checks pass, and coverage doesn't drop. +- New code has natspec where it helps, and new features or code paths have Forge tests. +- Contract changes include gas snapshots that show an improvement, or a cost worth the change. +- The description says why the change is needed and what it does. + +Report security issues through [Bugcrowd](https://bugcrowd.com/engagements/opensea), not in a public issue or pull request.