mirror of
https://github.com/pezkuwichain/pezkuwi-subquery.git
synced 2026-10-20 18:56:24 +00:00
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.
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# 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
|
|
|
|
```sh
|
|
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
|
|
|
|
```sh
|
|
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.
|