Arbitrum SDK

Что такое Arbitrum SDK?

Arbitrum SDK — это набор инструментов для разработчиков, создающих приложения, взаимодействующие с сетями Arbitrum. Он особенно полезен, если приложению нужны перевод токенов между сетями, кроссчейн-сообщения, определение сети, отслеживание транзакций или доступ к контрактам мостов Arbitrum.

В криптоиндустрии этим термином обычно называют пакет TypeScript @arbitrum/sdk, предназначенный для взаимодействия с сетями Arbitrum на стороне клиента.

SDK избавляет разработчиков от необходимости писать низкоуровневую логику моста с нуля: в нем есть типизированные классы и вспомогательные методы для распространенных операций в Arbitrum.

Согласно официальному репозиторию Arbitrum SDK на GitHub, SDK предоставляет вспомогательные функции и доступ к интерфейсам базовых смарт-контрактов для создания приложений в Arbitrum.

Для пользователей Arbitrum SDK — незаметная инфраструктура, которая может обеспечивать такие операции, как внесение ETH, перевод токенов ERC-20 между сетями, вывод активов или проверка статуса кроссчейн-транзакции.

Для разработчиков Arbitrum SDK — практический промежуточный уровень между приложением и смарт-контрактами, которые обеспечивают взаимодействие основной и дочерней сетей в обоих направлениях.

Место Arbitrum SDK в экосистеме Arbitrum

Arbitrum — это экосистема масштабирования Ethereum, которая обеспечивает более низкие затраты на выполнение операций, более быстрый пользовательский интерфейс и выделенные блокчейн-среды для криптоприложений.

В общей документации Arbitrum описывается как инфраструктура для приложений, токенизации и специализированных сетей. Поэтому инструменты SDK важны как для разработчиков приложений, так и для операторов сетей.

Основной SDK обычно используют с Arbitrum One, Arbitrum Nova и пользовательскими сетями Arbitrum, построенными по модели основной и дочерней сетей.

В этой модели основная сеть обеспечивает расчеты, передачу сообщений или инфраструктурную поддержку, а дочерняя сеть Arbitrum получает активы, сообщения или запросы на выполнение операций.

Термины «основная сеть» и «дочерняя сеть» стали важнее в Arbitrum SDK v4: теперь SDK использует более универсальную терминологию, подходящую для сред Layer 2 и Layer 3.

В официальном руководстве по переходу на Arbitrum SDK v4 объясняется, что многие прежние упоминания L1 и L2 заменены терминами «основная сеть» и «дочерняя сеть», чтобы лучше соответствовать расширяющейся экосистеме Arbitrum.

Почему Arbitrum SDK важен

Arbitrum SDK важен, поскольку без надежных инструментов создавать безопасные кроссчейн-криптоприложения сложно.

Пользователю простой перевод через мост может казаться одной операцией, однако на практике он может включать подтверждения, шлюзы, контракты inbox, повторно исполняемые запросы (retryable tickets), проверку статуса, периоды оспаривания и выполнение через outbox.

SDK упрощает эту сложность, объединяя многие этапы в повторно используемые классы и методы.

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

Без SDK разработчикам пришлось бы напрямую взаимодействовать с контрактами моста и вручную обрабатывать множество особых случаев.

С SDK они могут сосредоточиться на пользовательском интерфейсе, безопасности транзакций, отображении баланса и логике приложения.

Основные функции Arbitrum SDK

Перевод активов между сетями

Одно из основных применений Arbitrum SDK — перевод активов между основной и дочерней сетью Arbitrum.

В SDK есть классы-мосты, такие как EthBridger и Erc20Bridger, для перемещения нативных активов и токенов ERC-20.

В официальном обзоре мостов Arbitrum объясняется, что перевод токенов и кроссчейн-обмен сообщениями — важные составляющие создания приложений в Arbitrum.

Когда пользователь вносит ETH или другой нативный токен в сеть Arbitrum, SDK помогает подготовить и отправить необходимую транзакцию.

При внесении токенов ERC-20 SDK может помочь одобрить шлюз, инициировать депозит и дождаться обработки транзакции в дочерней сети.

В официальном руководстве Arbitrum по внесению токенов показано, как использовать Erc20Bridger для одобрения шлюза и внесения токенов ERC-20.

Кроссчейн-сообщения

Arbitrum SDK также поддерживает кроссчейн-обмен сообщениями: смарт-контракт или приложение может передавать данные и инструкции между основной и дочерней сетями.

Кроссчейн-сообщения важны, поскольку многим криптоприложениям нужны не только переводы токенов.

Системе управления может потребоваться передать инструкции для выполнения, платежному приложению — запустить логику расчетов, а игре — синхронизировать состояние между сетями.

В официальном руководстве Arbitrum по кроссчейн-сообщениям @arbitrum/sdk описывается как библиотека TypeScript для перевода токенов и передачи сообщений между основными и дочерними сетями Arbitrum.

Типизированные интерфейсы SDK упрощают создание, тестирование и отслеживание таких сценариев передачи сообщений.

Отслеживание статуса транзакций

Arbitrum SDK помогает разработчикам отслеживать, находится ли кроссчейн-транзакция в ожидании, завершена ли она, завершилась ли ошибкой или готова ли к следующему этапу.

Это особенно полезно, поскольку у кроссчейн-операций часто больше одного этапа выполнения транзакции.

Депозит из основной сети в дочернюю может включать транзакцию в основной сети, а затем ее выполнение в дочерней сети.

Вывод из дочерней сети в основную может включать инициирование операции в дочерней сети, период оспаривания и окончательное выполнение в основной сети.

SDK позволяет разработчикам извлекать сообщения из квитанций о транзакциях и проверять их статус.

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

Настройка сети

Arbitrum SDK может определять сети Arbitrum и получать корректные параметры выбранной дочерней сети.

Это важно, поскольку в разных сетях Arbitrum могут отличаться идентификаторы сети, адреса мостов и шлюзов токенов, нативные токены и связи с сетями, обеспечивающими расчеты.

Правильная настройка сети снижает риск отправки транзакции в неверный контракт моста.

Она также помогает приложениям поддерживать несколько сетей Arbitrum без необходимости вручную прописывать каждый адрес.

Основные классы Arbitrum SDK

EthBridger

EthBridger используется, когда приложению нужно перевести ETH или нативный токен поддерживаемой сети Arbitrum между сетями.

С его помощью разработчики могут вносить активы из основной сети в дочернюю или инициировать вывод из дочерней сети в основную.

В официальном руководстве по депозитам ETH и сообщениям показано, как EthBridger упрощает внесение средств в дочернюю сеть Arbitrum.

Этот класс полезен для кошельков, платежных приложений и любых криптоинтерфейсов, которым нужно поддерживать перемещение нативных активов в Arbitrum.

Erc20Bridger

Erc20Bridger используется для внесения и вывода токенов ERC-20.

Он помогает обрабатывать подтверждения, взаимодействовать со шлюзом, отправлять транзакции депозита, инициировать вывод и отслеживать сообщения.

Перевод токенов ERC-20 сложнее перемещения нативных активов: токенам может потребоваться пройти через стандартные или пользовательские шлюзы либо использовать другую логику моста.

SDK упрощает процесс, предоставляя разработчикам единый интерфейс для многих распространенных операций с токенами через мост.

ParentToChildMessage

ParentToChildMessage представляет сообщение, отправленное из основной сети в дочернюю сеть Arbitrum.

Этот класс полезен, если приложению нужно отслеживать, было ли выполнено в дочерней сети внесение средств или повторно исполняемый запрос.

Сообщения из основной сети в дочернюю часто используются для внесения средств, вызова контрактов и кроссчейн-инструкций.

Они тесно связаны с повторно исполняемыми запросами (retryable tickets) — одним из основных механизмов надежной передачи сообщений в Arbitrum.

ChildToParentMessage

ChildToParentMessage представляет сообщение, отправленное из дочерней сети Arbitrum в основную.

Этот класс важен для вывода средств: перед выполнением сообщения в основной сети должно пройти время ожидания.

В официальном руководстве Arbitrum по выводу токенов указано, что для завершения вывода требуется примерно 6.4 дня из-за периода оспаривания.

Приложения могут использовать инструменты SDK для работы с сообщениями, чтобы показывать, ожидает ли вывод завершения, готов ли он к исполнению или уже завершен.

Повторно исполняемые запросы и Arbitrum SDK

Повторно исполняемые запросы (retryable tickets) — важная часть передачи сообщений из основной сети в дочернюю в Arbitrum.

Повторно исполняемый запрос — это механизм, с помощью которого транзакция в основной сети создает запрос на выполнение операции в дочерней сети.

В официальной документации Arbitrum по повторно исполняемым запросам объясняется, что этот механизм разделяет отправку запроса в основной сети и его выполнение в дочерней.

Такая архитектура полезна, поскольку выполнение кроссчейн-операции может зависеть от лимитов газа, расходов на отправку, комиссионных ставок, размера calldata и базовой комиссии дочерней сети.

Arbitrum SDK помогает оценивать параметры газа для повторно исполняемых запросов и подготавливать данные транзакции, необходимые для их создания.

Пользователь обычно не видит повторно исполняемые запросы: они скрыты интерфейсом моста или приложения.

Разработчикам же важно понимать этот механизм для создания надежных депозитов в Arbitrum и вызовов контрактов.

Arbitrum SDK v4 и поддержка основной и дочерней сетей

В Arbitrum SDK v4 появились изменения, улучшающие поддержку более гибких архитектур сетей Arbitrum.

Самое заметное изменение — переход от прежних обозначений L1 и L2 к терминам «основная сеть» и «дочерняя сеть».

Это важно, поскольку дочерняя сеть Arbitrum в зависимости от своей архитектуры может проводить расчеты в Ethereum, в другой сети Arbitrum или в сети с иной конфигурацией родительской сети.

В руководстве по переходу на версию v4 также отмечены изменения типов сетей, AssetBridger, Erc20Bridger и классов сообщений.

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

Это особенно важно для интерфейсов мостов, средств отслеживания выводов и приложений, поддерживающих несколько сетей Arbitrum.

Arbitrum SDK и Arbitrum Chain SDK: в чем разница

Arbitrum SDK и Arbitrum Chain SDK связаны между собой, но это разные инструменты.

Arbitrum SDK, который обычно устанавливают как @arbitrum/sdk, в основном используется для задач на уровне приложений: перевода активов между сетями, обмена сообщениями и получения данных о сетях Arbitrum.

Arbitrum Chain SDK, который обычно устанавливают как @arbitrum/chain-sdk, предназначен для создания, развертывания и настройки пользовательских сетей Arbitrum.

В официальном руководстве по развертыванию с помощью Arbitrum Chain SDK объясняется, как Chain SDK помогает создать новую сеть Arbitrum, подготавливая конфигурацию и параметры развертывания.

После развертывания сети Chain SDK также может помочь создать конфигурацию узла Nitro.

В официальном руководстве по настройке узла Arbitrum указано, что функция prepareNodeConfig может создать объект конфигурации JSON для узла Nitro.

Разницу можно запомнить так: Arbitrum SDK предназначен для приложений, использующих сети Arbitrum, а Arbitrum Chain SDK — для команд, которые запускают или обслуживают сети Arbitrum.

Как разработчикам установить Arbitrum SDK

Обычно разработчики устанавливают Arbitrum SDK через npm, используя название пакета @arbitrum/sdk.

Как правило, для этого используется команда npm install @arbitrum/sdk.

В зависимости от настроек проекта разработчики также могут использовать такие менеджеры пакетов, как yarn или pnpm.

После установки разработчик подключает SDK к провайдерам и подписантам, а также задает параметры основной и дочерней сетей.

Затем приложение использует классы SDK, такие как EthBridger, Erc20Bridger, ParentToChildMessage и ChildToParentMessage, чтобы реализовать нужный сценарий.

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

Примеры использования Arbitrum SDK

Перевод активов через кошелек

Криптокошелек может использовать Arbitrum SDK, чтобы пользователи могли переводить активы в сети Arbitrum и обратно.

Инструменты SDK для проверки статуса помогут кошельку показать, когда депозит поступил в дочернюю сеть или когда вывод готов к выполнению в основной сети.

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

Децентрализованные приложения

Децентрализованное приложение может использовать Arbitrum SDK, чтобы пользователь мог напрямую пополнить аккаунт в сети Arbitrum из основной сети.

Это полезно для DeFi-приложений, платежей, игр, NFT и проектов, работающих с реальными активами и стремящихся упростить начало работы.

Приложение может объединить перевод через мост, отслеживание статуса и вызовы смарт-контрактов в единый пошаговый сценарий.

Эмитенты токенов

Эмитент токена может использовать инструменты SDK и документацию по мостам Arbitrum, чтобы обеспечить перемещение токенов между основной и дочерней сетями.

Это может упростить использование токена в приложениях на базе Arbitrum.

Эмитентам токенов все равно следует внимательно изучить требования к шлюзам: для особого поведения пользовательского токена может потребоваться отдельная конфигурация моста.

Операторы сетей

Команды, запускающие пользовательские сети Arbitrum, могут использовать Arbitrum Chain SDK для подготовки параметров развертывания, настройки параметров роллапа и создания конфигурации узла.

После запуска сети они также могут использовать @arbitrum/sdk на уровне приложения.

Такое сочетание позволяет команде работать как с настройкой инфраструктуры, так и с пользовательскими сценариями приложения.

Преимущества Arbitrum SDK

• • Упрощает внесение и вывод токенов между основными и дочерними сетями.
  • Предоставляет типизированный доступ к смарт-контрактам мостов и обмена сообщениями.
  • Сокращает объем ручной обработки квитанций о кроссчейн-транзакциях.
  • Помогает разработчикам оценивать параметры и отслеживать выполнение повторно исполняемых запросов.
  • В версии SDK v4 поддерживает более гибкие связи между основными и дочерними сетями.
  • Улучшает пользовательский интерфейс приложений, помогая точно показывать ход транзакций.

Риски и рекомендации для разработчиков

Arbitrum SDK упрощает разработку, но не отменяет необходимости тщательно проверять безопасность.

Разработчики по-прежнему должны защищать приватные ключи, проверять адреса токенов и параметры сети, а также тестировать все сценарии работы мостов.

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

Пользователям также следует учитывать, что вывод средств из дочерней сети в основную может занять несколько дней из-за периода оспаривания.

Приложения должны четко сообщать об этом до того, как пользователь начнет вывод.

Разработчикам следует избегать неограниченных разрешений на использование токенов, если у продукта нет веских причин запрашивать их.

Кроме того, необходимо следить за обновлениями зависимостей: пакеты SDK могут содержать несовместимые изменения, особенно при переходе на новую основную версию.

Рекомендации по использованию Arbitrum SDK

Перед созданием рабочей интеграции разработчикам следует обратиться к официальной документации и официальному репозиторию на GitHub.

При обновлении SDK нужно использовать актуальную версию и изучать заметки о переходе с предыдущих версий.

До выпуска продукта следует в безопасной среде протестировать депозиты, выводы, сбои повторно исполняемых запросов, ручное погашение и выполнение через outbox.

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

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

Не следует скрывать сроки вывода: пользователям важно знать, когда средства станут доступны в основной сети.

Интерфейс должен объяснять комиссии, требования к газу и условия возврата средств до того, как пользователь подпишет транзакцию.

Часто задаваемые вопросы

Что такое Arbitrum SDK простыми словами?

Arbitrum SDK — набор инструментов для разработчиков, который помогает криптоприложениям переводить активы через мосты, отправлять сообщения и отслеживать транзакции в сетях Arbitrum.

Arbitrum SDK предназначен только для мостов токенов?

Нет. Arbitrum SDK часто используют для мостов токенов, но он также поддерживает кроссчейн-сообщения, настройку сети, обработку квитанций о транзакциях и отслеживание статуса сообщений.

На каком языке программирования работает Arbitrum SDK?

Основной пакет @arbitrum/sdk — это библиотека TypeScript, которую обычно используют в криптоприложениях на JavaScript и TypeScript.

Чем EthBridger отличается от Erc20Bridger?

EthBridger используется для перемещения ETH или нативных токенов, а Erc20Bridger — для внесения и вывода токенов ERC-20.

Почему вывод средств из Arbitrum занимает время?

Перед выполнением сообщения в основной сети для вывода из дочерней сети Arbitrum в основную должен пройти период оспаривания.

Позволяет ли Arbitrum SDK запускать новые сети Arbitrum?

Основной пакет @arbitrum/sdk предназначен преимущественно для работы мостов и сообщений на уровне приложений, а @arbitrum/chain-sdk используют для создания и настройки сетей Arbitrum.

Нужно ли пользователям устанавливать Arbitrum SDK?

Обычным пользователям не нужно устанавливать Arbitrum SDK: разработчики используют его в кошельках, мостах, панелях мониторинга и децентрализованных приложениях.

Где разработчикам найти официальные материалы по Arbitrum SDK?

Разработчики могут изучить официальный репозиторий SDK, страницу пакета в npm и документацию Arbitrum по кроссчейн-сообщениям.

Заключение

Arbitrum SDK — важный набор инструментов для разработчиков, создающих криптоприложения с использованием мостов Arbitrum, обмена сообщениями и кроссчейн-транзакций.

Он помогает взаимодействовать со сложными контрактами мостов с помощью более понятных классов TypeScript и вспомогательных методов.

К основным функциям относятся перевод нативных активов и токенов ERC-20 между сетями, передача сообщений из основной сети в дочернюю, отслеживание сообщений в обратном направлении, поддержка повторно исполняемых запросов и настройка сети.

Arbitrum SDK v4 особенно важен, поскольку отражает более широкую модель основной и дочерних сетей, используемую в современных развертываниях Arbitrum.

Для пользователей SDK может упростить работу с мостами и сделать отслеживание транзакций более понятным.

Для разработчиков он сокращает объем низкоуровневой работы по интеграции, но по-прежнему требует тщательного тестирования, проверки безопасности и четкой коммуникации с пользователями.

По мере того как Arbitrum продолжает поддерживать новые приложения и специализированные сетевые среды, Arbitrum SDK остается одним из основных инструментов для подключения криптопродуктов к экосистеме Arbitrum.