Minters
A complete reference of all available minter types in the Art Blocks Shared Minter Suite.
Quick Reference
Set Price Minters
Set Price – ETH
The simplest minter. All tokens sell at a fixed price in ETH, first-come-first-served.
Best for: Projects with moderate demand, straightforward drops.
Key parameters:
price: Price per token in weimaxInvocations(optional): Minter-level cap on total mints
Set Price – ETH, allowlisted users only
Fixed price restricted to an allowlist. Artists configure a list of eligible wallet addresses and optionally limit how many times each address can mint.
Best for: Early access passes, community-exclusive drops, token-gated experiences.
Key parameters:
price: Price per token in weimerkleRoot: Merkle root of the allowlistmaxInvocationsPerAddress: Max mints per allowlisted wallet
Set Price – ETH, token holders only
Fixed price restricted to holders of a specified ERC-721 token collection.
Best for: Rewarding existing community holders; companion piece drops.
Key parameters:
price: Price per token in weiholderContract: Address of the ERC-721 contract holders must own
Set Price – custom ERC20
Fixed price accepting any ERC-20 token. Useful for "mint pass" mechanics or custom community tokens.
Key parameters:
price: Price in ERC-20 token unitscurrencyAddress: ERC-20 contract addresscurrencySymbol: Display symbol
Dutch Auction Minters
Dutch Auction (w/ Settlement) – exponential price decrease
All collectors pay the same final price — the price at which the last token sold. Collectors who purchase above the final price can claim a settlement (refund of the difference). Funds are held non-custodially by the contract until revenues are collected by the artist.
This is the most equitable Dutch auction for buyers: early purchasers aren't penalized for enthusiasm.
Best for: High-demand projects where fair price discovery and collector equitability are priorities.
Key parameters:
startPrice: Starting price in weibasePrice: Minimum (resting) price in weistartTime: Auction start timestamphalfLifeSeconds: Controls price decay speed (exponential curve)
If an artist reduces max supply mid-auction and the project sells out above base price, revenues must be withdrawn by the contract admin (not the artist alone). This protects collectors from an artist unilaterally inflating the sellout price.
Dutch Auction – exponential price decrease
Price starts high and decays exponentially over time. Collectors pay the price at the time they purchase — earlier buyers pay more. No settlement mechanism.
Best for: Projects where price discovery is desired and collectors accept variable prices.
Key parameters:
startPrice: Starting price in weibasePrice: Minimum resting price in weistartTime: Auction start timestamphalfLifeSeconds: Half-life of price decay
Dutch Auction – linear price decrease
Price decreases linearly from start to end over a set duration. Predictable price curve.
Best for: Projects where a predictable, transparent price reduction curve is desired.
Key parameters:
startPrice: Starting price in weibasePrice: Minimum resting price in weistartTime: Auction start timestampendTime: Auction end timestamp
Dutch Auction – exponential, token holders only
Extends the exponential Dutch Auction to require token holders of a specified collection to participate.
Dutch Auction – linear, token holders only
Extends the linear Dutch Auction to require token holders of a specified collection to participate.
Ranked Auction (RAM)
The Ranked Auction Minter (RAM) allows collectors to submit bids for a limited number of tokens. The highest bidders win; all winning bids pay the same price (the lowest winning bid).
Losing bidders receive automatic refunds. The ranked auction process runs non-custodially on-chain and scales to any project size. Artists may incur gas costs for minting tokens to winning bidders.
Best for: Projects with strong demand and a community-oriented ethos; "museum-quality" drops.
Key parameters:
auctionEndTime: When bidding closesnumTokensToSell: Number of tokens in the auction
Serial English Auction (SEA)
The Serial English Auction (SEA) runs sequential English auctions for individual tokens. Inspired by nouns.wtf.
- Collectors kick off each token's auction by submitting a bid
- Any wallet can outbid; outbid amounts are refunded automatically
- Bids submitted near the end of an auction extend the auction window, ensuring human competitors can respond to bots
- Once an auction ends, the next token auction can be started alongside delivering the previous winner their token
The minter pre-mints tokens before their auction starts. Bids are placed on existing tokens, not hypothetical ones.
Best for: Long-running projects meant to be savored token-by-token; 1:1 auctions; community engagement over an extended period.
Key parameters:
auctionLengthSeconds: Minimum duration per auctionminBidIncrementPercent: Minimum increment for a new bidstartingPrice: Minimum starting bid in wei
Minimum Price Minter
Distributes tokens at near-zero cost. A small mint fee is sent to the render provider to help cover rendering and indexing costs.
Best for: Community giveaways, public art projects, accessibility-focused releases.
Minimum Price – allowlisted users only
Extends the Minimum Price minter to restrict minting to an allowlist. Supports per-wallet limits.
Polyptych Minter
The Polyptych (copy-hash) minter mints tokens with identical token hashes. This allows a project to produce multiple pieces that share a common generative seed — creating visual or conceptual cohesion across a set.
- Artists may mint child tokens to a parent token holder's wallet, or allow the parent holder to mint children themselves
- The artist's script must handle frame assignment by token number (e.g., tokens 0–99 render frame 1, tokens 100–199 render frame 2)
- Artists can increment the active frame on the minter
Requires: Configuration of the shared randomizer. Some interactions may need Etherscan/gnosis safe tx builder.
Best for: Multi-panel generative works, polyptych editions, companion pieces.
Polyptych – custom ERC20
Extends the Polyptych minter to accept any ERC-20 token as payment.
Custom Minters
Engine partners can add custom minters for their contracts. See Custom Minters for the integration process.