artblocks/mint-artblocks-token

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), 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.