Minting an Art Blocks Token

Project ID Format

All minting tools require a full project ID: INLINECODE0

Example: INLINECODE1

Use discover_projects to find the project ID from a name or search term. To find projects currently open for minting, pass mintable: true — this filters to only projects with active minters and remaining supply.

Minting Workflow

Step 1 — Understand the minter

Call get_project_minter_config first. Returns:

• - Minter type (set price, Dutch auction, allowlist, RAM, etc.)
• Current price and currency (ETH or ERC-20)
• Remaining supply (max_invocations - invocations)
• Auction timing (start/end, price decay curve for DA minters)
• Allowlist details (for gated minters)

Step 2 — Check eligibility (gated projects only)

If the minter type is MinterMerkleV5 or MinterHolderV5, call check_allowlist_eligibility before proceeding.

Accepts a walletAddress (including ENS names) or an Art Blocks username. When the input resolves to an Art Blocks profile, all wallets linked to that profile are checked for eligibility. At least one of walletAddress or username is required.

Param	Type	Notes
INLINECODE13	string	Required. Full project ID.
INLINECODE14

string | Wallet address or ENS name. Provide this or username. |
| username | string | Art Blocks username — checks all linked wallets. |
| chainId | number | Default 1. 1, 42161, 8453. |

Returns: eligibility status, gate type, which wallets are eligible (for multi-wallet profiles), and for holder-gated minters, which projects the wallet must hold tokens from.

Step 3 — Build the transaction

INLINECODE22 currently supports MinterSetPriceV5 (ETH) only.

Param	Required	Notes
INLINECODE23	yes	INLINECODE24
INLINECODE25

— | Default 1. See chain IDs below. |
| purchaseTo | — | Mint to a different address (gifting). Check purchaseTo.disabled in get_project_minter_config first — some projects disable this. |

Returns { transaction, project, minter, price, purchaseTo, warnings }. The warnings array contains non-fatal issues (paused project, sold out, complete) — always surface these to the user before they sign.

Minter Types

Minter	Description	INLINECODE32
INLINECODE33	Fixed ETH price	Supported
INLINECODE34

Dutch auction — exponential decay | Use wallet directly | | MinterDALinV5 | Dutch auction — linear decay | Use wallet directly | | MinterMerkleV5 | Merkle allowlist gating | Use wallet directly | | MinterHolderV5 | Holder-gated (must own another token) | Use wallet directly | | RAM | Ranked auction mechanism | Use wallet directly |

For unsupported minters, explain the mechanics from get_project_minter_config data and direct the user to their wallet.

Chain IDs

Chain	ID
Ethereum mainnet	INLINECODE40
Arbitrum

42161 | | Base | 8453 |

Notes

• - User profiles: When a wallet address or username resolves to an Art Blocks profile, eligibility is checked across all linked wallets. The response includes walletAddresses (all checked), profile info, and for Merkle gates, eligibleWallets showing which specific wallets passed.
• ERC-20 projects: get_project_minter_config indicates the currency token address. build_purchase_transaction only supports ETH — direct ERC-20 users to their wallet.
• Dutch auctions: current price decreases over time. Use start_price, end_price, auction_start_time, and auction_end_time from get_project_minter_config to explain current pricing.
• purchaseTo: useful for gifting — mints the token directly to a recipient address instead of the signer.