Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/luisedmc/BlockchainGo
:chains: Implementing Blockchain in Golang
https://github.com/luisedmc/BlockchainGo
bitcoin-wallet blockchain blockchain-technology cryptocurrency go golang
Last synced: about 1 month ago
JSON representation
:chains: Implementing Blockchain in Golang
- Host: GitHub
- URL: https://github.com/luisedmc/BlockchainGo
- Owner: luisedmc
- Created: 2022-12-28T23:54:52.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-03-13T22:40:06.000Z (almost 2 years ago)
- Last Synced: 2024-11-30T06:48:03.052Z (about 1 month ago)
- Topics: bitcoin-wallet, blockchain, blockchain-technology, cryptocurrency, go, golang
- Language: Go
- Homepage:
- Size: 229 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## BlockchainGo
BlockchainGo is a simple implementation of the Blockchain technology in Go language. This project was build to learn more about the Blockchain technology and its features. The code was written with some comments in a way that can maybe help understand the most complicated parts. The code is also very direct, I didn't try to reinvent the wheel, just implement some of the Blockchain features.
I will be adding more features to this project in the future. See [Roadmap](#roadmap) section for more details.
#### Disclaimer
Like i said before, this project was built for learning purposes. It is not a production ready code. It is not secure or optimized and probably was not written in the best way.
## Table of Contents
- [BlockchainGo](#blockchaingo)
- [Disclaimer](#disclaimer)
- [Table of Contents](#table-of-contents)
- [Blockchain](#blockchain)
- [What's Blockchain?](#whats-blockchain)
- [Blocks](#blocks)
- [Transactions](#transactions)
- [Wallet](#wallet)
- [Current State](#current-state)
- [Usage](#usage)
- [Commands](#commands)
- [Example](#example)
- [Roadmap](#roadmap)
## Blockchain
### What's Blockchain?
Blockchain technology is a secure database that allows transparent information sharing inside a network. This database is public, so everyone can visualize the records inside but can't delete or modify the data (something like a read-only database). All the data are stored in an immutable encrypted container that anyone can track called **block**.
### Blocks
Blocks are used to store the data inside the Blockchain. Each block has a unique identifier called **hash**. This hash is generated by the hash of the previous block. This way, all the blocks are connected, like a chain, and it is impossible to change the data inside a block without changing the hash of the block and all the following blocks. That's why this tecnology is called Blockchain.
### Transactions
As I said before, the Blockchain stored encrypted data in blocks, which are a very safe way to store data.
This works very well in the context of transactions. For example, if you want to sell some cryptocurrencies for your friend, the Blockchain will create a unique ledger for the seller and buyer.
The transactions inside the Blockchain connect people with people **without relying on any financial system** (peer-to-peer), making this whole process a lot safer.
### Wallet
Wallet is simply the local you store your and manage your cryptocurrencies. It consists of two parts: a Public Address and a Private Key. The Public Address is the Wallet Address and is a string of characters that other people can use to send you cryptocurrency. The Private Key is a secret string of characters that you use to access your wallet (very important to keep this one in a safe place).
## Current State
At the current state, the BlockchainGo has the following features:
- Create a new Blockchain and store it in the database
- Print the All Blocks
- Transactions
- Get the balance of a specific address
- Create a valid BTC Wallet address
## Usage
Clone this repository and change to the project directory:
```
git clone https://github.com/luisedmc/BlockchainGo && cd BlockchainGo
```
If some packages are missing, you can get them with `go mod tidy`
In the project directory, just `go run main.go` or `go run .` and then the commands listed below.
You can also build the binary file with `go build` and then run it using `./BlockchainGo`
### Commands
| Command | Description |
| --------------------------------------- | ----------------------------------------------------------------- |
| `createBlockchain -address ADDRESS` | Create a new Blockchain with the given address as the first miner |
| `printChain` | Print all the blocks of the blockchain |
| `getBalance -address ADDRESS` | Get the balance of the given address |
| `send -from FROM -to TO -amount AMOUNT` | Send the given amount of coins from one address to another |
| `createWallet` | Create a new BTC wallet address |
#### Example
`go run . createBlockchain -address "luisedmc"`
or
`./BlockchainGo createBlockchain -address "luisedmc"`
## Roadmap
Features that I would like to implement in the future:
- [x] Wallets
- [ ] Signatures
- [ ] Web Server
- [ ] Ethereum