Skip to content

docs: fix the transaction store prefix and the output rows in the schema #263

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
artofbitcoin wants to merge 2 commits into
base: new-index
Choose a base branch
from
+7 −4
Open

docs: fix the transaction store prefix and the output rows in the schema #263

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f21c663
docs: raw transactions are stored under the T prefix
artofbitcoin Sep 29, 2026
6396fa6
docs(schema): describe the O and a rows as written by the indexer
artofbitcoin Sep 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ but instead queried from bitcoind on demand.

- Extended indexes and database storage for improved performance under high load:

- A full transaction store mapping txids to raw transactions is kept in the database under the prefix `t`.
- A full transaction store mapping txids to raw transactions is kept in the database under the prefix `T`.
- An index of all spendable transaction outputs is kept under the prefix `O`.
- An index of all addresses (encoded as string) is kept under the prefix `a` to enable by-prefix address search.
- A map of blockhash to txids is kept in the database under the prefix `X`.
Expand Down
9 changes: 6 additions & 3 deletions doc/schema.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,10 +31,13 @@ Each transaction results in the following new row:

* `"T{txid}" → "{serialized-transaction}"`

Each output results in the following new rows:
Each spendable output (`OP_RETURN` outputs are skipped, and on Elements also fee outputs and other provably unspendable outputs) results in the following new row:

* `"O{txid}{vout}" → "{scriptpubkey}{value}"`
* `"a{funding-address-str}" → ""` (for prefix address search, only saved when `--address-search` is enabled)
* `"O{txid}{vout}" → "{serialized-txout}"`

When `--address-search` is enabled, each output with an address also results in the following new row:

* `"a{funding-address-str}" → ""` (for prefix address search)

When the indexer is synced up to the tip of the chain, the hash of the tip is saved as following:

Expand Down