Skip to content

Repository files navigation

Certainly! Below is a professional README file tailored to impress blockchain hiring staff. This README highlights the key aspects of the project, including setup instructions, deployment, testing, and additional resources.

# Blockchain Developer Bootcamp Project

Welcome to the Blockchain Developer Bootcamp Project! This repository contains a comprehensive blockchain application built with Solidity, Hardhat, and React. The project demonstrates the deployment and interaction with a smart contract on the Ethereum blockchain.

## Table of Contents

- [Introduction](#introduction)
- [Features](#features)
- [Project Structure](#project-structure)
- [Setup Instructions](#setup-instructions)
- [Deployment](#deployment)
- [Testing](#testing)
- [Scripts](#scripts)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [License](#license)

## Introduction

This project showcases a full-stack blockchain application, including a smart contract for a token (ERC-20) and a React frontend for interacting with the contract. The smart contract is deployed using Hardhat, and the frontend is built with Create React App.

## Features

- **ERC-20 Token**: A custom token with minting, transferring, and allowance functionalities.
- **Deployment Scripts**: Automated deployment scripts using Hardhat.
- **Frontend Integration**: A React application to interact with the deployed smart contract.
- **Testing**: Comprehensive unit tests for the smart contract.

## Project Structure

. ├── .env ├── .gitignore ├── artifacts/ ├── cache/ ├── contracts/ │ └── Token.sol ├── hardhat.config.js ├── package.json ├── public/ │ └── index.html ├── scripts/ │ ├── 1_deploy.js │ └── deploy.js ├── src/ │ ├── App.css │ ├── App.js │ ├── App.test.js │ ├── index.css │ ├── index.js │ ├── reportWebVitals.js │ └── setupTests.js ├── test/ │ └── Token.js └── README.md


## Setup Instructions

1. **Clone the repository**:

git clone https://github.com/Th3c0d3d1/Token.git


2. **Install dependencies**:

npm install


3. **Set up environment variables**:
Create a .env file in the root directory and add the following:

ALCHEMY_API_KEY=your-alchemy-api-key PRIVATE_KEYS=your-private-keys ETHERSCAN_API_KEY=your-etherscan-api-key


## Deployment

1. **Compile the contracts**:

npx hardhat compile


2. **Deploy the contracts**:

npx hardhat run scripts/1_deploy.js --network sepolia


## Testing

1. **Run the tests**:

npx hardhat test


## Scripts

- **Start the React app**:

npm run start


- **Build the React app**:

npm run build


- **Run tests**:

npm test


## Technologies Used

- **Solidity**: Smart contract programming language.
- **Hardhat**: Ethereum development environment.
- **React**: JavaScript library for building user interfaces.
- **Ethers.js**: Library for interacting with the Ethereum blockchain.
- **Chai**: Assertion library for testing.

## Contributing

Contributions to this project are welcome. Please fork the repository and submit pull requests for any enhancements or bug fixes.

## License

This project is licensed under the MIT License. See the LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages