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

Транзакции API

Транзакции API — это поверхность истории. Используйте её, когда вам нужны индексированные представления транзакций или квитанций без постоянного опроса сырых RPC-методов и ручного объединения результатов.

Лучше всего подходит для​

  • лент активности аккаунта;
  • инструментов отладки и поддержки;
  • поиска транзакций и квитанций по хешу;
  • запросов по блокам и диапазонам блоков.

Когда его не стоит использовать​

  • Используйте FastNear API, когда вам нужны балансы, NFT, стейкинг или поиск по публичному ключу.
  • Используйте Справочник RPC, когда вам нужно каноническое поведение узла или отправка транзакций.

Базовые URL​

  • https://tx.main.fastnear.com
  • https://tx.test.fastnear.com

Аутентификация и доступность​

  • Эти страницы сейчас не используют API-ключи или токены Bearer.
  • Сервис предназначен для индексированного доступа к истории, а не для отправки транзакций.

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

  • Транзакции по хешу — когда вы уже знаете идентификатор транзакции.
  • История аккаунта — для лент активности и отладки аккаунта.
  • Поиск квитанции — для расследования цепочки исполнения.
  • Диапазон блоков — когда нужен ограниченный по диапазону просмотр истории.

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

Я ожидал, что здесь можно отправлять транзакции​

Это семейство предназначено для индексированных запросов по истории, а не для отправки подписанных транзакций. Для отправки используйте сырой RPC.

Мне нужны пояснения по пагинации​

/v0/account использует непрозрачный resume_token, а /v0/blocks опирается на диапазон и лимит. Повторно используйте непрозрачные токены ровно в том виде, в каком их вернул сервис.

Мне нужен только один канонический результат статуса транзакции из RPC​

Используйте сырой RPC вместо индексированного семейства истории.