As a backend project, lbryio/lbrycrd has picked up 2.5k stars on GitHub (C++). The blockchain that provides the digital content namespace for the LBRY protocol
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
LBRYcrd uses a blockchain similar to bitcoin's to implement an index and payment system for content on the LBRY network. It is a fork of bitcoin core. In addition to the libraries used by bitcoin, LBRYcrd also uses icu4c.
Please read the lbry.tech overview for a general understanding of the LBRY pieces. From there you could read the LBRY spec for specifics on the data in the blockchain.
Table of Contents
Installation
Usage
Examples
Data directory
Running from Source
Ubuntu with pulled static dependencies
Ubuntu with local shared dependencies
MacOS (cross-compiled)
MacOS with local shared dependencies
Windows (cross-compiled)
Use with CLion
Contributing
Testnet
Mailing List
License
Security
Contact
Installation
Latest binaries are available from https://github.com/lbryio/lbrycrd/releases. There is no installation procedure; the CLI binaries will run as-is and will have any uncommon dependencies statically linked into the binary. The QT GUI is not supported. LBRYcrd is distributed as a collection of executable files; traditional installers are not provided.
Usage
The lbrycrdd executable will start a LBRYcrd node and connect you to the LBRYcrd network. Use the lbrycrd-cli executable
to interact with lbrycrdd through the command line. Command-line help for both executables are available through
the "--help" flag (e.g. lbrycrdd --help). Examples:
Examples
Run ./lbrycrdd -server -daemon to start lbrycrdd in the background.
Run ./lbrycrd-cli -getinfo to check for some basic information about your LBRYcrd node.
Run ./lbrycrd-cli help to get a list of all commands that you can run. To get help on specific commands run ./lbrycrd-cli [command_name] help
Test locally:
./lbrycrdd -server -regtest -txindex # run this in its own window
./lbrycrd-cli -regtest generate 120 # mine 20 spendable coins
./lbrycrd-cli -regtest claimname my_name deadbeef 1 # hold a name claim with 1 coin
./lbrycrd-cli -regtest generate 1 # get that claim into the block
./lbrycrd-cli -regtest listnameclaims # show owned claims
./lbrycrd-cli -regtest getclaimsforname my_name # show claims under that name
./lbrycrd-cli -regtest stop # kill lbrycrdd
rm -fr ~/.lbrycrd/regtest/ # destroy regtest data
For further understanding of a "regtest" setup, see the local stack setup instructions here: https://lbry.tech/resources/regtest-setup
The CLI help is also browsable online at https://lbry.tech/api/blockchain
Data directory
Lbrycrdd will use the below default data directories (changeable with -datadir):
The data directory contains various things such as your default wallet (wallet.dat), debug logs (debug.log), and blockchain data. You can optionally create a configuration file lbrycrd.conf in the default data directory which will be used by default when running lbrycrdd.
For a list of configuration parameters, run ./lbrycrdd --help. Below is a sample lbrycrd.conf to enable JSON RPC server on lbrycrdd.
The easiest way to compile is to utilize the Docker image that contains the necessary compilers: lbry/build_lbrycrd. This will allow you to reproduce the build as made on our build servers. In this sample we map a local lbrycrd folder and a local ccache folder inside the image:
git clone https://github.com/lbryio/lbrycrd.git
cd lbrycrd
docker run -v "$(pwd):/lbrycrd" --rm -v "${HOME}/ccache:/ccache" -w /lbrycrd -e CCACHE_DIR=/ccache lbry/build_lbrycrd packaging/build_linux_64bit.sh
If you encounter any errors, please check doc/build-*.md for further instructions. If you're still stuck, create an issue with the output of that command, your system info, and any other information you think might be helpful. The scripts in the packaging folder are simple and will grant extra light on the build process as needed.
Use with CLion
CLion has not traditionally supported Autotools projects, although some progress on that is now in the works. We do include a cmake build file for compiling lbrycrd. See contrib/cmake. Alas, CLion doesn't support external projects in cmake, so that particular approach is also insufficient. CLion does support "compile_commands.json" projects. Fortunately, this can be easily generated for lbrycrd like so:
pip install --user compiledb
./autogen.sh && ./configure --enable-static=no --enable-shared --with-pic --without-gui CXXFLAGS="-O0 -g" CFLAGS="-O0 -g" # or whatever normal lbrycrd config
compiledb make -j10
Then open the newly generated compile_commands.json file as a project in CLion. Debugging is supported if you compiled with -g. To enable that you will need to create a target in CLion by going to File -> Settings -> Build -> Custom Build Targets. Add an empty target with your choice of name. From there you can go to "Edit Configurations", typically found in a drop-down at the top of the editor. Add a Custom Build Application, select your new target, select the compiled file (i.e. test_lbrycrd or lbrycrdd, etc), and then add any necessary command line parameters. Ensure that there is nothing in the "Before launch" section.
Contributing
Contributions to this project are welcome, encouraged, and compensated. For more details, see https://lbry.tech/contribute
We follow the same coding guidelines as documented by Bitcoin Core, see here. To run an automated code formatting check, try:
git diff -U0 master -- '*.h' '*.cpp' | ./contrib/devtools/clang-format-diff.py -p1. This will check any commits not on master for proper code formatting.
We try to avoid altering parts of the code that is inherited from Bitcoin Core unless absolutely necessary. This will make it easier to merge changes from Bitcoin Core. If commits are expected not to be merged upstream (i.e. we broke up a commit from Bitcoin Core in order to use a single feature in it), the commit message must contain the string "NOT FOR UPSTREAM MERGE".
The master branch is regularly built and tested, but is not guaranteed to be
completely stable. Releases are created
regularly to indicate new official, stable release versions.
Testing and code review is the bottleneck for development; we get more pull
requests than we can review and test on short notice. Please be patient and help out by testing
other people's pull requests, and remember this is a security-critical project where any mistake might cost people
lots of money. Developers are strongly encouraged to write unit tests for new code and to
submit new unit tests for old code. Unit tests are compiled by default and can be run with src/test/test_lbrycrd
The Travis CI system makes sure that every pull request is built, and that unit and sanity tests are automatically run. See https://travis-ci.org/lbryio/lbrycrd
Testnet
Testnet is maintained for testing purposes and can be accessed using the command ./lbrycrdd -testnet. If you would like to obtain testnet credits, please contact [email protected] or [email protected] .
It is easy to solo mine on testnet. (It's easy on mainnet too, but much harder to win.) For instructions see SGMiner and Mining Contributions
Mailing List
We maintain a mailing list for notifications of upgrades, security issues, and soft/hard forks. To join, visit https://lbry.com/forklist.
License
This project is MIT licensed. For the full license, see LICENSE.
Security
We take security seriously. Please contact [email protected] regarding any security issues.
Our PGP key is here if you need it.
Contact
The primary contact for this project is @BrannonKing ([email protected])
The most recent commit recorded on lbryio/lbrycrd was 5.0 years ago, based on the GitHub push timestamp. The repository has 172 forks — one of the better signals of community interest.
How does lbryio/lbrycrd compare to other Backend projects?
lbryio/lbrycrd is tracked by TopGit in the Backend category, with 2.5k GitHub stars and written in C++. Browse the Backend topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does lbryio/lbrycrd have?
lbryio/lbrycrd has 2.5k GitHub stars — refresh the page for the live number, or check github.com/lbryio/lbrycrd. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is lbryio/lbrycrd open source?
Yes — lbryio/lbrycrd ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/lbryio/lbrycrd.
What is lbryio/lbrycrd?
lbryio/lbrycrd (lbryio/lbrycrd) is a C++ project on GitHub. From the project's own README: The blockchain that provides the digital content namespace for the LBRY protocol
Where do I read more about lbryio/lbrycrd?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/lbryio/lbrycrd is the definitive source.
Read full README in the tab above.
Is lbrycrd worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of lbrycrd.