Files
pezkuwi-subquery/ops/zagros/README.md
T
Satoshi Qazi Muhammed 2476423362 Add a Zagros Asset Hub history indexer for the explorer host
The explorer at explorer.pezkuwichain.io needs transfer history for Zagros
Asset Hub. It runs on the explorer host next to its own archive node, so the
manifest points at 127.0.0.1:9955 and the compose file binds everything
locally with memory limits and no published ports.

deploy-vps now ignores these files: a change to the Zagros indexer must not
rebuild or restart the mainnet stack and its bots on the indexer host.
2026-10-15 10:52:35 +04:00

1.6 KiB

Zagros Asset Hub history (explorer host)

Serves HistoryElement for Zagros Asset Hub to explorer.pezkuwichain.io. It runs on the explorer host next to its own archive node, never on the mainnet indexer host (deploy-vps ignores zagros-assethub.yaml, docker-compose.zagros.yml and this directory).

Pieces

piece where listens
archive node zagros-ah-archive (systemd, --state-pruning archive --blocks-pruning archive, relay followed over RPC) host RPC 127.0.0.1:9955
postgres 16 compose 127.0.0.1:5433
subql-node, zagros-assethub.yaml compose 3101 (firewalled)
subql-query compose 3100 (firewalled); nginx exposes POST /history/assethub only

Build and start

git clone https://github.com/pezkuwichain/pezkuwi-subquery /opt/zagros-history
cd /opt/zagros-history
# Build the mapping (dist/) without installing Node on the host.
docker run --rm -v "$PWD":/w -w /w node:24-alpine sh -c \
  'corepack enable && yarn install --immutable && yarn subql codegen zagros-assethub.yaml && yarn subql build zagros-assethub.yaml'
printf 'ZAGROS_DB_PASS=%s\n' "$(openssl rand -hex 24)" > .env.zagros && chmod 600 .env.zagros
docker compose -f docker-compose.zagros.yml --env-file .env.zagros up -d --build

Check

curl -s -X POST 127.0.0.1:3100 -H 'content-type: application/json' \
  -d '{"query":"{_metadata{lastProcessedHeight targetHeight}}"}'

targetHeight - lastProcessedHeight above 100 for ten minutes means the indexer has stalled; the explorer then shows "on its way" for payments it has not seen yet.