Minting an Art Blocks Token
Project ID Format
All minting tools require a full project ID: <contract_address>-<project_index>
Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-0
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 |
|---|---|---|
projectId | string | Required. Full project ID. |
walletAddress | 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
build_purchase_transaction currently supports MinterSetPriceV5 (ETH) only.
| Param | Required | Notes |
|---|---|---|
projectId | yes | <contract_address>-<project_index> |
chainId | — | 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 | build_purchase_transaction |
|---|---|---|
MinterSetPriceV5 | Fixed ETH price | Supported |
MinterDAExpV5 | 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 | 1 |
| 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),profileinfo, and for Merkle gates,eligibleWalletsshowing which specific wallets passed. - ERC-20 projects:
get_project_minter_configindicates the currency token address.build_purchase_transactiononly supports ETH — direct ERC-20 users to their wallet. - Dutch auctions: current price decreases over time. Use
start_price,end_price,auction_start_time, andauction_end_timefromget_project_minter_configto explain current pricing. purchaseTo: useful for gifting — mints the token directly to a recipient address instead of the signer.