功能
Core Collections
Last updated April 8, 2026
Summary
Core Collection 是将相关 Core Asset 组织在共享元数据和插件下的 Solana 账户。
- Collection 存储名称、URI 以及应用于所有成员 Asset 的可选插件
- Asset 在创建或更新时通过
collection字段引用其所属 Collection - 合集级别的插件(例如 Royalties)会传播到所有成员 Asset,除非在 Asset 级别进行了覆盖
- 创建 Collection 需要约 0.0015 SOL 的租金
跳转到任务: 创建 Collection · 获取 Collection · 更新 Collection
什么是 Collection?
Core Collection 是属于同一系列或集合的 Asset 组。要将 Asset 组合在一起,首先需要创建一个 Collection 账户,用于存储共享元数据,如合集名称和图片 URI。Collection 账户充当合集的封面,还可以持有合集范围内的插件。
Collection 账户存储和可访问的数据如下:
| 字段 | 描述 |
|---|---|
| key | 账户键标识符 |
| updateAuthority | 合集的管理者 |
| name | 合集名称 |
| uri | 合集链下元数据的 URI |
| numMinted | 合集中曾经铸造的 Asset 总数 |
| currentSize | 当前合集中的 Asset 数量 |
Core Collection 仅对 Core Asset 进行分组。Token Metadata NFT 请使用 mpl-token-metadata,压缩 NFT 请使用 Bubblegum。
管理合集成员资格
Asset 创建后可以使用 update 指令将其添加到 Collection、在 Collection 之间移动或从 Collection 中移除。这些操作会更改 Asset 的 update authority。添加后设置为 Collection,移除后恢复为钱包地址。
| 操作 | 描述 | 指南 |
|---|---|---|
| 将 Asset 添加到 Collection | 将独立 Asset 分配到此 Collection | SDK · CLI |
| 将 Asset 移动到其他 Collection | 将 Asset 从一个 Collection 转移到另一个 Collection | SDK · CLI |
| 从 Collection 中移除 Asset | 分离 Asset 使其再次成为独立 Asset | SDK · CLI |
更改成员资格需要具有 Collection 的 update authority(如果 Asset 是独立的,还需要 Asset 的权限)。在 Collection 之间移动需要对源 Collection 和目标 Collection 都拥有权限。
Collection 上注册的 Update Delegate 也可以执行这些操作,无需根 update authority 的签名。可以从 Collection 中移除任何 Asset,以及添加其有权限的 Asset。
Notes
- Asset 可以在没有 Collection 的情况下独立存在 — Collection 不是必需的
- 合集级别的插件会被成员 Asset 继承,除非 Asset 拥有同类型的自有插件进行覆盖
numMinted统计合集中曾经创建的所有 Asset 总数,currentSize是实时数量- 包含 Asset 的 Collection 无法关闭 — 请先移除所有 Asset
Quick Reference
程序 ID
| 网络 | 地址 |
|---|---|
| Mainnet | CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d |
| Devnet | CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d |
Collection 操作
| 操作 | 页面 | SDK 函数 |
|---|---|---|
| 创建 Collection | 创建 Collection | createCollection |
| 获取 Collection | 获取 Collection | fetchCollection |
| 更新 Collection 元数据 | 更新 Collection | updateCollection |
| 更新 Collection 插件 | 更新 Collection | updateCollectionPlugin |
费用明细
| 项目 | 费用 |
|---|---|
| Collection 账户租金 | 约 0.0015 SOL |
| 交易手续费 | 约 0.000005 SOL |
| 合计 | 约 0.002 SOL |
FAQ
Collection 和 Asset 有什么区别?
Collection 是将 Asset 组合在一起的容器。它有自己的元数据(名称、图片),但无法像 Asset 一样被拥有或转移。Asset 是用户拥有的实际 NFT。
可以将现有的 Asset 添加到 Collection 吗?
可以,使用带有 newCollection 参数的 update 指令。Asset 的 Update Authority 必须有权限将其添加到目标 Collection。
NFT 需要 Collection 吗?
不需要。Asset 可以在没有 Collection 的情况下独立存在。但是,Collection 可以实现合集级别的版税设置、更易于发现以及批量操作。
可以从 Collection 中移除 Asset 吗?
可以,使用 update 指令更改 Asset 的合集。需要对 Asset 和 Collection 都拥有相应的权限。
删除 Collection 会发生什么?
包含 Asset 的 Collection 无法删除。请先移除所有 Asset,然后才能关闭 Collection 账户。
Glossary
| 术语 | 定义 |
|---|---|
| Collection | 将相关 Asset 组织在共享元数据下的 Core 账户 |
| Update Authority | 可以修改 Collection 元数据和插件的账户 |
| numMinted | 追踪合集中曾经创建的 Asset 总数的计数器 |
| currentSize | 当前合集中的 Asset 数量 |
| Collection Plugin | 附加到 Collection 上可能应用于所有成员 Asset 的插件 |
| URI | 指向 Collection 链下 JSON 元数据的 URL |
