HIP: ??
title: HIPs that require governor submission must include details
author: @juanu
status: Phase 1
created: 2022-05-31
Simple Summary
When reaching a Phase 3 HIP that reaches consensus, and requires an update to the gorvernor, the specificc details for submission must be included on the Implementation section of the Phase 3 HIP
Abstract
There has been a long discussion about HIP submission guidelines. This HIP is one more step to make them more clear.
When a Phase 3 HIP reaches consensus, and requires an update to the governor contract, the actual last step of sending the transaction with the submission, generates some friction. This is because not every HIP author knows what it’s required to make the submission, or, if they do, they don’t know how or where to do it.
By implementing this HIP as part of the submission frameworks, a submitter MUST include the details of the actual transaction to be submited to the governor contract, including any extra information such as the updated Proof of Humanity Policy document (if it applies).
As a bonus, having this definition mandatory on the HIP, it allows the community members to validate that proposed submission is correct. This validation might not be achievable by ALL members since it requires some technical knowledge, but it can be learned.
Implementation
In order to make Phase 3 HIPs implementation more clear to the community and easy to validate, all Phase 3 HIPs, that require a submission to the governor and that were created after this HIP acceptance, must include:
-
The details of the transaction to execute to the Governor. This can be done by creating the transaction without submitting it, using the Kleros submission tool for proof of humanity. To do this, some technical knowledge is required in order to understand what it takes to create the transaction. If the HIP proposer doesn’t know how to achieve it, they should ask for help on the community. [NOTE: THERE IS A GUIDE THAT WAS WRITTEN ON THE TELEGRAM CHAT BY @fnanni on how to do this**. If this HIP reaches interest to be moved to Phase 2, I, @juanu, pledge to edit and turn it into a simple step by step, explaining each step involved.]
-
If an update to the Proof of Humanity registry policy is needed, the updated document should be included on the Phase 3 proposal. This should be included as an IPFS url, in order to rely on a verifiable file URL, rather than a centralized storage service, which can be compromised. If teh submitter doesn’t know how to upload a file to IPFS, they should ask for help to the community.
-
In the case where the Phase 3 HIP requires an update to the Registry Policy Document, the source of truth of what should be on the new Registry policy, will be taken as the included document. This will also be true even if the HIP has differences in the HIP text vs the updated document text. In the end, what is what the updated Registry Policy states. This is only true as long as the HIP is congruent with the proposed update. It is recommended to not include registry policy text on the HIP, but on the final document to avoid interpretation issues.