https://github.com/dgca/macro-security

https://github.com/dgca/macro-security

Last synced: 7 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/dgca/macro-security
• Owner: dgca
• Created: 2022-05-21T14:59:15.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-05-21T19:04:34.000Z (over 2 years ago)
• Last Synced: 2024-04-14T10:31:42.848Z (7 months ago)
• Language: Solidity
• Size: 27.3 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# local-ethernauts

This challenge is based on https://ethernaut.openzeppelin.com/

# Setup

1. Get all the dependencies installed with `yarn install`

2. Compile all contracts by running `npx hardhat compile`

3. Run a local node by running `npx hardhat node`

# How to solve each level

- If you look inside the `contracts/` directory you'll find 8 levels for you to solve!

- Each level directory consists of the same structure, let's check out the first one to illustrate this:

  - **CoinFlip.sol**: This is the contract you're supposed to hack!

  - **AttackingCoinFlip.sol**: This is the malicious contract where you'll code the logic to exploit the vulnerable contract!

  - **CoinFlip.test.ts**: This is the file where you'll be able to test if the contract has been breached

  - **CoinFlipHelper.ts**: Not all challenges have this `Helper` file! Only the ones that require you to use `ethers` to interact with your contract do, which you can do right here! This function is already imported into the tests, so don't worry about anything other than coding!

  - And finally, the **README**. On this one you'll get all level instructions!

- After you're done writing your hack, run the following command to run the tests and see if you succesfully breached the contract:

  - `npx hardhat test contracts/{contract directory}/{contract name}.test.ts`

  - Example: `npx hardhat test "contracts/1. CoinFlip/CoinFlip.test.ts"`

# Helpful Tip

- You can console.log in solidity using hardhat! Read here for more details: https://hardhat.org/tutorial/debugging-with-hardhat-network.html