For the complete documentation index, see llms.txt. This page is also available as Markdown.

Supported Networks & Contracts

Molecule Labs runs on Base. Base mainnet is the canonical chain, where Lab state, LabNFT ownership and role grants live. Base Sepolia mirrors it for staging and development. The legacy IP-NFT contracts on Ethereum are listed at the bottom for reference only.

Networks

Network
Chain ID
CAIP-2
viem chain
Environment
Explorer

Base

8453

eip155:8453

base

Production (canonical chain)

Base Sepolia

84532

eip155:84532

baseSepolia

Staging / development (testnet)

The API environments map one-to-one onto these networks: the staging GraphQL endpoint and x402 gateway target Base Sepolia, and production targets Base. Credentials are per environment. To switch a script from one to the other, see Running in Production.

Base Mainnet — Molecule Labs core (v0.1.0)

The Lab smart-account stack deployed on Base (chain ID 8453):

Contract
Address
Verified URL
Function

OnChainLabFactory

0xECdF4f05384056507485C90aeAb0a83268760D6E

Lab account creation (mint & create)

LabNFT (proxy)

0x9F96027eeAFb9ad5F2b5d7043B36Ee96B2EeBE92

Lab ownership NFT (ERC-721)

ERC7484Registry

0x1Ab5Ba4300613F7346835b2BE7E2D10Ce6125eF5

Module attestation registry

RootValidator

0xb31d39ECc0cb26478E258C8f7e9C906115f494f6

Default signature validator

MoleculeOclDidRegistry (proxy)

0x6cd3Cf3c34a18Bf48F90590c3a57708F175b2eE3

DID linking for Labs

OdfCoAttestVerifier

0x5a7a22bbad7B8B3c91EdB7FC2Af2DE5de9060D8B

did:odf co-attestation verifier

AccessResolver (v3)

0x89a14Be8f7824d4775053Edad0f2fA2d6767b72B

Roles & file access control

OclTokenizer (proxy)

0x62F532C3f563D974deEc103AAb8cC597f4f9c84E

Lab tokenization (IPT factory)

OclTermsPermissioner

0x125A12C880934826c80A54ce216B6c1F542603eE

Membership-agreement signature verification

LabToken (clone template)

0xd13a5D5ab80c15c344aA0eAa36f16ABae940dB0c

IPT implementation (EIP-1167 template)

WrappedLabToken (clone template)

0x48Ab68bB775e4AC50eA0a9939dBcc71ae4A69817

Bring-your-own-token IPT wrapper

Base Sepolia Testnet — Molecule Labs core

The same stack on Base Sepolia (chain ID 84532). The staging API and every Getting Started tutorial run against these addresses:

Contract
Address
Verified URL
Function

OnChainLabFactory

0xd629FE2310b4309a212495F10A47f8436dcEfD90

Lab account creation (mint & create)

LabNFT (proxy)

0x13Ff210695fdb54A7F928ECcc28BC3486c05BB28

Lab ownership NFT (ERC-721)

ERC7484Registry

0x1Ab5Ba4300613F7346835b2BE7E2D10Ce6125eF5

Module attestation registry

RootValidator

0xb31d39ECc0cb26478E258C8f7e9C906115f494f6

Default signature validator

MoleculeOclDidRegistry (proxy)

0x8A23622967Cf7e3BB3219217ff685a5E4830C617

DID linking for Labs

OdfCoAttestVerifier

0x8c1BD0120CDe6102E60F547F5c898b82F6075541

did:odf co-attestation verifier

AccessResolver (v3)

0x5493F472602C87318EA5Eff753cDD593bf9bF559

Roles & file access control

OclTokenizer (proxy)

0xEe19e0Db8a7e59538710FAF6ed3ab655BCfCdB24

Lab tokenization (IPT factory)

OclTermsPermissioner

0x2196e7181393b8045F34b66f571F1566922Aa4dB

Membership-agreement signature verification

LabToken (clone template)

0x8038d3B220C635b3B7A7B4bcba0928a2D5B0B8F6

IPT implementation (EIP-1167 template)

WrappedLabToken (clone template)

0x1Ba1Bd7d8824d6e7DB4dDF15aa41E00cE841abE2

Bring-your-own-token IPT wrapper

Need testnet funds? Get Base Sepolia ETH from a Base Sepolia faucet. You also need testnet USDC from the Circle faucet, but only if you pay through the x402 gateway.

Contract details

  • IPT — the per-Lab ERC-20 IP Token

  • Tokenizer — OclTokenizer, which deploys and controls IPTs

  • AccessResolver — roles and file-access predicates, including the v2 deployments on Ethereum

Legacy IP-NFT contracts (unmaintained)

These predate Molecule Labs and are no longer maintained. New integrations should target the Base deployments above.

Ethereum Mainnet (chain ID 1)

Network
Contract
Address
Verified URL
Function

Ethereum Mainnet

IPNFT

0xcaD88677CA87a7815728C72D74B4ff4982d54Fc1

IP-NFT ownership

Ethereum Mainnet

CrowdSale

0xF0A8D23F38E9CbBe01C4Ed37f23BD519b65BC6C2

Token sales

Ethereum Mainnet

AccessResolver

0xc130e0b49840b266A49F62C0Cc77e353E0C99cD0

File access control (v2 — signer predicates only; the role system lives on Base)

Ethereum Sepolia (chain ID 11155111)

Contract
Address
Verified Link

IPNFT

0x152B444e60C526fe4434C721561a077269FcF61a

CrowdSale

0x8cA737E2cdaE1Ceb332bEf7ba9eA711a3a2f8037

Upgrade Pattern

The OclTokenizer contracts use the UUPS (Universal Upgradeable Proxy Standard) pattern:

  • Proxy contracts hold state and delegate calls to implementation contracts

  • Only the contract owner can authorize upgrades

  • Contract addresses remain stable across upgrades

IP Token Cloning

IP Tokens (IPTs) are deployed using the EIP-1167 Minimal Proxy pattern:

  • Each Lab tokenization creates a new LabToken clone

  • Clones share implementation code but have independent state

  • No fixed deployment address - each IPT has a unique address

  • Query OclTokenizer.tokenized(labId) or use the indexer to find IPT addresses

Security Considerations

  • Legacy core contracts (IPNFT, CrowdSale, TimelockedToken) have been audited by pashov

  • The Molecule Labs core (OnChainLab account stack) was audited by Cyfrin in 2026 — see Audits

  • Admin functions are protected by onlyOwner access control

  • See individual contract pages for specific security notes

Need help?

Ask the team on Discord. Reporting an API error? Include the requestId from the failing response so we can trace it.

Ask on Discord

Page wrong, unclear or missing something? Let us know with Was this helpful? on this page.

Last updated

Was this helpful?