Workflows

Individual tools are useful. Chaining them together is where it gets interesting.

Mint Pipeline

The core workflow: discover, evaluate, check eligibility, build transaction.

Discover

"What Art Blocks projects are minting right now?"

discover_live_mints returns active projects with pricing, supply, and minter type:

Each result includes lowestListing (secondary floor), so an agent can compare mint price vs. floor before recommending a purchase.

Evaluate

"Tell me more about Signal Boards"

get_project returns trait distributions, artist info, license, and script type. If the secondary floor (0.011 ETH) is below mint price (0.015 ETH), an agent can flag that buying on secondary may be cheaper.

Check Eligibility

"Can vitalik.eth mint this?"

check_allowlist_eligibility resolves ENS names and checks gating. This is the branching point: eligible wallets proceed to purchase, ineligible wallets get a clear explanation of why.

Build Transaction

"Build the mint transaction for vitalik.eth"

build_purchase_transaction returns a ready-to-sign EVM transaction:

{
  "to": "0x0635...b085",
  "data": "0xae77c237...",
  "value": "15000000000000000",
  "chainId": 1
}

No ABI encoding required. Pass directly to a wallet signer. A warnings array surfaces issues like price changes or low supply before signing.

Full Pipeline

discover_live_mints → get_project → get_project_minter_config
  → check_allowlist_eligibility
    → eligible: build_purchase_transaction → sign + submit
    → not eligible: explain reason, surface alternatives

Portfolio + Recommendations

"What Art Blocks pieces does vitalik.eth own?"

get_wallet_tokens returns all tokens with project details, traits, and transfer history. Cross-reference with discover_live_mints to surface connections:

• "You own Friendship Bracelets, and it still has 35 remaining."
• "You own work by Matto. Their latest project is live now."

Use get_artist to expand into full catalogs: "Fidenza is sold out (floor: 18.8 ETH) but available on secondary."

Catalog Research

"Tell me about all projects by Snowfro and Aaron Penne"

discover_projects searches the full catalog by name, artist, or tags. get_artist expands into full catalogs per artist. An agent can compare bodies of work, check which projects are sold out vs. still mintable, and surface secondary floor prices across an artist's entire output.