Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Modify Readme #11

Merged
merged 23 commits into from
Sep 26, 2024
Merged

Modify Readme #11

merged 23 commits into from
Sep 26, 2024

Conversation

nivcertora
Copy link
Contributor

No description provided.

@github-actions github-actions bot force-pushed the niv/New-Readme branch 2 times, most recently from a64302a to bbb8e73 Compare September 26, 2024 12:55
README.md Outdated
@@ -1,6 +1,6 @@
# ProposalTools

ProposalTools is a Python-based utility designed to fetch and compare smart contract source codes. It helps users identify and analyze differences between local and remote versions of smart contract code.
ProposalTools is an open-source Python utility designed to fetch and compare smart contract source codes. It helps users identify and analyze differences between local and remote versions of smart contract code, making it easier to review changes and ensure code integrity.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@itay-certora Can you please provide more information from a user perspective?
Maybe more details to someone who is not 100% familiar with proposal reviews?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ProposalTools is an open-source Python utility that simplifies the verification of smart contracts deployed on the blockchain. It works by fetching the smart contract code directly from the blockchain and comparing it to the official code provided by developers or customers in their GitHub repositories. This process ensures that the code running on the blockchain exactly matches the intended code, helping to detect any unauthorized changes or discrepancies and maintaining the integrity and trustworthiness of the deployed contracts.

For users involved in reviewing governance proposals, ProposalTools streamlines the process by automating tasks like searching for specific elements within the contract code—such as ChainLink addresses—making it easier to review and understand the contract’s functionality without manually sifting through the code. This aids in confidently assessing proposals and contributes to maintaining the security of the blockchain network.

If you’re unfamiliar with governance proposals: They are formal suggestions made by community members or stakeholders to introduce changes or improvements to a blockchain network’s protocols, smart contracts, or policies. These proposals require thorough review to ensure they are secure and beneficial to the network.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps add something like this: ProposalTools allows users to pull the smart contract code that is deployed on-chain and compare it to the version stored in the customer's official repositories. This ensures there are no discrepancies between the two versions, which is critical because any unintended changes or errors in smart contracts could lead to vulnerabilities or operational issues.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you think about this paragraph?

ProposalTools is an open-source Python utility designed to verify the integrity of smart contracts deployed on blockchains. It fetches contract code directly from the blockchain and compares it with the official version provided by developers or customers in their GitHub repositories. This process helps identify discrepancies between the on-chain and official code, ensuring the contract deployed on the blockchain matches the intended version. By automating code comparison and streamlining the review of governance proposals, ProposalTools enhances the security and trustworthiness of smart contracts, helping users quickly detect unauthorized changes or errors.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

seems good to me

@nivcertora nivcertora merged commit cfd2bb2 into main Sep 26, 2024
@nivcertora nivcertora deleted the niv/New-Readme branch September 26, 2024 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants