Verifier XRP Indexer

This is an indexer for the XRP blockchain. It is using the Verifier Indexer Framework (https://github.com/flare-foundation/verifier-indexer-framework). It collects Blocks and Transactions from the XRP blockchain. The indexer is configured via a configuration file - see config.example.toml for an example configuration.

Installation

To install the indexer, you need to have Go installed to the latest version - currently 1.23.0.

Now you may install the indexer by running the following command:

go install github.com/flare-foundation/verifier-xrp-indexer/cmd/indexer@latest

This will install the indexer command globally.

Running the indexer

Prerequisites

Database

To run the indexer a PostgreSQL database needs to be deployed. An example database is provided as docker image in tests directory which can be used with

docker compose up postgresdb

from the tests repository.

Config file

Provide a .toml config file with the following fields (mostly self explanatory)

[db]
username = "username"
password = "password"
db_name = "flare_xrp_indexer"
port = 5432
drop_table_at_start = false

[indexer]
max_block_range = 100 # size of a batch to be repeatedly queried and saved in a dataset
max_concurrency = 10 # number of concurrent processes querying data from the RPC node
start_block_number = 780000

[blockchain]
url = "https://s.altnet.rippletest.net:51234"

[timeout]
timeout_millis = 1000

[logger]
level = "DEBUG"
file = "logs/xrp_indexer.log"
console = true

Running the code

Assuming that the indexer was installed globally you can use indexer command to run it. Alternatively you can use go run ./cmd/indexer to build and run the binary.

By default the indexer will look for a configuration file named config.toml in the current working directory. You can specify a different configuration file by passing --config <filepath> when running the indexer. For example:

go run cmd/indexer/main.go --config tests/config_test.toml