From: Nadav Ivgi <nadav@shesek•info>
To: bitcoin-dev@lists•linuxfoundation.org
Subject: [bitcoin-dev] Announcing Bitcoin Wallet Tracker
Date: Sat, 30 May 2020 17:16:14 +0300 [thread overview]
Message-ID: <CAGXD5f16OFOTb3fobOPNjrhFkmXk6w=V7cW1LijP+OumEh_3NQ@mail.gmail.com> (raw)
[-- Attachment #1: Type: text/plain, Size: 3601 bytes --]
Hi all,
I recently released bwt [0], an HD wallet indexer implemented in Rust, using
a model similar to that of Electrum Personal Server.
It uses the bitcoind wallet functionality to do the heavy lifting and builds
additional indexes on top of that, which can be queried using the Electrum
RPC protocol, as well as a more modern, developer-friendly HTTP REST API.
The electrum server can also be used as an electrum plugin [1], which
integrates the server straight into the electrum client. From the user's
perspective, this allows connecting electrum directly to a full node.
The HTTP API is my take on a modern design for a wallet tracking API aimed
at app developers. Some use-cases include using it as a backend for wallets
(similarly to Samuari's Dojo) or to track deposits to a watch-only xpub
(similarly to BTCPay's NBXplorer).
Compared to using the bitcoind RPC directly, bwt provides:
- The ability to track an xpub and automatically have new addresses derived
and imported as needed, according to the gap limit.
- Two additional indexes, one for looking up the transaction history of
addresses, and another one for looking up txo spends (a map of
funding_txid:vout => spending_txid:vin).
- Real-time updates using Server-Sent Events [2] (a long-lived streaming
HTTP
connection) or Web Hooks [3] (an HTTP request sent to a configured URL).
The updates being sent [4] directly provide information about the funded
and spent wallet txos, instead of the client figuring it out from the tx.
- Some API conveniences and simplifications, like including key origin
information directly alongside inputs/outputs [5], the ability to specify
key origins in place of addresses (eg. GET /hd/15cb9edc/8/utxos), a
compact
history format [6], and an easy way to catch-up with missed events [7].
Unless explicitly asked for, the API omits information about non-wallet
inputs/outputs and protocol-level details like scriptsig and witnesses,
which are typically not needed for higher-level app development.
The indexer is designed in a way that minimizes RPC requests to bitcoind. By
using labels to store key origin information, it is able to index incoming
transactions using the information available from `listtransactions` alone
(plus 3 extra rpc requests that don't grow with the number of transactions),
but requires 1 additional rpc call per outgoing transaction (to learn which
prevouts were spent). It can index 10k incoming txs in under a second, or a
mixture of 5k/5k in under 5 seconds. The index is currently entirely in-
memory and does not get persisted. The indexer logic can be seen in [8].
One major item on the roadmap that I'm hoping to tackle soon is support for
output script descriptors.
If anyone is interested in contributing, the README has some useful
developer
resources [9] and a handy script for setting up a development environment.
This is an early alpha release, recommended for use with testnet/regtest.
All feedback welcome!
Cheers,
Nadav
[0] https://github.com/shesek/bwt
[1] https://github.com/shesek/bwt#electrum-plugin
[2] https://github.com/shesek/bwt#server-sent-events
[3] https://github.com/shesek/bwt#web-hooks
[4] https://github.com/shesek/bwt#event-categories
[5] https://github.com/shesek/bwt#wallet-transaction-format
[6] https://github.com/shesek/bwt#get-txssinceblock-heightcompact
[7]
https://github.com/shesek/bwt#catching-up-with-missed-events--re-org-detection
[8] https://github.com/shesek/bwt/blob/master/src/indexer.rs
(sync_transactions and load_transactions_since)
[9] https://github.com/shesek/bwt#developing
[-- Attachment #2: Type: text/html, Size: 4518 bytes --]
next reply other threads:[~2020-05-30 14:16 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-05-30 14:16 Nadav Ivgi [this message]
[not found] ` <h-iXaWQ7GCW2m7hWhPPdBalMXR_yzNL6AbK-YV4o-gaHyTxIOu8SwfdVp2hsYL8XrbkV_pry20fKQPSfc2g0uk-r5IrMXX1Ci0A4R1fLr4A=@protonmail.com>
2020-06-01 8:10 ` Nadav Ivgi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAGXD5f16OFOTb3fobOPNjrhFkmXk6w=V7cW1LijP+OumEh_3NQ@mail.gmail.com' \
--to=nadav@shesek$(echo .)info \
--cc=bitcoin-dev@lists$(echo .)linuxfoundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox