Full bitcoin solution written in Go (golang)
Piotr N
Latest commit 370b9a9 Oct 17, 2018
Failed to load latest commit information.
client No commit message Oct 12, 2018
lib No commit message Oct 5, 2018
tools No commit message Oct 17, 2018
wallet No commit message Jul 29, 2018
website No commit message Sep 23, 2018
.gitignore Former-commit-id: 6cd8af0 Jun 6, 2014
LICENSE No commit message May 29, 2018
README.md No commit message Mar 7, 2018
changelog.txt No commit message Oct 12, 2018
todo.txt No commit message Oct 7, 2018
version.go No commit message Apr 11, 2018


About Gocoin

Gocoin is a full Bitcoin solution written in Go language (golang).

The software architecture is focused on maximum performance of the node and cold storage security of the wallet.

The client (p2p node) is an application independent from the wallet. It keeps the entire UTXO set in RAM, providing the best block processing performance on the market. With a decent machine and a fast connection (e.g. 4 vCPUs from Google Cloud or Amazon AWS), the node should sync the entire bitcoin block chain in less than 4 hours (as of chain height ~512000).

The wallet is designed to be used offline. It is deterministic and password seeded. As long as you remember the password, you do not need any backups ever.




  • 64-bit architecture OS and Go compiler.
  • File system supporting files larger than 4GB.
  • At least 15GB of system memory (RAM).


  • Any platform that you can make your Go (cross)compiler to build for (Raspberry Pi works).
  • For security reasons make sure to use encrypted swap file (if there is a swap file).
  • If you decide to store your password in a file, have the disk encrypted (in case it gets stolen).

Operating System

Having hardware requirements met, any target OS supported by your Go compiler will do. Currently that can be at least one of the following:

  • Windows
  • Linux
  • OS X
  • Free BSD

Build environment

In order to build Gocoin yourself, you will need the following tools installed in your system:

If the tools mentioned above are all properly installed, you should be able to execute go and git from your OS's command prompt without a need to specify full path to the executables.


When building for Linux make sure to have gcc installed or delete file lib/utxo/membind_linux.go

Getting sources

Use go get to fetch and install the source code files. Note that source files get installed within your GOPATH folder.

go get github.com/piotrnar/gocoin


Client node

Go to the client/ folder and execute go build there.


Go to the wallet/ folder and execute go build there.


Go to the tools/ folder and execute:

go build btcversig.go

Repeat the go build for each source file of the tool you want to build.


Windows or Linux (amd64) binaries can be downloaded from

Please note that the binaries are usually not up to date. I strongly encourage everyone to build the binaries himself.


Although it is an open source project, I am sorry to inform you that I will not merge in any pull requests. The reason is that I want to stay an explicit author of this software, to keep a full control over its licensing. If you are missing some functionality, just describe me your needs and I will see what I can do for you. But if you want your specific code in, please fork and develop your own repo.


The official web page of the project is served at gocoin.pl where you can find extended documentation, including User Manual.

Please do not log github issues when you only have questions concerning this software. Instead see Contact page at gocoin.pl website for possible ways of contacting me.