Skip to main content

Marketplace

The Mirage marketplace is the app homepage at app.mirage.garden. It reads the bPeg factory, displays active collections, and links into collection and token pages.

Marketplace home​

The marketplace home reads:

  • BpegFactory.totalCollections()
  • BpegFactory.collections(index) for each collection
  • Collection name, symbol, totalSupply, and maxSupply
  • tokenURI(1) for a preview image when at least one token has been minted

Each collection card shows the collection art preview, minted count, max supply, and mint progress.

Collection page​

Collection pages live at:

/market/<collectionAddress>

The page reads:

ReadPurpose
name()Collection title
symbol()Collection symbol
totalSupply()Minted count
maxSupply()Supply cap
token()ERC-20 gate token
tokenThreshold()Required gate-token balance
BpegFactory.mintFee()Standard mint fee fallback
BpegFactory.feeFor(wallet)Wallet-specific mint fee
Gate token symbol, decimals, balanceOf(wallet)Collector balance check

The page lists minted token IDs up to the UI's practical preview cap and links to each token detail page.

Token detail page​

Token pages live at:

/market/<collectionAddress>/<tokenId>

The page reads:

  • Collection name and symbol.
  • Token owner via ownerOf(tokenId).
  • Metadata via tokenURI(tokenId).
  • totalSupply() for previous/next token navigation.

The metadata is expected to be a base64 JSON data URI with an image field and optional attributes.

Native marketplace contract​

The deployed BpegMarketplace contract supports listing, buying, offering, cancelling offers, and accepting offers. Its sale settlement supports protocol fees and EIP-2981 creator royalties.

This marketplace contract path was covered in the Base Sepolia end-to-end test flow. The current public app focuses on browsing, collection minting, and token viewing; native secondary listing UI is separate from the current minting surface.