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

NPM

$ npm install ts-node -g
$ npm install coin-ts -g
$ coin

Usage

Command	Alias	Description	Example
open	o	Open to accept incoming connections.	open 5000
connect	c	Connect to a new peer with 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 with and using wallet	pay xxx... 10 5 mypassword
balance [address]	b	Balance of optional	balance or balance xxx...
help [command...]		Provides help for a given command	help balance or help
exit		Exits application.