Solidity Learning

This repository contains Solidity smart contract projects and CTF-like challenges for learning purposes.

Built and tested with Hardhat.

Some of the old projects were built and tested with now deprecated Truffle Suite using now deprecated Ganache local test network and Sepolia public test network.

Useful resources:

Work in progress...

Table of Contents

• Ethernaut
• Upgradeable Contracts
• Fundraiser (old)
• Metamorphic Malware (old)

Ethernaut

Web: ethernaut.openzeppelin.com

GitHub: OpenZeppelin/ethernaut

Built and tested with Hardhat. Work in progress...

From \Ethernauth\hardhat, run the unit tests:

npm install

npx hardhat compile

npx hardhat test --network localhost --parallel

Unit tests (Hardhat):

• \Ethernaut\hardhat\test\ethernaut.js (1-25)

[Deprecated] Unit tests (Truffle):

• \Ethernaut\truffle_suite_deprecated\test\ethernaut.js (level 1-20)

Upgradeable Contracts

Built and tested with Hardhat. Work in progress...

Smart contracts:

• \UpgradeableContracts\contracts\

Unit tests:

• \UpgradeableContracts\test\upgradeable.js

Migrations:

• \UpgradeableContracts\scripts\deploy.js

Fundraiser

Built and tested with now deprecated Truffle Suite using now deprecated Ganache local test network and Sepolia public test network.

Work in progress... Also, need to migrate to Hardhat.

Install Truffle:

npm install -g truffle

Make sure to start a local test network using Ganache on port 8545.

From \Fundraiser\truffle, run the unit tests:

npm install

truffle compile

truffle test --network development --show-events

From \Fundraiser\client, run the client web application:

npm install

npm start

Navigate to the client web application with your preferred web browser.

To run the unit tests on Sepolia public test network, do the following:

[1] Specify your Infura (Sepolia) API key and MetaMask wallet mnemonic inside \Fundraiser\truffle\example.env file.

[2] Rename the file from example.env to .env.

[3] In your MetaMask wallet, switch to the Sepolia public test network.

[4] Get some Sepolia ETH from infura.io/faucet/sepolia to your MetaMask wallet.

[5] Finally, run:

truffle test --network sepolia --show-events

Smart contracts:

• \Fundraiser\truffle\contracts\Fundraiser.sol

Unit tests:

• \Fundraiser\truffle\test\fundraiser.js

Migrations:

• \Fundraiser\truffle\migrations\1_deploy_fundraiser.js

Client web application:

• \Fundraiser\client\src\components\Donate.jsx

Metamorphic Malware

Built and tested with now deprecated Truffle Suite using now deprecated Ganache local test network and Sepolia public test network.

Work in progress... Also, need to migrate to Hardhat.

From \Metamorphic, run the unit tests:

npm install

truffle compile

truffle test --network development --show-events

Smart contracts:

• \Metamorphic\contracts\MetamorphicBasic.sol

Unit Tests:

• \Metamorphic\test\metamorphic.js

Migrations:

• \Metamorphic\migrations\1_deploy_metamorphic.js