Contracts

Current app-wired Sepolia addresses

These are the addresses currently wired into the local Sepolia env files in this repo. They reflect the build that the web app and indexer are currently pointed at.

For implementation addresses or deployment history, refer to deployment logs and scripts.

Use npm run check:deployments with a real RPC when you want to verify that the configured addresses have code, expected ownership, registry wiring, and shared-minter authorization on the target chain. If the contract env values are unset, the command falls back to docs/deployments.sepolia-app-wired.json.

Contract families

NFTFactory currently has four practical contract groups:

1. shared publishing
2. creator-owned collections
3. registry and protocol control surfaces
4. marketplace and moderation support

Shared mint contracts

Purpose

SharedMint721 and SharedMint1155 provide the fastest path to publishing:

• no creator contract deployment step
• publish directly from the UI after media/metadata preparation
• optional subname attribution through SubnameRegistrar

Current behavior

• immutable contract logic
• not proxy-based
• no upgrade path
• no creator-specific royalty configuration at the contract level

Creator-owned collections

Purpose

CreatorCollection721 and CreatorCollection1155 are deployed by CreatorFactory as ERC-1967 proxies.

Current behavior

• creator-owned by default
• upgradeable until finalizeUpgrades() is called
• ownership can be transferred
• royalty defaults are configurable at deployment
• token-level metadata can be locked

These are the only contracts in the current product with a live upgrade path.

CreatorFactory

CreatorFactory:

• stores implementation pointers for the ERC-721 and ERC-1155 paths
• deploys the correct proxy type
• initializes the deployed proxy
• registers the new collection in NftFactoryRegistry

NftFactoryRegistry

NftFactoryRegistry is the central protocol policy and bookkeeping surface.

It tracks:

• authorized factories
• creator-to-collection registrations
• blocklist state
• treasury address
• protocol fee bps

It does not act as the discovery index or public profile registry.

SubnameRegistrar

SubnameRegistrar is the current on-chain identity creation surface exposed by NFTFactory.

It supports:

• nftfactory.eth subname registration
• subname renewal under current contract rules
• shared-mint attribution through recordMint
• minter authorization for shared mint contracts

It does not manage arbitrary external ENS parent domains.

ModeratorRegistry

ModeratorRegistry is a protocol-owned contract for canonical moderator records.

The app does not require it to boot, but the indexer will read from it when MODERATOR_REGISTRY_ADDRESS is configured.

Marketplace

Marketplace provides:

• listing creation and cancellation
• offer creation, acceptance, and cancellation
• purchase settlement
• per-collection marketplace blocklist toggles

It depends on registry blocklist and fee state at runtime. The original basic Marketplace (listings only) and MarketplaceV2 (listings + offers) have been merged into a single Marketplace contract.

RoyaltySplitRegistry

RoyaltySplitRegistry exists in the contract suite but is not directly referenced by the current web or indexer env snapshot. Treat it as a protocol-owned supporting registry, not a removed contract.

Related pages

• ENS Integration
• Finality
• Contract Dependencies
• Operations and Governance
• Testing and Validation