Skill Développement Metaplex

Aperçu

Metaplex fournit l'infrastructure standard pour les NFTs et tokens sur Solana :

Core : Standard NFT nouvelle génération (recommandé pour les nouveaux projets NFT)
Token Metadata : Tokens fongibles + NFTs legacy/pNFTs
Bubblegum : NFTs compressés (cNFTs) utilisant des arbres de Merkle — scalabilité massive à coût minimal
Candy Machine : Drops NFT avec règles de minting configurables
Genesis : Protocole de lancement de tokens avec distribution équitable + graduation de liquidité

Sélection des outils

Préférer CLI à SDK pour l'exécution directe. Utiliser SDK uniquement si l'utilisateur demande explicitement du code.

Approche	Quand l'utiliser
CLI (`mplx`)	Choix par défaut - exécution directe, aucun code nécessaire
Umi SDK	L'utilisateur a besoin de code — choix SDK par défaut. Couvre tous les programmes (TM, Core, Bubblegum, Genesis)
Kit SDK	L'utilisateur utilise spécifiquement @solana/kit, ou demande des dépendances minimales. Token Metadata uniquement — pas de support Core/Bubblegum/Genesis

Routeur de tâches

IMPORTANT : Vous DEVEZ lire le fichier détaillé de votre tâche AVANT d'exécuter une commande ou d'écrire du code. La syntaxe des commandes, les flags requis, les étapes de configuration et les règles de batching se trouvent UNIQUEMENT dans les fichiers détaillés. Ne DEVINEZ PAS les commandes de mémoire.

Type de tâche	Consulter ce fichier
Toute opération CLI (configuration partagée)	`./references/cli.md`
CLI : Core NFTs/Collections	`./references/cli.md` + `./references/cli-core.md`
CLI : NFTs Token Metadata	`./references/cli.md` + `./references/cli-token-metadata.md`
CLI : NFTs compressés (Bubblegum)	`./references/cli.md` + `./references/cli-bubblegum.md`
CLI : Candy Machine (drops NFT)	`./references/cli.md` + `./references/cli-candy-machine.md`
CLI : Lancement de tokens (Genesis)	`./references/cli.md` + `./references/cli-genesis.md`
CLI : Tokens fongibles	`./references/cli.md` (section toolbox)
Configuration SDK (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 : NFTs compressés (Bubblegum)	`./references/sdk-umi.md` + `./references/sdk-bubblegum.md`
SDK : Token Metadata avec Kit	`./references/sdk-token-metadata-kit.md`
SDK : Lancement de tokens (Genesis)	`./references/sdk-umi.md` + `./references/sdk-genesis.md`
Structures de comptes, PDAs, concepts	`./references/concepts.md`

Capacités CLI

Le CLI mplx peut traiter la plupart des opérations Metaplex directement. Lisez ./references/cli.md pour la configuration partagée, puis le fichier spécifique au programme.

Tâche	Support CLI
Créer un token fongible	✅
Créer Core NFT/Collection	✅
Créer TM NFT/pNFT	✅
Transférer TM NFTs	✅
Transférer tokens fongibles	✅
Transférer Core NFTs	❌ SDK uniquement
Uploader vers Irys	✅
Drop Candy Machine	✅ (setup/config/insert — minting requiert SDK)
NFTs compressés (cNFTs)	✅ (limite de batch ~100, utiliser SDK pour plus)
Vérifier solde SOL / Airdrop	✅
Requêter assets par propriétaire/collection	❌ SDK uniquement (DAS API)
Lancement de tokens (Genesis)	✅

IDs des programmes

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

Guide rapide de décision

NFTs : Core vs Token Metadata

Choisir	Quand
Core	Nouveaux projets NFT, coût inférieur (87% moins cher), plugins, application des royalties
Token Metadata	Collections TM existantes, besoin d'éditions, pNFTs pour compatibilité legacy

NFTs compressés (Scalabilité massive)

Utiliser Bubblegum pour minter des milliers+ de NFTs à coût minimal. Voir ./references/cli-bubblegum.md (CLI) ou ./references/sdk-bubblegum.md (SDK).

Tokens fongibles

Toujours utiliser Token Metadata. Lisez ./references/cli.md (section toolbox) pour les commandes CLI.

Drops NFT

Utiliser Core Candy Machine. Lisez ./references/cli.md + ./references/cli-candy-machine.md.

Lancements de tokens (Token Generation Event / Fair Launch / Memecoin)

Utiliser Genesis. L'API Launch (genesis launch create / createAndRegisterLaunch) est recommandée — elle gère tout en une seule étape. Deux types de lancement :

project (par défaut) : Allocations configurables, dépôt 48h, support du vesting d'équipe
memecoin : Simplifié, dépôt 1h, flux de fonds codifiés — nécessite uniquement le nom, symbole, image et heure de début de dépôt

Lisez ./references/cli.md + ./references/cli-genesis.md (CLI) ou ./references/sdk-genesis.md (SDK).

Vérification

Un vrai appel RPC/SDK a été émis (mainnet, devnet ou validateur local) et la charge utile de réponse est capturée dans la transcription, pas juste paraphrasée
Chaque transaction a été simulée (simulateTransaction ou équivalent) avant toute étape de signature/envoi ; les logs de simulation sont attachés
Pour toute transaction signée/envoyée, la signature résultante est enregistrée et confirmée on-chain (statut retourné par getSignatureStatuses ou une URL d'explorateur)
Les slippages, priority-fees et limites de compute-units sont définis explicitement avec des valeurs numériques concrètes, pas laissés aux défauts de la bibliothèque
Les adresses de comptes, mints et program IDs utilisés dans l'exécution correspondent aux adresses metaplex-nfts documentées pour le cluster ciblé (pas de mélange mainnet/devnet)
Le chemin d'échec a été exercé au moins une fois (solde insuffisant, oracle obsolète, blockhash expiré, etc.) et la gestion d'erreur de l'agent a produit un message lisible

Ressources externes

Documentation : https://developers.metaplex.com
Core : https://developers.metaplex.com/core
Token Metadata : https://developers.metaplex.com/token-metadata
Bubblegum : https://developers.metaplex.com/bubblegum-v2
Candy Machine : https://developers.metaplex.com/core-candy-machine
Genesis : https://developers.metaplex.com/genesis