Edition Guard | Core Candy Machine

The Edition guard assigns sequential edition numbers to Assets minted from a Core Candy Machine, starting from a configurable offset value.

Overview

The Edition guard is a special kind of guard. It is not used to charge the buyer, or verify conditions that they are allowed to mint. Instead the Edition guard determines which edition number a created Asset should have.

React Flow

Guard Settings

The Edition guard contains the following settings:

editionStartOffset: The number where the edition number starts counting up.

Set up a Candy Machine using the Edition guard


create(umi, {
  // ...
  guards: {
    edition: { editionStartOffset: 0 },
  },
});

API References: create

Mint Settings

The Edition guard does not need Mint Settings.

Route Instruction

The Edition guard does not require a route instruction.

Notes

The Edition guard does not restrict who can mint or charge a fee -- it solely controls edition number assignment on minted Assets.
Edition numbers increment sequentially from the editionStartOffset value. Setting this to 0 means the first minted Asset receives edition number 0.
The edition counter is tracked via an on-chain PDA (Edition Counter PDA), ensuring each mint receives a unique, sequential edition number.