119 lines
3.8 KiB
Markdown
119 lines
3.8 KiB
Markdown
btcd
|
|
====
|
|
|
|
[]
|
|
(https://travis-ci.org/conformal/btcd)
|
|
|
|
btcd is an alternative full node bitcoin implementation written in Go (golang).
|
|
|
|
This project is currently under active development and is in an Alpha state.
|
|
|
|
It currently properly downloads, validates, and serves the block chain using the
|
|
exact rules (including bugs) for block acceptance as the reference
|
|
implementation (bitcoind). We have taken great care to avoid btcd causing a
|
|
fork to the block chain. It passes all of the 'official' block acceptance tests
|
|
(https://github.com/TheBlueMatt/test-scripts).
|
|
|
|
It also properly relays newly mined blocks, maintains a transaction pool,
|
|
and relays individual transactions that have not yet made it into a block. It
|
|
ensures all individual transactions admitted to the pool follow the rules
|
|
required into the block chain and also includes the vast majority of the more
|
|
strict checks which filter transactions based on miner requirements ("standard"
|
|
transactions).
|
|
|
|
One key difference between btcd and bitcoind is that btcd does *NOT* include
|
|
wallet functionality and this was a very intentional design decision. See the
|
|
blog entry [here](https://blog.conformal.com/btcd-not-your-moms-bitcoin-daemon)
|
|
for more details. This means you can't actually make or receive payments
|
|
directly with btcd. That functionality is provided by the
|
|
[btcwallet](https://github.com/conformal/btcwallet) and
|
|
[btcgui](https://github.com/conformal/btcgui) projects which are both under
|
|
active development.
|
|
|
|
## Requirements
|
|
|
|
[Go](http://golang.org) 1.2 or newer.
|
|
|
|
## Installation
|
|
|
|
#### Windows - MSI Available
|
|
|
|
https://github.com/conformal/btcd/releases
|
|
|
|
#### Linux/BSD/POSIX - Build from Source
|
|
|
|
- Install Go according to the installation instructions here:
|
|
http://golang.org/doc/install
|
|
|
|
- Run the following command to obtain btcd, all dependencies, and install it:
|
|
```$ go get github.com/conformal/btcd```
|
|
|
|
- btcd will now be installed in either ```$GOROOT/bin``` or ```$GOPATH/bin```
|
|
depending on your configuration. If you did not already add to your system
|
|
path during the installation, we recommend you do so now.
|
|
|
|
## Updating
|
|
|
|
#### Windows
|
|
|
|
Install a newer MSI
|
|
|
|
#### Linux/BSD/POSIX - Build from Source
|
|
|
|
- Run the following command to update btcd, all dependencies, and install it:
|
|
```$ go get -u -v github.com/conformal/btcd/...```
|
|
|
|
## Getting Started
|
|
|
|
btcd has several configuration options avilable to tweak how it runs, but all
|
|
of the basic operations described in the intro section work with zero
|
|
configuration.
|
|
|
|
#### Windows (Installed from MSI)
|
|
|
|
Launch btcd from your Start menu.
|
|
|
|
#### Linux/BSD/POSIX/Source
|
|
|
|
```bash
|
|
$ ./btcd
|
|
````
|
|
## Mailing lists
|
|
|
|
- btcd: discussion of btcd and its packages.
|
|
- btcd-commits: readonly mail-out of source code changes.
|
|
|
|
To subscribe to a given list, send email to list+subscribe@opensource.conformal.com
|
|
|
|
## Issue Tracker
|
|
|
|
The [integrated github issue tracker](https://github.com/conformal/btcd/issues)
|
|
is used for this project.
|
|
|
|
## Documentation
|
|
|
|
The documentation is a work-in-progress. It uses the [github wiki](https://github.com/conformal/btcd/wiki) facility.
|
|
|
|
## GPG Verification Key
|
|
|
|
All official release tags are signed by Conformal so users can ensure the code
|
|
has not been tampered with and is coming from Conformal. To verify the
|
|
signature perform the following:
|
|
|
|
- Download the public key from the Conformal website at
|
|
https://opensource.conformal.com/GIT-GPG-KEY-conformal.txt
|
|
|
|
- Import the public key into your GPG keyring:
|
|
```bash
|
|
gpg --import GIT-GPG-KEY-conformal.txt
|
|
```
|
|
|
|
- Verify the release tag with the following command where `TAG_NAME` is a
|
|
placeholder for the specific tag:
|
|
```bash
|
|
git tag -v TAG_NAME
|
|
```
|
|
|
|
## License
|
|
|
|
btcd is licensed under the [copyfree](http://copyfree.org) ISC License.
|