Ready To Use
Catalog Impl

RMRKCatalogImpl

RMRK team

RMRKCatalogImpl

Implementation of RMRK catalog.

Contract for storing 'catalog' elements of NFTs to be accessed by instances of RMRKAsset implementing contracts. This default implementation includes an OwnableLock dependency, which allows the deployer to freeze the state of the catalog contract.

Methods

addEquippableAddresses

function addEquippableAddresses(uint64 partId, address[] equippableAddresses) external nonpayable

Used to add multiple equippableAddresses to a single catalog entry.

Can only be called on Parts of Slot type.

Parameters

NameTypeDescription
partIduint64ID of the Part that we are adding the equippable addresses to
equippableAddressesaddress[]An array of addresses that can be equipped into the Part associated with the partId

addPart

function addPart(IRMRKCatalog.IntakeStruct intakeStruct) external nonpayable

Parameters

NameTypeDescription
intakeStructIRMRKCatalog.IntakeStructundefined

addPartList

function addPartList(IRMRKCatalog.IntakeStruct[] intakeStructs) external nonpayable

Parameters

NameTypeDescription
intakeStructsIRMRKCatalog.IntakeStruct[]undefined

checkIsEquippable

function checkIsEquippable(uint64 partId, address targetAddress) external view returns (bool isEquippable)

Used to check whether the given address is allowed to equip the desired Part.

Returns true if a collection may equip asset with partId.

Parameters

NameTypeDescription
partIduint64The ID of the part that we are checking
targetAddressaddressThe address that we are checking for whether the part can be equipped into it or not

Returns

NameTypeDescription
isEquippableboolThe status indicating whether the targetAddress can be equipped into Part with partId or not

checkIsEquippableToAll

function checkIsEquippableToAll(uint64 partId) external view returns (bool isEquippable)

Used to check if the part is equippable by all addresses.

Returns true if part is equippable to all.

Parameters

NameTypeDescription
partIduint64ID of the part that we are checking

Returns

NameTypeDescription
isEquippableboolThe status indicating whether the part with partId can be equipped by any address or not

getLock

function getLock() external view returns (bool isLocked)

Used to retrieve the status of a lockable smart contract.

Returns

NameTypeDescription
isLockedboolA boolean value signifying whether the smart contract has been locked

getMetadataURI

function getMetadataURI() external view returns (string)

Used to return the metadata URI of the associated Catalog.

Returns

NameTypeDescription
_0stringCatalog metadata URI

getPart

function getPart(uint64 partId) external view returns (struct IRMRKCatalog.Part part)

Used to retrieve a Part with id partId

Parameters

NameTypeDescription
partIduint64ID of the part that we are retrieving

Returns

NameTypeDescription
partIRMRKCatalog.PartThe Part struct associated with given partId

getParts

function getParts(uint64[] partIds) external view returns (struct IRMRKCatalog.Part[] parts)

Used to retrieve multiple parts at the same time.

Parameters

NameTypeDescription
partIdsuint64[]An array of part IDs that we want to retrieve

Returns

NameTypeDescription
partsIRMRKCatalog.Part[]An array of Part structs associated with given partIds

getType

function getType() external view returns (string)

Used to return the itemType of the associated Catalog

Returns

NameTypeDescription
_0stringitemType of the associated Catalog

isContributor

function isContributor(address contributor) external view returns (bool isContributor_)

Used to check if the address is one of the contributors.

Parameters

NameTypeDescription
contributoraddressAddress of the contributor whose status we are checking

Returns

NameTypeDescription
isContributor_boolBoolean value indicating whether the address is a contributor or not

manageContributor

function manageContributor(address contributor, bool grantRole) external nonpayable

Adds or removes a contributor to the smart contract.

Can only be called by the owner.Emits ContributorUpdate event.

Parameters

NameTypeDescription
contributoraddressAddress of the contributor's account
grantRoleboolA boolean value signifying whether the contributor role is being granted (true) or revoked (false)

owner

function owner() external view returns (address owner_)

Returns the address of the current owner.

Returns

NameTypeDescription
owner_addressAddress of the current owner

renounceOwnership

function renounceOwnership() external nonpayable

Leaves the contract without owner. Functions using the onlyOwner modifier will be disabled.

Can only be called by the current owner.Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.

resetEquippableAddresses

function resetEquippableAddresses(uint64 partId) external nonpayable

Used to remove all of the equippableAddresses for a Part associated with the partId.

Can only be called on Parts of Slot type.

Parameters

NameTypeDescription
partIduint64ID of the part that we are clearing the equippableAddresses from

setEquippableAddresses

function setEquippableAddresses(uint64 partId, address[] equippableAddresses) external nonpayable

Function used to set the new list of equippableAddresses.

Overwrites existing equippableAddresses.Can only be called on Parts of Slot type.

Parameters

NameTypeDescription
partIduint64ID of the Parts that we are overwiting the equippableAddresses for
equippableAddressesaddress[]A full array of addresses that can be equipped into this Part

setEquippableToAll

function setEquippableToAll(uint64 partId) external nonpayable

Sets the isEquippableToAll flag to true, meaning that any collection may be equipped into the Part with this partId.

Can only be called on Parts of Slot type.

Parameters

NameTypeDescription
partIduint64ID of the Part that we are setting as equippable by any address

setLock

function setLock() external nonpayable

Locks the operation.

Once locked, functions using notLocked modifier cannot be executed.Emits LockSet event.

supportsInterface

function supportsInterface(bytes4 interfaceId) external view returns (bool)

Returns true if this contract implements the interface defined by interfaceId. See the corresponding https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP (opens in a new tab) section] to learn more about how these ids are created. This function call must use less than 30 000 gas.

Parameters

NameTypeDescription
interfaceIdbytes4undefined

Returns

NameTypeDescription
_0boolundefined

transferOwnership

function transferOwnership(address newOwner) external nonpayable

Transfers ownership of the contract to a new owner.

Can only be called by the current owner.

Parameters

NameTypeDescription
newOwneraddressAddress of the new owner's account

Events

AddedEquippables

event AddedEquippables(uint64 indexed partId, address[] equippableAddresses)

Event to announce new equippables to the part.

It is emitted when new addresses are marked as equippable for partId.

Parameters

NameTypeDescription
partId indexeduint64ID of the part that had new equippable addresses added
equippableAddressesaddress[]An array of the new addresses that can equip this part

AddedPart

event AddedPart(uint64 indexed partId, enum IRMRKCatalog.ItemType indexed itemType, uint8 zIndex, address[] equippableAddresses, string metadataURI)

Event to announce addition of a new part.

It is emitted when a new part is added.

Parameters

NameTypeDescription
partId indexeduint64ID of the part that was added
itemType indexedenum IRMRKCatalog.ItemTypeEnum value specifying whether the part is None, Slot and Fixed
zIndexuint8An uint specifying the z value of the part. It is used to specify the depth which the part should be rendered at
equippableAddressesaddress[]An array of addresses that can equip this part
metadataURIstringThe metadata URI of the part

ContributorUpdate

event ContributorUpdate(address indexed contributor, bool isContributor)

Event that signifies that an address was granted contributor role or that the permission has been revoked.

This can only be triggered by a current owner, so there is no need to include that information in the event.

Parameters

NameTypeDescription
contributor indexedaddressAddress of the account that had contributor role status updated
isContributorboolA boolean value signifying whether the role has been granted (true) or revoked (false)

LockSet

event LockSet()

Emitted when the smart contract is locked.

OwnershipTransferred

event OwnershipTransferred(address indexed previousOwner, address indexed newOwner)

Used to anounce the transfer of ownership.

Parameters

NameTypeDescription
previousOwner indexedaddressAddress of the account that transferred their ownership role
newOwner indexedaddressAddress of the account receiving the ownership role

SetEquippableToAll

event SetEquippableToAll(uint64 indexed partId)

Event to announce that a given part can be equipped by any address.

It is emitted when a given part is marked as equippable by any.

Parameters

NameTypeDescription
partId indexeduint64ID of the part marked as equippable by any address

SetEquippables

event SetEquippables(uint64 indexed partId, address[] equippableAddresses)

Event to announce the overriding of equippable addresses of the part.

It is emitted when the existing list of addresses marked as equippable for partId is overwritten by a new one.

Parameters

NameTypeDescription
partId indexeduint64ID of the part whose list of equippable addresses was overwritten
equippableAddressesaddress[]The new, full, list of addresses that can equip this part

Errors

RMRKBadConfig

error RMRKBadConfig()

Attempting to incorrectly configue a Catalog item

RMRKIdZeroForbidden

error RMRKIdZeroForbidden()

Attempting to use ID 0, which is not supported

The ID 0 in RMRK suite is reserved for empty values. Guarding against its use ensures the expected operation

RMRKLocked

error RMRKLocked()

Attempting to interact with a contract that had its operation locked

RMRKNewContributorIsZeroAddress

error RMRKNewContributorIsZeroAddress()

Attempting to assign a 0x0 address as a contributor

RMRKNewOwnerIsZeroAddress

error RMRKNewOwnerIsZeroAddress()

Attempting to transfer the ownership to the 0x0 address

RMRKNotOwner

error RMRKNotOwner()

Attempting to interact with a management function without being the smart contract's owner

RMRKNotOwnerOrContributor

error RMRKNotOwnerOrContributor()

Attempting to interact with a function without being the owner or contributor of the collection

RMRKPartAlreadyExists

error RMRKPartAlreadyExists()

Attempting to add a Part with an ID that is already used

RMRKPartDoesNotExist

error RMRKPartDoesNotExist()

Attempting to use a Part that doesn't exist

RMRKPartIsNotSlot

error RMRKPartIsNotSlot()

Attempting to use a Part that is Fixed when Slot kind of Part should be used

RMRKZeroLengthIdsPassed

error RMRKZeroLengthIdsPassed()

Attempting not to pass an empty array of equippable addresses when adding or setting the equippable addresses