Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/HardlyCodeMan/audit_helper
Boilerplate test creation and Foundry initialisation for solidity smart contract audits
https://github.com/HardlyCodeMan/audit_helper
Last synced: 2 months ago
JSON representation
Boilerplate test creation and Foundry initialisation for solidity smart contract audits
- Host: GitHub
- URL: https://github.com/HardlyCodeMan/audit_helper
- Owner: HardlyCodeMan
- License: mit
- Created: 2022-12-13T01:29:41.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-05T01:19:22.000Z (about 2 years ago)
- Last Synced: 2024-08-05T01:08:52.558Z (6 months ago)
- Language: Python
- Size: 17.6 KB
- Stars: 20
- Watchers: 1
- Forks: 2
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Audit: audit_helper
Awesome Lists containing this project
- awesome-foundry - Audit_Helper - audit_helper is a Python3 helper script for Linux to automate some Foundry boilerplate set up in audit repositories. (Tools)
README
# audit_helper
## Description
audit_helper is a Python3 helper script for Linux to automate some Foundry boilerplate set up in audit repositories.
Too many times have I found myself initialising Hardhat framework based audit repositories with my preferred audit framework Foundry.
## Requirements
Python3
```bash
user@machine:~/ sudo apt install python3
```
Foundry
```bash
user@machine:~/ curl -L https://foundry.paradigm.xyz | bash
```
## Installation
```bash
mkdir ~/audit_helper && cd ~/audit_helper
wget https://raw.githubusercontent.com/HardlyCodeMan/audit_helper/main/audit_helper
chmod u+x ~/audit_helper/audit_helper
echo 'export PATH="$PATH:~/audit_helper"' >> ~/.bashrc
source ~/.bashrc
```
## Usage Example
```bash
user@machine:~/audit_repo$ audit_helper -c src/ -o test/ -p myTest_ -s -oz
```
The above bash command will:
- initialise Foundry into the repository root (with ``-s``)
- remove the initial Counter.* files created automatically by ``foundry init``
- install the openzeppelin/openzeppelin-contracts (with ``-oz``)
- set the contract source in foundry.toml to src/ (with ``-c``)
- set the test source in foundry.toml to test/ (with ``-o``)
- create boilerplate test files
- prefix the boilerplate test filenames with myTest_ (with ``-p``)
## Flags
| --flag | -flag | Description |
|---|---|---|
| --help | -h | Display this menu |
| --version | -v | Print the version number |
||||
| --contracts | -c | Location of contracts |
| --output | -o | Test output folder. (Default: test/) |
| --prefix | -p | Test file prefix (Default: "") |
| --setup | -s | Initialise Foundry project and edit foundry.toml accordingly |
| --openzeppelin | -oz | Requires -s flag. Initialize with OpenZeppelin-Contracts repository |
| --solmate | -sm | Requires -s flag. Initialize with Solate repository |
## Links
- [Changes](./CHANGELOG.md)
- [License](./LICENSE)
- [Foundry](https://github.com/foundry-rs/foundry)
- [OpenZeppelin](https://github.com/openzeppelin/openzeppelin-contracts/)
- [Solmate](https://github.com/transmissions11/solmate)
## Issues and Improvements
Feel free to create issues to raise awareness of problems or feature implementation requests.
By all means please contribute fixes and features through pull requests.