Awesome
<img align="right" width="150" height="150" top="100" src="./assets/m-icon.jpg">VSCode Solidity Inspector •
An extension for VSCode editor that offers multiple utilities to work with the Solidity smart-contracts.
Note: This extension is not tested across multiple platforms yet. Only the contracts under foundry project are supported for now.
Motivation:
0age 👑 dropped the optimization alpha in his tweet and when I tried it out for the first time I thought it was really a cool trick. The tweet has the configuration only for hardhat projects. But forge helps to do the same thing in a single command. So I thought instead of typing out the command for each contract in the CLI, it would be handy for the buildooors if there's an extension to inspect solidity contracts and generate low-level code for the contracts. The o/p generated is very useful for gas optimizations. Later I started adding more features to this extension.
TL;DR, this is my first VSCode extension, so feel free to provide feedback as I know that there's a plenty of room for improvements, as always^^
Features at a glance:
- Forge ir-optimized o/p generation for the current file (or) selected file(s).
- Forge asm-optimized o/p generation for the current file (or) selected file(s).
- Forge storage-layout o/p generation for the current file (or) selected file(s).
- Flatten current file (or) selected file(s).
- Inline highlighting in code editor for unused imports.
- Generate and view Foundry deployment report in a clean and concise table format.
- Syntax highlighting of for
.tree
files. - Generate foundry test stub using bulloak's
scaffold
command. - Auto-complete path suggestions for importing files and dependencies (with forge remappings support).
- Inline code-separator suggestion (solmate and solady style)
- Contract code size decorator.
Requirements
The following will need to be installed in order to use this template. Please follow the links and instructions.
-
- This will install
forge
,cast
, andanvil
- You can test you've installed them right by running
forge --version
and get an output like:forge 0.2.0 (f016135 2022-07-04T00:15:02.930499Z)
- To get the latest of each, just run
foundryup
- This will install
-
- This is required to generate test stub from
.tree
spec files.
- This is required to generate test stub from
Usage
The usage of this extension is straightforward.
- From the context menu: Select file(s) -> Right click ->
SolidityInspector: <ACTION>
- From the command pallet: Press
Cmd + Shift + P
-> SearchSolidity Inspector - <ACTION>
Highlights unused imports:
Generate foundry deployment report:
Support for .tree
files and test stub generation:
File import auto-complete suggestions (with forge remappings support):
[!TIP] If you have updated your remappings.txt file, you can press
CMD+CTRL+X
to refresh remappings.
Inline separator suggestions:
Inline contract size decoration:
[!TIP] This uses the
deployedBytecode
object from the build file. So it will get updated only after every build. This setting can be also turned on/off via the extension settings.
<!-- CONTRIBUTING -->[!NOTE] For more demos, see ./assets
Contributing
Contributions are welcomed. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Disclaimer
The outputs generated are not always safe for production usage. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the result. They have not been audited and as such there can be no assurance they will work as intended, and users may experience delays, failures, errors, omissions, loss of transmitted information or loss of funds. The creators are not liable for any of the foregoing. Users should proceed with caution and use at their own risk.