Как выбрать подходящую поверхность
Не начинайте с того, чтобы отдавать агенту каждый эндпоинт FastNear. Сначала сопоставьте вопрос с правильной поверхностью.
| Вопрос агента | Лучшая поверхность | Почему |
|---|---|---|
| «Каково точное состояние аккаунта в цепочке?» | Справочник RPC | Сырой RPC даёт ответ, максимально близкий к данным узлов NEAR. |
| «Какие балансы, NFT и позиции стейкинга есть у этого аккаунта?» | FastNear API | Индексированные представления аккаунта быстрее и удобнее, чем несколько RPC-вызовов. |
| «Какие транзакции или квитанции затронули этот аккаунт?» | Транзакции API | История уже индексирована для поиска по аккаунту, блоку и квитанции. |
| «Что изменилось в самых свежих блоках?» | NEAR Data API | Эта поверхность хорошо подходит для опроса почти в реальном времени и чтения данных по блокам. |
| «Как мне сначала поднять инфраструктуру?» | Снапшоты | Сценарии со снапшотами нужны операторам, а не прикладным инструментам. |
Практическое правило
- Предпочитайте индексированные API, когда ответ уже должен быть в продуктовой форме.
- Переходите на сырой RPC, когда корректность зависит от канонического поведения протокола.
- Оставляйте NEAR Data API для проверок свежести через опрос.
- Рассматривайте снапшоты как инфраструктурный путь, а не как путь прикладного запроса.