Skip to content

Simple blockchain server written in Haskell for educational purposes

License

Notifications You must be signed in to change notification settings

aviaviavi/legion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Legion - a simple blockchain implementation

Build Status

An as-simple-as-possible blockchain server inspired by naivechain, but written in Haskell. Spinning up several Legion nodes creates a peer to peer network that syncronizes the block chain across the network.

Prereqs: To compile from source, you'll need stack.

Alternatively, you can get a precompiled pre-release binary. Note: if you download the binary from github, you'll need to mark it executable by running:

$ chmod +x legion-exe

Usage:

$ stack exec legion-exe [http port] [p2p port] [optional: `seedhost:seedP2PPort`]

Examples:

$ stack exec legion-exe 8001 9001

By default, legion will log what it's doing to standard out. In another terminal window:

$ stack exec legion-exe 8002 9002 localhost:9001

Alternatively, you grab the binaries from the github releases, and run that directly rather than via stack exec

The 3rd argument tells the node where a seed node can be found to bootstrap the connection to the peer to peer network. The current state of the (valid) blockchain will be fetched from all servers, and it will automatically keep itself updated and post its own updated to others.

Now that 2 nodes are now synced, and you can view the current chain from either node at http://localhost:$httpPort/chain, eg http://localhost:8001/chain

Add a new block to the blockchain via a POST request to /block:

$ curl -H "Content-Type: application/json" -X POST -d '{"blockBody": "this is the data for the next block"}' http://localhost:8001/block

About

Simple blockchain server written in Haskell for educational purposes

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published