# Gatekeeper Guard

In most cases, this token will be obtained after completing a Captcha challenge but any Gatekeeper Network may be used.

There isn’t much to set up on the Core Candy Machine side but, depending on the selected Gatekeeper Network, you may need to ask the minting wallet to perform so pre-validation checks to grant them the required Gateway Token.

Here are some additional recommended materials you may find helpful when setting up a Gatekeep Network.

* [The CIVIC Documentation](https://docs.civic.com/civic-pass/overview)
* [Gateway JS Library](https://www.npmjs.com/package/@identity.com/solana-gateway-ts)
* [Gateway React Components](https://www.npmjs.com/package/@civic/solana-gateway-react)

Core Candy MachineOwner: Core Candy Machine Core ProgramCandy GuardOwner: Candy Guard ProgramGuardsGatekeeper- Gatekeeper Network- Expire on use...

Request Gateway Token

from the Gatekeeper

Network e.g. Captcha

Gateway Token

Mint from

*Candy Guard Program*

Access Control

Mint from

*Core Candy Machine Program*

Mint Logic

Asset

if a valid token for the given

Network and payer does not exist

Minting will fail

[React Flow](https://reactflow.dev/)

### Guard Settings <a href="#guard-settings" id="guard-settings"></a>

The Gatekeeper guard contains the following settings:

* **Gatekeeper Network**: The public key of the Gatekeeper Network that will be used to check the validity of the minting wallet. For instance, you may use the "**Civic Captcha Pass**" Network — which ensures the minting wallet has passed a captcha — by using the following address: `ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6`.
* **Expire On Use**: Whether we should mark the Gateway Token of the minting wallet as expired after the NFT has been minting.
  * When set to `true`, they will need to go through the Gatekeeper Network again to mint another NFT.
  * When set to `false`, they will be able to mint another NFT until the Gateway Token expires naturally.

Set up a Core Candy Machine using the Gatekeeper guard

JavaScript

```
create(umi, {
  // ...
  guards: {
    gatekeeper: some({
      network: publicKey("ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6"),
      expireOnUse: true,
    }),
  },
});
```

API References: [create](https://mpl-core-candy-machine.typedoc.metaplex.com/functions/create.html), [Gatekeeper](https://mpl-core-candy-machine.typedoc.metaplex.com/types/Gatekeeper.html)

### Mint Settings <a href="#mint-settings" id="mint-settings"></a>

The Gatekeeper guard accepts the following mint settings:

* **Gatekeeper Network**: The public key of the Gatekeeper Network that will be used to check the validity of the minting wallet.
* **Expire On Use**: Whether we should mark the Gateway Token of the minting wallet as expired after the NFT has been minting.
* **Token Account** (optional): As a little disclaimer, you should very rarely need to provide this setting but it’s here if you need to. This refers to the Gateway Token PDA derived from the payer and the Gatekeeper Network which is used to verify the payer's eligibility to mint. This PDA address can be inferred by our SDKs which is why you do not need to provide it. However, some Gatekeeper Networks may issue multiple Gateway Tokens to the same wallet. To differentiate their PDA addresses, it uses a **Seeds** array which defaults to `[0, 0, 0, 0, 0, 0, 0, 0]`.

Note that, if you’re planning on constructing instructions without the help of our SDKs, you will need to provide these Mint Settings and more as a combination of instruction arguments and remaining accounts. See the [Candy Guard’s program documentation](https://github.com/metaplex-foundation/mpl-core-candy-machine/tree/main/programs/candy-guard#gatekeeper) for more details.

Mint with the Gatekeeper Guard

JavaScript

You may pass the Mint Settings of the Gatekeeper guard using the `mintArgs` argument like so.

```
mintV1(umi, {
  // ...
  mintArgs: {
    gatekeeper: some({
      network: publicKey("ignREusXmGrscGNUesoU9mxfds9AiYTezUKex2PsZV6"),
      expireOnUse: true,
    }),
  },
});
```

### Route Instruction <a href="#route-instruction" id="route-instruction"></a>

*The Gatekeeper guard does not support the route instruction.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://8bit-1.gitbook.io/solibrary/gatekeeper-guard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.