Часто задаваемы вопросы для разработчиков
Reading time: 6 min
На этой странице собраны некоторые из наиболее частых вопросов для разработчиков, использующих The Graph.
Субграф - это пользовательский API, построенный на данных блокчейна. Субграфы запрашиваются с использованием языка запросов GraphQL и развертываются на Graph Node с помощью Graph CLI. После развертывания и публикации в децентрализованной сети The Graph индексаторы обрабатывают субграфы и делают их доступными для запросов потребителей субграфов.
Для успешного создания субграфа Вам потребуется установить The Graph CLI. Перед началом работы, ознакомьтесь с разделом . Подробную информацию см. в разделе .
Настоятельно рекомендуется структурировать смарт-контракты так, чтобы они содержали события, связанные с данными, которые вы хотите запросить. Обработчики событий в субграфе срабатывают на события контракта и являются самым быстрым способом получения нужных данных.
Если контракты, с которыми Вы работаете, не содержат событий, Ваш субграф может использовать обработчики вызовов и блоков для запуска индексации. Хотя это не рекомендуется, так как производительность будет существенно ниже.
Нет. После создания субграфа связанная с ним учетная запись GitHub не может быть изменена. Пожалуйста, учтите это перед созданием субграфа.
Вы можете развернуть новую версию своего субграфа в Subgraph Studio с помощью интерфейса командной строки (CLI). Это действие сохраняет конфиденциальность вашего субграфа, но, если результат Вас удовлетворит, Вы сможете опубликовать его в Graph Explorer. При этом будет создана новая версия Вашего субграфа, на которую Кураторы смогут начать подавать сигналы.
6. Можно ли дублировать субграф на другую учетную запись или конечную точку без повторного развертывания?
Вы должны повторно развернуть субграф, но если идентификатор субграфа (хэш IPFS) не изменится, его не нужно будет синхронизировать с самого начала.
7. Как вызвать контрактную функцию или получить доступ к публичной переменной состояния из моих мэппингов субграфа?
Просмотрите положение Доступ к смарт-контракту в разделе .
В настоящее время нет, так как мэппинги написаны на языке AssemblyScript.
Одним из возможных альтернативных решений является хранение необработанных данных в объектах и выполнение логики, для которой требуются библиотеки JS на клиенте.
9. При прослушивании нескольких контрактов, возможно ли выбрать порядок прослушивания событий контрактов?
Внутри субграфа события всегда обрабатываются в том порядке, в котором они появляются в блоках, независимо от того, относится ли это к нескольким контрактам или нет.
Шаблоны позволяют Вам быстро создавать источники данных, пока Ваш субграф индексируется. Ваш контракт может создавать новые контракты по мере того, как люди будут с ним взаимодействовать. Поскольку форма этих контрактов (ABI, события и т. д.) известна заранее, Вы сможете определить, как Вы хотите индексировать их в шаблоне. Когда они будут сгенерированы, Ваш субграф создаст динамический источник данных, предоставив адрес контракта.
Ознакомьтесь с параграфом "Создание экземпляра шаблона источника данных" в разделе: .
11. Можно ли настроить субграф с помощью graph init из graph-cli с двумя контрактами? Или мне следует вручную добавить другой источник данных в subgraph.yaml после запуска graph init?
Да. В самой команде graph init Вы можете добавлять несколько источников данных, вводя контракты один за другим.
Вы также можете использовать команду graph add для добавления нового источника данных.
Event and call handlers are first ordered by transaction index within the block. Event and call handlers within the same transaction are ordered using a convention: event handlers first then call handlers, each type respecting the order they are defined in the manifest. Block handlers are run after event and call handlers, in the order they are defined in the manifest. Also these ordering rules are subject to change.
When new dynamic data source are created, the handlers defined for dynamic data sources will only start processing after all existing data source handlers are processed, and will repeat in the same sequence whenever triggered.
Вы можете запустить следующую команду:
docker pull graphprotocol/graph-node:latest
Примечание: docker / docker-compose всегда будет использовать ту версию graph-node, которая была получена при первом запуске, поэтому убедитесь, что используете последнюю версию graph-node.
14. Каков рекомендуемый способ создания "автоматически сгенерированных" идентификаторов для объекта при обработке событий?
Если во время события создается только один объект и нет ничего лучшего, то индекс хэша транзакции и журнала будет уникальным. Вы можете замаскировать их, преобразовав в байты, а затем, пропустив через crypto.keccak256, но это не сделает их более уникальными.
Yes, you can and your subgraph.
Вы можете найти список поддерживаемых сетей .
Да. Вы можете это сделать, импортировав graph-ts, как показано в примере ниже:
import { dataSource } from '@graphprotocol/graph-ts'dataSource.network()dataSource.address()
Да. Sepolia поддерживает обработчики блоков, обработчики вызовов и обработчики событий. Следует отметить, что обработчики событий намного более эффективны, чем два других обработчика, и они поддерживаются в каждой сети, совместимой с EVM.
Да. dataSources.source.startBlock в файле subgraph.yaml указывает номер блока, с которого источник данных начинает индексирование. В большинстве случаев мы предлагаем использовать блок, в котором создавался контракт:
20. Есть ли какие-либо советы по увеличению производительности индексирования? Синхронизация моего субграфа занимает очень много времени
Да, Вам следует обратить внимание на дополнительную функцию стартового блока, чтобы начать индексирование с блока, в котором был развернут контракт:
21. Есть ли способ напрямую запросить субграф, чтобы определить номер последнего проиндексированного блока?
Да! Попробуйте выполнить следующую команду, заменив "organization/subgraphName" на название организации, под которой она опубликована, и имя Вашего субграфа:
curl -X POST -d '{ "query": "{indexingStatusForCurrentVersion(subgraphName: \"organization/subgraphName\") { chains { latestBlock { hash number }}}}"}' https://api.thegraph.com/index-node/graphql
По умолчанию ответы на запросы ограничены 100 единицами на коллекцию. Если Вы хотите получить больше, Вы можете довести количество до 1000 единиц на коллекцию, а для получения ещё большего количества можно использовать пагинацию:
someCollection(first: 1000, skip: <number>) { ... }
23. If my dapp frontend uses The Graph for querying, do I need to write my API key into the frontend directly? What if we pay query fees for users – will malicious users cause our query fees to be very high?
В настоящее время рекомендуемым подходом для децентрализованного приложения является добавление ключа во внешний интерфейс и предоставление его конечным пользователям. При этом Вы можете ограничить этот ключ именем хоста, например yourdapp.io и субграфом. Шлюз в настоящее время находится в управлении Edge & Node. Частью ответственности шлюза является отслеживание злоупотреблений и блокировка трафика от вредоносных клиентов.
Federation пока не поддерживается. В настоящее время Вы можете использовать объединение схем либо на клиенте, либо через прокси-сервис.