@manifoldxyz/royalty-registry-solidity
Advanced tools
Readme
The Royalty Registry was developed in conjunction with Foundation, manifold.xyz, Nifty Gateway, OpenSea, Rarible, SuperRare and Zora.
Please visit https://royaltyregistry.xyz for Registry and Engine deployment locations for each network.
https://royaltyregistry.xyz is a Web3 DApp which makes on-chain royalty lookups and override configurations easy.
The open-source code can be found at: https://github.com/manifoldxyz/royalty-registry-client
Ethereum and Polygon were deployed using a legacy method without CREATE2 and hence the proxies live at different addresses. For all other EVM chains, all the contracts live at the same address.
Note: Future implementations, the override factory, and fallback registry will be the same on all chains, including Ethereum and Polygon.
Currently supported chains:
| Ethereum | Polygon | |
| Gnosis Safe | 0xA70e7Ef659C209D977f0f5Ab932F3f775a94502F | 0xdAC451C0b1c13d7aF7f38022e6A2A29211Cc80d5 |
| TimeLock Controller | 0x178AD648e66815E1B01791eBBdbF7b2D7C5B1626 | 0x87bCD4735CbCF9CE98ea2822fBf3F05F2ce10f96 |
| Proxy Admin | 0xc9198CbbB57708CF31e0caBCe963c98e60d333c3 | 0x40d603b2e9B3dE39ddc28Fb93a46BbB8E82b8a88 |
| Royalty Registry | 0xaD2184FB5DBcfC05d8f056542fB25b04fa32A95D | 0xe7c9Cb6D966f76f3B5142167088927Bf34966a1f |
| Royalty Engine | 0x0385603ab55642cb4Dd5De3aE9e306809991804f | 0x28EdFcF0Be7E86b07493466e7631a213bDe8eEF2 |
| Royalty Registry Impl | 0x64427932eFE137F80b012552B6772F7f58ddd9a6 | |
| Royalty Engine Impl | 0x43A48AbF383D7508C03c20e1e46b58e0cd735669 | |
| Royalty Override Factory | 0x734513F61a65B3745fC7BB574aDFe18379355a1C | |
| Royalty Fallback Registry | 0xB78fC2052717C7AE061a14dB1fB2038d5AC34D29 |
| Gnosis Safe | 0x520f09e18895ACd6A9E75dE01355b5691Bf3D92B |
| TimeLock Controller | 0xe3A6CD067a1193b903143C36dA00557c9d95C41e |
| Proxy Admin | 0x0779702742c1397700e452A0976EfEF18D874764 |
| Royalty Registry | 0x3D1151dc590ebF5C04501a7d4E1f8921546774eA |
| Royalty Engine | 0xEF770dFb6D5620977213f55f99bfd781D04BBE15 |
| Royalty Registry Impl | 0x64427932eFE137F80b012552B6772F7f58ddd9a6 |
| Royalty Engine Impl | 0x43A48AbF383D7508C03c20e1e46b58e0cd735669 |
| Royalty Override Factory | 0x734513F61a65B3745fC7BB574aDFe18379355a1C |
| Royalty Fallback Registry | 0xB78fC2052717C7AE061a14dB1fB2038d5AC34D29 |
The royalty registry was designed with the following goals
The Royalty Registry is comprised of two components.
This is the central contract to be used for determining what address should be used for royalty lookup given a token address. The reason that this registry is necessary is to provide backwards compatability with contracts created prior to any on-chain royalty specs. It provides the ability for these contracts to set up an on-chain royalty override with support for:
Override permissions can be expanded in the future by the community.
Overrides are emitted as events so that any other systems that want to cache this data can do so.
function setRoyaltyLookupAddress(address tokenAddress, address royaltyLookupAddress) public
Override where to get royalty information from for a given token contract. Only callable by the owner of the token contract (relies on @openzeppelin's Ownable implementation) or the owner of the Royalty Registry (i.e. DAO governance access control). This allows legacy contracts to set royalties.
function getRoyaltyLookupAddress(address tokenAddress) public view returns(address)
Returns the address that should be used to lookup royalties. Defaults to return the tokenAddress unless an override is set.
function overrideAllowed(address tokenAddress) public view returns(bool)
Returns whether or not the address sender can override the royalty lookup address for the given token address. Example Use Case: A royalty lookup dApp can also show override functionality if it detects that they can override
The royalty engine provides a common interface to unify the lookup for various royalty specifications currently in existence.
As new standards are adopted, they can be added to the royalty engine. If new standards require a more complex output, the royalty engine can be upgraded.
The royalty engine also contains a spec cache to make lookups faster. The cache is filled only if getRoyaltyAndCacheSpec is called, which is only useable within another contract as it is a mutable function.
function getRoyalty(address tokenAddress, uint256 tokenId, uint256 value) public override returns(address payable[] memory recipients, uint256[] memory amounts)
Get the royalties for a given token and sale amount. Also cache the royalty spec for the given tokenAddress for more gas efficient future lookup. Use this within marketplace contracts.
Returns two arrays, first is the list of royalty recipients, second is the amounts for each recipient.
function getRoyaltyView(address tokenAddress, uint256 tokenId, uint256 value) public view override returns(address payable[] memory recipients, uint256[] memory amounts)
View only version of getRoyalty. Useful for dApps that want to provide lookup functionality.
Returns two arrays, first is the list of royalty recipients, second is the amounts for each recipient.
An upgradeable version of both the Royalty Registry and Royalty Engine (v1) has been deployed for public consumption. There should only be one instance of the Royalty Registry (in order to ensure that people who wish to override do not have to do so in multiple places), while many instances of the Royalty Engine can exist.
Marketplaces may choose to directly inherit the Royalty Engine to save a bit of gas (from our testing, a possible savings of 6400 gas per lookup).
To find the location of the Royalty Registry and Royalty Engine, please visit https://royaltyregistry.xyz, or reference the mainnnet locations above.
See contracts/overrides/RoyaltyOverride.sol for a reference override implementation.
See contracts/overrides/RoyaltyOverrideCore.sol if you would like to inherit EIP2981RoyaltyOverrideCore for your own smart contract.
See contracts/token/ERC721.sol and contracts/token/ERC1155.sol for reference ERC721 and ERC1155 reference implementations.
All contributions should come with accompanying test coverage.
npm install
Start development network (in separate terminal):
npm run test:start-network
Run tests:
npm test
FAQs
The Royalty Registry was developed in conjunction with Foundation, manifold.xyz, Nifty Gateway, OpenSea, Rarible, SuperRare and Zora.
We found that @manifoldxyz/royalty-registry-solidity demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 21 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
CISA launched a new project called Vulnrichment to enrich CVEs with details that help prioritize patching and mitigation efforts, as the NVD backlog of unenriched CVEs awaiting analysis surpasses 10,000.
Security News
Socket is joining forces with CISA and other industry leaders at the RSA Conference to sign the Secure by Design pledge, committing to uphold the highest security standards in our products.
Research
The Socket research team breaks down a sampling of malicious packages that download and execute files, among other suspicious behaviors, targeting the popular Discord platform.