Redeemed Amount Guard

The Redeemed Amount guard forbids minting when the total number of minted Assets across the entire Core Candy Machine reaches a configured maximum, enabling global supply caps and tiered minting phases.

Overview

The Redeemed Amount guard forbids minting when the number of minted Assets for the entire Core Candy Machine reaches the configured maximum amount.

This guard becomes more interesting when used with Guard Groups since it allows us to add global minting thresholds to our groups.

Guard Settings

The Redeemed Amount guard contains the following settings:

• Maximum: The maximum amount of NFTs that can be minted.

create(umi, {
  // ...
  itemsAvailable: 500,
  guards: {
    redeemedAmount: some({ maximum: 300 }),
  },
});

Notice that, even if the Candy Machine contains 500 items, only 300 of these items will be mintable because of this guard.

Thus, this guard becomes more useful when using Guard Groups. Here's another example using two groups such that the first 300 Assets can be minted for 1 SOL but the last 200 will need 2 SOL to mint.

create(umi, {
  // ...
  itemsAvailable: 500,
  groups: [
    {
      label: "early",
      guards: {
        redeemedAmount: some({ maximum: 300 }),
        solPayment: some({ lamports: sol(1), destination: treasury }),
      },
    },
    {
      label: "late",
      guards: {
        solPayment: some({ lamports: sol(2), destination: treasury }),
      },
    },
  ],
});

Mint Settings

The Redeemed Amount guard does not need Mint Settings.

Route Instruction

The Redeemed Amount guard does not support the route instruction.

Notes

• The Redeemed Amount guard tracks total mints across the entire Core Candy Machine, not per-wallet. To limit mints per wallet, use the Mint Limit guard instead.
• The maximum value must be less than or equal to itemsAvailable on the Candy Machine to have any practical effect.
• When used with Guard Groups, the Redeemed Amount counter is shared globally across all groups, making it ideal for implementing tiered pricing phases.