DEV Community

Cover image for How to build a blockchain from scratch with Go
Matt Angelosanto for LogRocket

Posted on • Originally published at

How to build a blockchain from scratch with Go

Written by Solomon Esenyi ✏️

Blockchains are the underlying technology for many decentralized applications and cryptocurrencies. They are considered one of this generation’s most significant discoveries. Despite being in its early stages, blockchain is already applicable in many industries and is creating new job roles and opportunities for developers, artists, gamers, content writers, and many more.

This tutorial aims to teach you how blockchains work by guiding you through building one from scratch with Go. If you have heard of blockchains, but are still confused about how they work, this article is for you.

Why build a blockchain with Go?

Go provides many unique features and functionalities that make it a good fit for building a blockchain. For example, Go allows you to create highly efficient and performant applications with little effort.

Go is also excellent for building applications that require parallelism and concurrency (like blockchains) with its ability to spawn and manage thousands of Goroutines. Go implements automatic garbage collection and stack management with its runtime system.

Finally, it compiles applications to machine code and single binaries, supporting multiple OSs and processor architectures, and deploys easily on server infrastructure.


To follow and understand this tutorial, you will need the following:

What is a blockchain?

A blockchain is a digital record of transactions distributed and shared among the nodes of a computer network. Each transaction in the blockchain is called a block, and links to another with cryptography techniques.

Blockchains are helpful when you are trying to build a decentralized system that ensures the security and integrity of data while maintaining trust between every system user.

What is a block?

We mentioned blocks earlier, and you might be wondering what they are. Put simply, a block is a group of data, and multiple blocks come together to form a blockchain.

Every block in a blockchain possesses the following properties:

  • Data to record on the blockchain, e.g., transaction data
  • A block hash, the ID of the block generated using cryptography techniques
  • The previous block’s hash, which is the cryptographic hash of the last block in the blockchain. It is recorded in every block to link it to the chain and improve its security
  • A timestamp of when the block was created and added to the blockchain
  • Proof of Work (PoW), which is the amount of effort taken to derive the current block’s hash. We will explain this in depth later in the tutorial

Getting started

Let us start by creating a new Go project and importing all the necessary packages to build our blockchain. Create a file named blockchain.go and save the following code in it:

package main

import (
Enter fullscreen mode Exit fullscreen mode

Next, we will create a custom block type to hold our blockchain’s data. Add the following code to the blockchain.go file:

type Block struct {
        data         map[string]interface{}
        hash         string
        previousHash string
        timestamp    time.Time
        pow          int
Enter fullscreen mode Exit fullscreen mode

Then, we will create a custom Blockchain type that contains our blocks. Add the following code to the blockchain.go file:

type Blockchain struct {
        genesisBlock Block
        chain        []Block
        difficulty   int
Enter fullscreen mode Exit fullscreen mode

The genesisBlock property represents the first block added to the blockchain. In contrast, the difficulty property defines the minimum effort miners have to undertake to mine a block and include it in the blockchain.

Calculating the hash of a block

Like we discussed earlier, the hash of a block is its identifier generated using cryptography. We will derive the block hash for our blockchain by hashing the previous block hash, current block data, timestamp, and PoW using the SHA256 algorithm.

Let's create a method for our Block type that implements this functionality:

func (b Block) calculateHash() string {
        data, _ := json.Marshal(
        blockData := b.previousHash + string(data) + b.timestamp.String() + strconv.Itoa(b.pow)
        blockHash := sha256.Sum256([]byte(blockData))
        return fmt.Sprintf("%x", blockHash)
Enter fullscreen mode Exit fullscreen mode

In the code above, we did the following:

  • Converted the block’s data to JSON format
  • Concatenated the block’s previous hash, data, timestamp, and proof of work (PoW)
  • Hashed the earlier concatenation with the SHA256 algorithm
  • Returned the hashing result in base 16, with lowercase letters for A-F

Mining new blocks

Mining a new block involves generating a block hash that starts with a desired number of zeros (the desired number is the mining difficulty). This means if the difficulty of the blockchain is three, you have to generate a block hash that starts with "000" e.g., "0009a1bfb506…".

Because we derive a block’s hash from its content, we need to keep changing the PoW value of the current block until we get a hash that satisfies our mining condition (starting zeros > difficulty).

To implement this, we will create a mine() method for our Block type that will keep incrementing the PoW value and calculating the block hash until we get a valid hash.

Add the following code to the blockchain.go file:

func (b *Block) mine(difficulty int) {
        for !strings.HasPrefix(b.hash, strings.Repeat("0", difficulty)) {
                b.hash = b.calculateHash()
Enter fullscreen mode Exit fullscreen mode

Creating the genesis block

Next, we will write a function that creates a genesis block for our blockchain and returns a new instance of the Blockchain type.

Add the following code to the blockchain.go file:

func CreateBlockchain(difficulty int) Blockchain {
        genesisBlock := Block{
                hash:      "0",
                timestamp: time.Now(),
        return Blockchain{
Enter fullscreen mode Exit fullscreen mode

Here, we set the hash of our genesis block to "0". Because it is the first block in the blockchain, there is no value for the previous hash, and the data property is empty.

Then, we created a new instance of the Blockchain type and stored the genesis block along with the blockchain’s difficulty.

Adding new blocks to the blockchain

Now that we have implemented functionalities for our blocks to calculate their hash and mine themselves, let’s see how to include new blocks into a blockchain.

Add the following code to the blockchain.go file:

func (b *Blockchain) addBlock(from, to string, amount float64) {
        blockData := map[string]interface{}{
                "from":   from,
                "to":     to,
                "amount": amount,
        lastBlock := b.chain[len(b.chain)-1]
        newBlock := Block{
                data:         blockData,
                previousHash: lastBlock.hash,
                timestamp:    time.Now(),
        b.chain = append(b.chain, newBlock)
Enter fullscreen mode Exit fullscreen mode

Here, we created an addBlock method to the Blockchain type that does the following:

  • Collects the details of a transaction (sender, receiver, and transfer amount)
  • Creates a new block with the transaction details
  • Mines the new block with the previous block hash, current block data, and generated PoW
  • Adds the newly created block to the blockchain

Checking the validity of the blockchain

We have successfully created a blockchain that can record transactions, and we need a functionality that checks if the blockchain is valid so we know that no transactions have been tampered with.

Add the following code to the blockchain.go file:

func (b Blockchain) isValid() bool {
        for i := range b.chain[1:] {
                previousBlock := b.chain[i]
                currentBlock := b.chain[i+1]
                if currentBlock.hash != currentBlock.calculateHash() || currentBlock.previousHash != previousBlock.hash {
                        return false
        return true
Enter fullscreen mode Exit fullscreen mode

Here, we recalculated the hash of every block, compared them with the stored hash values of the other blocks, and checked if the previous hash value of any other block is equal to the hash value of the block before it. If any of the checks fail, the blockchain has been tampered with.

Using the blockchain to make transactions

We now have a fully functional blockchain! Let’s create a main() function to show its usage.

Add the following code to the blockchain.go file:

func main() {
        // create a new blockchain instance with a mining difficulty of 2
        blockchain := CreateBlockchain(2)

        // record transactions on the blockchain for Alice, Bob, and John
        blockchain.addBlock("Alice", "Bob", 5)
        blockchain.addBlock("John", "Bob", 2)

        // check if the blockchain is valid; expecting true
Enter fullscreen mode Exit fullscreen mode


In this tutorial, you learned how blockchains work under the hood, including what blocks are and what they contain, and how to calculate a block hash, implement a consensus algorithm for mining blocks, record transactions on the blockchain, and validate the authenticity of a blockchain.

The source code of the Go blockchain is available as a GitHub Gist. I can’t wait to see the amazing things you build with Go, as it is a good fit for applications where efficiency and performance are a top priority.

Happy coding!

LogRocket: Full visibility into your web apps

LogRocket Dashboard Free Trial Banner

LogRocket is a frontend application monitoring solution that lets you replay problems as if they happened in your own browser. Instead of guessing why errors happen, or asking users for screenshots and log dumps, LogRocket lets you replay the session to quickly understand what went wrong. It works perfectly with any app, regardless of framework, and has plugins to log additional context from Redux, Vuex, and @ngrx/store.

In addition to logging Redux actions and state, LogRocket records console logs, JavaScript errors, stacktraces, network requests/responses with headers + bodies, browser metadata, and custom logs. It also instruments the DOM to record the HTML and CSS on the page, recreating pixel-perfect videos of even the most complex single-page apps.

Try it for free.

Top comments (3)

s0bacc profile image

Now is the perfect time to learn more about it and become a developer because the crypto market is getting pretty popular, and in general, this technology is quite promising. I used to work with guys from, and they're actually great specialists, and I don't even know how long it took them to become that good.

umitsamima profile image
Umit D Sami

Great Blockchain article 101 ! next you must add a consensus algorithm to make the blocks distributed and consistent ! Byzantine Cons. Algo, Raft ( ) or something else !

lil5 profile image
Lucian I. Last

Golang's efficiency will not fix the resource usage problem Crypo currencies introduce, the Jevons Paradox will/has happen(ed).