LBRYFoundation/lbry.com
1
0
Fork 0
mirror of https://github.com/LBRYFoundation/lbry.com.git synced 2025-08-23 17:47:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Delete 169-what-is-chain-query.md

Browse source
This commit is contained in:
Brinck Slattery 2018-05-24 13:16:21 -04:00 • committed by GitHub
parent 42be9e1213
commit ebbc34dc87
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 0 additions and 59 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
content/news/169-what-is-chain-query.md
View file

@ -1,59 +0,0 @@
---
author: mark-beamer
title: 'What is Chainquery'
date: '2018-05-24 14:00:00'
cover: 'database2.jpg'
---
### Chainquery is a tool that makes data in the LBRY blockchain significantly more presentable and more usable.
By default, data from the LBRY blockchain is basically a raw dump of data in a compressed format:
![Raw Data](https://spee.ch/@lbry/lbrycliexample.png)
<div class="meta">
In addition to extracting this data, you’d have to run this command several hundred thousand times to get the same data returned by a single command below.
</div>
Since it is raw and compressed, it is difficult to express the richer formats contained within the data. As such, most blockchains have specifically designed methods of extracting the raw data.
In the case of LBRY, Chainquery is both the easiest and most feature-rich method of doing that to date.
# What does Chainquery do?
Chainquery takes all the raw data in the blockchain, decompresses and extracts it, and stores it in a relational database, all in real-time. This allows the rich features of SQL to be applied to live blockchain data.
This is all rather abstract, so let’s look at an example. Suppose we wanted to determine the 10 LBRY URLs with the largest number of staked credits. Without Chainquery, this would require making direct calls to the LBRY blockchain API, iterating over each claim, and storing the 10 largest. In addition to being non-trivial to write, it would also be quite slow.
With Chainquery, it’s about a hundred characters of performant SQL:
![Top Channels](https://spee.ch/@lbry/topchannels.png)
Virtually any application that is interested in displaying or operating off of data stored in the LBRY blockchain can benefit from Chainquery.
You can see the full schema for Chainquery [here](https://github.com/lbryio/chainquery/blob/master/db/chainquery_schema.sql).
# Why is Chainquery exciting?
Chainquery is exciting, anyone in the world interested in building on top of LBRY, as well as internal LBRY team members, can do so much, much more efficiently.
LBRY team members will be able to save significant time when working on any features that depend at any point on blockchain data. No longer do we have to develop complex data handling or transformations for a new feature that works around the specific formats coming out of the blockchain. We can now “Chainquery it”. Indeed, Chainquery will see internal use in at least four projects: search, explorer, rewards, and spee.ch!
For our community and users, they will now be able to see these elegant features faster. They will also no longer be encumbered by the raw and compressed format of the blockchain. So if I am a user and I want to build something on top of LBRY, I can now run my own instance of Chainquery and get the blockchain information in the format I want with a simple SQL query.
# How do I use Chainquery?
Most LBRY users do not need to use Chainquery directly and instead will simply benefit from the increased engineering capabilities and performance it allows us internally.
However, if you’re interested in using it directly or poking around with the data, all of our code is open-source and available on GitHub. Detailed setup instructions are inside of the repository.
Additionally, at least for now, we’ve provided a public, readonly MySQL server you can connect to. This is a generic sql api that is accessible from an http GET and returns JSON data. Test it in your browser!
Get the latest block information:
[https://chainquery.lbry.io/api/sql?query=SELECT * FROM block ORDER BY height DESC LIMIT 1](https://chainquery.lbry.io/api/sql?query=SELECT%20*%20FROM%20block%20ORDER%20BY%20height%20DESC%20LIMIT%201)
Get all claims and their details for the name “lbry”:
[https://chainquery.lbry.io/api/sql?query=SELECT * FROM claim WHERE name = “lbry”](https://chainquery.lbry.io/api/sql?query=SELECT%20*%20FROM%20claim%20WHERE%20name%20=%20%27lbry%27)