機能
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をまとめるには、まずコレクション名や画像URIなどの共有メタデータを保存するCollectionアカウントを作成します。Collectionアカウントはコレクションのフロントカバーとして機能し、コレクション全体のプラグインも保持できます。
Collectionアカウントに保存されるデータは次のとおりです:
| フィールド | 説明 |
|---|---|
| key | アカウントキーの識別子 |
| updateAuthority | Collectionの管理者 |
| name | コレクション名 |
| uri | コレクションのオフチェーンメタデータへのURI |
| numMinted | コレクションで作成された総Asset数 |
| currentSize | 現在コレクション内にあるAsset数 |
Core CollectionはCore Assetのみをグループ化します。Token Metadata NFTにはmpl-token-metadataを、圧縮NFTにはBubblegumを使用してください。
Notes
- AssetはCollectionなしで単独で存在できます — Collectionは必須ではありません
- コレクションレベルのプラグインは、同じタイプの独自プラグインを持つAssetを除き、メンバーAssetに継承されます
numMintedはコレクションで作成されたすべてのAssetの累計数、currentSizeはライブカウントです- CollectionはAssetが含まれている間はCloseできません — 先にすべての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へのAsset追加権限を持っている必要があります。
NFTにCollectionは必要ですか?
いいえ。AssetはCollectionなしで単独で存在できます。ただし、Collectionによりコレクションレベルのロイヤリティ設定、発見しやすさの向上、バッチ操作が可能になります。
CollectionからAssetを削除できますか?
はい、update命令を使ってAssetのコレクションを変更します。AssetとCollection両方の適切なAuthorityが必要です。
Collectionを削除するとどうなりますか?
CollectionはAssetが含まれている間は削除できません。先にすべてのAssetを削除してから、CollectionアカウントをCloseしてください。
Glossary
| 用語 | 定義 |
|---|---|
| Collection | 関連するAssetを共有メタデータの下にグループ化するCoreアカウント |
| Update Authority | Collectionのメタデータとプラグインを変更できるアカウント |
| numMinted | Collectionで作成されたAssetの総数を追跡するカウンター |
| currentSize | 現在Collection内にあるAsset数 |
| Collection Plugin | すべてのメンバーAssetに適用される可能性のあるCollectionに付与されたプラグイン |
| URI | CollectionのオフチェーンJSONメタデータを指すURL |
