Document Bubblegum V2 sfbp inheritance

src/components/products/bubblegum-v2/index.js

@@ -58,6 +58,10 @@ export const bubblegumv2 = {
               href: '/smart-contracts/bubblegum-v2/mint-cnfts',
             },
             { title: 'Fetching cNFTs', href: '/smart-contracts/bubblegum-v2/fetch-cnfts' },
+            {
+              title: 'Reading Inherited Royalties',
+              href: '/smart-contracts/bubblegum-v2/reading-inherited-royalties',
+            },
             { title: 'Transferring cNFTs', href: '/smart-contracts/bubblegum-v2/transfer-cnfts' },
             { title: 'Freeze and Thaw cNFTs', href: '/smart-contracts/bubblegum-v2/freeze-cnfts' },
             { title: 'Updating cNFTs', href: '/smart-contracts/bubblegum-v2/update-cnfts' },
@@ -152,6 +156,11 @@ export const bubblegumv2 = {
         ko: 'cNFT 가져오기',
         zh: '获取cNFT'
       },
+      'Reading Inherited Royalties': {
+        ja: '継承ロイヤリティの読み取り',
+        ko: '상속 로열티 읽기',
+        zh: '读取继承版税'
+      },
       'Transferring cNFTs': {
         ja: 'cNFTの転送',
         ko: 'cNFT 전송',

src/examples/bubblegum/get-asset-with-proof-inherited/index.js

@@ -0,0 +1,32 @@
+/**
+ * Example: getAssetWithProof with inherited royalties
+ *
+ * Leaf metadata keeps the on-chain sentinel; DAS main royalty fields hold the collection-resolved display rate.
+ *
+ * This file is auto-generated by scripts/build-examples.js
+ * Edit the native .js/.ts and .rs files, then run: node scripts/build-examples.js
+ */
+
+const umiSections = {
+  "imports": "import { getAssetWithProof, mplBubblegum } from '@metaplex-foundation/mpl-bubblegum'\nimport { publicKey } from '@metaplex-foundation/umi'\nimport { createUmi } from '@metaplex-foundation/umi-bundle-defaults'",
+  "setup": "const umi = createUmi('https://api.devnet.solana.com').use(mplBubblegum())\n\nconst assetId = publicKey('YOUR_ASSET_ID')",
+  "main": "const assetWithProof = await getAssetWithProof(umi, assetId, {\n  truncateCanopy: true,\n})\n\n// Leaf / hashing value (65535 when inherited)\nconsole.log(assetWithProof.metadata.sellerFeeBasisPoints)\n\n// Display / payout value from DAS main fields\nconsole.log(assetWithProof.rpcAsset.royalty?.basis_points)",
+  "output": "// 65535\n// 500",
+  "full": "// [IMPORTS]\nimport { getAssetWithProof, mplBubblegum } from '@metaplex-foundation/mpl-bubblegum'\nimport { publicKey } from '@metaplex-foundation/umi'\nimport { createUmi } from '@metaplex-foundation/umi-bundle-defaults'\n// [/IMPORTS]\n\n// [SETUP]\nconst umi = createUmi('https://api.devnet.solana.com').use(mplBubblegum())\n\nconst assetId = publicKey('YOUR_ASSET_ID')\n// [/SETUP]\n\n// [MAIN]\nconst assetWithProof = await getAssetWithProof(umi, assetId, {\n  truncateCanopy: true,\n})\n\n// Leaf / hashing value (65535 when inherited)\nconsole.log(assetWithProof.metadata.sellerFeeBasisPoints)\n\n// Display / payout value from DAS main fields\nconsole.log(assetWithProof.rpcAsset.royalty?.basis_points)\n// [/MAIN]\n\n// [OUTPUT]\n// 65535\n// 500\n// [/OUTPUT]\n"
+}
+
+export const metadata = {
+  title: "getAssetWithProof with inherited royalties",
+  description: "Leaf metadata keeps the on-chain sentinel; DAS main royalty fields hold the collection-resolved display rate.",
+  tags: [],
+}
+
+export const examples = {
+  umi: {
+    framework: 'Umi',
+    language: 'typescript',
+    code: umiSections.full,
+    sections: umiSections,
+  },
+
+}

src/examples/bubblegum/get-asset-with-proof-inherited/umi.ts

@@ -0,0 +1,28 @@
+// [IMPORTS]
+import { getAssetWithProof, mplBubblegum } from '@metaplex-foundation/mpl-bubblegum'
+import { publicKey } from '@metaplex-foundation/umi'
+import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
+// [/IMPORTS]
+
+// [SETUP]
+const umi = createUmi('https://api.devnet.solana.com').use(mplBubblegum())
+
+const assetId = publicKey('YOUR_ASSET_ID')
+// [/SETUP]
+
+// [MAIN]
+const assetWithProof = await getAssetWithProof(umi, assetId, {
+  truncateCanopy: true,
+})
+
+// Leaf / hashing value (65535 when inherited)
+console.log(assetWithProof.metadata.sellerFeeBasisPoints)
+
+// Display / payout value from DAS main fields
+console.log(assetWithProof.rpcAsset.royalty?.basis_points)
+// [/MAIN]
+
+// [OUTPUT]
+// 65535
+// 500
+// [/OUTPUT]

src/examples/bubblegum/mint-inherit-royalties/umi.ts

@@ -0,0 +1,57 @@
+// [IMPORTS]
+import { createTreeV2, mintV2, mplBubblegum } from '@metaplex-foundation/mpl-bubblegum'
+import { createCollection, mplCore, ruleSet } from '@metaplex-foundation/mpl-core'
+import { generateSigner, some } from '@metaplex-foundation/umi'
+import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
+// [/IMPORTS]
+
+// [SETUP]
+const umi = createUmi('https://api.devnet.solana.com')
+  .use(mplBubblegum())
+  .use(mplCore())
+
+const merkleTree = generateSigner(umi)
+const collectionSigner = generateSigner(umi)
+
+await createTreeV2(umi, {
+  merkleTree,
+  maxDepth: 5,
+  maxBufferSize: 8,
+}).sendAndConfirm(umi)
+
+// The collection must include BubblegumV2 and Royalties plugins.
+await createCollection(umi, {
+  collection: collectionSigner,
+  name: 'My Collection',
+  uri: 'https://example.com/collection.json',
+  plugins: [
+    { type: 'BubblegumV2' },
+    {
+      type: 'Royalties',
+      basisPoints: 500, // 5%
+      creators: [{ address: umi.identity.publicKey, percentage: 100 }],
+      ruleSet: ruleSet('None'),
+    },
+  ],
+}).sendAndConfirm(umi)
+// [/SETUP]
+
+// [MAIN]
+// sellerFeeBasisPoints is omitted — the SDK sends the inherit sentinel (65535).
+await mintV2(umi, {
+  collectionAuthority: umi.identity,
+  leafOwner: umi.identity.publicKey,
+  merkleTree: merkleTree.publicKey,
+  coreCollection: collectionSigner.publicKey,
+  metadata: {
+    name: 'My NFT',
+    uri: 'https://example.com/my-nft.json',
+    collection: some(collectionSigner.publicKey),
+    creators: [], // must be empty when inheriting royalties
+  },
+}).sendAndConfirm(umi)
+// [/MAIN]
+
+// [OUTPUT]
+// cNFT minted with SELLER_FEE_BASIS_POINTS_INHERIT (65535) on the leaf
+// [/OUTPUT]

src/examples/bubblegum/update-inherit-royalties/umi.ts

@@ -0,0 +1,50 @@
+// [IMPORTS]
+import {
+  getAssetWithProof,
+  updateMetadataV2,
+  UpdateArgsArgs,
+  mplBubblegum,
+} from '@metaplex-foundation/mpl-bubblegum'
+import { publicKey, some } from '@metaplex-foundation/umi'
+import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
+// [/IMPORTS]
+
+// [SETUP]
+const umi = createUmi('https://api.devnet.solana.com').use(mplBubblegum())
+
+const assetId = publicKey('YOUR_ASSET_ID')
+const collectionPublicKey = publicKey('YOUR_COLLECTION_ADDRESS')
+// [/SETUP]
+
+// [MAIN]
+const assetWithProof = await getAssetWithProof(umi, assetId, {
+  truncateCanopy: true,
+})
+
+// Switch from inherited royalties to an explicit seller fee before removing
+// the cNFT from its collection.
+const updateArgs: UpdateArgsArgs = {
+  sellerFeeBasisPoints: some(550), // explicit 5.5%
+}
+
+await updateMetadataV2(umi, {
+  ...assetWithProof,
+  currentMetadata: {
+    name: assetWithProof.metadata.name,
+    symbol: assetWithProof.metadata.symbol,
+    uri: assetWithProof.metadata.uri,
+    sellerFeeBasisPoints: assetWithProof.metadata.sellerFeeBasisPoints,
+    primarySaleHappened: assetWithProof.metadata.primarySaleHappened,
+    isMutable: assetWithProof.metadata.isMutable,
+    tokenStandard: assetWithProof.metadata.tokenStandard,
+    creators: assetWithProof.metadata.creators,
+    collection: some(collectionPublicKey),
+  },
+  updateArgs,
+  coreCollection: collectionPublicKey,
+}).sendAndConfirm(umi)
+// [/MAIN]
+
+// [OUTPUT]
+// Leaf seller fee updated from inherit sentinel (65535) to 550 basis points
+// [/OUTPUT]

src/pages/en/dev-tools/das-api/methods/get-asset.md

@@ -7,6 +7,8 @@ tableOfContents: false
 
 Returns the information of a compressed/standard asset including metadata and owner.
 
+For Bubblegum V2 cNFTs that inherit seller fees from an MPL-Core collection, collection-resolved display values are on `royalty.basis_points` / `creators`, and leaf values are on `royalty.basis_points_raw` / `creators_raw` (with `royalty.inherited: true`). See [Reading Inherited Royalties](/smart-contracts/bubblegum-v2/reading-inherited-royalties).
+
 ## Parameters
 
 | Name            | Required | Description                                |

src/pages/en/smart-contracts/bubblegum-v2/collections.md

@@ -3,7 +3,7 @@ title: Managing Collections
 metaTitle: Managing Collections - Bubblegum V2 - Metaplex
 description: Learn how to set, change, and remove MPL-Core collections on compressed NFTs using Bubblegum V2. Covers the setCollectionV2 instruction.
 created: '01-15-2025'
-updated: '02-24-2026'
+updated: '06-19-2026'
 keywords:
   - NFT collection
   - verify collection
@@ -26,6 +26,8 @@ faqs:
     a: Yes. Use setCollectionV2 with both coreCollection (current) and newCoreCollection (new) parameters. Both collection authorities must sign.
   - q: What is the BubblegumV2 plugin?
     a: It is an MPL-Core collection plugin that enables Bubblegum V2 features like freeze/thaw, soulbound cNFTs, and royalty enforcement on the collection.
+  - q: Can I remove a cNFT from a collection when it inherits royalties?
+    a: No. Update sellerFeeBasisPoints to an explicit value first, then remove the collection with setCollectionV2.
 ---
 
 ## Summary
@@ -118,12 +120,20 @@ const signature = await setCollectionV2(umi, {
 {% /dialect %}
 {% /dialect-switcher %}
 
+## Inherited royalties {% #inherited-royalties %}
+
+cNFTs minted with [inherited seller fee basis points](/smart-contracts/bubblegum-v2/mint-cnfts#inheriting-royalties-from-the-collection) store the sentinel value `65535` on the leaf. This affects collection management:
+
+- **Removing a collection** — `setCollectionV2` rejects the operation while the leaf still uses the inherit sentinel. Update the cNFT to an explicit `sellerFeeBasisPoints` first via [`updateMetadataV2`](/smart-contracts/bubblegum-v2/update-cnfts#inherited-royalties).
+- **Moving to another collection** — Allowed when the destination collection has the `Royalties` plugin. The cNFT keeps the inherit sentinel and resolves royalties from the new collection.
+- **Moving to a collection without royalties** — Rejected with `CollectionMustHaveRoyaltiesPlugin`.
 
 ## Notes
 
 - The MPL-Core collection must have the `BubblegumV2` plugin enabled before cNFTs can be added to it.
 - Unlike Bubblegum V1 (which uses Token Metadata collections with a "verified" boolean), V2 uses MPL-Core collections without verification flags.
 - When changing between collections, both the old and new collection authorities must sign the transaction.
+- cNFTs with inherited seller fees cannot be removed from a collection until royalties are set to an explicit value on the leaf.
 
 ## FAQ
 
@@ -139,6 +149,10 @@ Yes. Use `setCollectionV2` with both `coreCollection` (current) and `newCoreColl
 
 It is an MPL-Core collection plugin that enables Bubblegum V2 features like freeze/thaw, soulbound cNFTs, royalty enforcement, and permanent delegates on the collection level.
 
+### Can I remove a cNFT from a collection when it inherits royalties?
+
+No. The program returns `CannotRemoveFromCollectionWithInheritedSellerFee`. Use `updateMetadataV2` to set an explicit `sellerFeeBasisPoints` value first, then call `setCollectionV2` to remove the collection.
+
 ## Glossary
 
 | Term | Definition |