Skip to content

Commit

Permalink
Updates and cleanups
Browse files Browse the repository at this point in the history
  • Loading branch information
tjayrush committed May 31, 2022
1 parent 9d082cf commit 1cd838f
Show file tree
Hide file tree
Showing 7 changed files with 82 additions and 26 deletions.
4 changes: 2 additions & 2 deletions content/blog/2018/024-How-Many-ERC20-Tokens-Do-You-Have.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ lead: You may never know
date: '2018-04-20T23:11:49.781Z'
draft: false
categories:
- Ethereum
tags: ['ethereum']
- TrueBlocks
tags: ['trueblocks']
keywords: []
---

Expand Down
2 changes: 1 addition & 1 deletion content/contact/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ draft: true
images: []
---

{{< email user="tjayrush" domain="quickblocks.io" >}}
{{< email user="jrush" domain="quickblocks.io" >}}
File renamed without changes
Binary file added content/data-model/img/the-index.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
62 changes: 42 additions & 20 deletions content/data-model/intro.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Enhanced ethereum data"
description: "Underlying all Ethereum data─and therefore all TrueBlocks data─is a set of inter-related data models."
lead: "Underlying all Ethereum data─and therefore all TrueBlocks data─is a set of inter-related data models."
title: "Blockchain data"
description: "Ethereum consists of multiple different data models. TrueBlocks exposes them all."
lead: "Ethereum consists of multiple different data models. TrueBlocks exposes them all."
date: 2021-07-01T11:40:11-03:00
lastmod:
- :git
Expand All @@ -18,27 +18,49 @@ weight: 1000
toc: true
---

<img src="/data-model/data-model-600.png" alt="TrueBlocks is full of data that interrelates." width="600"/>
<img src="/data-model/img/data-model-600.png" alt="TrueBlocks is full of data that interrelates." width="600"/>

## Blockchain + people = TrueBlocks-enhanced data
## TrueBlocks data

On its own Ethereum blockchain data is just a boring blob of bytes.
What really interests us are the stories behind this data--questions like:
* What addresses were involved?
* Can I see all transactions involved this address?
* When did the transaction happen?
* What smart contracts were involved?
On its own blockchain data is an unintelligable blob of binary bytes. But, we all know there
is an amazing collection of deeply interesting information contained therein. Thousands of
people are trading, voting, expressing thier preferences, making markets for valueless
items every minute.

Through TrueBlock's `--articulate` option, you can unpack the input fields
of transactions and trace through the whole history of contract calls.
What interests us about this data are answers to questions such as:
* What exaclty is going on?
* Where is my money?
* Didn't I have some of those tokens somewhere?
* May I please just get a list of my transactions?

The account-organized data describes things like account collections, account
balances, and transaction histories. This data tells you the _who_, _where_, and
_why_ behind the Blockchain transactions. It is where TrueBlocks really shines.
TrueBlocks allows you to query this type of information and more. Using the
`chifra list` option, one may list every detail of any transaction that happened
against one's own wallet address (or anyone else's for that matter).

## This data applies to all TrueBlocks apps
The `--articulate` option, which is available on many commands, reanimates
or articulates the impossible-to-understand `input` and `event` data fields.
TrueBlocks even articulates trace data which reveals the deep history of
any transaction include multi-layer deep smart contract calls.

Because all TrueBlocks apps use the same backend, these references describe
the data found with the command line, the Explorer app, and the API. However,
the presentation of the data may change depending on the app and file format.
TrueBlocks works as easily with multiple related addresses at a time as it
does with individual addresses. One can view entire asset balance histories,
detailed voting histories for a DAO, or the ownership status on one's POAPs
and ENS names. We even allow exporting of Open Financial Exchange files which
is what your bank uses to export your transactions to accounting software.

## Consistent apis / interfaces

Each of the TrueBlocks endpoints and command-line tools are built on
the same core libraries (many of which are in Go). Our server (`chifra serve`)
uses the command line tools directly to complete many of its tasks, therefore
the interfaces are identical. Applications built on top of TrueBlocks have
a consistent, stable data interface.

## Open source

Furthermore, TrueBlocks is fully open
source. If you don't like something, change it and make a PR (non-commercial
use only). If you're a commercial entity, feel free to make changes, but
remember, you must either license the code separately or release your
modifications under the same open source license. Please contact us about our
licensing plans if you have a non-public, commercial use case.
39 changes: 36 additions & 3 deletions content/data-model/the-index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "The index"
description: "The index is the skeleton key that lets you explore the data and all its relations"
lead: "The index is the skeleton key that lets you explore the data and all its relations"
title: "Unchained index"
description: "Unchained Index allows blazingly fast, perfectly-private access to any account anywhere on the chain."
lead: "Unchained Index allows blazingly fast, perfectly-private access to any account anywhere on the chain."
date: 2021-07-06T09:35:59-03:00
lastmod:
- :git
Expand All @@ -17,3 +17,36 @@ weight: 1100
toc: true
---

<img src="/data-model/img/the-index.png" alt="The Unchained Index." width="600"/>

## Benefits of unchaining the index

We've written a lot about the Unchained Index elsewhere. We won't belabour the point, however, we want
to point out that the Unchained Index:

- Allows blazingly fast access to any account anywhere on the chain
- Allows perfectly-private access to query blockchain data completely locally
- Naturally shards itself and distributes itself using IPFS and user behaviour
- Is published periodically to a smart contract and once published cannot be removed from public use
- Is reproducable directly from immutable data with a well-defined series of operations meaning its as immutable as the original blockchain data
- Compact
- Digs deeper into the blockchain than any other source allowing for instantaneous, 18-decimal-place accurate off-chain reconciliation of any account
- Blazingly fast

## Links to articles about TrueBlocks

Here we present a number of articles we've written about TrueBlocks over the years. Read at least a few of these and you will better understand what we're trying to do.

| Title and description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<font color="blue">A Long-Winded Explanation of TrueBlocks</font>](http://localhost:1313/blog/a-long-winded-explanation-of-trueblocks/)<br>- *in which we go on and on about how things work and why* |
| [<font color="blue">How Accurate is EtherScan</font>](http://localhost:1313/blog/how-accurate-is-etherscan/)<br>- *in which we compare TrueBlocks with EtherScan's apis* |
| [<font color="blue">Comparison of TrueBlocks and The Graph</font>](http://localhost:1313/papers/2021/the-difference-between-trueBlocks-and-rotki-and-trueBlocks-and-thegraph.pdf)<br>- *in which we compare TrueBlocks to The Graph* |
| [<font color="blue">Custom Traversers</font>](http://localhost:1313/blog/dynamic-traversers-for-trueblocks/)<br>- *in which we describe how to enhance the extracted data* |
| [<font color="blue">Simple Undeniable Facts</font>](http://localhost:1313/blog/simple-undeniable-facts/)<br>- *in which we argue strongly for full decentralization* |
| [<font color="blue">A Time-Ordered Log of an Index of a Time-Ordered Log</font>](http://localhost:1313/blog/a-time-ordered-index-of-time-ordered-immutable-data/)<br>- *in which we describe why old-fashioned web 2.0 indexes don't cut it* |
| [<font color="blue">Indexing Addresses on the Ethereum Blockchain</font>](http://localhost:1313/blog/indexing-addresses-on-the-ethereum-blockchain/)<br>- *in which we describe the process of building the unchained index* |
| [<font color="blue">Mother May I</font>](http://localhost:1313/blog/mother-may-i/)<br>- *in which we play a childish and churlish game with our users* |
| [<font color="blue">Building an Account Scraper with TrueBlocks</font>](http://localhost:1313/blog/building-an-ethereum-account-scraper-with-trueblocks/)<br>- *in which we describe the technical details of building the index* |
| [<font color="blue">How Many ERC20 Tokens Do I Have?</font>](http://localhost:1313/blog/how-many-erc20-tokens-do-you-have/)<br>- *in which we describe why it's hard to know and how TrueBlocks helps* |
| [<font color="blue">Accounting for the Revolution</font>](http://localhost:1313/blog/accounting-for-the-revolution/)<br>- *a very early paper in which we first try to describe TrueBlocks* |
1 change: 1 addition & 0 deletions redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@ Old > new
/docs/prologue/how-can-i-get-the-index.md > /docs/install/get-the-index
/docs/prologue/install-explorer.md > /docs/install/install-explorer

/data-model/the-index.md > /data-model/unchained-index.md

0 comments on commit 1cd838f

Please sign in to comment.