lbry-sdk/README.md

57 lines
3.8 KiB
Markdown
Raw Permalink Normal View History

2021-08-22 02:01:49 +02:00
# <img src="https://raw.githubusercontent.com/lbryio/lbry-sdk/master/lbry.png" alt="LBRY" width="48" height="36" /> LBRY SDK [![build](https://github.com/lbryio/lbry-sdk/actions/workflows/main.yml/badge.svg)](https://github.com/lbryio/lbry-sdk/actions/workflows/main.yml) [![coverage](https://coveralls.io/repos/github/lbryio/lbry-sdk/badge.svg)](https://coveralls.io/github/lbryio/lbry-sdk)
2016-05-23 04:45:08 +02:00
2019-01-31 20:24:44 +01:00
LBRY is a decentralized peer-to-peer protocol for publishing and accessing digital content. It utilizes the [LBRY blockchain](https://github.com/lbryio/lbrycrd) as a global namespace and database of digital content. Blockchain entries contain searchable content metadata, identities, rights and access rules. LBRY also provides a data network that consists of peers (seeders) uploading and downloading data from other peers, possibly in exchange for payments, as well as a distributed hash table used by peers to discover other peers.
2019-10-07 15:17:20 +02:00
LBRY SDK for Python is currently the most fully featured implementation of the LBRY Network protocols and includes many useful components and tools for building decentralized applications. Primary features and components include:
2021-06-02 20:10:19 +02:00
* Built on Python 3.7 and `asyncio`.
2020-01-01 22:02:16 +01:00
* Kademlia DHT (Distributed Hash Table) implementation for finding peers to download from and announcing to peers what we have to host ([lbry.dht](https://github.com/lbryio/lbry-sdk/tree/master/lbry/dht)).
* Blob exchange protocol for transferring encrypted blobs of content and negotiating payments ([lbry.blob_exchange](https://github.com/lbryio/lbry-sdk/tree/master/lbry/blob_exchange)).
* Protobuf schema for encoding and decoding metadata stored on the blockchain ([lbry.schema](https://github.com/lbryio/lbry-sdk/tree/master/lbry/schema)).
* Wallet implementation for the LBRY blockchain ([lbry.wallet](https://github.com/lbryio/lbry-sdk/tree/master/lbry/wallet)).
* Daemon with a JSON-RPC API to ease building end user applications in any language and for automating various tasks ([lbry.extras.daemon](https://github.com/lbryio/lbry-sdk/tree/master/lbry/extras/daemon)).
2017-02-20 22:12:47 +01:00
## Installation
2015-08-20 17:27:15 +02:00
2019-06-21 05:13:57 +02:00
Our [releases page](https://github.com/lbryio/lbry-sdk/releases) contains pre-built binaries of the latest release, pre-releases, and past releases for macOS, Debian-based Linux, and Windows. [Automated travis builds](http://build.lbry.io/daemon/) are also available for testing.
2017-02-20 22:12:47 +01:00
## Usage
2016-05-23 22:13:46 +02:00
2018-10-02 00:44:32 +02:00
Run `lbrynet start` to launch the API server.
2017-03-13 17:05:13 +01:00
By default, `lbrynet` will provide a JSON-RPC server at `http://localhost:5279`. It is easy to interact with via cURL or sane programming languages.
2017-03-13 17:05:13 +01:00
Our [quickstart guide](https://lbry.tech/playground) provides a simple walkthrough and examples for learning.
With the daemon running, `lbrynet commands` will show you a list of commands.
2017-03-13 17:05:13 +01:00
2018-10-02 00:44:32 +02:00
The full API is documented [here](https://lbry.tech/api/sdk).
2016-05-23 22:13:46 +02:00
## Running from source
2018-10-29 22:01:41 +01:00
Installing from source is also relatively painless. Full instructions are in [INSTALL.md](INSTALL.md)
2017-03-13 17:14:02 +01:00
## Contributing
2017-03-13 17:14:02 +01:00
2019-04-01 19:00:31 +02:00
Contributions to this project are welcome, encouraged, and compensated. For more details, please check [this](https://lbry.tech/contribute) link.
2017-02-20 22:12:47 +01:00
## License
2015-08-20 17:27:15 +02:00
This project is MIT licensed. For the full license, see [LICENSE](LICENSE).
2015-08-20 17:27:15 +02:00
## Security
2015-08-20 17:27:15 +02:00
2021-05-04 00:04:29 +02:00
We take security seriously. Please contact security@lbry.com regarding any security issues. [Our PGP key is here](https://lbry.com/faq/pgp-key) if you need it.
2016-05-23 22:13:46 +02:00
## Contact
2015-08-20 17:27:15 +02:00
2019-04-01 19:00:31 +02:00
The primary contact for this project is [@eukreign](mailto:lex@lbry.com).
## Additional information and links
2015-08-20 17:27:15 +02:00
The documentation for the API can be found [here](https://lbry.tech/api/sdk).
Daemon defaults, ports, and other settings are documented [here](https://lbry.tech/resources/daemon-settings).
2020-01-01 22:02:16 +01:00
Settings can be configured using a daemon-settings.yml file. An example can be found [here](https://github.com/lbryio/lbry-sdk/blob/master/example_daemon_settings.yml).