You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Candy Machine V2如何配置WL钱包白名单模式并支持多白名单

问题答复

首先明确结论:Candy Machine V2 原生不支持纯钱包地址模式的白名单配置,你检索不到对应文档不是关键词问题,是该功能从合约层到官方CLI、官方前端配套逻辑里都没有实现。Candy Machine V2 官方内置的唯一白名单方案就是你目前在用的SPL代币持有校验模式。

如果要实现无代币的钱包地址白名单、且支持多组白名单配置,可以参考以下可落地方案:

  • 方案1:前置校验+门限签名方案(改造成本最低,无需修改CM核心合约)
    该方案把白名单校验逻辑移到交易发起前,不依赖CM本身的白名单能力:
    • 本地维护多组独立白名单列表,比如OG白名单、普通白名单、合作渠道白名单,不同列表可对应不同的mint时间、mint价格、可mint数量规则
    • 部署轻量校验服务,用户连接钱包发起mint前,服务先校验用户地址是否在当前开放的白名单分组内,校验通过则给用户的mint交易返回服务端签名
    • 配置Candy Machine V2的mint权限,仅认可该服务端对应地址签发的签名交易,非白名单地址拿不到有效签名就无法发起合法mint交易
    • 注意配置时要关闭CM原生的SPL白名单校验规则,在guards配置中开启签名校验规则,同时锁死CM的其他mint入口,避免规则被绕过
  • 方案2:自定义代理合约方案(全链上无中心化依赖)
    如果不想依赖中心化校验服务,可以自行开发轻量代理合约:
    • 将多组白名单地址映射存在代理合约的存储中,给不同白名单组配置对应的mint权限规则
    • 用户mint时先调用代理合约,合约校验地址属于对应白名单组后,再代用户调用Candy Machine V2的mint接口完成铸造
    • 该方案需要自行完成合约安全审计,避免出现权限绕过、盗mint类漏洞
  • 方案3:升级至Candy Machine V3(官方原生支持,稳定性最高)
    如果项目还未进入mint窗口期,最稳妥的方案是升级到Metaplex Candy Machine V3版本:
    • V3版本原生支持多组独立Guard(守卫规则)配置,除SPL代币门控外,自带地址白名单门控能力,无需向用户发放任何WL代币
    • 配置时只需将白名单地址生成Merkle树写入对应allowlist Guard配置即可,多组白名单可以绑定不同的mint阶段,分别配置价格、限额、开放时间,官方CLI和前端SDK全链路支持,不需要额外开发自定义服务或合约

如果坚持使用Candy Machine V2,优先选方案1即可,社区绝大多数CM V2的地址白名单需求都是用这个方案实现的,配置成本最低,出问题的概率也最小。


内容的提问来源于stack exchange,提问作者bschmitty

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 08:39:20