MIME-Version: 1.0
References: <CAGXD5f16OFOTb3fobOPNjrhFkmXk6w=V7cW1LijP+OumEh_3NQ@mail.gmail.com>
 <h-iXaWQ7GCW2m7hWhPPdBalMXR_yzNL6AbK-YV4o-gaHyTxIOu8SwfdVp2hsYL8XrbkV_pry20fKQPSfc2g0uk-r5IrMXX1Ci0A4R1fLr4A=@protonmail.com>
In-Reply-To: <h-iXaWQ7GCW2m7hWhPPdBalMXR_yzNL6AbK-YV4o-gaHyTxIOu8SwfdVp2hsYL8XrbkV_pry20fKQPSfc2g0uk-r5IrMXX1Ci0A4R1fLr4A=@protonmail.com>
From: Nadav Ivgi <nadav@shesek.info>
Date: Mon, 1 Jun 2020 11:10:50 +0300
Message-ID: <CAGXD5f2wZ+x1Mc7kak0+Qp5DmBp1ZoED4bu1xw9J7LE6sJxhmw@mail.gmail.com>
To: darosior <darosior@protonmail.com>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Cc: Bitcoin Protocol Discussion <bitcoin-dev@lists.linuxfoundation.org>
Subject: Re: [bitcoin-dev] Announcing Bitcoin Wallet Tracker
Precedence: list

Hi Antoine,

I designed both APIs, so they definitely do share some similarities.

It's difficult to compare their performance directly, since
esplora-electrs keeps a full index of everything, while bwt tracks
your wallet addresses only.

If you're only interested in your wallet addresses and don't have a
*really* huge number of them, bwt will definitely perform better, as
it can avoid a lot of unnecessary indexing work. If you do have a lot
of addresses, esplora-electrs will be better suited for the job, as
its designed to deal with high volumes of data and does not rely on
the bitcoind wallet functionality, which was not designed for this.

I'm not sure where the line for "really huge" crosses exactly though,
I have not put this to the test. Definitely if you're tracking
millions of addresses, probably also for hundreds of thousands,
possibly even less?

API design wise, the main differences between the two are:

- Esplora provides every bit of information one might want to know
about transactions/blocks, while bwt intentionally tries to reduce
this to the subset useful in the context of app development.

- bwt provides wallet-contextual information, like key origins next to
addresses and the net change inflicted on the wallet's balance by
transactions.

- Esplora doesn't provide real-time updates (yet), while bwt provides
them using two different mechanisms (SSE and Web Hooks).

Nadav


On Sun, May 31, 2020 at 5:56 PM darosior <darosior@protonmail.com> wrote:
>
> Hi,
>
> I gave a quick look to the http API, and it seems very similar to Esplora=
's. So I wonder : how does
> bwt compares to Esplora, performance-wise ?
>
> Thanks!
> Antoine
>
>
> =E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90 Original =
Message =E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90=E2=80=90
> Le samedi, mai 30, 2020 4:16 PM, Nadav Ivgi via bitcoin-dev <bitcoin-dev@=
lists.linuxfoundation.org> a =C3=A9crit :
>
> Hi all,
>
> I recently released bwt [0], an HD wallet indexer implemented in Rust, us=
ing
> a model similar to that of Electrum Personal Server.
>
> It uses the bitcoind wallet functionality to do the heavy lifting and bui=
lds
> additional indexes on top of that, which can be queried using the Electru=
m
> 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 aime=
d
> at app developers. Some use-cases include using it as a backend for walle=
ts
> (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 deriv=
ed
>   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 =3D> 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 funde=
d
>   and spent wallet txos, instead of the client figuring it out from the t=
x.
>
> - Some API conveniences and simplifications, like including key origin
>   information directly alongside inputs/outputs [5], the ability to speci=
fy
>   key origins in place of addresses (eg. GET /hd/15cb9edc/8/utxos), a com=
pact
>   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 incomin=
g
> transactions using the information available from `listtransactions` alon=
e
> (plus 3 extra rpc requests that don't grow with the number of transaction=
s),
> but requires 1 additional rpc call per outgoing transaction (to learn whi=
ch
> 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 f=
or
> output script descriptors.
>
> If anyone is interested in contributing, the README has some useful devel=
oper
> 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_transa=
ctions and load_transactions_since)
> [9] https://github.com/shesek/bwt#developing
>
>