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

feat(docs): Project overview and spelling. #45

Merged
merged 2 commits into from
Dec 22, 2023
Merged

Conversation

raxhvl
Copy link
Contributor

@raxhvl raxhvl commented Dec 13, 2023

No description provided.

@gnidan gnidan mentioned this pull request Dec 13, 2023
Copy link
Member

@gnidan gnidan left a comment

Choose a reason for hiding this comment

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

Thanks for all the typo fixes and the first pass on a Project overview.

This is definitely a significant net improvement, so here's an approve. Feel free to incorporate my suggestion now or in another PR :)

Comment on lines +7 to +13
The security of smart contracts hinges on the availability of robust debugging tools. As the compiler optimizes a contract, it may move instructions around or remove them thus weakening its relationship with the original source code. The debugger then faces the challenging task of reversing these transformations to enrich the often cryptic artifacts with contexts mapping back to the contract's source.

The ETH debug standard aims to bridge this intricate dichotomy between the compiler and debugger, guided by the following key goals:

- **Minimal Overhead**: Extend compiler output without duplication or excessive disk footprint.
- **Language Agnostic**: Remain independent of any specific programming language or compiler, ensuring wide applicability within the Ethereum Virtual Machine (EVM) ecosystem.
- **Robust Interface**: Provide a comprehensive and standardized interface for debuggers, enabling a rich and industry-standard debugging experience for developers.
Copy link
Member

Choose a reason for hiding this comment

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

This is great stuff. Should we also mention in this subsection something about how we want to build a debugging data format? We mention the problem but maybe a sentence at the end (after your bulleted list), something like "To this end, we seek to design and specify a debugging data format for EVM languages." (nothing fancy, since the following sections will expand on all these points)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I have extended to add:

  • info about primary audience (tool devs)
  • downstream benefits for app developers / ecosystem

To this end, we seek to design and specify a debugging data format for EVM languages. We hope this format will empower tooling developers building debuggers and analysis frameworks, and ultimately enable application developers to benefit from enhanced debugging capabilities to build more robust and secure smart contracts.

@gnidan gnidan changed the base branch from docusaurus to main December 22, 2023 05:29
@gnidan gnidan merged commit e16e864 into ethdebug:main Dec 22, 2023
1 check passed
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.

2 participants