-
Notifications
You must be signed in to change notification settings - Fork 11.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
79 additions
and
123 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,5 @@ | ||
[package] | ||
name = "sui-indexer" | ||
name = "mvr-indexer" | ||
version.workspace = true | ||
authors = ["Mysten Labs <[email protected]>"] | ||
license = "Apache-2.0" | ||
|
@@ -85,5 +85,5 @@ ntest.workspace = true | |
criterion.workspace = true | ||
|
||
[[bin]] | ||
name = "sui-indexer" | ||
name = "mvr-indexer" | ||
path = "src/main.rs" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,132 +1,26 @@ | ||
Sui indexer is an off-fullnode service to serve data from Sui protocol, including both data directly generated from chain and derivative data. | ||
The MVR indexer is a spin-off of the Sui indexer. It has a subset of the full indexer schema, limited to just the tables needed to support MVR. The required tables are `epochs`, `checkpoints`, `packages`, `objects_snapshot`, and `objects_history`. This enables the custom indexer to support the `package_by_name` and `type_by_name` queries on GraphQL. | ||
|
||
⚠ **Warning:** Sui indexer is still experimental and we expect occasional breaking changes that require backfills. | ||
|
||
## Architecture | ||
![enhanced_FN](https://user-images.githubusercontent.com/106119108/221022505-a1d873c6-60e2-45f1-b2aa-e50192c4dfbb.png) | ||
|
||
## Steps to run locally | ||
### Prerequisites | ||
- install local [Postgres server](https://www.postgresql.org/download/). You can also `brew install postgresql@15` and then add the following to your `~/.zshrc` or `~/.zprofile`, etc: | ||
```sh | ||
export LDFLAGS="-L/opt/homebrew/opt/postgresql@15/lib" | ||
export CPPFLAGS="-I/opt/homebrew/opt/postgresql@15/include" | ||
export PATH="/opt/homebrew/opt/postgresql@15/bin:$PATH" | ||
``` | ||
- make sure you have libpq installed: `brew install libpq`, and in your profile, add `export PATH="/opt/homebrew/opt/libpq/bin:$PATH"`. If this doesn't work, try `brew link --force libpq`. | ||
|
||
- install Diesel CLI with `cargo install diesel_cli --no-default-features --features postgres`, refer to [Diesel Getting Started guide](https://diesel.rs/guides/getting-started) for more details | ||
- [optional but handy] Postgres client like [Postico](https://eggerapps.at/postico2/), for local check, query execution etc. | ||
|
||
### Start the Postgres Service | ||
# Running this indexer | ||
## Start the Postgres Service | ||
|
||
Postgres must run as a service in the background for other tools to communicate with. If it was installed using homebrew, it can be started as a service with: | ||
|
||
``` sh | ||
brew services start postgresql@version | ||
``` | ||
|
||
### Local Development(Recommended) | ||
|
||
See the [docs](https://docs.sui.io/guides/developer/getting-started/local-network) for detailed information. Below is a quick start guide: | ||
|
||
Start a local network using the `sui` binary: | ||
```sh | ||
cargo run --bin sui -- start --with-faucet --force-regenesis | ||
``` | ||
|
||
If you want to run a local network with the indexer enabled (note that `libpq` is required), you can run the following command after following the steps in the next section to set up an indexer DB: | ||
```sh | ||
cargo run --bin sui -- start --with-faucet --force-regenesis --with-indexer --pg-port 5432 --pg-db-name sui_indexer_v2 | ||
``` | ||
|
||
### Running standalone indexer | ||
1. DB setup, under `sui/crates/sui-indexer` run: | ||
```sh | ||
# an example DATABASE_URL is "postgres://postgres:postgres@localhost/exampledb" | ||
diesel setup --database-url="<DATABASE_URL>" | ||
diesel database reset --database-url="<DATABASE_URL>" | ||
``` | ||
Note that you need an existing database for this to work. Using the DATABASE_URL example in the comment of the previous code, replace `exampledb` with the name of your database. | ||
|
||
2. Checkout to your target branch | ||
|
||
For example, if you want to be on the DevNet branch | ||
```sh | ||
git fetch upstream devnet && git reset --hard upstream/devnet | ||
``` | ||
3. Start indexer binary, under `sui/crates/sui-indexer` run: | ||
- run indexer as a writer, which pulls data from fullnode and writes data to DB | ||
```sh | ||
# Change the RPC_CLIENT_URL to http://0.0.0.0:9000 to run indexer against local validator & fullnode | ||
cargo run --bin sui-indexer -- --db-url "<DATABASE_URL>" --rpc-client-url "https://fullnode.devnet.sui.io:443" --fullnode-sync-worker --reset-db | ||
``` | ||
- run indexer as a reader, which is a JSON RPC server with the [interface](https://docs.sui.io/sui-api-ref#suix_getallbalances) | ||
``` | ||
cargo run --bin sui-indexer -- --db-url "<DATABASE_URL>" --rpc-client-url "https://fullnode.devnet.sui.io:443" --rpc-server-worker | ||
``` | ||
More flags info can be found in this [file](src/main.rs#L41). | ||
|
||
### DB reset | ||
## DB reset | ||
When making db-related changes, you may find yourself having to run migrations and reset dbs often. The commands below are how you can invoke these actions. | ||
```sh | ||
cargo run --bin sui-indexer -- --database-url "<DATABASE_URL>" reset-database --force | ||
``` | ||
|
||
## Steps to run locally (TiDB) | ||
|
||
### Prerequisites | ||
|
||
1. Install TiDB | ||
|
||
``` sh | ||
curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh | ||
``` | ||
|
||
2. Install a compatible version of MySQL (At the time of writing, this is MySQL 8.0 -- note that 8.3 is incompatible). | ||
|
||
``` sh | ||
brew install [email protected] | ||
``` | ||
|
||
3. Install a version of `diesel_cli` that supports MySQL (and probably also Postgres). This version of the CLI needs to be built against the version of MySQL that was installed in the previous step (compatible with the local installation of TiDB, 8.0.37 at time of writing). | ||
|
||
``` sh | ||
MYSQLCLIENT_LIB_DIR=/opt/homebrew/Cellar/[email protected]/8.0.37/lib/ cargo install diesel_cli --no-default-features --features postgres --features mysql --force | ||
``` | ||
|
||
### Run the indexer | ||
|
||
1.Run TiDB | ||
|
||
```sh | ||
tiup playground | ||
``` | ||
|
||
2.Verify tidb is running by connecting to it using the mysql client, create database `test` | ||
|
||
```sh | ||
mysql --comments --host 127.0.0.1 --port 4000 -u root | ||
create database test; | ||
cargo run --bin mvr-indexer -- --database-url "<DATABASE_URL>" reset-database --force | ||
``` | ||
|
||
3.DB setup, under `sui/crates/sui-indexer` run: | ||
|
||
```sh | ||
# an example DATABASE_URL is "mysql://root:[email protected]:4000/test" | ||
diesel setup --database-url="<DATABASE_URL>" --migration-dir='migrations/mysql' | ||
diesel database reset --database-url="<DATABASE_URL>" --migration-dir='migrations/mysql' | ||
``` | ||
|
||
Note that you need an existing database for this to work. Using the DATABASE_URL example in the comment of the previous code, replace `test` with the name of your database. | ||
4. Run indexer as a writer, which pulls data from fullnode and writes data to DB | ||
|
||
```sh | ||
# Change the RPC_CLIENT_URL to http://0.0.0.0:9000 to run indexer against local validator & fullnode | ||
cargo run --bin sui-indexer --features mysql-feature --no-default-features -- --db-url "<DATABASE_URL>" --rpc-client-url "https://fullnode.devnet.sui.io:443" --fullnode-sync-worker --reset-db | ||
## Start the indexer | ||
```SH | ||
cargo run --bin mvr-indexer -- --db-url "<DATABASE_URL>" indexer --rpc-client-url "https://fullnode.devnet.sui.io:443" --remote-store-url http://lax-suifn-t99eb.devnet.sui.io:9000/rest | ||
``` | ||
|
||
### Extending the indexer | ||
## Migrations | ||
|
||
To add a new table, run `diesel migration generate your_table_name`, and modify the newly created `up.sql` and `down.sql` files. | ||
|
||
|
2 changes: 1 addition & 1 deletion
2
crates/sui-mvr-indexer/src/backfill/backfill_instances/sql_backfills/event_sender.sh
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,6 @@ | ||
# Copyright (c) Mysten Labs, Inc. | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
INDEXER=${INDEXER:-"sui-indexer"} | ||
INDEXER=${INDEXER:-"mvr-indexer"} | ||
DB=${DB:-"postgres://postgres:postgrespw@localhost:5432/postgres"} | ||
"$INDEXER" --database-url "$DB" run-back-fill "$1" "$2" sql "UPDATE events SET sender = CASE WHEN cardinality(senders) > 0 THEN senders[1] ELSE NULL END" checkpoint_sequence_number |
2 changes: 1 addition & 1 deletion
2
crates/sui-mvr-indexer/src/backfill/backfill_instances/sql_backfills/full_objects_history.sh
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,6 @@ | ||
# Copyright (c) Mysten Labs, Inc. | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
INDEXER=${INDEXER:-"sui-indexer"} | ||
INDEXER=${INDEXER:-"mvr-indexer"} | ||
DB=${DB:-"postgres://postgres:postgrespw@localhost:5432/postgres"} | ||
"$INDEXER" --database-url "$DB" run-back-fill "$1" "$2" sql "INSERT INTO full_objects_history (object_id, object_version, serialized_object) SELECT object_id, object_version, serialized_object FROM objects_history" checkpoint_sequence_number |
2 changes: 1 addition & 1 deletion
2
...es/sui-mvr-indexer/src/backfill/backfill_instances/sql_backfills/tx_affected_addresses.sh
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
# Copyright (c) Mysten Labs, Inc. | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
INDEXER=${INDEXER:-"sui-indexer"} | ||
INDEXER=${INDEXER:-"mvr-indexer"} | ||
DB=${DB:-"postgres://postgres:postgrespw@localhost:5432/postgres"} | ||
"$INDEXER" --database-url "$DB" run-back-fill "$1" "$2" sql "INSERT INTO tx_affected_addresses SELECT tx_sequence_number, sender AS affected, sender FROM tx_senders" tx_sequence_number | ||
"$INDEXER" --database-url "$DB" run-back-fill "$1" "$2" sql "INSERT INTO tx_affected_addresses SELECT tx_sequence_number, recipient AS affected, sender FROM tx_recipients" tx_sequence_number |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
# Build application | ||
# | ||
# Copy in all crates, Cargo.toml and Cargo.lock unmodified, | ||
# and build the application. | ||
FROM rust:1.81-bullseye AS builder | ||
ARG PROFILE=release | ||
ARG GIT_REVISION | ||
ENV GIT_REVISION=$GIT_REVISION | ||
WORKDIR "$WORKDIR/sui" | ||
|
||
# mvr-indexer needs postgres libpq5 and ca-certificates | ||
RUN apt update && apt install -y libpq5 ca-certificates libpq-dev postgresql | ||
|
||
RUN apt-get update && apt-get install -y cmake clang | ||
|
||
COPY Cargo.toml Cargo.lock ./ | ||
COPY consensus consensus | ||
COPY crates crates | ||
COPY sui-execution sui-execution | ||
COPY narwhal narwhal | ||
COPY external-crates external-crates | ||
|
||
RUN cargo build --profile ${PROFILE} --bin mvr-indexer | ||
|
||
# Production Image | ||
FROM debian:bullseye-slim AS runtime | ||
# Use jemalloc as memory allocator | ||
RUN apt-get update && apt-get install -y libjemalloc-dev ca-certificates curl | ||
ENV LD_PRELOAD /usr/lib/x86_64-linux-gnu/libjemalloc.so | ||
WORKDIR "$WORKDIR/sui" | ||
COPY --from=builder /sui/target/release/mvr-indexer /usr/local/bin | ||
RUN apt update && apt install -y libpq5 ca-certificates libpq-dev postgresql | ||
|
||
ARG BUILD_DATE | ||
ARG GIT_REVISION | ||
LABEL build-date=$BUILD_DATE | ||
LABEL git-revision=$GIT_REVISION |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
#!/bin/sh | ||
# Copyright (c) Mysten Labs, Inc. | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
# fast fail. | ||
set -e | ||
|
||
DIR="$( cd "$( dirname "$0" )" && pwd )" | ||
REPO_ROOT="$(git rev-parse --show-toplevel)" | ||
DOCKERFILE="$DIR/Dockerfile" | ||
GIT_REVISION="$(git describe --always --abbrev=12 --dirty --exclude '*')" | ||
BUILD_DATE="$(date -u +'%Y-%m-%d')" | ||
|
||
echo | ||
echo "Building mvr-indexer docker image" | ||
echo "Dockerfile: \t$DOCKERFILE" | ||
echo "docker context: $REPO_ROOT" | ||
echo "build date: \t$BUILD_DATE" | ||
echo "git revision: \t$GIT_REVISION" | ||
echo | ||
|
||
docker build -f "$DOCKERFILE" "$REPO_ROOT" \ | ||
--build-arg GIT_REVISION="$GIT_REVISION" \ | ||
--build-arg BUILD_DATE="$BUILD_DATE" \ | ||
"$@" |