coin-cli's Introduction

Coin CLI

A minimal cryptocurrency CLI implementation in TypeScript & Immutable.js

Demo

Connect

Mining

Payment

🎉 Features

💰 Wallet with public and private key.
💳 Make Payments between wallets.
🔑 Transactions are signed with the wallet's private key.
🔗 Blocks with index, hash, data, transactions, and timestamp.
⛏ Proof-of-work implementation.
⛓ In-memory JavaScript array to store the blockchain.
✅ Block & Transaction integrity validation.
📡 Decentralized and distributed peer-to-peer communication.
✨ Minimal implementation in 900 lines of code.

📦 Installation

To install this application, you'll need Node.js 7+ (which comes with npm) installed on your computer. From your command line:

Source (recommended)

You'll need Git to run the project from source. From your command line:

# Clone this repository
$ git clone https://github.com/seanjameshan/coin-cli

# Go into the repository
$ cd coin-cli

# Install dependencies
$ npm install

# Run the app
$ npm start

🕹️ Usage

Command	Alias	Description	Example
open	o	Open port to accept incoming connections.	open 5000
connect	c	Connect to a new peer with host and	connect localhost 5000
blockchain	bc	See the current state of the blockchain.
peers	p	Get the list of connected peers.
mine [address]	m	Mine a new block with rewards going to optional [address].	mine or mine xxx...
transactions	tx	See unconfirmed transactions that can be mined.
wallet	w	Create a new wallet with	wallet mypassword
key	k	Get your public key
pay	p	Make payment to address with and using wallet	pay xxx... 10 5 mypassword
balance [address]	b	Balance of optional address	balance or balance xxx...
help [command...]		Provides help for a given command	help balance or help
exit		Exits application.