MPL-Bubblegum Javascript SDK

Metaplex provides a JavaScript library that can be used to interact with the MPL-Bubblegum program. Thanks to the Umi Framework, it ships without many opinionated dependencies thus providing a lightweight library that can be used in any JavaScript project.

To get started, you'll need to install the Umi framework and the MPL-Bubblegum JavaScript library.

Installation

Installation can be executed with any of the JS package managers, npm, yarn, bun etc...

npm install @metaplex-foundation/mpl-bubblegum

Umi Setup

An umi instance is required to interact with the Metaplex Javascript SDKs. If you haven't set up and configured an umi instance yet then you can get checkout the Umi Getting Started page and configure your RPC endpoint and your umi identity/signer.

During the initialization of the umi instance you can add the MPL-Bubblegum package to umi using

.use(mplCore())

You can add the mplCore() package anywhere in your umi instance creation with .use().

import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
import { mplbubblegum } from '@metaplex-foundation/mpl-bubblegum'

// Use the RPC endpoint of your choice.
const umi = createUmi('http://api.devnet.solana.com')
... // additional umi settings, packages, and signers
.use(mplBubblegum())

From here your umi instance will have access to the MPL-Bubblegum package and you start to explore the MPL-Bubblegum feature set.