graphprotocol/graph-node: индексация блокчейн-данных для GraphQL

Проект graphprotocol/graph-node является компонентом протокола The Graph, который занимается организацией и распределением данных из блокчейнов на ведущих Web3-сетях. Основное назначение Graph Node — это индексирование и выполнение запросов к данным, хранящимся в блокчейнах.

Этот проект интересен разработчикам Subgraph — вспомогательных структур, организующих данные из блокчейна. Также он полезен для тех, кто хочет внести изменения в сам graph-node. Для более подробной информации рекомендуется ознакомиться с официальной документацией по Subgraphs.

Установка и запуск

Существует несколько способов запуска graph-node: с использованием Docker и из исходников.

Запуск из Docker

Для разработчиков субграфов рекомендуется использовать предсобранные Docker-образы. Установку и настройку можно произвести следуя этим инструкциям.

Запуск из исходников

Для этого необходимо установить следующие компоненты:

• Rust (последняя стабильная версия).
• PostgreSQL — база данных, необходимая для хранения данных graph-node.
• IPFS для хранения данных.
• Protobuf Compiler для работы с сериализацией данных.

После установки PostgreSQL необходимо создать базу данных с нужной конфигурацией, выполнив следующие команды в psql:

psql -U <SUPERUSER> <<EOF
create user graph with password '<password>';
create database "graph-node" with owner=graph template=template0 encoding='UTF8' locale='C';
create extension pg_trgm;
create extension btree_gist;
create extension postgres_fdw;
grant usage on foreign data wrapper postgres_fdw to graph;
EOF

Затем нужно задать строку подключения к базе данных в переменной окружения:

export POSTGRES_URL=postgresql://graph:<password>@localhost:5432/graph-node

После этого можно собрать и запустить graph-node с помощью следующей команды:

cargo run -p graph-node --release -- \
  --postgres-url $POSTGRES_URL \
  --ethereum-rpc NETWORK_NAME:[CAPABILITIES]:URL \
  --ipfs 127.0.0.1:5001

При старте graph-node выведет порты, на которых доступен API, включая основной GraphQL HTTP сервер, который по умолчанию работает на http://localhost:8000.

Развертывание Subgraph

После запуска graph-node можно развернуть Subgraph, следуя руководству по развертыванию. Для этого потребуется установить graph-cli.

Дополнительные возможности

graph-node поддерживает различные конфигурации хранения логов, включая локальные файлы, Elasticsearch и другие. Пример настройки логирования через файлы приведен ниже:

cargo run -p graph-node --release -- \
  --postgres-url $POSTGRES_URL \
  --ethereum-rpc mainnet:archive:https://... \
  --ipfs 127.0.0.1:5001 \
  --log-store-backend file \
  --log-store-file-dir ./graph-logs

Запросы к логам можно делать через GraphQL на http://localhost:8000/graphql.

Лицензия

Проект лицензирован под MIT и Apache License, Version 2.0. Программное обеспечение предоставляется "как есть" без каких-либо гарантий.