Modular Contracts

Write smart contracts for which you can add, remove, upgrade or switch out the exact parts you want.

A Modular Contract is built of two kinds of parts: a Modular Core and its Modular Extensions.

A developer writes a Core smart contract as the foundation that can be customized by adding new parts and updating or removing these parts over time. These ‘parts’ are Extension smart contracts which any third-party developer can independently develop with reference to the Core smart contract as the known foundation to build around.

Install and Use

This project can currently be installed as a dependency in foundry projects. To install, run:

forge install https://github.com/thirdweb-dev/modular-contracts

Add the following in a remappings.txt file:

@modular-contracts/=lib/modular-contracts/src/

Import ModularCore inherit to build a Modular Core contract (e.g. ERC-721 Core):

import {ModularCore} from "@modular-contracts/ModularCore.sol";
import {ERC721A} from "@erc721a/extensions/ERC721AQueryable.sol";

contract ModularNFTCollection is ERC721A, ModularCore {}

Import ModularExtension to create an Extension for your Core contract (e.g. Soulbound):

import {ModularExtension} from "@modular-contracts/ModularExtension.sol";

contract SoulboundERC721 is ModularExtension {}

Run this repo

Clone the repo:

git clone https://github.com/thirdweb-dev/modular-contracts.git

Install dependencies:

# Install dependecies
forge install

Feedback

If you have any feedback, please create an issue or reach out to us at [email protected].

Authors

• thirdweb

License

Apache 2.0