lbry-sdk/README.md

44 lines
2.4 KiB
Markdown
Raw Normal View History

# <img src="https://raw.githubusercontent.com/lbryio/lbry/master/lbry.png" alt="LBRY" width="48" height="36" /> LBRY [![Build Status](https://travis-ci.org/lbryio/lbry.svg?branch=master)](https://travis-ci.org/lbryio/lbry) [![Test Coverage](https://codecov.io/gh/lbryio/lbry/branch/master/graph/badge.svg)](https://codecov.io/gh/lbryio/lbry)
2016-05-23 04:45:08 +02:00
LBRY is an open-source protocol providing distribution, discovery, and purchase of digital content (data) via a decentralized network. 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, and rights and access rules. LBRY also provides a data network that consists of peers uploading and downloading data from other peers, possibly in exchange for payments, and a distributed hash table, used by peers to discover other peers.
2018-10-02 00:44:32 +02:00
This project provides an SDK for building applications using the LBRY protocol. The SDK is written in Python 3.7+ using Twisted. For other languages or platforms, a JSONRPC API is provided.
2017-02-20 22:12:47 +01:00
## Installation
2015-08-20 17:27:15 +02:00
Our [releases page](https://github.com/lbryio/lbry/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
2017-07-05 22:28:41 +02:00
Our [quickstart guide](http://lbry.io/quickstart) provides a simple walkthrough and examples for learning.
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
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
Contributions to this project are welcome, encouraged, and compensated. For more details, please check [this](https://lbry.io/faq/contributing) 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
We take security seriously. Please contact security@lbry.io regarding any security issues. Our PGP key is here if you need it.
2016-05-23 22:13:46 +02:00
## Contact
2015-08-20 17:27:15 +02:00
The primary contact for this project is [@jackrobison](mailto:jack@lbry.io)
## Additional information and links
2015-08-20 17:27:15 +02:00
2018-10-02 00:44:32 +02:00
The documentation for the api can be found [here](https://lbry.tech/api/sdk).