Транзакции API

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

Базовые URL

Transactions API Mainnet

https://tx.main.fastnear.com

Transactions API Testnet

https://tx.test.fastnear.com

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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