R
Rare Protocol

Rare Protocol

The open marketplace protocol for NFTs. Onchain auctions, agent-native tooling, $RARE burns.

Rare Protocol is a permissionless NFT marketplace protocol deployed on Ethereum. It provides onchain timed auctions, fixed-price sales, offers, and a fee architecture powered by the $RARE token. Anyone can interact with the contracts directly — no frontend required.

Sepolia Testnet — The protocol is currently deployed on Sepolia for testing. All contracts are verified and open source.

Architecture

The protocol consists of five core contracts:

  • SuperRareBazaar — The marketplace hub. Handles sales, offers, auctions, and settlement.
  • RareMinter — Managed minting with configurable direct sale parameters.
  • SovereignNFTContractFactory — Deploys new ERC-721 collections with ERC-2981 royalties.
  • RareAppRegistry — Apps register here with a fee in basis points.
  • $RARE Token — ERC-20 governance token. Protocol fee revenue is used to buy and burn $RARE.

Deployed Contracts (Sepolia)

ContractAddress
SuperRareBazaar0xCE999aeF38E1316A510615b80713b494658807c6
RareMinter0xf689b3344090DdE8b7a2C6b942730fF05De29451
NFT Factory0xeF4aac03af2684bE0BE2B07c451949CC4246085F
RareAppRegistry0x3ad7694F899804206076F9A8E6F06719E360A90b
$RARE Token0x197FaeF3f59eC80113e773Bb6206a17d183F97CB

Deployment block: 10416876

Timed Auctions

Rare Protocol supports fully onchain timed auctions. Three auction types: Reserve (Coldie), Scheduled, and anti-snipe extensions. After the auction ends, anyone can call settleAuction() to transfer the NFT to the winner.

Fee Structure

No app (_app = address(0)) — Zero protocol fees. Registered app — The app's fee is deducted; protocol takes a share (default 20%).

$RARE Token Burns

Protocol revenue accumulates and is used to buy and burn $RARE. Burn rate scales with marketplace volume. Direct usage (no app) generates zero protocol revenue.

App Registry

Any address can register as a marketplace app. Pass your address as _app in Bazaar functions to collect fees.

Agent Skills

Add the Rare Protocol skill to your AI agent for minting, auctions, offers, and marketplace operations.

CLI Reference

The web CLI provides a terminal interface. Connect your wallet and type commands.

CLI commands
connect              Connect MetaMask, switch to Sepolia
status               Show address, balance, network
contracts            List all deployed contract addresses
mint deploy --name "Name" --symbol SYM    Deploy collection
mint token --contract 0x... --uri ipfs://...   Mint NFT
list --contract 0x... --id 1 --price 0.5  List for sale
buy --contract 0x... --id 1 --price 0.5   Buy listed token
auction create --contract 0x... --id 1 --min 0.1 --duration 3600
auction bid --contract 0x... --id 1 --amount 0.2
auction settle --contract 0x... --id 1
offer place --contract 0x... --id 1 --amount 0.3
apps register --fee 250    Register (250 bps = 2.5%)

Indexer API

The protocol is indexed by an Envio indexer. GraphQL endpoint:

https://indexer.dev.hyperindex.xyz/d59a89b/v1/graphql

Tracks: sales, listings, offers, auctions, bids, settlements, mints, collection deployments, app registrations.