Pera Connect SDK 1.6.0 получил экспериментальную подпись через браузерное расширение по стандарту ARC-27
Профиль центра для разработчиков Pera: @perawallet/connect 1.6.0 добавляет опциональную подпись через расширение по ARC-27, а рядом — публичный API данных об ASA, спецификации парсера NFT и мобильные deep links.

Парадный вход для разработчиков в кошелёк Algorand по умолчанию
Когда веб-приложение в сети Algorand предлагает посетителю подключить кошелёк, обычно открывается кошелёк Pera1. Pera вышел как официальный кошелёк сети, в феврале 2022 года сменил бренд и по-прежнему остаётся выбором по умолчанию на мобильных: средняя оценка приложения для iOS — 4,8 звезды по 7,952 оценкам, а 11 августа команда объявила о полной переработке обоих приложений на единой кодовой базе React Native. За двенадцать дней до этого та же команда выпустила версию 1.6.0 @perawallet/connect2 — JavaScript SDK, который позволяет веб-приложениям общаться с кошельком. Главное новшество релиза — запросы на подпись через браузерное расширение, стандартизованные как ARC-27, — намеренно консервативно: оно поставляется за экспериментальным флагом, выключенным по умолчанию.
SDK занимает центральное место в хабе технической документации Pera3, где собраны четыре направления интеграции для сторонних разработчиков. Каждое из них позволяет проекту взять инфраструктуру, которую Pera уже поддерживает для своих продуктов, вместо того чтобы строить её с нуля.
| Направление интеграции | Что охватывает | Что это даёт на практике |
|---|---|---|
| Pera Connect SDK | JavaScript-библиотека, связывающая веб-приложения с кошельком Pera | Код, стоящий за большинством кнопок «Подключить кошелёк» в dApp на Algorand |
| Public API | Эндпоинты, возвращающие метаданные и метки верификации для любого Algorand Standard Asset | Приложения показывают названия токенов, логотипы, цены и знаки доверия Pera, не запуская собственный индексер |
| NFT Parser Specs | Как конвейер Pera находит, загружает и классифицирует NFT в масштабе | Кошельки и обозреватели отображают медиа и свойства коллекционных предметов, не требуя от каждого проекта собственного парсера |
| Mobile App URL Schemes | Deep links perawallet://, которые принимают приложения для iOS и Android | Любая страница может запустить Pera сразу на отправке, подключении актива или добавлении отслеживаемого аккаунта |
Что именно добавляет версия 1.6.0
Pera Connect работает по протоколу WalletConnect: он позволяет веб-приложению подключиться к кошельку через сканирование QR-кода, чтобы приложение могло прочитать адрес кошелька и запрашивать подписанные транзакции, никогда не получая доступа к приватным ключам. Основных методов в SDK немного: connect() возвращает адреса аккаунтов, signTransaction() подписывает отдельные транзакции или атомарные группы — наборы, которые должны пройти целиком или не пройти вовсе, — а signData() подписывает произвольные байты для аутентификации и сценариев идентификации.
Версия 1.6.0, вышедшая 30 июля, добавляет второй транспорт для подписи: ARC-27 — стандарт Algorand, позволяющий кошельку-браузерному расширению отвечать на запросы dApp напрямую, минуя обмен через QR-код. Поскольку поддержка спрятана за экспериментальным флагом со значением false по умолчанию, для существующих интеграций ничего не меняется, пока разработчик сам не включит её. После включения в окне подключения появляется пункт «Connect with Pera Extension», совместимое установленное расширение определяется автоматически через обмен discover по ARC-27, а если расширения нет, происходит откат к QR-коду или Pera Web. Путь через расширение поддерживает подпись данных по ARC-60 — при этом домен запрашивающей стороны сверяется с origin страницы — но не старую подпись произвольных данных, при попытке которой возникает ошибка о неподдерживаемой операции. В том же релизе вышел набор исправлений для соответствия спецификации ARC-60, а на npm под тегом beta теперь лежит 1.6.1-beta.0.
За последний месяц пакет скачали 46,854 раза, из них 11,724 — за последнюю неделю, и от него зависят 46 других зарегистрированных пакетов npm. Репозиторий на GitHub4 собрал 70✓1 звёзд, а последний push датирован 14 августа — с исправлениями для сценария подписи в iOS Safari и для неверно помеченных ошибок signData. Такой темп сопровождения соответствует самому кошельку: пример dApp5, который поддерживает команда, прогоняет более сотни сценариев подписи — от единичных платежей до пакетов из 1,000✓2 транзакций.
Остальная часть хаба: данные, коллекционные предметы, deep links
Три других направления закрывают то, что нужно dApp вокруг самого процесса подписи. Публичный API, отдаваемый с mainnet.api.perawallet.app, возвращает метаданные для любого ASA в сети — название, имя единицы, число десятичных знаков, общий выпуск, создателя, логотип и стоимость в долларах США, — а вместе с ними уровень верификации: trusted, verified, unverified или suspicious. Ответы кэшируются на пять минут. Отдельные эндпоинты verified-assets и labeled-assets возвращают списки разрешённых активов одним ответом, а в документации есть ссылки на Swagger UI и загружаемую спецификацию OpenAPI. Есть две оговорки: уведомление об устаревании, датированное 2024 годом, перенесло эндпоинты в путь /v1/public/ с перенаправлениями с 1 августа того же года; а требования к использованию API — это обязательства по брендингу. Лицензиат должен показывать надпись «Data provided by Pera» с логотипом Pera, размещать знаки Verified и Suspicious рядом с каждым ASA и вести ссылку на страницу этого ASA в Pera Explorer с видимым призывом к действию «View on Pera Explorer».
Спецификация парсера NFT объясняет, как Pera наполняет свою базу коллекционных предметов: непрерывно работающая задача перебирает все активы, загружая метаданные и медиа через отдельный шлюз IPFS, и относит объект JSON к NFT стандарта ARC3 (метаданные), а изображение или видео — к NFT стандарта ARC69 (медиа). Метаданные ARC69 изменяемы, поэтому конвейер при каждом проходе разбирает их заново из последней конфигурационной транзакции актива, а медиа ARC3 загружается один раз и кэшируется. Файлы размером более 100 МБ игнорируются, а неудачные загрузки повторяются трижды. Завершают набор мобильные URL-схемы: ссылки perawallet:// открывают приложение сразу на нужном действии — добавить отслеживаемый аккаунт, подключить актив или заранее заполнить перевод ALGO либо ASA с примечанием. Суммы при этом указываются в микроалго.
Компромиссы, которые достаются разработчику
Документация не выставляет напоказ то, насколько прочно эти направления привязывают проект к одному поставщику. Схема deep links открывает только Pera, окно подключения несёт бренд Pera, а условия Публичного API требуют показывать логотип и знаки Pera вместо нейтральной подачи данных. Причём эти знаки — собственная оценка Pera, а не независимый реестр: в условиях прямо сказано, что знак не является одобрением. Ни документация, ни примечания к релизу не упоминают независимый аудит безопасности SDK, так что команды, выбирающие его, полагаются на инженерную культуру и репутацию Pera. Эта репутация реальна: переработка кошелька до версии 7.0 и ежемесячный цикл релизов SDK говорят о активной поддержке. Но из этого следует и другое: Pera как кошелёк по умолчанию в экосистеме имеет коммерческий интерес в каждой интеграции, которую обслуживает. Для команд, которые хотят дистанции, есть два обходных пути: в README указана use-wallet6 — обёртка, не привязанная к конкретному кошельку и поддерживающая несколько кошельков, а вопросы разработчиков попадают в канал #dev-support в Discord-сервере Pera.
Экспериментальный флаг — честная оговорка: через ARC-27 Pera обозначает направление, а не обещает законченную историю с расширением, и добровольное включение означает, что ранние пользователи тестируют, а не зависят. Для команды, готовой сделать кошелёк Pera своей кошелёк-инфраструктурой, SDK — самый короткий путь от нуля до работающей кнопки «Подключить кошелёк». Для той, что хочет сохранять нейтральность среди кошельков Algorand, обёртки дают путь к отступлению. Как бы то ни было, хаб документации сегодня — самая ясная карта того, куда кошелёк по умолчанию намерен вести опыт разработчиков в экосистеме.
Источники
- Документация Pera Wallet3
- @perawallet/connect в npm2
- perawallet/connect на GitHub4
- Пример dApp для Pera Wallet5
- docs.perawallet.app7
- docs.perawallet.app8
- Pera Connect | Документация Pera Wallet9
- NFT Parser Specs | Документация Pera Wallet10
- Mobile App URL Schemes | Документация Pera Wallet11
- raw.githubusercontent.com12
- raw.githubusercontent.com13
- Pera Algorand Explorer14
- docs.perawallet.app15
- raw.githubusercontent.com16
- Introduction | Документация Pera Wallet17
- https://registry.npmjs.org/@perawallet/connect18
2 цифры в этом материале проверены.Все проверки
Источники
- 1кошелёк Pera perawallet.app↩
- 2@perawallet/connect npmjs.com↩
- 3хабе технической документации Pera docs.perawallet.app↩
- 4Репозиторий на GitHub github.com↩
- 5пример dApp perawallet.github.io↩
- 6use-wallet github.com↩
- 7docs.perawallet.app/llms.txt docs.perawallet.app↩
- 8docs.perawallet.app/llms-full.txt docs.perawallet.app↩
- 9Pera Connect | Документация Pera Wallet docs.perawallet.app↩
- 10NFT Parser Specs | Документация Pera Wallet docs.perawallet.app↩
- 11Mobile App URL Schemes | Документация Pera Wallet docs.perawallet.app↩
- 12raw.githubusercontent.com/algorandfoundation/ARCs/main/ARCs/arc-0027.md raw.githubusercontent.com↩
- 13raw.githubusercontent.com/perawallet/connect/main/README.md raw.githubusercontent.com↩
- 14Pera Algorand Explorer explorer.perawallet.app↩
- 15docs.perawallet.app/llms-small.txt docs.perawallet.app↩
- 16raw.githubusercontent.com/algorandfoundation/ARCs/main/ARCs/arc-0060.md raw.githubusercontent.com↩
- 17Introduction | Документация Pera Wallet docs.perawallet.app↩
- 18registry.npmjs.org/@perawallet/connect registry.npmjs.org↩