2021-08-27 21:46:13 +02:00
|
|
|
lbcd
|
2013-09-09 18:00:46 +02:00
|
|
|
====
|
|
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
[](https://github.com/lbryio/lbcd/actions)
|
|
|
|
|
[](https://coveralls.io/github/lbryio/lbcd?branch=master)
|
2020-05-13 14:44:07 +02:00
|
|
|
[](http://copyfree.org)
|
2021-08-27 21:46:13 +02:00
|
|
|
<!--[](https://pkg.go.dev/github.com/btcsuite/btcd)-->
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
lbcd is a full node implementation of LBRY's blockchain written in Go (golang).
|
2014-02-13 18:39:17 +01:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
This project is currently under active development and is in a Beta state while we
|
|
|
|
|
ensure it matches LBRYcrd's functionality. The intention is that it properly downloads, validates, and serves the block chain using the exact
|
|
|
|
|
rules (including consensus bugs) for block acceptance as LBRYcrd. We have
|
|
|
|
|
taken great care to avoid lbcd causing a fork to the blockchain.
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
Note: lbcd does *NOT* include
|
|
|
|
|
wallet functionality. That functionality is provided by the
|
|
|
|
|
[lbcwallet](https://github.com/lbryio/lbcwallet) and the [LBRY SDK](https://github.com/lbryio/lbry-sdk).
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
## Security
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
We take security seriously. Please contact [security](mailto:security@lbry.com) regarding any security issues.
|
|
|
|
|
Our PGP key is [here](https://lbry.com/faq/pgp-key) if you need it.
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
We maintain a mailing list for notifications of upgrades, security issues,
|
|
|
|
|
and soft/hard forks. To join, visit https://lbry.com/forklist
|
2015-05-29 22:25:52 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
## Requirements
|
2015-05-29 22:25:52 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
All common operating systems are supported. lbcd requires at least 8GB of RAM
|
|
|
|
|
and at least 100GB of disk storage. Both RAM and disk requirements increase slowly over time.
|
|
|
|
|
Using a fast NVMe disk is recommended.
|
2015-05-29 22:25:52 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
lbcd is not immune to data loss. It expects a clean shutdown
|
|
|
|
|
via SIGINT or SIGTERM. SIGKILL, immediate VM kills, and sudden power loss
|
|
|
|
|
can cause data corruption, thus requiring chain resynchronization for recovery.
|
2015-02-08 19:00:36 +01:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
For compilation, [Go](http://golang.org) 1.16 or newer is required.
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
## Installation
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
Acquire binary files from https://github.com/lbryio/lbcd/releases
|
2013-10-08 20:30:36 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
#### To build from Source on Linux/BSD/MacOSX/POSIX:
|
2013-10-08 20:30:36 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
- Install Go according to its [installation instructions](http://golang.org/doc/install).
|
|
|
|
|
- Use your favorite git tool to acquire the lbcd source.
|
|
|
|
|
- lbcd has no non-Go dependencies; it can be built by simply running `go build .`
|
|
|
|
|
- lbcctl can be built similarly:
|
2015-02-08 19:00:36 +01:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
Both [GoLand](https://www.jetbrains.com/go/)
|
|
|
|
|
and [VS Code](https://code.visualstudio.com/docs/languages/go) IDEs are supported.
|
2013-10-08 20:30:36 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
## Usage
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
By default, data and logs are stored in `~/.lbcd/`
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
To enable RPC access a username and password is required. Example:
|
2016-09-13 21:10:19 +02:00
|
|
|
```
|
2021-08-27 21:46:13 +02:00
|
|
|
./lbcd --notls --rpcuser=x --rpcpass=y --txindex &
|
|
|
|
|
./lbcctl --notls --rpcuser=x --rpcpass=y getblocktemplate
|
|
|
|
|
```
|
|
|
|
|
<!-- TODO: explain how to use TLS certificates. -->
|
2014-03-04 18:58:59 +01:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
## Contributing
|
2014-02-04 18:06:39 +01:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
Contributions to this project are welcome, encouraged, and compensated.
|
|
|
|
|
The [integrated github issue tracker](https://github.com/lbryio/lbcd/issues)
|
|
|
|
|
is used for this project. All pull requests will be considered.
|
2013-10-05 05:59:05 +02:00
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
<!-- ## Release Verification
|
2019-10-11 01:17:57 +02:00
|
|
|
Please see our [documentation on the current build/verification
|
|
|
|
|
process](https://github.com/btcsuite/btcd/tree/master/release) for all our
|
|
|
|
|
releases for information on how to verify the integrity of published releases
|
|
|
|
|
using our reproducible build system.
|
2021-08-27 21:46:13 +02:00
|
|
|
-->
|
2013-10-05 05:59:05 +02:00
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
2021-08-27 21:46:13 +02:00
|
|
|
lbcd is licensed under the [copyfree](http://copyfree.org) ISC License.
|
