molecule-core

Setup

This project was built using Foundry. Refer to installation instructions here.

git clone git@github.com:molecule-protocol/molecule-core.git
cd molecule-core
forge install
yarn build

What is Molecule Protocol?

Molecule Protocol standardizes how to implement access control rules.

It consists of a MoleculeController contract, where rules can be added or removed. The owner can also preset which combination of rules to activate, or set different statuses to "always allow" or "always block", for example.

The access control rules are defined by MoleculeLogic contracts. The template is minimalistic by design, so it can be implemented in any ways for any purposes. It has only 1 required function check() that returns the logic (true or false.) The other requirements are a human readable name and a boolean that states if it is an allow-list or a block-list.

Two fully functionaly sample MoleculeLogic contracts are provided for implementing allow-list or block-list using NFTs or custom lists.

How do I use Molecule Protocol in my smart contracts?

It can be implemented with 1-line using a require statement. Or use the more gas-optimized code snippet below.

  error RecipientNotAllowedToReceive(address sender);
  if (!IMoleculeController(_moleculeTransfer).check(recipient)) {
      revert RecipientNotAllowedToReceive(recipient);
  }

_moleculeTransfer is the MoleculeController contract address that checks if the recipient is allowed or not. Use the Solidity error more meaningful error messages can be logged with variables.

Three simple steps:

1. Launch and configure configure your MoleculeController contract and customize the logic

2. Import the MoleculeController Interface in your smart contract

3. Cast the MoleculeController with contract address and call the check() function with the address to validate

Fully functional token contracts with Molecule Protocol integrated are available here:

ERC20m | ERC721m | ERC1155m

You can launch the contracts and add rules later.

Below are other common use cases for the Molecule Protocol.

NFT Mint Allowlist (Whitelist)

Allow list (whitelist) is a common use case for NFT minting. By using Molecule Protocol in the NFT smart contract, the allow list can be added and managed easily. After the mint, the Molecule Protocol smart contract can be set to bypass entirely.

On-Chain Compliance

AML: Most DeFi protocols enforce AML (Anti-Money-Laundering) at the UI level only. Molecule Protocol enables AML checks at the smart contract level, ensuring no unauthorized counterparties at any time.

KYC: Molecule Protocol is composable with KYC projects like KYC Dao and Quadrata

Soulbound and Conditional-Soulbound Tokens

A soulbound token refers to an NFT token that cannot be transferred. For example, for KYC tokens, the identity token is tied to each wallet address, and transfer is prohibited.

Many Web3 loyalty programs or GameFi projects prevent transfer to avoid "farming." However, transfer should be conditionally allowed during redemption. Tokens should either be burned or transferred to the treasury.

Implementing these with Molecule Protocol is trivial and more flexible than hardcoding.

Subscription Payment

Proof of payment can be implemented with adding an allowlist logic. By adding this payment check, proof of payment and even subscription payment can be verified before allowing smart contract executions. By decoupling the payment at the smart contract level, it enables subscriptions, installments, and many other payment options for DeFi projects.

Ecosystem

Features like payment services, AML, and KYC are common use cases. Service providers can publish their Molecule Smart Contract address and allow any project to use their services. They can also use Molecule Protocol to implement payment services, essentially enabling the SaaS model on-chain.

By standardizing the construction of rule engines using Molecule Protocol, even complex rules can be implemented easily and in a composable way. This removes duplicate implementations and maximizes value for service providers.

Contribution

Can you think of more use cases that Molecule Protocol can support? Please describe your idea, or demo your idea, or submit a PR (pull request) to us so we can share it with the entire community!

Questions?

Send us questions on Twitter: @moleculepro

or join our Discord: https://discord.gg/J8dqFK8ufA

Additional Information

AML Deployments

Goerli Testnet:

• Molecule AML Deployment: 0x1D2048b4673a7D3C874D5Ca0cB584695Fcc4CC7e

• US Sanction List: 0x36fcB28EA4F1a227F6FB17005046b59Fb164BEA1

• EU Sanction List: 0xAB73E85dd23f87E205D1C7C2354a372C3841c829

Goerli Testnet (Old):

• MoleculeAddress contract: 0x692f0Ac3eDDF405C8a864643DC104b3B01F594C2

• LogicAddressAML US (ID:840) contract address: 0x6ff3F2DAa62e11D6fEC233410d2151948234d496

• LogicAddressAML UK (ID:826) contract address: 0x3daD441A8C07eF64AA22e6114c39d690a098783F

Gas Comparison on Batch updations

Gas Comparison on Molecule contracts