TON API от GetBlock
Это руководство охватит основные шаги получения и использования приватных конечных точек RPC от GetBlock для доступа к блокчейну TON.
GetBlock - это поставщик Web3 инфраструктуры, предлагающий конечные точки API на основе HTTP для взаимодействия клиентов с различными блокчейн-сетями, включая TON.
Как получить доступ к конечным точкам блокчейна TON
Чтобы начать использовать конечные точки GetBlock, пользователи должны войти в свой аккаунт, получить URL-адрес для конечной точки TON и все готово к работе. Далее приведены более подробные инструкции.
1. Создайте учетную запись GetBlock
Посетите [веб-сайт] GetBlock (https://getblock.io/?utm_source=external&utm_medium=article&utm_campaign=ton_docs) и найдите на главной странице кнопку "Get Started for Free". Зарегистрируйте аккаунт, используя адрес электронной почты или подключив кошелек MetaMask.
2. Выберите блокчейн TON
После входа вы будете перенаправлены на панель управления. Найдите раздел, называемый "My Endpoints", и выберите "TON" в выпадающем меню "Protocols".
Выберите желаемую сеть и тип API (JSON-RPC или JSON-RPC(v2)).
3. Сгенерируйте URL конечной точки
Нажмите на кнопку "Get", чтобы сгенерировать URL-адрес вашей конечной точки блокчейна TON.
Все конечные точки в GetBlock API имеют последовательную структуру: https://go.getblock.io/[ACCESS TOKEN]/.
Эти токены доступа служат уникальными идентификаторами для каждого пользователя или приложения и содержат информацию, необходимую для маршрутизации запросов к соответствующим конечным точкам без раскрытия чувствительных данных. Они в конечном итоге заменяют необходимость отдельных заголовков авторизации или API-ключей.
Пользователи имеют возможность генерировать несколько конечных точек, заменять токены, если они скомпрометированы и удалять неиспользуемые конечные точки.
Теперь вы можете использовать эти URL-адреса для взаимодействия с блокчейном TON, запрашивать данные, отправлять транзакции и создавать децентрализованные приложения без необходимости настройки и поддержания инфраструктуры.
Бесплатные запросы и ограничения для пользователей
Обратите внимание, что каждому зарегистрированному пользователю GetBlock предоставляется до 40 000 бесплатных запросов, ограниченных 60 запросами в секунду (RPS). Баланс запросов обновляется ежедневно и может использоваться на любых общих конечных точках для поддерживаемых блокчейн-сетей.
Для получения расширенных функций и возможностей пользователи могут воспользоваться платными опциями, которые будут описаны ниже.
GetBlock.io предлагает два типа тарифных планов: Общие узлы и Выделенные узлы. Клиенты могут выбрать тариф, и сходя из своих требований и бюджета.
Общие узлы
- Уровень доступа, где одни и те же узлы используются несколькими клиентами одновременно;
- Ограничение скорости увеличено до 200 RPS;
- Подходит для индивидуального использования или для приложений с меньшими объемами транзакций и требованиями к ресурсам по сравнению с полностью масштабированными производственными приложениями;
- Более доступный вариант для индивидуальных разработчиков или небольших команд с ограниченным бюджетом.
Общие узлы предлагают экономически эффективное решение для доступа к инфраструктуре блокчейна TON без необходимости значительных первоначальных инвестиций или обязательств.
По мере того как разработчики будут масштабировать свои приложения и нуждаться в дополнительных ресурсах, они смогут легко обновить свои планы подписки или перейти на выделенные узлы, если это будет необходимо.
Выделенные узлы
- Один узел выделяется исключительно для одного клиента; Нет ограничений на запросы;
- Открывает доступ к архивным узлам, различным местоположениям серверов и пользовательским настройкам;
- Гарантирует клиентам обслуживание и поддержку на высшем уровне.
Это следующий уровень решения для разработчиков и децентрализованных приложений (dApps), требующих улучшенной пропускной способности, более высокой скорости подключения к узлам и гарантированных ресурсов при масштабировании.
Как использовать TON HTTP API от GetBlock
В этом разделе мы погрузимся в практическое использование TON HTTP API, предоставленного GetBlock. Мы рассмотрим примеры, чтобы продемонстрировать, как эффективно использовать сгенерированные конечные точки для вашего взаимодействия с блокчейном.
Примеры обычных вызовов API
Давайте начнем с простого примера, используя метод '/getAddressBalance' для получения баланса конкретного адреса с помощью команды curl.
curl --location --request GET 'https://go.getblock.io/[ACCESS-TOKEN]/getAddressBalance?address=EQDXZ2c5LnA12Eum-DlguTmfYkMOvNeFCh4rBD0tgmwjcFI-' \
--header 'Content-Type: application/json'
Не забудьте заменить ACCESS-TOKEN на ваш реальный токен доступа, предоставленный GetBlock.
Это выведет баланс в nanotons.
Некоторые другие доступные методы для запросов к блокчейну TON:
| # | Метод | Конечная точка | Описание |
|---|---|---|---|
| 1 | GET | getAddressState | возвращает текущий статус (uninitialized, active, или frozen) указанного адреса в блокчейне TON |
| 2 | GET | getMasterchainInfo | Получает информацию о состоянии masterchain |
| 3 | GET | getTokenData | Получает подробные сведения об NFT или Jetton, связанных с указанным аккаунтом в сети TON |
| 4 | GET | packAddress | Преобразует адрес TON из raw формата в удобный для чтения |
| 5 | POST | sendBoc | Отправляет сериализованные файлы BOC вместе с внешними сообщениями в блокчейн для выполнения |
Пожалуйста, обратитесь к [документации] GetBlock (https://getblock.io/docs/ton/json-rpc/ton_jsonrpc/), чтобы получить подробную справочную инфо рмацию об API с примерами и списком дополнительных методов.
Развертывание умных контрактов
Разработчики могут использовать те же URL-адреса конечных точек для непрерывного развертывания контрактов на блокчейне TON с использованием библиотеки TON.
Библиотека инициализирует клиент для подключения к сети через конечные точки HTTP API GetBlock.
Этот руководство должно предоставить подробный обзор для разработчиков, которые хотят эффективно использовать API GetBlock с блокчейном TON.
Не стесняйтесь узнать больше на веб-сайте или написать в службу поддержки GetBlock через чат, Telegram или форму на сайте.