Get StartedBubblegum IDL
BGUMAp9Gq7iTEuizy4pqaxsTyUCBK68MDfK752saRPUYMetaplex Bubblegum is the compressed NFT (cNFT) program on Solana. Enables minting millions of NFTs at a fraction of the cost using Merkle trees for state compression while maintaining full on-chain verifiability.
Instructions
Account Types
Integration Examples
Use the Bubblegum 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 Bubblegum IDL
import idl from "./bubblegum.json";
const PROGRAM_ID = new PublicKey("BGUMAp9Gq7iTEuizy4pqaxsTyUCBK68MDfK752saRPUY");
// 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.bubblegum
.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.12.0",
"name": "bubblegum",
"instructions": [
{
"name": "burn",
"accounts": [
{
"name": "treeAuthority",
"isMut": false,
"isSigner": false
},
{
"name": "leafOwner",
"isMut": false,
"isSigner": false
},
{
"name": "leafDelegate",
"isMut": false,
"isSigner": false
},
{
"name": "merkleTree",
"isMut": true,
"isSigner": false
},
{
"name": "logWrapper",
"isMut": false,
...Frequently Asked Questions
What is the Bubblegum IDL?
The Bubblegum IDL (Interface Definition Language) is a JSON schema that defines the on-chain program interface for the Bubblegum smart contract on Solana. It describes all available instructions, account structures, events, and custom types that developers need to interact with the Bubblegum program. This IDL contains 17 instructions, 2 account types, 0 events, and 12 type definitions.
How do I use the Bubblegum 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 Bubblegum program address on Solana?
The Bubblegum program is deployed at address BGUMAp9Gq7iTEuizy4pqaxsTyUCBK68MDfK752saRPUY on Solana mainnet. You can verify this on any Solana block explorer.
What version of the Bubblegum IDL is this?
This is version 0.12.0 of the Bubblegum 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.