Roles And Permissions

Roles define the permissions and access levels across different contracts and modules. This page outlines the structure of roles, their functions, and the path toward full decentralization.

To maintain a secure and flexible smart contract system, we leverage roles to manage administrative tasks and define who has the authority to perform specific actions. These roles control everything from minting tokens to upgrading contracts, pausing operations, and setting governance parameters.

The central goal of this structure is to gradually decentralize power from individual wallets to the DAO (the B3TRGovernor governance contract).

Roles

This document categorizes roles and outlines their functionalities, detailing what permissions each role grants. Here's a quick summary of some common roles and what they do:

• DEFAULT_ADMIN_ROLE: The superuser role with the ability to grant, revoke, and renounce roles.

• PAUSER_ROLE: Controls the ability to pause and unpause contract functionality.

• MINTER_ROLE: Allows for token minting.

• UPGRADER_ROLE: Permits contract upgrades and modifications.

• CONTRACTS_ADDRESS_MANAGER_ROLE: Manages critical contract addresses.

• DECAY_SETTINGS_MANAGER_ROLE: Manages parameters surrounding cycle lengths, allocation percentages and decay rates in the Emission contract.

• GOVERNANCE_ROLE: Involved in governance decisions, proposal management, and voting.

All roles have in common the following functionality: they can renounce that role.

Once there isn’t any address that has the DEFAULT_ADMIN_ROLE then it won’t be possible to grant or revoke any role. If some contract is upgradeable and the DAO has the UPGRADER_ROLE then the DAO could decide to upgrade the contract and assign the role to whoever they want.

Permissions

The ultimate aim is to create a self-governing system where no single entity holds absolute control. This section of the page provides a detailed plan for achieving this goal, outlining the steps for transitioning roles to the B3TRGovernor contract, removing direct admin control, and enabling decentralized governance.

Follow the outlined steps to understand the current state of role assignments and the specific actions required to achieve a more autonomous system. Through this journey, we aim to establish a resilient and community-driven ecosystem where the power of decision-making rests in the hands of the DAO and its stakeholders.

Contract: B3TR

Steps for full decentralization:

• After we migrate to mainnet we revoke the MINTER_ROLE from the admin wallet.

• When we no longer want the power to pause the contract we revoke the PAUSER_ROLE.

• We renounce the DEFAULT_ADMIN_ROLE

Contract: B3TRGovernor

Steps for full decentralization:

• B3TRGovernor is already responsible for upgrading, changing voting or deposit threshold, min voting delay, and quorum.

• We grant the GOVERNOR_FUNCTIONS_SETTINGS_ROLE to the B3TRGovernor, and revoke it from the current wallet. Now governance can vote on whitelisting other functions or completely remove whitelisting of functions on proposal creation.

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor, and revoke it from the current wallet.

• We renounce the PAUSER_ROLE or grant it to the B3TRGovernor

• We renounce the DEFAULT_ADMIN_ROLE and PROPOSAL_EXECUTOR_ROLE

Contract: Emissions

Steps for full decentralization:

• We renounce the MINTER_ROLE once we complete the mainnet migration

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the DECAY_SETTINGS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

Contract: GalaxyMember

Steps for full decentralization:

• We renounce the MINTER_ROLE once we complete the mainnet migration

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We renounce the PAUSER_ROLE

• We grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor and revoke it from the current wallet

Contract: Timelock

Steps for full decentralization:

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from current wallet

• We renounce the DEFAULT_ADMIN_ROLE and now Timelock is self-administrating, which means that if the DAO wants to change the proposer or executor they will need to create a proposal that calls the Timelock contract to grant/revoke that role

Contract: Treasury

Steps for full decentralization:

• The B3TRGovernor already has the GOVERNANCE_ROLE, if we have some admin that has this role then we need to renounce it

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We renounce the PAUSER_ROLE

• We can grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor or renounce it

Contract: VOT3

Steps for full decentralization:

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet.

• When we no longer want the power to pause the contract we revoke the PAUSER_ROLE.

• We renounce the DEFAULT_ADMIN_ROLE role.

Contract: VoterRewards

Steps for full decentralization:

• VOTE_REGISTRAR_ROLE should be assigned only to the contracts performing voting

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor and revoke it from current wallet

Contract: X2EarnApps

Steps for full decentralization:

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the GOVERNANCE_ROLE to the B3TRGovernor and revoke it from current wallet

• We grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor and revoke it from current wallet

NB: This contract will be upgraded to handle app endorsement, so the “Add app” functionality triggered by a GOVERNANCE_ROLE could be removed in a future release

Contract: X2EarnRewardsPool

Steps for full decentralization:

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We renounce the DEFAULT_ADMIN_ROLE role

Contract: XAllocationPool

Steps for full decentralization:

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor and revoke it from current wallet

Contract: XAllocationVoting

Steps for full decentralization:

• ROUND_STARTER_ROLE should always be the Emissions contract

• Renaunce GOVERNANCE_ROLE

• We grant the UPGRADER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the CONTRACTS_ADDRESS_MANAGER_ROLE to the B3TRGovernor and revoke it from the current wallet

• We grant the DEFAULT_ADMIN_ROLE to the B3TRGovernor and revoke it from current wallet