MagicDrop

MagicDrop is a collection of EVM minting protocols that enable the multi stage minting, per stage WL management, per stage supply limit, and authorized minter support.

Motivation

We'd like to introduce the standard of "minting stages". At each stage, the creators can define the following properties:

• per-stage price
• per-stage walletLimit
• per-stage merkleRoot(whitelist)
• per-stage maxStageSupply

The composability of the stages is generic enough to enable flexible and complicated EVM minting contracts.

Tech/ Framework

Built with

• Hardhat
• ERC721A by Azuki. Fully compliant implementation of IERC721 with significant gas savings for batch minting.
• ERC721C by LimitBreak. Extends ERC721 and add creator-definable transfer security profiles that are the foundation for enforceable, programmable royalties.

Features

• Minting Stages
• Permenent BaseURI Support
• Non-incresing Max Total Supply Support
• Per-stage whitelist Merkle Tree
• Per-stage Max Supply
• Global and Per-stage Limit
• Authorized minter support
• Native TypeScript and Typechain-Types Support

Contracts

Contract	Description
ERC721M	The basic minting contract based on ERC721A.
ERC721CM	The basic minting contract based on ERC721C and ERC721M.
ERC1155M	The basic minting contract based on ERC1155.
MagicDropTokenImplRegistry	The implementation registry for MagicDrop contracts.
MagicDropCloneFactory	The factory contract for cloning MagicDrop contracts.
ERC721MInitializableV1_0_2	The initializable implementation for ERC721M.
ERC721CMInitializableV1_0_2	The initializable implementation for ERC721CM.
ERC1155MInitializableV1_0_2	The initializable implementation for ERC1155M.
ERC721MagicDropCloneable	A simple cloneable implementation of ERC721 with public and private stages.
ERC1155MagicDropCloneable	A simple cloneable implementation of ERC1155 with public and private stages.

Deployment Address & Salts (Non-ZKSync Chains)

Name	Address	Salt
MagicDropTokenImplRegistry Implementation	0x00000000a5837C1EeD8145A831c8e69C81112da0	0x38f7e43d7b4b0493bb35918ede2a002486e822173f68e1c7c4e9a7a9af451ac2
MagicDropTokenImplRegistry Proxy	0x000000000e447e71b2EC36CD62048Dd2a1Cd0a57	0xc9b080cde9332d8feb50c92fb198b503b9f90ca09a83429194ad8ef8928aca79
MagicDropCloneFactory Implementation	0x0000000067502A08Cc4307672A1d4dc48f08a444	0x3ad1a60297b1c9e825cdf7e9452a4e9b109c404a4f9f8069e77c6a916096aa0a
MagicDropCloneFactory Proxy	0x00000000bEa935F8315156894Aa4a45D3c7a0075	0xdcb4ae77dc30804459a9a9bcc9bb1a271049553639fdf5c47e4a6a0c3fd97c7b
ERC721MInitializableV1_0_2	0x00000000df57029C0628F946f37a4CBaa417d1d9	0x56c09d9f6a0b39a14e082b2ee9329f2d07e0d2a57900d4d24797d0bb95f521a9
ERC721CMInitializableV1_0_2	0x00000000E7aEc12181Cb4C1D8474634e3fCEe456	0x958674b386d1433f28e925ecd473b9ff8ca9cf8b1d4e5a0f417a1d731da7c565
ERC1155MInitializableV1_0_2	0x0000000055E6c029AD855Af4a30a0f0fA73b6c5E	0xab66c31281be63f79c25e30ef51a6293b25eea4a86beb47b323525497c4612af
ERC721MagicDropCloneable	0x000000002A1351440079144BF9e40869092576f1	0x802853f87f3efa7109bd4a3b7b9ac3daf75f98a3fc97a8fce04d8c17ed2e85c7
ERC1155MagicDropCloneable	0x00000000b03D92E78432FB3377A171655Afdb5bb	0x0b6a866fa283524661d3b4a0f7f5b85636819e32e1384b395d5454edc7d9299a

Abstract Deployed Addresses

Contract	Address
MagicDropTokenImplRegistry	0x17c9921D99c1Fa6d3dC992719DA1123dCb2CaedA
MagicDropCloneFactory	0x01c1C2f5271aDeA338dAfba77121Fc20B5176620
ERC721MInitializableV1_0_2	0x92578FCA9eaBEe0f5Bb3E5ea8e291612B75C8748
ERC721CMInitializableV1_0_2	0x96e5Ed4446E7652C4306290099C6760fA2332EeC
ERC1155MInitializableV1_0_2	0x3Cd56fB82B34Bf4AD8f94c29EeDDB7bC132E41De
ERC721MagicDropCloneable	0xd929CE55a5Ea307FED843E145aFbcC261e2691d8
ERC1155MagicDropCloneable	0xDb56d1512C0E885B9b1Ddf704eA83C82654a5B61

Supported Chains

• Ethereum
• Polygon
• Base
• Sei
• Arbitrum
• Apechain
• BSC
• Abstract
• Berachain
• Monad Testnet

Using Foundry

Install Foundry

curl -L https://foundry.paradigm.xyz | bash
foundryup

For Abstract, install Foundry ZKSync

curl -L https://raw.githubusercontent.com/matter-labs/foundry-zksync/main/install-foundry-zksync | bash
foundryup-zksync

Install Dependencies

forge install

Build Contracts

Note: For Abstract, use the --zksync flag.

forge build

Run Tests

forge test

Generate Coverage Report

This project includes a script to generate and view a test coverage report. The script is located at test/generate-coverage-report.sh.

./test/generate-coverage-report.sh

Security

• ERC721M Kudelski Security Audit

Bounty Program

• HackerOne program: please contact https://magiceden.io/.well-known/security.txt
• Please be noted that there are some prerequites need to be met and certain assumptions are made when using the contracts. Please check the Contract Usage Guide for more details.

Used By

• Magic Eden Launchpad

License

MIT © MagicEden Open Source