Candy Machine v2铸造NFT在Phantom显示Collection NFT如何解决

问题现象 #

• 使用candy-machine v2铸造NFT合集，已完成全部配置并通过基础铸造测试，单NFT元数据本地校验全部正常
• Phantom钱包中查看时，合集名称未展示自定义值，统一显示为默认文案"Collection NFT"
  
• 单NFT元数据已按规范填写collection字段，将name、family均设置为test collection，预期钱包展示该自定义合集名，实际未生效。

单NFT元数据配置参考：

{
 "name": "test #0",
  "symbol": "test",
  "description": "testing",
  "seller_fee_basis_points": 1000,
  "image": "0.png",
  "external_url": "test.com",
  "edition": 0,
  "creator": "tester",
  "attributes": [
    {
      "trait_type": "a",
      "value": "a"
    },
    {
      "trait_type": "b",
      "value": "b"
    },
    {
      "trait_type": "c",
      "value": "c"
    }
  ],
  "properties": {
    "files": [
      {
        "uri": "0.png",
        "type": "image/png"
      }
    ],
    "category": "image",
    "creators": [
      {
        "address": "my address here",
        "share": 100
      }
    ]
  },
  "collection": {
    "name": "test collection",
    "family": "test collection"
  }
}

问题根因 #

Phantom等主流Solana钱包不会直接读取NFT元数据里自填的未认证collection.name/collection.family字段，会优先识别经过Metaplex认证的链上合集（MCC标准），未检测到有效链上认证合集时，就会 fallback 显示默认的"Collection NFT"，和你本地元数据里填的collection字段内容无关。

修复步骤 #

• 第一步：铸造合集母NFT
  单独铸造1个作为合集根的NFT，这个NFT的名称填你要展示的自定义合集名test collection，对应上传合集封面图、官方描述，铸造完成后将该NFT存到你的糖果机部署权限钱包中，不要对外发放。
• 第二步：给糖果机绑定合集配置
  在糖果机部署目录下执行命令，将刚铸造的合集母NFT绑定到当前CMv2实例：

  sugar collection set --collection-mint <替换为你的合集母NFT mint地址>
  

• 第三步：批量给已铸造NFT做合集认证
  如果你已经完成全部NFT的铸造，执行批量校验命令，给所有已流出的NFT追加链上合集认证标记（标记为verified: true，和你之前自填的未认证字段有本质区别）：

  sugar collection verify all
  

• 第四步：钱包刷新验证
  等1-2分钟待链上数据同步完成，打开Phantom钱包下拉刷新NFT列表，或者重启钱包清除缓存，即可看到合集名称正常显示为你设置的自定义名称。

注意：如果后续新铸造NFT，糖果机会自动给新NFT打上合集认证标记，不需要重复执行verify命令。

内容的提问来源于stack exchange，提问作者brknarsy