Candy Machine

Candy Machine es el protocolo de minting justo de Metaplex para lanzar colecciones de NFT con guardas (listas de permitidos, pagos, fechas de inicio, límites). Candy Machine v3 (CndyV3LdqHUfDLmE5naZjVN8rBZz4tqhdedBYaPJrtzc) se dirige a activos de Token Metadata; las grandes tiradas a menudo usan cNFT en su lugar.

Receta

# Sugar CLI orquesta el despliegue y la revelación de Candy Machine
sugar launch
sugar deploy
sugar mint

import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { mplCandyMachine } from "@metaplex-foundation/mpl-candy-machine";

Cuándo recurrir a esto:

• Mint público justo con guardas configurables
• Fases de lista de permitidos (merkle, token gate)
• Mints de pago que enrutan SOL a la tesorería
• Lanzamientos de colecciones de Token Metadata con flujo de trabajo de revelación

Ejemplo de Trabajo

import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { mplCandyMachine } from "@metaplex-foundation/mpl-candy-machine";
import { generateSigner, publicKey } from "@metaplex-foundation/umi";
import { fetchCandyMachine } from "@metaplex-foundation/mpl-candy-machine";
 
const umi = createUmi("https://api.devnet.solana.com").use(mplCandyMachine());
 
// Alto nivel: Sugar genera config.json + assets, despliega la cuenta de CM
// Mint programático desde la máquina desplegada:
const candyMachine = publicKey("CANDY_MACHINE_PUBKEY");
 
const cm = await fetchCandyMachine(umi, candyMachine);
console.log("items disponibles:", cm.data.itemsAvailable);
console.log("items acuñados:", cm.itemsRedeemed);

# Flujo de trabajo típico de Sugar
sugar validate
sugar upload    # assets a Arweave/IPFS
sugar deploy    # crea Candy Machine on-chain
sugar mint      # prueba de mint

Lo que esto demuestra:

• La cuenta de Candy Machine rastrea el suministro y el recuento de acuñados
• Las guardas imponen reglas de pago, tiempo y lista de permitidos por transacción de mint
• Sugar CLI es la cadena de herramientas estándar del operador para lanzamientos de CM

Análisis Profundo

Cómo Funciona

• Candy Machine contiene la configuración: precio, fecha de inicio, conjuntos de guardas, configuraciones ocultas
• Cada instrucción mint incrementa itemsRedeemed y crea un NFT según la configuración
• Guardas modulares: pago en sol, pago en token, lista de permitidos merkle, límite de mint
• Revelación: las configuraciones ocultas intercambian una URI de marcador de posición por los metadatos finales después del mint

CM vs cNFT a Escala

Notas de TypeScript

// Siempre simula el mint antes del lanzamiento público
// Monitoriza itemsRedeemed vs itemsAvailable durante la ventana de mint

Errores Comunes

• Carrera por agotado - mints concurrentes exceden el suministro. Solución: guardas + tarifas de prioridad de CU adecuadas.
• Metadatos no revelados para siempre - la transacción de revelación no se ejecuta. Solución: automatizar el crank de revelación post-mint.
• Configuración de guarda incorrecta - explotación de mint gratuito. Solución: auditar guardas en devnet con pruebas adversarias.
• Fallos de carga de Arweave - imágenes rotas en el mint. Solución: sugar validate + verificación de URIs.
• Usar CM para tirada de 100k+ - alquiler prohibitivo. Solución: usar el pipeline cNFT de Bubblegum.

Alternativas

Preguntas Frecuentes

Relacionado

• Metadatos y Almacenamiento - alojamiento de assets
• Colecciones y Verificación - configuración de colecciones
• NFTs Comprimidos (Bubblegum) - tiradas grandes

Versiones del Stack: Esta página se escribió para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.