Acting as guardian for a dispute
Last updated
Last updated
In this section, we will explain how to act as a guardian for an Aragon Govern dispute.
The first use case for Aragon Court is the subjective dispute resolution for Aragon Govern DAOs, enabling optimistic governance to take place with an extra layer of security.
Whenever an Aragon Govern transaction is challenged, a new dispute is created in Aragon Court. If you get summoned as a guardian for this kind of dispute, this is what you need to know.
Description: The basic description of the transactions. This should provide you with additional context on what the transaction is about.
Agreement: The agreement or contract that supports this transaction. All Aragon Govern DAOs MUST have a human-readable agreement that states how the DAO intends to operate, and what actions should be allowed or not. For example, an agreement might say that a given DAO can only invest in sustainability projects, and the action instead intends to transfer funds to a car manufacturing company.
Executor: The address of the contract that will execute this transaction.
Dispute creator: The address of the person/contract that created the dispute.
Actions: The set of transactions that will be executed if the dispute is ruled in favor of who created this.
Original justification: This is a human-readable justification stating why actions were scheduled to be executed. For example, the creator might say something like "Transferring funds to a project that is creating a carbon footprint offset device". This is added by the actions creator when scheduling the actions.
Dispute evidence: The justification of why the actions are being challenged. For example, something like "The destination address belongs to a car manufacturing company, and therefore we should not allow this transferring of the funds". This is added by the person that challenged the actions.
Actions are nothing more than smart contract transactions that have been scheduled with an Aragon Govern DAO. Those can be any interaction with an EVM-compatible blockchain, such as transferring funds, minting tokens, swapping tokens, etc.
On Aragon Govern, an action can be a bundle of several transactions. This is what is shown in Aragon Court. Understanding the Actions is primordial to be able to rule on this dispute.
The action contains the following information:
To: Smart contract that will receive the transaction
Value: Optional amount of ETH being sent in the transaction
Function to be called: Name of the function being called in the "To" smart contract
Data: The parameters being sent to the function.
If you want to dig deeper and understand what a given function does, and what each parameter is used for, click on the TO address and open it on Etherscan. There you should be able to see details of the contract and function code.
Sometimes the function and data might not be available (when the contract is not verified on Etherscan (Learn More). In this case, you will see the Raw Data, which can still be decompiled if you research the destination contract.
You can always click on the addresses to check the contracts on Etherscan to better understand what the transactions will be performing.
As mentioned, whenever someone schedules transactions on Aragon Govern or challenges these, they are required to provide evidence on why they are doing so. The evidence section of Aragon Court shows the address of the person that submitted the evidence, as well as the date of the submission, and its content (text or file).
Once the dispute goes into the voting stage (after the guardians have been summoned, and you were one of them) it is time to vote if these actions should be permitted or not.
When the voting time comes for an Aragon Govern dispute, you need to decide if the Actions should be allowed, blocked, or if you don't have enough context to rule upon it.
Remember that if you voted with the majority (for any of the 3 aforementioned options) your tokens will not get slashed, and you will earn slashed tokens from whoever did not vote with the majority. Take the time to deeply think about what is the right decision here.
Voting is MANDATORY if you are summoned. If you don't cast your vote (The refuse to vote option is considered a cast as well) your tokens will be slashed.
Allow action: transactions take place if the majority votes for it.
Block action: transactions are canceled if the majority votes for them.
Refuse to vote: transactions take place if the majority refuses to vote.
To make sure guardians act without any bias, votes are kept secret during the voting phase. For this reason, when you commit your vote, you will be asked to save a one-time code to be used when the reveal phase starts.
You also have the option to enable the auto-reveal service.
Auto-reveal service might not be available sometimes. If this happens, please wait for about 2 minutes, and try again.
If you do not enable auto-reveal and do not manually reveal your vote when the reveal stage is available, the system will consider that you did not vote, and you will get your tokens slashed.
The next stages can be triggered by anyone in Aragon court (including you) but are not your responsibility. If a dispute is appealed, a new round of guardians will be summoned. If you are one of them, follow this same process again.
