Get StartedCandy Machine v1 IDL
cndyAnrLdpjq1Ssp1z8xxDsB8dxe7u4HL5Nxi2K5WXZMetaplex Candy Machine v1 is the original NFT minting program on Solana. Enables collection creators to set up fair launches with configurable mint prices, go-live dates, and per-wallet limits.
Instructions
Account Types
Integration Examples
Use the Candy Machine v1 IDL in your application with these code examples for TypeScript, Rust, and Python.
import { Connection, PublicKey } from "@solana/web3.js";
import { Program, AnchorProvider, Idl } from "@coral-xyz/anchor";
// Load the Candy Machine v1 IDL
import idl from "./candy machine v1.json";
const PROGRAM_ID = new PublicKey("cndyAnrLdpjq1Ssp1z8xxDsB8dxe7u4HL5Nxi2K5WXZ");
// Set up the provider and program
const connection = new Connection("https://api.mainnet-beta.solana.com");
const provider = new AnchorProvider(connection, wallet, {
commitment: "confirmed",
});
const program = new Program(idl as Idl, provider);
// Fetch and decode an account
const accountData = await program.account.candy_Machine_v1
.fetch(accountPublicKey);
console.log("Account data:", accountData);
// Build and send an instruction
const tx = await program.methods
.initialize(/* ...args */)
.accounts({
/* ...required accounts */
})
.rpc();
console.log("Transaction signature:", tx);IDL JSON Preview
{
"version": "0.1.0",
"name": "nft_candy_machine",
"instructions": [
{
"name": "mintNft",
"accounts": [
{
"name": "config",
"isMut": false,
"isSigner": false
},
{
"name": "candyMachine",
"isMut": true,
"isSigner": false
},
{
"name": "payer",
"isMut": true,
"isSigner": true
},
{
"name": "wallet",
"isMut": true,
"isSigner": false
},
{
"name": "metadata",
"isMut": true,
...Frequently Asked Questions
What is the Candy Machine v1 IDL?
The Candy Machine v1 IDL (Interface Definition Language) is a JSON schema that defines the on-chain program interface for the Candy Machine v1 smart contract on Solana. It describes all available instructions, account structures, events, and custom types that developers need to interact with the Candy Machine v1 program. This IDL contains 7 instructions, 2 account types, 0 events, and 4 type definitions.
How do I use the Candy Machine v1 IDL in my project?
Download the JSON file and import it in your project. With TypeScript, use the @coral-xyz/anchor package to create a Program instance. In Rust, use anchor-client. For Python, use anchorpy. See the integration examples above for complete code snippets in all three languages.
What is the Candy Machine v1 program address on Solana?
The Candy Machine v1 program is deployed at address cndyAnrLdpjq1Ssp1z8xxDsB8dxe7u4HL5Nxi2K5WXZ on Solana mainnet. You can verify this on any Solana block explorer.
What version of the Candy Machine v1 IDL is this?
This is version 0.1.0 of the Candy Machine v1 IDL. IDL versions correspond to specific program deployments and may be updated as the protocol evolves. Always verify compatibility with the on-chain program version before integrating.