⚠⚠⚠ This feature is experimental and may behave unexpectedly.


The Collab.Land Royalty Detection Rule (RDR) checks if a member paid royalties when purchasing an NFT from an NFT marketplace. This allows communities to ensure that all members continue to pay creator royalties for community access. The RDR returns three possible results: true / unknown / false.


The RDR uses the Alchemy API to check certain NFT marketplaces for evidence of royalties paid; it checks OpenSea, Blur, X2Y2, and LooksRare.


  1. Case true: If the NFT was purchased from any of the supported marketplaces and royalties were paid, the RDR returns true.

  2. Case unknown: If the NFT was purchased from an unsupported marketplace with an additional transaction sent, the RDR assumes royalties were paid and returns unknown.
    NOTE: this assumes royalties were paid, but the RDR cannot be sure.

  3. Case false: If the NFT was purchased from a marketplace with no additional send transaction, the RDR knows royalties were not paid and returns false.
    NOTE: RDR will also return false for private sales or simple token transfers as it only checks the single address provided by the connected wallet.



This is the logic flow for Collab.Land’s Royalty Detection Rule. 



When creating a Token-Granted Role (TGR) using an ERC-721 NFT, you can use the new metadata trait royaltyPaid to track if the current owner of the NFT paid royalties to the creator on their purchase. 


This allows communities to require paying NFT creator royalties to grant roles.


Metadata trait: royaltyPaid returns value: true/unknown/false


NOTE: We recommend specifying both unknown and true cases, and specifying an OR condition, to account for members who may have purchased your community’s NFT from alternative marketplaces. 


If you have not created a TGR before, visit our TGR tutorial to get started.