The requested page could not be found. Here is the image located at lbry://404 to console you.
- -Think something should be here? Let us know by raising an issue.
-diff --git a/app/client.js b/app/client.js index 1bd34f5..566f813 100755 --- a/app/client.js +++ b/app/client.js @@ -37,6 +37,7 @@ function main() { app.use(ssr()); app.route("/", page(require("./views/home"))); + app.route("/api", page(require("./views/api"))); app.route("/api/*", page(require("./views/api"))); app.route("/*", page(require("./views/redirect"))); diff --git a/app/components/api/header-blockchain.js b/app/components/api/header-blockchain.js deleted file mode 100644 index 301b016..0000000 --- a/app/components/api/header-blockchain.js +++ /dev/null @@ -1,15 +0,0 @@ -"use strict"; - -import html from "choo/html"; - -export default () => { - return html` -
- Methods and signatures provided by the lbrycrd blockchain daemon are documented below. - To build, download, or run lbrycrd, see the project README. -
-- Methods and signatures provided by the lbry-sdk daemon are documented below. - To build, download, or run the daemon, see the project README. -
-The requested page could not be found. Here is the image located at lbry://404 to console you.
- -Think something should be here? Let us know by raising an issue.
-What if anyone in the world could publish a piece of digital content, anyone else in the world could access it, for free or for payment, and that entire system worked end-to-end without any centralized authority or point of control?
- Observe the Overview + +That's the idea behind LBRY. To create a market for accessing and publishing information that is global, decentralized, robust, optimal and complete.
+ + Learn more about our missionLooking for API documentation, formal specifications, how-tos, resources, or the meaning of life? Find at least some of these things in the resources area.
- Roam to Resources +LBRY has enough moving parts to warrant comprehensive documentation. Whether you are interested in learning the technical details of our technology stack or you want to integrate LBRY into your life, you will find everything you need in our docs.
+ + Explore our documentationNo matter your experience or skill level, you can progress content freedom.
+Interested in progressing content freedom? Awesome! No matter your experience or skill level, you can make a difference.
- +Like a bit of documentation but would prefer to jump in and make your mark on the blockchain? Perhaps add cats to it?
+ + Learn the LBRY APIThere's literally 12n of us.
+Hang out with us! We have a vibrant community of lbryians and would be delighted if you joined us.
The page you are looking for does not exist.
+And don't forget to sign up for developer-only mailing list, below.
diff --git a/documents/contribute.md b/documents/contribute.md index f70ddcf..79a9490 100644 --- a/documents/contribute.md +++ b/documents/contribute.md @@ -1,42 +1,43 @@ --- -title: Contributor's Guide +title: Contributing --- -## Welcome to LBRY! + +## Contributing to LBRY Interested in working on the LBRY protocol, an official LBRY app, or other LBRY infrastructure? Awesome! This guide will get you started. -This is a guide for contributing to the code bases maintained by the LBRY organization by [Coding](#coding), [Designing](#designing), [Writing](#writing), and [Testing](#testing). +This guide is for contributing to the code bases maintained by the LBRY organization. For building on top of the LBRY protocol, see [Build](/build). -Contributors that provide accepted pull requests, well-specified issues, or assist in testing and quality assurance typically receive LBC tokens as [appreciation](#appreciation). +Contributors that provide accepted pull requests, well-specified issues, or assist in testing and quality assurance typically receive LBC tokens as appreciation. ## Ecosystem Overview Typical usage of LBRY does not involve a single piece of software, but several interacting components. -If you want to contribute to LBRY, there's definitely something for you! The first step is to figure out what project to work on. +If you want to contribute to LBRY, the first step is to understand where. ### Core Protocol Components | Component | Language (Toolset) | What Is It --- | --- | --- -| [lbrycrd](https://github.com/lbryio/lbrycrd) | C++ | A full node for the LBRY blockchain, including a standalone wallet. Used by miners and some applications. Most consumer applications do not bundle [[lbrycrd]] directly, and instead bundle [[lbry-sdk]]. -| [lbry-sdk](https://github.com/lbryio/lbry) | Python (Twisted) | A daemon that can be used directly or to develop other applications. Provides convenience [APIs](/api/sdk), bundles an SPV wallet ([[torba]]), and contains an implementation of the LBRY data network. | -| [torba](https://github.com/lbryio/torba) | Python | An [[SPV]] (Simple Payment Verification) wallet. Bundled with [[lbry-sdk]]. | -| [lbryumx](https://github.com/lbryio/lbryumx) | Protobuf, Python | The wallet server used by [[torba]]. -| [lbry-schema](https://github.com/lbryio/lbryschema) | Protobuf, Python | Defines the structure of the metadata stored in the LBRY blockchain. +| [lbrycrd](https://github.com/lbryio/lbrycrd) | C++ | A full node for the LBRY blockchain, including a standalone wallet. Used by miners and some applications. Most consumer applications do not bundle `lbrycrd` directly. +| [lbry](https://github.com/lbryio/lbry) | Python (Twisted) | A daemon that implements the LBRY protocol. Bundled with and/or used by most LBRY applications. +| [torba](https://github.com/lbryio/torba) | Python | The Simple Payment Verification (SPV) wallet bundled with `lbry`. +| [lbryumx](https://github.com/lbryio/lbryumx) | Protobuf, Python | The wallet server for the `lbryum` SPV wallet. +| [lbry-schema](https://github.com/lbryio/lbryschema) | Protobuf, Python | The structure of the metadata stored in the LBRY blockchain. ### Official Applications | Application | Language (Toolset) | What Is It --- | --- | --- -| [lbry-desktop](https://github.com/lbryio/lbry-desktop) | JavaScript (ReactJS, Electron) | A graphical browser for the LBRY network for Windows, macOS, and Linux. [[lbry-desktop]] is built with [[lbry-sdk]]. | -| [lbry-android](https://github.com/lbryio/lbry-desktop) | JavaScript (ReactNative), Python (kivy) | A graphical browser for the LBRY network for Android. [[lbry-android]] is built with [[lbry-sdk]]. -| [lbry-redux](https://github.com/lbryio/lbry-redux) | JavaScript (Redux) | A common codebase for shared Redux logic between [[lbry-desktop]] and [[lbry-android]]. +| [lbry-desktop](https://github.com/lbryio/lbry-desktop) | JavaScript (ReactJS, Electron) | A graphical browser for the LBRY protocol for Windows, macOS, and Linux. `lbry-desktop` bundles `lbry` and is primarily frontend code. +| [lbry-android](https://github.com/lbryio/lbry-desktop) | JavaScript (ReactNative), Python (kivy) | A graphical browser for the LBRY protocol for Android. `lbry-android` bundles `lbry` and is primarily frontend code. +| [lbry-redux](https://github.com/lbryio/lbry-redux) | JavaScript (Redux) | A common codebase for shared Redux logic between `lbry-desktop` and `lbry-android`. | [spee.ch](https://github.com/lbryio/spee.ch) | JavaScript (Node, ReactJS, Express) | A web-based host for free LBRY content. Usable directly as a content link dump site or as a customized, standalone install. ### Websites | Domain | Language (Toolset) | What Is It --- | --- | --- -| [lbry.tech](https://github.com/lbryio/lbry.tech) | JavaScript (Node, Choo) | You're on it. +| [lbry.tech](https://github.com/lbryio/lbry.tech) | JavaScript (Vue, Vuepress) | You're on it. | [lbry.io](https://github.com/lbryio/lbry.io) | PHP (vanilla) | A website for LBRY end-users and creators. | [lbry.fund](https://github.com/lbryio/lbry.fund) | HTML | A website for receiving funding from LBRY, Inc. @@ -47,18 +48,20 @@ If you want to contribute to LBRY, there's definitely something for you! The fir | [lighthouse](https://github.com/lbryio/lighthouse) | JavaScript, ElasticSearch | A search service for the LBRY blockchain. | [wunderbot](https://github.com/lbryio/lbry-wunderbot) | JavaScript (Node) | A chatbot used by the LBRY discord. | [block-explorer](https://github.com/lbryio/block-explorer) | PHP (vanilla) | A blockchain explorer for the LBRY blockchain. +| Add more? other tipbots... | ## Coding -Several hundred extremely good-looking, wise and moral people, as well as our CTO, have contributed to LBRY. Join us! +Several hundred extremely good-looking, intelligent and popular people, as well as our CTO, have contributed to LBRY. Join us! + +Additionally, every technical employee of LBRY outside of the founding team started as a public contributor. ### How To Contribute Code -1. **Join the Community**. By joining our [chat](https://chat.lbry.io) or our [forum](https://discourse.lbry.io), you can interact with other developers when you have questions, ideas, or problems. -1. **Identify the component you want to work on**. LBRY has code bases that deal with everything from cryptography and distributed systems to end-user graphic user-interfaces. We use Python, JavaScript, C++, Go, and more. See [Ecosystem Overview](#ecosystem-overview) to find the right project. -1. **Get set up.** Each repo has a [[README]] with clear instructions on how to get the repo up and running properly. Thanks, [Repository Standards](/repository-standards)! -1. **Find something to work on**. All actively developed repositories should have issues tagged "Good First Issues" specifically for new contributors. You are also welcome to work on something not currently filed if you have your own idea. Additionally, all repositories have contact information for the maintainer if you have trouble finding an issue to work on. -1. **Abide coding and commit standards**. Any specific information necessary to know in this regard should be in the project [[README]]. +1. **Identify the component you want to work on**. LBRY has code bases in Python, JavaScript, PHP, and C++. See [Ecosystem Overview](#ecosystem-overview). +1. **Get set up.** Each repo has a `README.md` with clear instructions on how to get the repo up and running properly. Thanks, [Repository Standards](/repository-standards)! +1. **Find something to work on**. All actively developed repositories should have issues tagged "Good First Issues" specifically for new contributors. Some projects use a "level: n" tagging system, where lower numbers are simpler and higher numbers are more complex. Of course, you are also welcome to work on something not currently filed if you have your own idea! Additionally, all repositories have contact information for the maintainer if you have trouble finding an issue to work on. +1. **Abide coding and commit standards**. Any specific information necessary to know in this regard should be in the `README`. 1. **Commit early and ask questions**. Is an issue confusing? Please comment and say so! Not sure if you've got the right approach? Commit your code and we'll give feedback. Certain you're doing everything right? Commit it anyway. Once you commit, open a pull request. We encourage work-in-progress commits to let us know you're working on something and to facilitate feedback. 1. **Accept feedback and finish**. Most pull requests are reviewed within two business days. Once the repository maintainer has approved your contribution, it will get merged and we'll try really hard to give you LBC even if you say no. @@ -66,48 +69,44 @@ Several hundred extremely good-looking, wise and moral people, as well as our CT Web and application designers are requested to be able to work directly on CSS in the project they'd be contributing to. Please follow the [Coding](#coding) instructions for any website or application you want to improve. -We're happy to provide assistance if you're used to working in HTMl and CSS but are having trouble getting started. Check out [our chat](https://chat.lbry.io) or [our forum](https://discourse.lbry.io). - ## Writing -Most written content, and especially all technical writing, is checked into source control. To improve content we've written or add new content: +Most written content at LBRY is checked into source control. To improve content we've written: 1. Identify which website or application it is in (see the [overview])(#ecosystem-overview). -1. Search for a quoted phrase of the content you want to change (or use the same technique to identify the folder to create a new document in). +1. Search for a quoted phrase of the content you want to change. 1. Edit the content via the GitHub interface and submit it as a pull request. ## Testing If you want to contribute without getting directly into the code, one of the best ways you can contribute is testing. -A number of our code bases ([[lbrycrd]], [[lbry-sdk]], all applications, more...) go through regular release cycles where new versions are shipped every several weeks. Testing pre-release versions is a great way to help us identify issues and ship bug-free code. +A number of our code bases (`lbrycrd`, `lbry`, all applications, more...) go through regular release cycles where new versions are shipped every several weeks. Testing pre-release versions is a great way to help us identify issues and ship bug-free code. -### Ways to Test +For any projects that you want to be a tester on, "Watch" the repo on GitHub. You will receive an email with release notes whenever a release candidate is out. -- "Watch" the repo on GitHub. You will receive an email with release notes whenever a release candidate is out and you can [raise an issue](#raising-issues). -- Join the #early-testing channel in our [chat](https://chat.lbry.io). -- For the hardcore, run master from source and/or the latest builds from [build.lbry.io](http://build.lbry.io). +For even harder-core testing, you can follow the `README` instructions in a project and test against the `master` branch of a project at any time. Additionally, `master` builds for some projects are always available via [build.lbry.io](http://build.lbry.io). Opening well-specified issues against release candidates or master builds is extremely useful in helping us create quality software. -**Note: Please do not use wallets with substantial sums when testing. If using release candidates and especially master builds, back up your wallet and be cautious. While a substantial bug, like one that caused loss of funds, would merit significant [Appreciation](#appreciation), you perform testing at your own risk.** +**Note: that you perform testing at your own risk! If using release candidates and especially master builds, back up your wallet and be cautious.** ## Raising Issues -All [bug reports](#reporting-a-bug) and [feature requests](#feature-requests) are managed through GitHub. - If you're about to raise an issue because you've found a problem with LBRY, or you'd like to request a new feature, or for any other reason, please read this first. +GitHub is the preferred channel for [bug reports](#reporting-a-bug) and [feature requests](#feature-requests). + ### Reporting a Bug A bug is a _demonstrable problem_ that is caused by the code in the repository. Good bug reports are extremely helpful - thank you! Guidelines for bug reports: 1. **Identify the correct repo**. See [ecosystem overview](#ecosystem-overview). While it's okay if you get this wrong, it's a big help to us if you get it right. -2. **Check if the issue exists**. Please do a quick search to see if the issue has been reported (or fixed), including closed tickets. -3. **Follow the instructions** - When you open an issue inside of GitHub, each repo contains a template for how to create a good bug report. Santa _loves_ people who follow it. +2. **Use the GitHub issue search** — check if the issue has already been reported (or fixed). Be sure to include closed tickets in your search. +3. **Follow the instructions** — When you open an issue inside of GitHub, each repo contains a template for how to create a good bug report. Please follow it! -Well-specified bug reports save developers lots of time and are [appreciated](#appreciation). +Well-specified bug reports save developers lots of time and are extremely appreciated, typically with an LBRY credit tip. ### Feature Requests @@ -118,14 +117,8 @@ Feature requests are welcome. Before you submit one be sure to: 3. **Consider whether it's feasible** for us to tackle this feature in the next 6-12 months. The LBRY team is currently stretched thin just adding basic functionality. If this is a nice to have rather than a need, it is probably more clutter than helpful. 4. **Make a strong case** to convince the project's leaders of the merits of this feature. Please provide as much detail and context as possible. This means explaining the use case and why it is likely to be common. -### Discussion and Help +## Tips -Sometimes, you may have a problem but an issue isn't appropriate (or you're not sure if it's a real issue). - -Join our [chat](https://chat.lbry.io), our [forum](https://discourse.lbry.io), or another [community](https://lbry.tech/community) and talk to others about it. - -## Appreciation - -We offer LBC as a gesture of our appreciation to anyone who contributes to LBRY. While we're generous in what we send, it is more about recognizing and appreciating what you've given to the community than providing compensation. +We offer LBC as a thank you to anyone who contributes to LBRY. While we think we're fair-to-generous in our tips, tipping is more about recognizing and appreciating what you've given to the community than providing compensation. The amount of LBC is not typically specified in advance of a contribution, though if you're particularly motivated by this aspect you are welcome to ask. diff --git a/documents/glossary.md b/documents/glossary.md index e90a0a8..6ca0dc9 100644 --- a/documents/glossary.md +++ b/documents/glossary.md @@ -136,15 +136,9 @@ The content price, set by the publisher, in order to download a claim. The key f The currency code for 1 LBRY Credit (defined as 100 000 000 *deweys*). -### lbrycrd +### LBRYCrd -lbrycrd is the authoritative implementation of the LBRY [[blockchain]] protocol. See [the source code](https://github.com/lbryio/lbrycrd), [the API](/api/blockchain), or [the whitepaper](/whitepaper). - -### lbry-sdk - -An [[SDK]] for the LBRY protocol that can also be used independently. Distributed as a daemon or bundled directly, it contains a set of convenience methods for developing applications, and bundles an [[SPV]] wallet as well as implementation of the data network. - -See [the source code](https://github/lbryio/lbry) or [the API documentation](/api/sdk). +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 Core. ### LBRY Credits @@ -258,10 +252,6 @@ Note that owning a very large amount of computational power does not override ot A 2D point on an elliptic curve [secp256k1](https://en.bitcoin.it/wiki/Secp256k1) that is produced by multiplying a predefined "generator" point by a *private key*. Usually it is represented by a pair of 256-bit numbers ("uncompressed public key"), but can also be compressed to just one 256-bit number (at the slight expense of CPU time to decode an uncompressed number). A special hash of a public key is called *address*. Typical LBRY transactions contain public keys or addresses in the output scripts and *signatures* in the input scripts. -### README - -A README is a file included in all code repositories that includes basic information about that project. More in (/resources/repository-standards). - ### Reflector A reflector cluster to accept LBRY content for hosting en masse, re-host the content, and make money on data fees (currently disabled). This code includes Go implementations of the LBRY peer protocol, reflector protocol, and DHT. @@ -282,10 +272,6 @@ Amount of newly generated LBRY credits that a *miner* may claim in a new block. A compact turing-incomplete programming language used in transaction *inputs* and *outputs*. Scripts are interpreted by a Forth-like stack machine: each operation manipulates data on the stack. Most scripts follow the standard pattern and verify the digital *signature* provided in the transaction *input* against a *public key* provided in the previous transaction's *output*. Both signatures and public keys are provided using scripts. Scripts may contain complex conditions, but can never change amounts being transferred. Amount is stored in a separate field in a *transaction output*. -### SDK - -An abbreviation for Software Development Kit. [[lbry-sdk]] is an SDK for developing applications that use the LBRY protocol. - ### Secret key Either the *Private Key* or an encryption key used in encrypted *wallets*. LBRY protocol does not use encryption anywhere, so *secret key* typically means a *private key* used for signing transactions. @@ -294,9 +280,9 @@ Either the *Private Key* or an encryption key used in encrypted *wallets*. LBRY A sequence of bytes that proves that a piece of data is acknowledged by a person holding a certain *public key*. LBRY, like Bitcoin, uses *ECDSA* for signing transactions. Amounts of credits are sent through a chain of transactions: from one to another. Every transaction must provide a signature matching a public key defined in the previous transaction. This way only a proper owner of a secret *private key* associated with a given public key can spend credits further. -### Simplified Payment Verification +### Simplified Payment Verification (SPV) -A scheme to validate transactions without storing the whole blockchain (only block headers) and without trusting any external service. Every transaction must be present with all its parent and sibling hashes in a *merkle tree* up to the root. SPV client trusts the most *difficult* chain of block headers and can validate if the transaction indeed belongs to a certain block header. Since SPV does not validate all transactions, a *51% attack* may not only cause a *double spend* (like with *full nodes*), but also make a completely invalid payment with credits created from nowhere. However, this kind of attack is very costly and probably more expensive than a product in question. Frequently abbreviated as SPV. +A scheme to validate transactions without storing the whole blockchain (only block headers) and without trusting any external service. Every transaction must be present with all its parent and sibling hashes in a *merkle tree* up to the root. SPV client trusts the most *difficult* chain of block headers and can validate if the transaction indeed belongs to a certain block header. Since SPV does not validate all transactions, a *51% attack* may not only cause a *double spend* (like with *full nodes*), but also make a completely invalid payment with credits created from nowhere. However, this kind of attack is very costly and probably more expensive than a product in question. ### Soft Fork @@ -310,10 +296,6 @@ Incorrect peer-to-peer messages (like sending invalid transactions) may be consi A transaction *output* can be spent only once: when another valid transaction makes a reference to this output from its own input. When another transaction attempts to spend the same output, it will be rejected by the nodes already seeing the first transaction. Blockchain as a *proof-of-work* scheme allows every node to agree on which transaction was indeed the first one. The whole transaction is considered spent when all its outputs are spent. -### SPV - -SPV is an abbreviation for [[Simplified Payment Verification]]. - ### Stream Streaming media is multimedia that is constantly received by and presented to an end-user while being delivered by a provider. In LBRY, streams as associated with claim data in order to provide the capability to download files over a Peer to Peer network. @@ -338,10 +320,6 @@ A 256-bit number that puts an upper limit for a block header hash to be valid. T A set of parameters used for testing a LBRY network. Testnet is like *mainnet*, but has a different genesis block (it was reset several times, the latest testnet is *testnet3*). Testnet uses slightly different *address* format to avoid confusion with main LBRY addresses and all nodes are relaying and mining non-standard transactions. -### Torba - -An [[SPV]] wallet for the LBRY [[blockchain]]. See the [source code](https://github.com/lbryio/torba). - ### Transaction A chunk of binary data that describes how credits are moved from one owner to another. Transactions are stored in the *[blockchain](#blockchain)*. Every transaction (except for *coinbase* transactions) has a reference to one or more previous transactions (*inputs*) and one or more rules on how to spend these credits further (*outputs*). See *Transaction Input* and *Transaction Output* for more info. diff --git a/documents/resources.md b/documents/resources.md index 8b46dca..ef08db8 100644 --- a/documents/resources.md +++ b/documents/resources.md @@ -2,18 +2,22 @@ title: Resources --- -