Back to Details

metaplex

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Metaplex Development Skill

Metaplex 开发技能

Overview

概述

Metaplex provides the standard infrastructure for NFTs and tokens on Solana:
  • Core: Next-gen NFT standard (recommended for new NFT projects)
  • Token Metadata: Fungible tokens + legacy NFTs/pNFTs
  • Bubblegum: Compressed NFTs (cNFTs) using Merkle trees — massive scale at minimal cost
  • Candy Machine: NFT drops with configurable minting rules
  • Genesis: Token launch protocol with fair distribution + liquidity graduation
Metaplex 为 Solana 上的 NFT 和代币提供标准基础设施：
  • Core：下一代NFT标准（推荐用于新NFT项目）
  • Token Metadata：可替代代币 + 传统NFT/pNFT
  • Bubblegum：使用默克尔树的压缩NFT（cNFT）—— 以极低成本实现大规模发行
  • Candy Machine：可配置铸造规则的NFT发售工具
  • Genesis：具备公平分配和流动性升级的代币发行协议

Tool Selection

工具选择

Prefer CLI over SDK for direct execution. Use SDK only when user specifically needs code.
ApproachWhen to Use
CLI (
mplx
)		Default choice - direct execution, no code needed
Umi SDKUser needs code — default SDK choice. Covers all programs (TM, Core, Bubblegum, Genesis)
Kit SDKUser specifically uses @solana/kit, or asks for minimal dependencies. Token Metadata only — no Core/Bubblegum/Genesis support
优先使用 CLI 而非 SDK 来直接执行操作。仅当用户明确需要代码时才使用SDK。
方式使用场景
CLI (
mplx
)		默认选择 - 直接执行，无需代码
Umi SDK用户需要代码时的默认SDK选择。支持所有程序（TM、Core、Bubblegum、Genesis）
Kit SDK用户明确使用 @solana/kit，或要求最小依赖时使用。仅支持 Token Metadata —— 不支持 Core/Bubblegum/Genesis

Task Router

任务路由

IMPORTANT: You MUST read the detail file for your task BEFORE executing any command or writing any code. The command syntax, required flags, setup steps, and batching rules are ONLY in the detail files. Do NOT guess commands from memory.
Task TypeRead This File
Any CLI operation (shared setup)
./references/cli.md
CLI: Core NFTs/Collections
./references/cli.md
+ 
./references/cli-core.md
CLI: Token Metadata NFTs
./references/cli.md
+ 
./references/cli-token-metadata.md
CLI: Compressed NFTs (Bubblegum)
./references/cli.md
+ 
./references/cli-bubblegum.md
CLI: Candy Machine (NFT drops)
./references/cli.md
+ 
./references/cli-candy-machine.md
CLI: Token launch (Genesis)
./references/cli.md
+ 
./references/cli-genesis.md
CLI: Fungible tokens
./references/cli.md
(toolbox section)
SDK setup (Umi)
./references/sdk-umi.md
SDK: Core NFTs
./references/sdk-umi.md
+ 
./references/sdk-core.md
SDK: Token Metadata
./references/sdk-umi.md
+ 
./references/sdk-token-metadata.md
SDK: Compressed NFTs (Bubblegum)
./references/sdk-umi.md
+ 
./references/sdk-bubblegum.md
SDK: Token Metadata with Kit
./references/sdk-token-metadata-kit.md
SDK: Token launch (Genesis)
./references/sdk-umi.md
+ 
./references/sdk-genesis.md
Account structures, PDAs, concepts
./references/concepts.md
重要提示：在执行任何命令或编写代码之前，你必须阅读对应任务的详细文件。命令语法、所需标志、设置步骤和批量处理规则仅在详细文件中提供。请勿凭记忆猜测命令。
任务类型阅读文件
任何CLI操作（通用设置）
./references/cli.md
CLI：Core NFT/集合
./references/cli.md
+ 
./references/cli-core.md
CLI：Token Metadata NFT
./references/cli.md
+ 
./references/cli-token-metadata.md
CLI：压缩NFT（Bubblegum）
./references/cli.md
+ 
./references/cli-bubblegum.md
CLI：Candy Machine（NFT发售）
./references/cli.md
+ 
./references/cli-candy-machine.md
CLI：代币发行（Genesis）
./references/cli.md
+ 
./references/cli-genesis.md
CLI：可替代代币
./references/cli.md
（工具箱章节）
SDK 设置（Umi）
./references/sdk-umi.md
SDK：Core NFT
./references/sdk-umi.md
+ 
./references/sdk-core.md
SDK：Token Metadata
./references/sdk-umi.md
+ 
./references/sdk-token-metadata.md
SDK：压缩NFT（Bubblegum）
./references/sdk-umi.md
+ 
./references/sdk-bubblegum.md
SDK：基于 Kit 的 Token Metadata
./references/sdk-token-metadata-kit.md
SDK：代币发行（Genesis）
./references/sdk-umi.md
+ 
./references/sdk-genesis.md
账户结构、PDA、概念
./references/concepts.md

CLI Capabilities

CLI 功能

The 
mplx
CLI can handle most Metaplex operations directly. Read 
./references/cli.md
for shared setup, then the program-specific file.
TaskCLI Support
Create fungible token✅
Create Core NFT/Collection✅
Create TM NFT/pNFT✅
Transfer TM NFTs✅
Transfer fungible tokens✅
Transfer Core NFTs❌ SDK only
Upload to Irys✅
Candy Machine drop✅ (setup/config/insert — minting requires SDK)
Compressed NFTs (cNFTs)✅ (batch limit ~100, use SDK for larger)
Check SOL balance / Airdrop✅
Query assets by owner/collection❌ SDK only (DAS API)
Token launch (Genesis)✅
mplx
CLI 可直接处理大多数 Metaplex 操作。先阅读 
./references/cli.md
了解通用设置，再阅读对应程序的文件。
任务CLI 支持情况
创建可替代代币✅
创建 Core NFT/集合✅
创建 TM NFT/pNFT✅
转移 TM NFT✅
转移可替代代币✅
转移 Core NFT❌ 仅支持 SDK
上传至 Irys✅
Candy Machine 发售✅（设置/配置/插入 —— 铸造需要SDK）
压缩NFT（cNFT）✅（批量上限约100，大规模操作请使用SDK）
查看 SOL 余额 / 空投✅
按所有者/集合查询资产❌ 仅支持 SDK（DAS API）
代币发行（Genesis）✅

Program IDs

程序ID

Token Metadata:  metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s
Core:            CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d
Bubblegum V1:    BGUMAp9SX3uS4efGcFjPjkAQZ4cUNZhtHaMq64nrGf9D
Bubblegum V2:    BGUMAp9Gq7iTEuizy4pqaxsTyUCBK68MDfK752saRPUY
Core Candy:      CMACYFENjoBMHzapRXyo1JZkVS6EtaDDzkjMrmQLvr4J
Genesis:         GENSkbJAfXcp9nvQm9eBPMg4MUefawD4oBNK7P8aLvEC
Token Metadata:  metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s
Core:            CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d
Bubblegum V1:    BGUMAp9SX3uS4efGcFjPjkAQZ4cUNZhtHaMq64nrGf9D
Bubblegum V2:    BGUMAp9Gq7iTEuizy4pqaxsTyUCBK68MDfK752saRPUY
Core Candy:      CMACYFENjoBMHzapRXyo1JZkVS6EtaDDzkjMrmQLvr4J
Genesis:         GENSkbJAfXcp9nvQm9eBPMg4MUefawD4oBNK7P8aLvEC

Quick Decision Guide

快速决策指南

NFTs: Core vs Token Metadata

NFT：Core vs Token Metadata

ChooseWhen
CoreNew NFT projects, lower cost (87% cheaper), plugins, royalty enforcement
Token MetadataExisting TM collections, need editions, pNFTs for legacy compatibility
选择场景
Core新NFT项目、成本更低（便宜87%）、支持插件、版税强制执行
Token Metadata现有TM集合、需要版本功能、兼容传统pNFT

Compressed NFTs (Massive Scale)

压缩NFT（大规模发行）

Use Bubblegum when minting thousands+ of NFTs at minimal cost. See 
./references/cli-bubblegum.md
(CLI) or 
./references/sdk-bubblegum.md
(SDK).
当需要低成本铸造数千个以上NFT时，使用 Bubblegum。请查看 
./references/cli-bubblegum.md
（CLI）或 
./references/sdk-bubblegum.md
（SDK）。

Fungible Tokens

可替代代币

Always use Token Metadata. Read 
./references/cli.md
(toolbox section) for CLI commands.
始终使用 Token Metadata。请阅读 
./references/cli.md
（工具箱章节）了解CLI命令。

NFT Drops

NFT发售

Use Core Candy Machine. Read 
./references/cli.md
+ 
./references/cli-candy-machine.md
.
使用 Core Candy Machine。请阅读 
./references/cli.md
+ 
./references/cli-candy-machine.md
。

Token Launches (Token Generation Event / Fair Launch)

代币发行（代币生成事件/公平发行）

Use Genesis. Read 
./references/cli.md
+ 
./references/cli-genesis.md
(CLI) or 
./references/sdk-genesis.md
(SDK).
使用 Genesis。请阅读 
./references/cli.md
+ 
./references/cli-genesis.md
（CLI）或 
./references/sdk-genesis.md
（SDK）。

External Resources

外部资源