Core Candy Machine - Vanity Mint Guard

The Vanity Mint guard requires the minter to supply an asset address that matches a configured regular expression, effectively adding a Proof of Work requirement to the minting process.

Overview

The Vanity Mint guard allows minting if the specified mint address matches a specific format. This guard basically allows to add a Proof of Work (POW) requirement where the user has to grind for a Public Key that matches the pattern.

If the minter does not use a matching mint address, minting will fail.

Guard Settings

The Vanity Mint guard contains the following settings:

• Regular Expression: A Regex that the mint address has to match. E.g. if you want all mints to start with string mplx you could use this as regex Parameter.

Ideas for regular expressions that can be used for example could be:

• Starting with a specific pattern: ^mplx
• Ending with a specific pattern: mplx$
• Starting and Ending with a specific pattern: ^mplx*mplx$
• Exactly matches a specific pattern: ^mplx1111111111111111111111111111111111111mplx$ The string mplx would need to be replaced with the expected characters.

create(umi, {
  // ...
  guards: {
    vanityMint: some({
      regex: "^mplx*mplx$",
    }),
  },
});

Mint Settings

The Vanity Mint guard does not require mint settings. It expects the mint address to match.

Route Instruction

The Vanity Mint guard does not support the route instruction.

Notes

• The regular expression is matched against the base-58 encoded public key of the mint address. Only characters valid in base-58 encoding (alphanumeric, excluding 0, O, I, and l) can appear in mint addresses.
• More restrictive regex patterns (longer prefixes or suffixes) require exponentially more computational effort from the minter to find a matching keypair. Consider the user experience when setting pattern complexity.
• The Vanity Mint guard does not require any mint settings or route instructions -- it only validates the mint address against the configured pattern.