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 mintimport { 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 mintLo 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
mintincrementaitemsRedeemedy 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
| Enfoque | Costo por mint | Estándar |
|---|---|---|
| Candy Machine v3 | Más alto (cuentas de mint completas) | Token Metadata |
| Bubblegum cNFT | Muy bajo | Comprimido |
Notas de TypeScript
// Siempre simula el mint antes del lanzamiento público
// Monitoriza itemsRedeemed vs itemsAvailable durante la ventana de mintErrores 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
| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Mint masivo con Bubblegum | 10k+ ítems | Necesitas Token Metadata completo on-chain |
| Sitio de mint personalizado Core | Control total, suministro menor | Necesitas biblioteca de guardas probada en batalla |
| Mint manual desde tesorería | Solo amigos y familiares | Lanzamiento público justo |
Preguntas Frecuentes
¿Qué es Candy Machine?
Contrato de mint de Metaplex con sistema de guardas para drops de NFT justos.
¿ID del programa Candy Machine?
v3: CndyV3LdqHUfDLmE5naZjVN8rBZz4tqhdedBYaPJrtzc.
¿Qué es Sugar?
CLI que agrupa la carga de assets, el despliegue de CM y las pruebas de mint.
¿Qué son las guardas?
Reglas componibles: pago SOL, fecha de inicio, lista de permitidos, límite de mint por billetera, etc.
¿Configuraciones ocultas?
URI de marcador de posición en el mint; la autoridad revela los metadatos finales más tarde.
¿Soporte Core?
Candy Machine históricamente Token Metadata - consulta la documentación de Metaplex para integraciones de mint Core.
¿Ensayo en Devnet?
Despliegue completo de Sugar en devnet antes de mainnet - prueba las guardas y la revelación.
¿Mitigación de bots?
Límites de mint, listas de permitidos y tarifas de prioridad - no hay una solución única.
¿Reembolsos de mint fallidos?
La guarda de pago SOL devuelve la transacción fallida sin mint - el usuario solo paga la tarifa de red.
¿Seguir el progreso del mint?
Leer itemsRedeemed en la cuenta de Candy Machine o indexar eventos de mint.
¿Actualizar máquina?
Planifica cuidadosamente la configuración inmutable - los cambios a menudo requieren un nuevo despliegue.
¿vs mint personalizado Anchor?
CM proporciona guardas auditadas; personalizado para mecánicas novedosas.
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.