1. исторические метаданные корректно обрабатываются, реестр, константы меняются местами. (см. maxNominatorRewardedPerValidator)
2. Запросы ограничиваются текущим обрабатываемым блоком. (см. валидаторы и экспозиции)
3. api.queryMulti поддерживается. (см. activeEra, currentEra)
   Узнайте больше о SubQuery на сайте https://subquery.network/ и на наших социальных каналах https://linktr.ee/subquerynetwork

Шаг 0: Подключитесь к удаленному серверу Linux Ubuntu 20.04 через любой удобный для вас терминал/SSH-клиент: PuTTY, MobaXterm, Xshell, Terminus или какой-либо другой.

Шаг 1: Обновите существующий список пакетов в корневом каталоге root:

sudo apt-get update
sudo apt install screen
sudo apt upgrade

Шаг 2: Установите и настройте PostgreSQL 12 версии или выше, рекомендую воспользоваться этим видео и статьей под ним https://www.youtube.com/watch?v=wWJAE3gZIvM&t=69s
Примечание! Здесь обязательно стоить отметить, что перед запуском репозитория вам надо проверить и вписать имя своей версии, например, если Вам нужно установить PostgreSQL на Ubuntu 20.04.4 LTS, то в адресе репозитория вместо $(lsb_release -cs) напишите focal, т.е. замените кодовое имя своей версии (проверка версии lsb_release -a).

Шаг 3: Установите Docker Compose

apt install curl
curl -SL https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Шаг 4: Установите nodejs и yarn

sudo apt-get install npm -y
sudo npm install -g n yarn -y
sudo n 16 -y

Шаг 5: Установите @subql/cli
@subql/cli это клиентский инструмент для SubQuery. Он используется для инициализации каркаса проекта, построения кода проекта SubQuery и создания graph node, etc… и т. д.

sudo npm install -g @subql/cli

Шаг 6: Создайте новый каталог

mkdir ~/SubQl

Перейдите в него:

cd ~/SubQl

Шаг 7: Запустите Validator Threshold — это один из вариантов использования SubQuery Projects.

Создайте проект Validator Threshold клонируя с официального репозитория на гитхабе исходник:

apt install git

Y

git clone https://github.com/subquery/subql-examples.git

После завершения процесса инициализации вы должны увидеть, что внутри каталога создана папка с названием вашего проекта.

Шаг 8: В каталоге проекта установите зависимости

cd subql-examples
cd validator-threshold
yarn

Шаг 9: Сгенерируйте типы

yarn codegen

Шаг 10: Создайте проект

yarn build

Шаг 11: Запустите docker для извлечения образов и запуска контейнера

docker-compose pull && docker-compose up

Шаг 12: Выполните запрос
Как только контейнер docker будет запущен, что может занять несколько минут, откройте ваш браузер и перейдите по адресу www.localhost:3000.
Используйте IP вашего сервера в строке браузера, например:
143.198.150.65:3000

Откроется “игровая площадка”, где вы сможете увидеть свой запрос. Скопируйте приведенный ниже пример и нажмите кнопку со стрелкой
Пример запроса для запуска

{
  query{
    validatorThresholds{
      nodes{
        leastStaked,
        totalStaked
      }
    }
  }
}

Содержание:
Блокировать v События v Звонки
Использование словаря
События и внешние имена
Документация Polkadot
Проводник в горошек
API интерфейса командной строки Polkadot
Подключение к API
Получение блока
Получение внешних элементов внутри блока
Получение событий на определенной высоте блока
Введите безопасные свойства
Логирование
Отладка
Изменение размера пакетного блока
Смена стартового блока

Введение

В этих упражнениях мы узнаем, что такое SubQuery Project, как развернуть проект в SubQuery Project и узнаем о SubQuery Explorer.

Блокировать v События v Звонки

Чтобы проект SubQuery обрабатывал и индексировал данные как можно быстрее и эффективнее, необходимо понимать, как все работает внутри. SubQuery имеет три обработчика для обработки данных блокчейна. Они есть обработчики блоков , обработчики событий , и обработчики вызовов.

Обработчики блоков очень неэффективны. Они проверяют каждый блок, чтобы получить данные для индексации.
Это означает, что с более чем семью миллионами блоков, если каждый блок можно проиндексировать за 10 мс, для полной индексации блокчейна потребуется более восьми (8) дней. Поэтому рекомендуется по возможности избегать использования обработчиков блоков.

Обработчики событий и вызовов являются рекомендуемыми обработчиками для использования, конечно, в сочетании с фильтрами сопоставления, поскольку производительность намного выше. Фильтр сопоставления позволяет проекту
индексировать только те блоки, которые удовлетворяют критериям фильтра. Например, ниже показан фильтр, индексирующий staking модуль и Rewarded метод.

- handler: myCustomHandle
kind: substrate/EventHandler
filter:
  module: staking
  method: Rewarded

Для еще большего повышения производительности также настоятельно рекомендуется использовать словарь.

Использование словаря

Концепция словаря была представлена в предыдущих модулях (например, в модуле 5 «Переопределение конечных точек»), но снова упоминается здесь из-за ее важности.
● Понимание того, как работает словарь

События и внешние имена

Популярный вопрос при создании проектов SubQuery: как мне узнать, какие данные я могу извлечь из блокчейна Polkadot? Есть несколько вариантов:
1. Полкадот-документация
2. Обозреватель блокчейна Polkadot
3. Прямое взаимодействие с API Polkadot.

Примечание. Эти параметры также могут применяться к другим блокчейнам.

Документация Полкадот

Документацию Polkadot можно найти по адресу: https://polkadot.js.org/docs/

Более конкретно:
● События: https://polkadot.js.org/docs/substrate/events/
● Внешние элементы: https://polkadot.js.org/docs/substrate/extrinsics/

Проводник Polkadot

Обозреватель блокчейна Polkadot также является отличным местом для ознакомления с доступной для извлечения информацией. Есть несколько вариантов на выбор:
● https://polkadot.js.org/apps/#explorer
● https://polkadot.subscan.io/
● https://polkascan.io/polkadot
● https://dotscanner.com/polkadot/search
● https://polkastats.io/

Обратите внимание, что не все обозреватели одинаковы, и некоторые из них могут быть проще в использовании, а некоторые представляют нужные вам данные более четким образом. Со временем у вас появится несколько фаворитов.

Polkadot API

Предыдущие два метода понимания того, какие данные блокчейна доступны, а также тип (что не менее важно) — это здорово, но научиться напрямую подключаться к Polkadot API через командную строку дает несколько преимуществ.

Во-первых, он обеспечивает доступ к самым последним спецификациям API, поскольку документация может быть немного устаревшей. Во-вторых, это позволяет разработчикам понимать точные аргументы и их типы. Это особенно важно, когда есть проблемы и требуется отладка. И, наконец, это очень полезно при интеграции с пользовательскими цепочками, где иногда недоступна документация.

Подключение к API
Чтобы подключиться к API, выполните следующее:

npm install --save @polkadot/api

node --experimental-repl-await
const { ApiPromise, WsProvider } = require(`@polkadot/api`)
const provider = new
WsProvider(`wss://polkadot.api.onfinality.io/public-ws`);

Если требуются пользовательские типы цепей:

const types={}

Если нужны типы:

api = await ApiPromise.create({ provider, types});

Без типов:

api = await ApiPromise.create({ provider });

Получение блока
Чтобы получить хэш блока на высоте `h` , мы можем получить run const blockHash = await api.rpc.chain.getBlockHash(h)

const blockHash = await api.rpc.chain.getBlockHash(1234567)

Потом:

const block = await api.rpc.chain.getBlock(blockHash)

Получение внешних элементов внутри блока
Чтобы получить все внешние данные:

const extrinsics = block.block.extrinsics;

Для определенного внешнего элемента: (измените 1 на желаемый внешний номер)

const myExtrinsic = extrinsic[1];

Чтобы проверить типы аргументов (ввод для транзакции), введите:

myExtrinsic.meta.args

Вы должны увидеть Vec/массив. Размер массива означает, сколько аргументов занимает эта внешняя функция, и информация о метаданных каждого аргумента должна включать 'name', 'type', 'typeName'. Тип, который мы ищем. например: «MultiAddress» — это тип интерфейса из Polkadot/api.

Получение событий на определенной высоте блока

События нельзя извлечь из блока, но их можно запросить. Поскольку у нас уже есть blockHash (сверху), мы можем «привязать» текущий API к этой конкретной высоте блока. Начните с:

const apiAt = await api.at(blockHash)

Потом:

const events = await apiAt.query.system.events();

Далее укажите конкретное интересующее событие. Например, для события № 4:

const myEvent = events[4];

Наконец, введите:

myEvent.event.meta.toJSON()

И вы должны увидеть что-то вроде этого:

> myEvent.event.meta.toJSON()
{
  name: 'Withdraw',
  fields: [
    { name: null, type: 0, typeName: 'T::AccountId', docs: [] },
    { name: null, type: 6, typeName: 'T::Balance', docs: [] }
  ],
  index: 8,
  docs: [
    'Some amount was withdrawn from the account (e.g. for transaction
fees). \\[who, value\\]'
  ],
  args: [ 'AccountId32', 'u128' ]
}

Свойства безопасности типа

«Безопасный тип» обычно относится к языкам, которые гарантируют, что операция работает с правильным типом данных в какой-то момент до фактического выполнения операции. Это может быть во время компиляции или во время выполнения.

В Polkadot, все имеет свой тип . Это означает, что любая созданная переменная должна иметь тип. Например:

record.blockNumber = event.block.block.header.number.toBigInt();
record.amount = (numberYes as Int).toNumber();
record.bigAmount = (data as Balance).toBigInt();
record.bool = (data as bool).valueOf();

Логирование

Для регистрации данных в CLI из функций сопоставления, когда запущен узел subql, можно использовать команду logger.info:

logger.info("Blockheight: " +
event.block.block.header.number.toNumber());

При локальном запуске узла subql через командную строку также можно добавить уровень журнала для устранения неполадок.
● Справочник по ведению журнала Subql CLI

Отладка

Для отладки проектов SubQuery, таких как пошаговое выполнение кода, установка точек останова и проверка переменных, вам придется использовать инспектор Node.js в сочетании с инструментами разработчика Chrome.
● Как отладить проект SubQuery?

Для отладки локального узла subql можно также использовать флаг --debug из командной строки. Например:

> subql-node -f . --debug

● Справочник по отладке Subql CLI.

Изменение размера пакетного блока

Использование меньшего размера пакета может сократить использование памяти и не заставлять пользователей выполнять большие запросы. Другими словами, ваше приложение может быть более отзывчивым.
● Как изменить размер пакетного блока

Смена стартового блока

Обратите внимание, что некоторые события начинают происходить только при большей высоте блока, поэтому один из способов быстрее протестировать функцию сопоставления — отрегулировать начальную высоту блока.
● Как начать с другой высоты блока?

Введение

Подробные шаги

• Шаг 1: Hello World (размещение подзапроса).
• Шаг 2: Переключение учетных записей GitHub.
• Шаг 3: Переопределение конечных точек.
• Шаг 4. Понимание слотов.
• Шаг 5. Доступ к игровой площадке.
• Шаг 6. Запрос через API.

В этих упражнениях мы узнаем, что такое SubQuery Project, как развернуть проект в SubQuery Project и узнаем о SubQuery Explorer.
NB: «Проект SubQuery» (заглавная буква P) — это размещенное решение SubQuery. Проект подзапроса (p в нижнем регистре) относится к общему проекту подзапроса, такому как «проект подзапроса по переносу учетной записи».

Упражнение 1. Развертывание вашего проекта
Ступени высокого уровня

1. Загрузите свой проект на GitHub
2. Подключите проект SubQuery к GitHub
3. Создайте проект
4. Разверните свой проект
5. Тестирование вашего проекта на игровой площадке

Подробные шаги

Шаг 1: Hello World (размещение подзапроса)
Подробные шаги по развертыванию проекта в SubQuery Projects описаны на нашем веб-сайте документации по адресу: https://doc.subquery.network/quickstart/helloworld-hosted/ . Он берет начальный проект, загружает его на GitHub, подключает GitHub к проектам подзапросов, а затем развертывает его.

В SubQuery Projects можно развернуть любой проект на ваш выбор, но наиболее подходящим будет проект из предыдущего модуля.

Шаг 2. Переключение учетных записей GitHub
Обычно ваш проект SubQuery публикуется под именем вашей учетной записи GitHub Organization, а не вашей личной учетной записи GitHub. Пожалуйста, обратитесь к:
● Добавить учетную запись организации GitHub в проекты подзапросов

Шаг 3. Переопределение конечных точек
При развертывании проекта можно переопределить сеть по умолчанию или конечные точки словаря другой сетью. Для получения дополнительной информации см.:
● 5. Разверните свой проект

Чтобы узнать больше о том, как работают словари, обратитесь к:

● Как работает словарь SubQuery?

Шаг 4. Понимание слотов
Слоты — это функция в проектах подзапросов, эквивалентная средам разработки.
Чтобы узнать больше, посетите:
● Что такое слоты развертывания?
● В чем преимущество промежуточного слота?

Шаг 5: Доступ к игровой площадке
Как только ваш проект будет развернут, войдите в свой проект и запустите нужный запрос на игровой площадке. Для получения дополнительной информации посетите:

● Запросите свой проект в SubQuery Explorer

GraphQL — это язык, используемый для запроса данных. Чтобы узнать больше о GraphQL, посетите:

● Узнайте больше о GraphQL

Шаг 6: Запрос через API
Разработчики обычно запрашивают проект SubQuery через API. Посмотрите пример того, как это делается:
● Запрос через API

Шаг 7: Удаление проектов SubQuery
Важно поддерживать порядок в проектах подзапросов и следить за тем, чтобы тестовые проекты не запускались без необходимости. Это потребляет дополнительные ресурсы в сети и создает дополнительные затраты. Чтобы удалить проект, см. руководство ниже:
● Удаление проектов подзапросов

В настоящее время SubQuery централизованно предоставляет данные индексирования и преобразований. Это позволило им привести в действие некоторые из лучших проектов Polkadot; Приложения DeFi, такие как Acala и Bifrost, кошельки, такие как Fearless Wallet, платформы NFT, такие как KodaDot open in new window, межсетевые мосты, такие как Darwinia open in new window, и аналитические платформы, такие как SubVis open in new window - у него есть обратная сторона.

Это требует от пользователей доверия к сервису, который предоставляет SubQuery, и несет в себе риски, связанные с централизованным сервисом, такие как потенциальные сбои сервера или простои, которые могут нанести вред вашим приложениям. Это основная причина, по которой они движутся к децентрализованному будущему.

Конкурентные преимущества SubQuery

SubQuery Network конкурирует со многими игроками в индустрии децентрализованных данных, в стремлении обеспечить уникальные и основные преимущества за счет своих руководящих принципов — это гибкость и простота их сети.

#Гибкость

Первое преимущество – это гибкость SubQuery так как — это открытый исходный код, поэтому любой может свободно определять набор данных, соответствующий его потребностям, с учетом своих приложений. Вместо того, чтобы комбинировать запросы от разных конечных точек API, вы можете сами определять форму своих API. Это экономит время, деньги и обеспечивает гораздо лучший опыт для всех пользователей.

#Простота

Вам не нужно быть экспертом, чтобы воспользоваться преимуществами SubQuery. Есть буквально 3 файла, которые нужно изменить, чтобы создать рабочий проект SubQuery. Они сосредоточились на том, чтобы сделать SubQuery более простым в использовании и построении, чем их конкуренты. Успех SubQuery зависит от успеха сообщества, строящего с его помощью будущее.

#Дисбаланс индексатора / делегатора

Среди конкурентов SubQuery считает, что возможность индексаторов без предупреждения изменять ставки вознаграждения за делегирование является несправедливой. Они пытаются исправить это, требуя от индексаторов рекламировать снижение ставки доли дохода от комиссии за запрос в течение всей эпохи размещения ставок (28-дневный период).

#Приобрести заказы вместо кураторов

На таких торговых площадках, как SubQuery, где есть как покупатели, так и продавцы данных, сложно сигнализировать о спросе на будущее предложение. Другие конкуренты используют для этого «кураторов» - участников, которые предсказывают будущий спрос и получают вознаграждение, когда этот будущий спрос возникает.

SubQuery использует другой подход, когда они обращаются к Потребителям с просьбой создать предварительное обязательство, заказ на покупку. Это можно использовать как для привлечения индексаторов к новым проектам SubQuery, так и для привлечения дополнительных индексаторов к существующим и неконкурентоспособным проектам SubQuery.

#Стимулы для выполнения запросов:

Процесс обнаружения и маршрутизации индексатора будет включать данные о производительности (задержка и время безотказной работы) для всех индексаторов, и SubQuery предпримет шаги для обеспечения того, чтобы потребители отчитывались об этих данных при разблокировке микроплатежей индексаторам.

В идеале это будет стимулировать индексаторы в сети SubQuery обеспечивать инфраструктуру с высоким временем безотказной работы и малой задержкой, а также с максимальной производительностью.

#Сосредоточить на Substrate/Polkadot:

SubQuery с самого начала сфокусировал себя на Polkadot и Substate. Это позволило с самого начала создать их сервис и инструменты для работы с Substrate. Вдобавок ко всему, уникальная архитектура Polkadots упрощает для SubQuery автоматическую поддержку нескольких текущих и будущих блокчейнов.

Важные ссылки
Все наши ссылки: https://linktr.ee/subquerynetwork
Посетите сайт: https://subquery.network/
Поиграйте Проводником: https://explorer.subquery.network/
Начните работу с репозиторием SubQuery на Github: https://github.com/subquery
Читайте нашу документацию по SubQuery https://doc.subquery.network/

Следите за SubQuery
Youtube: https://www.youtube.com/c/SubQueryNetwork
Telegram: https://t.me/subquerynetwork
Twitter: https://twitter.com/subquerynetwork
Матрица: https://matrix.to/#/%23subquery:matrix.org
LinkedIn: https://www.linkedin.com/company/subquery