Smart Contracts
List and description of all smart contracts of VeBetterDAO.
Last updated
List and description of all smart contracts of VeBetterDAO.
Last updated
Contracts can be found at the following repository: https://github.com/vechain/vebetterdao-contracts
The VeBetterDAO smart contracts have undergone a comprehensive audit by Hacken.
Putting it all together we get a picture of the connections of all smart contracts with hierarchies and usages between each other.
The following is the list of all smart contracts listed alphabetically:
This contract governs the issuance and management of B3TR fungible tokens within the VeBetter ecosystem, allowing for minting under a capped total supply.
Extends ERC20 Token Standard with capping, pausing, and access control functionalities to manage B3TR tokens in the VeBetter ecosystem.
Address: 0x5ef79995FE8a89e0812330E4378eB2660ceDe699
This contract implements an upgradeable proxy for all of our upgradeable contracts. It is upgradeable because calls are delegated to an implementation address that can be changed. This address is stored in storage in the location specified by https://eips.ethereum.org/EIPS/eip-1967[EIP1967], so that it doesn't conflict with the storage layout of the implementation behind the proxy.
Forked from Openzeppelin.
This contract is the main governance contract for the VeBetterDAO ecosystem. Anyone can create a proposal to both change the state of the contract, to execute a transaction on the timelock or to ask for a vote from the community without performing any on-chain action. In order for the proposal to become active, the community needs to deposit a certain amount of VOT3 tokens. This is used as a heath check for the proposal, and funds are returned to the depositors after vote is concluded. Votes for proposals start periodically, based on the allocation rounds (see xAllocationVoting contract), and the round in which the proposal should be active is specified by the proposer during the proposal creation.
A minimum amount of voting power is required in order to vote on a proposal. The voting power is calculated through the quadratic vote formula based on the amount of VOT3 tokens held by the voter at the block when the proposal becomes active.
Once a proposal succeeds, it can be executed by the timelock contract.
The contract is upgradeable and uses the UUPS pattern.
Manages the governance process for the VeBetterDAO ecosystem, allowing users to create and vote on proposals with VOT3 token deposits. This contract leverages OpenZeppelin's AccessControl and UUPSUpgradeable libraries for role-based access control and upgradeability. The core functionality, including proposal management, voting mechanisms, quorum calculations, and deposit logic, is modularly organized in external libraries, ensuring maintainability, flexibility, and ease of upgrades.
Address: 0x1c65C25fABe2fc1bCb82f253fA0C916a322f777C
This contract is responsible for the scheduled distribution of emissions based on predefined cycles and decay settings.
Manages the periodic distribution of B3TR tokens to XAllocation, Vote2Earn, and Treasury allocations. This contract leverages openzeppelin's AccessControl, ReentrancyGuard, and UUPSUpgradeable libraries for access control, reentrancy protection, and upgradability.
Address: 0xDf94739bd169C84fe6478D8420Bb807F1f47b135
This contract manages the unique assets owned by users within the Galaxy Member ecosystem.
Extends ERC721 Non-Fungible Token Standard basic implementation with upgradeable pattern, burnable, pausable, and access control functionalities.
Address: 0x93B8cD34A7Fc4f53271b9011161F7A2B5fEA9D1F
This contract acts as a proxy between Vechain Node Contracts and VeBetter DAO, enabling node holders to delegate and manage multiple nodes within a single account.
Address:
This contract is used to perform the actions of the B3TRGovernor contract with a time delay. The proposers and executors roles should be assigned only to the B3TRGovernor contract.
Address: 0x7B7EaF620d88E38782c6491D7Ce0B8D8cF3227e4
This contract is designed to manage all assets owned by the VeBetter DAO
This contract handles the receiving and transferring of assets, leveraging upgradeable, pausable, and access control features.
Address: 0xD5903BCc66e439c753e525F8AF2FeC7be2429593
This contract governs the issuance and management of VOT3 tokens, which are the tokens used for voting in the VeBetter DAO Ecosystem.
Extends ERC20 Fungible Token Standard basic implementation with upgradeability, pausability, ability for gasless transactions and governance capabilities.
Address: 0x76Ca782B59C74d088C7D2Cce2f211BC00836c602
This contract handles the rewards for voters in the VeBetterDAO ecosystem. It calculates the rewards for voters based on their voting power and the level of their Galaxy Member NFT.
The contract is
upgradeable using UUPSUpgradeable.
using AccessControl to handle the admin and upgrader roles.
using ReentrancyGuard to prevent reentrancy attacks.
using Initializable to initialize the contract.
following the ERC-7201 standard for storage layout.
Address: 0x838A33AF756a6366f93e201423E1425f67eC0Fa7
This contract handles the x-2-earn applications of the VeBetterDAO ecosystem. The contract allows the insert, management, and eligibility of apps for the B3TR allocation rounds.
The contract is using AccessControl to handle the admin and upgrader roles. Only users with the DEFAULT_ADMIN_ROLE can add new apps, set the base URI, and set the voting eligibility for an app. Admins can also control the app metadata and management. Each app has a set of admins and moderators (built without using AccessControl) that can manage the app metadata and management.
Address: 0x8392B7CCc763dB03b47afcD8E8f5e24F9cf0554D
This contract is designed to manage new XApp submissions within VeBetter DAO, ensuring only verified creators can enter the ecosystem. This contract supports Creator NFTs, non-transferable ERC721 tokens, to grant creators access to the endorsement process.
Extends ERC721 Non-Fungible Token Standard basic implementation with upgradeable pattern, pausable, and access control functionalities.
Address:
This contract is used by x2Earn apps to reward users that performed sustainable actions. The XAllocationPool contract or other contracts/users can deposit funds into this contract by specifying the app that can access the funds.
Admins of x2Earn apps can withdraw funds from the rewards pool, which are sent to the team wallet address. The contract is upgradeable through the UUPS proxy pattern and UPGRADER_ROLE can authorize the upgrade.
Address: 0x6Bee7DDab6c99d5B2Af0554EaEA484CE18F52631
This contract receives B3TR tokens from the Emissions contract and distributes them to the rewards pool contract and x2earn apps based on the allocation round outcome. Funds can be claimed at the end of each allocation round.
Interacts with the Emissions contract to get the amount of B3TR available for distribution in each round, and the x2EarnApps contract to check app existence and receiver address. The contract is using AccessControl to handle roles for upgrading the contract and external contract addresses.
Address: 0x4191776F05f4bE4848d3f4d587345078B439C7d3
This contract handles the voting for the most supported x2Earn applications through periodic allocation rounds. The user's voting power is calculated on his VOT3 holdings at the start of each round, using a "Quadratic Funding" formula.
Rounds are started by the Emissions contract. Interacts with the X2EarnApps contract to get the app data (eg: app IDs, app existence, eligible apps for each round). Interacts with the VotingRewards contract to save the user from casting a vote. The contract is using AccessControl to handle roles for admin, governance, and round-starting operations.
Address: 0x89A00Bb0947a30FF95BEeF77a66AEdE3842Fe5B7
Some contracts (eg: B3TRGovernor) store their logic inside libraries to optimize the contract size. The following is the list of libraries we created and the addresses they are deployed to.
Library for managing the clock logic as specified in EIP-6372, with fallback to block numbers.
This library interacts with the IVOT3 interface to get the clock time or mode.
Address: 0xF8746E74334218d79e951313A87D82954b3dF5Ea
Library for managing the configuration of a Governor contract.
This library provides functions to set and get various configuration parameters and contracts used by the Governor contract.
Address: 0x8E4B5503DbBBCD7A4407b3B3cFE9306F758AFBe9
Library for managing deposits related to proposals in the Governor contract.
This library provides functions to deposit and withdraw tokens for proposals, and to get deposit-related information.
Address: 0x9cb90470CC69b6C0b8709e237efC38410F4AC5F8
Library for managing function restrictions within the Governor contract.
This library provides functions to whitelist or restrict functions that can be called by proposals.
Address: 0x6a9331336c33F750E3eb562Fe2F4ffa339793d35
Library for managing proposals in the Governor contract.
This library provides functions to create, cancel, execute, and validate proposals.
Address: 0x1B7E1DB94Fd6De974138b59F41d87EB78be92ba1
Library for managing quorum numerators using checkpointed data structures.
Address: 0x21d7Be787b92C1d4E760dE2f9bBf88F69678eddB
Library for Governor state logic, managing the state transitions and validations of governance proposals.
Address: 0x8Ff6e6926D583FEE68B4092e7cc4F4446bFDCB97
Library for handling voting logic in the Governor contract.
Address: 0xFdD2F1D4fb6d6660FAe38596ba8fd501623ffDa8
We are using UUPS proxy for our upgradeable contracts. You can read more about it here:https://docs.openzeppelin.com/contracts/5.x/api/proxy.
Contract | Upgradable | Authoriser |
B3TR | No | |
B3TRProxy | No | |
B3TRGovernor | Yes | Governance OR DEFAULT_ADMIN |
Emissions | Yes | UPGRADER_ROLE |
GalaxyMember | Yes | UPGRADER_ROLE |
NodeManagement | Yes | UPGRADER_ROLE |
Timelock | Yes | UPGRADER_ROLE |
Treasury | Yes | UPGRADER_ROLE |
VOT3 | Yes | UPGRADER_ROLE |
VoterRewards | Yes | UPGRADER_ROLE |
X2EarnApps | Yes | UPGRADER_ROLE |
X2EarnCreators | Yes | UPGRADER_ROLE |
X2EarnRewardsPool | Yes | UPGRADER_ROLE |
XAllocationPool | Yes | UPGRADER_ROLE |
XAllocationVoting | Yes | UPGRADER_ROLE |
In B3TRGovernorwe are utilizing libraries inside some of the modules. To upgrade the functionalities inside these libraries the following steps must be done.
Update library
Deploy new library
Deploy new implementation contract connecting updated library with new library address
Upgrade the proxy to use this new implementation smart contract using the upgradeToAndCall function .
