Blockchain

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 12 Open GitHub ↗

P2P payment system with a cryptocurrency wallet built on a blockchain like distributed ledger with shared transaction pool and shared blockchain across all nodes in the network

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Cryptocurrency built on a distributed ledger

[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![alt text](https://github.com/mayankamencherla/Blockchain/blob/master/bitcoin.jpg)

## Downloading
```bash
$ git clone https://github.com/mayankamencherla/Blockchain.git
```

> This app is a backend that mimics a peer to peer payment system (like Bitcoin), with a fully functional wallet, attached to the local miner, but with transactions and the blockchain synced across the distributed system of nodes

## Pre-requisities:
> Some key things to set up / understand to use this app:

- **[NodeJS v9](https://nodejs.org/en/)**
- **[npm](https://www.npmjs.com/)**
- **[Bitcoin](https://bitcoin.org/bitcoin.pdf)**

## Setup Locally
> To get the app working locally, or to run test cases, follow the instructions below.
> After setting up the app, details on each API and how to use it can be found below in the **[API's available on this app](https://github.com/mayankamencherla/Blockchain#apis-available-on-this-app)** section.
> If any of the commands below are denied due to a permission error, please prepend a sudo to the command.

1. Navigate to the app's root directory

2. Run the following command to install all the dependencies:
```bash
$ npm install
```

3. Open the first node on the network:
```bash
$ npm run dev
```
By default, the first node's HTTP server is hosted on port 3001, and the P2P server is hosted on port 5001

4. Open the second node on the network:
```bash
$ HTTP_PORT=3002 P2P_PORT=5002 PEERS=ws://localhost:5001 npm run dev
```
This opens a new node, with an HTTP server hosted on port 3002, and the P2P server hosted on 5002, and it connects to the peers in the network (In this case, only 1 hosted on port 5001)

5. To open the nth node on the network:
```
  a. Choose 2 open ports, 1 for the HTTP server, and 1 for the P2P server of the node
  b. PEERS = n-1 P2P servers that were created before this node in the form: ws://localhost:<port>, seperated by commas
```
```bash
$ HTTP_PORT=<HTTP PORT> P2P_PORT=<P2P PORT> PEERS=<ws://localhost:<PORT1>,ws://localhost:<PORT2>...> npm run dev
```

## Run test cases:
```bash
$ npm run test
```

## API's available on this app
> This app supports 6 API's currently: (3001 can be changed to any of the other node's HTTP server's port number)

1. GET <a href="http://localhost:3001/blocks" target="_blank">/blocks</a>
   - Fetch the blocks in the blockchain saved locally on the node whose HTTP server is running on port 3001

2. POST <a href="http://localhost:3001/mine" target="_blank">/mine</a>
   - Mines a new block containing the data field in the post request
   - The block is then added to the blockchain locally
   - The updated blockchain is broadcasted across the network so that other nodes can update their blockchains

3. GET <a href="http://localhost:3001/transactions" target="_blank">/transactions</a>
   - Fetch all transactions in the transactions pool saved locally in the node
   - The transaction pool is the same and is saved across all nodes in the network

4. POST <a href="http://localhost:3001/transact" target="_blank">/transact</a>
   - Takes in recipient and amount as post parameters
   - This endpoint is used to send amount to recipient from wallet at 3001
   - Creates a new transaction and adds it to the transaction pool
   - Wallet at 3001 has amount subtracted, and recipient wallet gets amount added to balance

5. GET <a href="http://localhost:3001/public-key" target="_blank">/public-key</a>
   - This endpoint is used to retrieve public key for the wallet at port 3001
   - This public key must be used as recipient to send wallet at 3001 currency

6. GET <a href="http://localhost:3001/mine-transactions" target="_blank">/mine-transactions</a>
   - Mines a new block containing all the transactions in the transaction pool shared across all nodes in the network
   - The block is mined based on the **[proof of work](https://github.com/mayankamencherla/Blockchain#proof-of-work)** mechanism also used in Bitcoin.
   - The block is then added to the blockchain locally
   - The updated blockchain is broadcasted across the network so that other nodes can update their blockchains

## Proof of work
> The miner creats a new block using the proof of work mechanism outlined below

1. When the miner decides to mine a new block, he does so with all the transactions in the transaction pool
2. The initial block is a genesis block, and a new block is mined based on the following parameters:
```
    a. block of the last hash
    b. nonce
    c. hash of the current block
    d. timestamp
    e. difficulty
```
3. The proof of work mechanism iteratively increases nonce and alters difficulty, until the number of leadings 0's in the block's hash are equal to the difficulty in the current iteration
4. This is done to ensure that each block is added once every `MINE_RATE` of the blockchain
5. The algorithm can be found in **[mine block](https://github.com/mayankamencherla/Blockchain/blob/master/blockchain/block.js#L38)**

Blockchain

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README