OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Developer Tools

Candymachine Client SDK

Candymachine Client SDK is a pre-alpha TypeScript client-side library for creating and managing Metaplex Candy Machine V2 NFT launches on Solana.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Candymachine Client SDK — OpenViST project profile in Developer Tools.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when implementing a client-side workflow specifically for Candy Machine V2 on Solana, rather than integrating a V1 or V3 machine.

Who it is for

  • Developers building browser-based Solana NFT launch workflows.
  • Teams using React or Next.js that need Candy Machine V2 configuration and minting functions.

Documented uses

  • Create a Candy Machine V2 with configurable supply, price, authority, mutability, captcha settings, storage and mint start time.
  • Update a machine when the user is its authority and has the cache file.
  • Explore a machine's minted and remaining NFTs, or mint an NFT from it.
Before you choose

Requirements & limits

The public repository lists an Apache-2.0 license and documents installation through npm, Yarn or pnpm.

  • The project is explicitly pre-alpha, so its stated maturity is an important implementation consideration.
  • Compatibility is limited to Candy Machine V2; V1 and V3 are excluded.
  • The README names Mainnet and Devnet and describes React and Next.js compatibility.
  • Updating requires authority over the machine and access to its cache file.
  • The example uses an Anchor provider, wallet details, asset files and launch configuration.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Install the SDK and prepare a Candy Machine V2 upload

Add the package and follow the README's documented preparation sequence for a browser-side Candy Machine V2 upload.

Before you start

  • A TypeScript project in a browser-capable environment.
  • Candy Machine V2 assets, a configuration, an Anchor provider and wallet details.
  • An intended Solana network; the README names Mainnet and Devnet.

Steps

  1. Install @boxfish-studio/candymachine-client-sdk with npm, Yarn or pnpm.

  2. Import uploadV2, loadCandyProgramV2, StorageType and verifyAssets.

  3. Configure the machine, including supply, price, storage and mint start time, and provide the asset files.

  4. Use verifyAssets to check the files against the selected storage type and configured quantity.

  5. Create the Anchor provider and load the Candy Machine V2 program before passing the prepared values to uploadV2.

Expected outcome

The documented sequence prepares and submits a Candy Machine V2 upload through the SDK.

Guide limitations

  • The README labels the SDK pre-alpha.
  • Only Candy Machine V2 is supported; V1 and V3 are incompatible.
  • The guide reflects the README example and is not a test of execution.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
16 October 2026
Original website title
boxfish-studio/candymachine-client-sdk · Official homepage title · retained in its source language
How we review sourcesSuggest a correction