Namadexer is an indexer for Namada. The vast majority of the work was done by Zondax in
the original Namadexer repo (since archived) up until Namada version v0.31.4.
This fork attempts to bring it up-to-date with recent Namada versions. Due to the many changes in Namada transaction structure
since then (such as the introduction of batched transactions and changes in how transfers are represented in the protocol) this includes breaking changes to the DB model; most notably, the transactions table has been split into inner_transactions and wrapper_transactions.
The project is composed of 2 entities : the indexer and the server. They are both written in Rust.
-
the
indexer: This component establishes a connection to the Namada node via RPC and collects blocks and transactions. It then stores this data in a PostgreSQL database. The indexer operates independently of the server and can be initiated on its own. -
the
server: This is a JSON-based server that facilitates querying of blocks and transactions using unique identifiers. It also provides additional useful endpoints, such as/blocks/latest. A comprehensive list of all endpoints, along with their descriptions, is available in the documentation.
These services require a connection to a postgres database. Support for OpenTelemetry has also been added.
You can find more information about the indexer in the ./docs folder.
You will need access to a namada node and specify its tendermint rpc host and port in the Settings.toml file. You can use the Settings.example.toml as a template.
To proceed, you must have Rust installed and a Namada node operational and accessible locally.
The system will automatically install the appropriate version of protoc (version 3.12 or higher) within this repository. This ensures no conflicts arise with other versions of protoc that may be installed on your system
$ make install-deps
Start the docker database :
$ make postgres
You will need to use this command if you want to avoid issues with protoc.
$ make run
Run jaeger in background
$ docker run -d -p6831:6831/udp -p6832:6832/udp -p16686:16686 -p14268:14268 jaegertracing/all-in-one:latest
Start the indexer
$ RUST_LOG=trace cargo run --bin indexer
View spans
$ firefox http://localhost:16686/