Перейти к основному содержимому

Справочник RPC

FastNear RPC даёт вам прямой доступ по JSON-RPC к узлам NEAR для запросов состояния, проверки блоков и чанков, отправки транзакций, чтения данных валидаторов и диагностики протокола.

Эндпоинты​

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

Обычный RPC mainnet
https://rpc.mainnet.fastnear.com
Обычный RPC testnet
https://rpc.testnet.fastnear.com

Архивные RPC открывают всю историю цепочки, когда вам нужны старые блоки, квитанции или историческое состояние контракта:

Архивный RPC mainnet
https://archival-rpc.mainnet.fastnear.com
Архивный RPC testnet
https://archival-rpc.testnet.fastnear.com

С чего обычно начинают​

  • Аккаунт: запросы по аккаунту, ключу доступа и списку ключей.
  • Блоки: поиск финализированных блоков или блоков по высоте и хешу.
  • Контракты: вызовы view-методов, получение кода и просмотр состояния контракта.
  • Протокол: статус, состояние узла, цена газа, конфигурация сети и экспериментальные методы протокола.
  • Транзакции: отправка транзакций и методы статуса исполнения.
  • Валидаторы: текущие валидаторы и данные по эпохам.

Используйте RPC, когда​

  • вам нужны канонические формы запросов и ответов из протокола;
  • вам важно поведение настоящего узла для запросов состояния и поиска блоков;
  • вы отправляете транзакции или проверяете результаты исполнения;
  • вам нужна самая низкоуровневая поверхность до перехода к индексированным или продуктовым представлениям.

Не используйте RPC, когда​

  • вы хотите получить в одном вызове балансы, NFT, позиции стейкинга или поиск по публичному ключу;
  • вам нужна индексированная история транзакций по аккаунту вместо опроса узлов и сшивания ответов;
  • для вас важнее простота продуктового интерфейса, чем прямой контроль над протоколом.

В этих случаях переходите к индексированным REST-семействам, например FastNear API, Транзакции API или NEAR Data API.

Аутентификация и лимиты​

  • API-ключи FastNear необязательны для работы с документацией и сценариев с повышенными лимитами.
  • Браузерные демо из документации могут использовать встроенный поток API-ключа, но продакшен-трафик стоит перевести на серверную стратегию управления ключами.
  • Начните с Аутентификации и доступа, если вам нужен платный доступ или рекомендации для продакшена.

Устранение неполадок​

Запрос работает локально, но падает в продакшене​

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

Мне нужно более старое состояние, чем возвращает обычный RPC​

Переключитесь с обычного RPC-эндпоинта на архивный RPC-эндпоинт.

Мне нужен более простой ответ, чем даёт JSON-RPC​

Обычно это означает, что вам нужно индексированное REST-семейство, а не сырой RPC. Воспользуйтесь страницей выбора поверхности и подберите более высокий уровень абстракции.