Candy Machine v2 - Notes from the office hours

V2? V2!
There are different reasons for a new Version. The one that triggered our man Jordan was probably bots sniping on mints.

Follow me on Twitter

Image Not Showing Possible Reasons

The image file may be corrupted
The server hosting the image is unavailable
The image path is incorrect
The image format is not supported

Learn More →

@MarkSackerberg if you like my work.
You can also DM me or

Image Not Showing Possible Reasons

The image file may be corrupted
The server hosting the image is unavailable
The image path is incorrect
The image format is not supported

Learn More →

@9HOMIES if you want to work together!

Have a look at

Image Not Showing Possible Reasons

The image file may be corrupted
The server hosting the image is unavailable
The image path is incorrect
The image format is not supported

Learn More →

SolSlimes to see more of my work!

Key differences

There are quite big changes and I will elaborate on them in the future, but first have some top level bullet points to get an overview:

Whitelist
- With SPL Tokens (airdropped or distributed via gumdrop)
- presale boolean allows users with the token to mint before the start date
- Payment with presale token + SOL possible
- discounted price for users with tokens possible
- Whitelist token can either be burned or stay with the holder
Randomized mint
- Bots will not be able to mint specific NFTs anymore because the next mint is determined quite randomly. Not just based on a counter anymore
Gatekeeper / Captcha
- Some kind of captcha integration (currently with Civic Technologies). Result is stored on chain, so if you activate that the UX might not be as good as before but no bots can mint!
- In the futre other Gatekeepers than civic are possible.
All settings modifiable.
- With v1 you could e.g. not change the "currency". Now you can change the accepted mint
ExiledApes mint button not compatible anymore. You can use the candy machine ui or community frontends instead

Build your own!

From my point of view the things got much easier. At least less commands are required. But let's do it step by step:

Clone & install Metaplex

git clone https://github.com/metaplex-foundation/metaplex.git Clone metaplex from github. If you already have metaplex locally make sure to run git pull .
go into js folder (cd js)
run yarn install

1. Settings

One huge difference to v1: The candy machine and config are one account now. Therefore we need to provide all the information directly (can be updated though). We don't have a create_candy_machine command later on.

We do not do the configuration with hundreds of CLI parameters anymore. Instead we can build a config.json file for most of our parameters. The documentation on this is already quite good, so I will skip explaining all the parameters for now.

Make sure that you do not delete anything but instead set them to null. E.g. if you don't need the endSettings do '"endSettings": null' instead of removing the line completely. Otherwise you will receive error 0x66

Use this as basis and save it somewhere e.g. as config.json

{
    "price": 0.01,
    "number": 6,
    "gatekeeper": null,
    "solTreasuryAccount": "G2j7mmWuA9AH7u8Ykxm1hSuizxJk8u8YYBUZkuMvmytM",
    "splTokenAccount": null,
    "splToken": null,
    "goLiveDate": "11 Dec 2021 13:00:00 GMT",
    "endSettings": {
        "endSettingType": { "amount": true },
        "value": 5
        },
    "whitelistMintSettings": {
        "mode": { "burnEveryTime": true },
        "mint": "7nE1GmnMmDKiycFkpHF7mKtxt356FQzVonZqBWsTWZNf",
        "presale": true,
        "discountPrice": 0.5
        },
    "hiddenSettings": null,
    "storage": "arweave",
    "ipfsInfuraProjectId": null,
    "ipfsInfuraSecret": null,
    "awsS3Bucket": null,
    "noRetainAuthority": false,
    "noMutable": false
  }

Explanation for the different fields in config.json

Option	Sub-Option	possible values	description
Price		Numbers	Price in SOL or SPL tokens
number		Integer	Amount of NFTs in the candy machine
solTreasuryAccount		Publickey / null	Account SOL proceedings should go to
splTokenAccount		Publickey / null	Account SPL proceedings should go to
splToken		Publickey / null	Mint Adress of the SPL token the machine is paid with
goLiveDate		Datetime	Date where "normal" users can mint. (Can be circumvented by CM Authority and whitelist)
endSettings		options / null	Date or mint amount after which the Candy machine is closed
	endSettingstype		type of end setting
	-amount	boolean	end after n mints
	-value	Integer	amount of mints before end
tbc…

2. Upload

This step is similar to v1. Except that we need to add one config parameter -cp <config location>

e.g. your command could look like this:

ts-node candy-machine-v2-cli.ts upload -e devnet -k <path to keyfile> -cp <path to config.json> <path to assets> -c <cache file name>

3. Verify

DO NOT SKIP THIS STEP!

This step checks if the upload of all files was successful. Command can look like that:

ts-node candy-machine-v2-cli.ts verify -e devnet -k <path to keyfile> -cp <path to config.json>  -c <cache file name>

Only proceed if it says successful. Otherwise run the upload command again!

4. Mint

That's it already. You can test your candy machine with the mint_one_token command.

ts-node candy-machine-v2-cli.ts mint_one_token -e devnet -k <path to keyfile> -cp <path to config.json>  -c <cache file name>

5. Build a frontend

Well, I lied. The candy machine is set up and technically you can mint, but obviously you want to give your community the chance to mint, too. Unfortunately the v1 standard "exiledApes" mint button repository does not work anymore. But there are alternatives.

candy machine ui

You can use the frontend of the fair launch protocol which is already in the metaplex repository. Just go into metaplex/js/packages/candy-machine-ui and modify the .env file.

After REACT_APP_CANDY_MACHINE_ID add the ID of your candy machine. The ID was printed when running the upload command. You can also see it in the file in the .cache folder in metaplex/js/packages/cli/src/.cache
Change to correct network. I was talking about devnet the whole time, so make sure that no # is in front of the lines with devnet (line 3+4) but instead in front of mainnet (line 6+7) like you can see below

REACT_APP_CANDY_MACHINE_ID=<YOUR CANDY MACHINE PROGRAM ID>

REACT_APP_SOLANA_NETWORK=devnet
REACT_APP_SOLANA_RPC_HOST=https://api.devnet.solana.com

Run yarn start in metaplex/js/packages/candy-machine-ui to run a local version of the front end. You can test minting here!
Do changes to the frontend. It's lame if all look the same!
Deploy it to cloudflare / vercel / whatever.

Community frontend by TonyBoyle.eth

https://github.com/tonyboylehub/candymachine-v2-boiler-mint-site-noFLP

Caveats

1. Gumdrop

Currently Gumdrop will not directly work with v2 right now. Jordan confirmed that it will work in the future, though.

There is a workaround:

Use gumdrop to give your users SPL tokens
Modify the candy machine config to accept the SPL token as whitelist token.

FAQ & Troubleshooting

Using SPL tokens as whitelist token

create a SPL token. Make sure to use option --decimals 0 e.g. like spl-token create-token --decimals 0
Distribute it to your users. (e.g. with Gumdrop). (can also be done ofter setting up the machine)
Configure your candy machine. The following config will accept a presale token and burn 1 on every mint. It will not give a discounted price.

One examle config file that has been confirmed working. Look into the docs for more details!

    "price": 0.01,
    "number": 10,
    "gatekeeper": null,
    "solTreasuryAccount": "<your wallet>", 
    "splTokenAccount": null,
    "splToken": null,
    "goLiveDate": "1st Jan 2022 00:00:00 GMT",
    "endSettings": {
        "endSettingType": { "date":true },
        "value":"25 Dec 2022 23:59:00 GMT"
    },
    "whitelistMintSettings": { // THIS IS THE IMPORTANT THING HERE!
        "mode" : { "burnEveryTime": true },
        "mint" : "E5BuTQcD22n6FyC2RWMtVNH2uZVNqAcy5855P8GrTxx4", //your SPL token mint
        "presale" : true, //enable the wallets having the token to mint before start date
        "discountPrice" : null // preminter have same price as normal minters
    },
    "hiddenSettings": null,
    "storage": "arweave",
    "ipfsInfuraProjectId": null,
    "ipfsInfuraSecret": null,
    "awsS3Bucket": null,
    "noRetainAuthority": false,
    "noMutable": false
}

TypeError: Cannot read properties of undefined (reading 'slice') / FLP Frontend not working

Thats an issue with the current master branch. FLP frontend is broken here. You can e.g. use the branch
fix-arweave-upload

Clone it with git clone -b fix-arweave-upload https://github.com/metaplex-foundation/metaplex.git or just copy the flp folder out of this branch.

Some Reports say that it helps to

checkout the above branch,
copy the /js/packages/fair-launch folder to another location
run yarn add -d @types/canvas-confetti if that does not work try npm i --save-dev @types/canvas-confetti
run yarn install and yarn start

Signing your NFTs

The sign_all CLI command does currently not work for candy machine v2. It does not find unverified metadata. What you can do is use Metaboss to sign your NFTs. Donwload it and run

metaboss sign all -k <path-to-keypair> --candy-machine-id <first-creator-pubkey>

Make sure that you are NOT using the candy machine ID but the first creator instead.

Error: The file assets/.DS_Store is not a supported file type

There is a hidden Folder called .DS_Store in your asset folder. In case you can't find it you can run this script to delete it.
find ./assets -name .DS_Store -exec rm {} ;

Guest Beck2021/12/26 08:35:05

new PublicKey(cacheContent.program.candyMachine), ^ TypeError: Cannot read properties of undefined (reading 'program') at Command.<anonymous> (Edited)

Guest Kelley2021/12/26 08:39:12

That's my verify result

Guest Williams2022/01/01 19:05:59

I get the same result - did you fix this?

Guest Williams2022/01/01 19:07:20

Fixed. I specified the wrong cache file

Guest Stone2021/12/26 08:38:30

Beginning the upload for 20 (img+json) pairs started at: 1640507879507 Size 0 undefined Done. Successful = true. ended at: 2021-12-26T08:37:59.510Z. time taken: 00:00:00 (Edited)

Guest Kelley2021/12/26 08:38:47

That's my upload result

Guest McGee2021/12/26 08:43:37

NVM (Edited)

Guest Morris2021/12/26 08:57:16

upload was not successful, please re-run. TypeError: Cannot read properties of undefined (reading '_bn') (Edited)

Guest Estrada2022/01/10 00:05:16

I have the same thing! ahh

Guest Jacobs2022/02/11 06:56:20

For me, it turned out i put the sol treasury address in the wrong place. Double check your config.

Guest Holloway2021/12/29 14:05:35

This step is similar to v1. Except that we need to add one config parameter `-cp <config

I get this error when trying to use the upload function Error deploying config to Solana network. TypeError: src.toArrayLike is not a function (Edited)

Guest Bowen2021/12/30 02:58:12

Error: Storage option must either be arweave-bundle, arweave-sol, arweave, ipfs, aws. Got: undefined (Edited)

Guest Sutton2022/01/02 06:19:24

Randomized mint * Bots will not be able to mint specific NFTs anymore because the next mint is determined quite randomly. Not just based on a counter anymore

This is because the config lines are added "randomly" in parallel right? is this explicitly random? (Edited)

Guest Boyd2022/01/02 06:20:04

Would it be feasible to generate a truly random ordering first, and then upload them in order?

Guest Swanson2022/01/02 19:51:46

When executing V2 I receive the following error: (Edited)

Guest Hardy2022/01/02 19:53:21

When executing V2 I receive the following error:[ TSError: ⨯ Unable to compile TypeScript: js/packages/cli/src/helpers/accounts.ts:578:36 - error TS2339: Property 'Wallet' does not exist on type 'typeof import("/Users/XXXXX/Desktop/solana/metaplex-master/node_modules/@project-serum/anchor/dist/cjs/index")'. Any ideas? I have been searching but cannot find a solution. (Edited)

anguslai

2022/01/05 16:34:31

Run `yarn start` in `metaplex/js/packages/candy-machine-ui` to run a local version of the front end. You can test minting here!

https://github.com/metaplex-foundation/metaplex/issues/1401 I stuck on here, is it the bugs of metaplex or module version should not use the most updated? (Edited)

Guest Watson2022/01/05 23:16:00

not give a d

is this meant to be it will NOT give a discounted price (Edited)

Guest Montgomery2022/01/06 16:19:39

documentation

Perhaps should link to the docs page: https://docs.metaplex.com/candy-machine-v2/configuration (Edited)

Guest Robinson2022/01/10 00:00:52

/Users/Bryson/metaplex/js/node_modules/@solana/web3.js/src/publickey.ts:29 return (value as PublicKeyData)._bn !== undefined; ^ TypeError: Cannot read properties of null (reading '_bn') at isPublicKeyData (/Users/Bryson/metaplex/js/node_modules/@solana/web3.js/src/publickey.ts:29:35) at new PublicKey (/Users/Bryson/metaplex/js/node_modules/@solana/web3.js/src/publickey.ts:45:9) at getCandyMachineV2Config (/Users/Bryson/metaplex/js/packages/cli/src/ (Edited)

Guest Singleton2022/01/10 00:25:38

return (value as PublicKeyData)._bn !== undefined; ^ TypeError: Cannot read properties of null (reading '_bn') at isPublicKeyData (/Users/Bryson/metaplex/js/node_modules/@solana/web3.js/src/publickey.ts:29:35) at new PublicKey (/Users/Bryson/metaplex/js/node_modules/@solana/web3.js/src/publickey.ts:45:9) at getCandyMachineV2Config (/Users/Bryson/metaplex/js/packages/cli/src/helpers/various.ts:171:36) at Command.<anonymous> (/Users/Bryson/metaplex (Edited)

Guest Sandoval2022/03/22 01:38:03

I keep getting this error: Error deploying config to Solana network. Error: Invalid public key input at new PublicKey (C:\Users\jakee\OneDrive\Desktop\Solana\~\metaplex\js\node_modules\@solana\web3.js\src\publickey.ts:58:17) at C:\Users\jakee\OneDrive\Desktop\Solana\~\metaplex\js\packages\cli\src\commands\upload.ts:169:24 at Array.map (<anonymous>) at uploadV2 (C:\Users\jakee\OneDrive\Desktop\Solana\~\metaplex\js\packages\cli\src\commands\upload.ts:167:60) at Command.<anonymo (Edited)

Akash Gajera

2022/06/01 05:42:26

Error uploading {"mediaExt":".png","index":"1"} asset (skipping) invalid json response body at https://us-central1-metaplex-studios.cloudfunctions.net/uploadFile reason: Unexpected token E in JSON at position 0WTGncvawms6odEFRqGrK3 *This Error Create Please Help Me* (Edited)

Candy Machine v2 - Notes from the office hours

Key differences

Build your own!

1. Settings

2. Upload

3. Verify

4. Mint

5. Build a frontend

candy machine ui

Community frontend by TonyBoyle.eth

Caveats

1. Gumdrop

FAQ & Troubleshooting

Using SPL tokens as whitelist token

TypeError: Cannot read properties of undefined (reading 'slice') / FLP Frontend not working

Signing your NFTs

Error: The file assets/.DS_Store is not a supported file type

Read more

Gumdrop - Notes from the office hours

Whitelist with Candy v2 - a walkthrough

Make your candy machine "snipe bot proof"