Roles and Access Control within Liquid Earth Contracts

In the context of Liquid Earth's smart contracts deployed on the Fantom blockchain, roles and permissions are designed to ensure security, flexibility, and compliance. Here are the various roles and their functionalities:

Owner

• Who: The deployer of the contract initially assumes the 'Owner' role.

• Can it change?: Yes, ownership can be transferred to another address.

• Responsibilities: The owner has exclusive permissions to update contract parameters, register new contracts, add or remove tokens, and handle other administrative functions.

• Admin of Roles: The owner sets and manages all other roles unless explicitly programmed otherwise.

KYC (Know Your Customer)

• Who: Addresses that have been verified through an external KYC process.

• Can it change?: An address's KYC status can be updated based on ongoing verification.

• Responsibilities: KYC-verified users are permitted to interact with various contract methods that involve financial transactions, such as listing items, placing bids, and making offers.

Admin

• Who: Usually the owner or another trusted entity.

• Can it change?: Yes, new admins can be appointed by the owner.

• Responsibilities: Admins may have access to a subset of the owner's permissions, like updating specific contract parameters or toggling features.

Digital Asset Creator

• Who: The original minter or registrant of an Digital Asset.

• Can it change?: Generally, no, but some contracts may allow for the transfer of creator status.

• Responsibilities: Entitled to royalties upon each sale or trade of the Digital Asset. Can also have permissions to update metadata or other attributes.

Digital Asset Owner

• Who: The current holder of an Digital Asset.

• Can it change?: Yes, changes upon sale, auction, or transfer.

• Responsibilities: Allowed to sell, auction, or transfer the Digital Asset. May also have the ability to update certain attributes or metadata.

External Contracts

• Who: Other smart contracts that are authorized to interact with the contract in question.

• Can it change?: Yes, the owner can update the list of authorized external contracts.

• Responsibilities: May vary but generally include activities like executing transfers or fetching data.

Public

• Who: Any address that interacts with the contract.

• Responsibilities: Limited to read-only methods and other functionalities that do not require special permissions.

By carefully defining these roles and their permissions, Liquid Earth maintains a secure, flexible, and regulatory-compliant environment on the Fantom blockchain.