Pera Connect SDK 1.6.0 发布实验性 ARC-27 浏览器扩展签名功能
@perawallet/connect 1.6.0 新增可选启用的 ARC-27 扩展签名,与 Pera 的公开 ASA 数据 API、NFT 解析规范和移动端深度链接一同构成其开发者文档中心的四大入口。

Algorand 默认钱包的开发者入口
当 Algorand 上的网页应用请访客连接钱包时,弹出的通常是 Pera1。Pera 以该网络官方钱包的身份上线,2022 年 2 月完成品牌重塑,至今仍是移动端的默认选择——其 iOS 应用在 7,952 条评分中平均拿到 4.8 星;团队于 8 月 11 日宣布,将把两款应用基于同一套 React Native 代码库彻底重写。而就在这一消息发布的 12 天前,同一团队推出了 @perawallet/connect2 的 1.6.0 版本——这个 JavaScript SDK 让网页应用得以与钱包通信。此次发布最受关注的新增能力,即通过浏览器扩展发起签名请求(已标准化为 ARC-27),态度却相当克制:它被放在一个默认关闭的实验性开关之后。
这个 SDK 处于 Pera 技术文档中心3 的核心位置。文档中心为第三方开发者梳理出四类集成入口,每一类都让项目可以直接借用 Pera 为自家产品已经跑起来的基础设施,而不必从头自建。
| 集成入口 | 涵盖内容 | 实际影响 |
|---|---|---|
| Pera Connect SDK | 连接网页应用与 Pera Wallet 的 JavaScript 库 | Algorand dApp 上多数“连接钱包”按钮背后的代码 |
| 公开 API | 返回任意 Algorand 标准资产 元数据与验证标签的接口 | 应用无需自建 索引器,即可显示代币名称、标识、价格和 Pera 的信任徽章 |
| NFT 解析规范 | Pera 的流水线如何大规模发现、获取并归类 NFT | 钱包和区块浏览器无需各自编写解析器,即可渲染藏品媒体与属性 |
| 移动应用 URL Scheme | iOS 与 Android 应用接受的 perawallet:// 深度链接 | 任何页面都能直接唤起 Pera,进入转账、资产选择加入或观察账户流程 |
1.6.0 究竟新增了什么
Pera Connect 基于 WalletConnect 协议运行:网页应用扫描二维码即可连接钱包,从而读取钱包地址并请求已签名的交易,全程不接触私钥。SDK 的核心方法很少:connect() 返回账户地址,signTransaction() 用于签署单笔交易或原子组(即要么全部成交、要么全部不成交的一组交易),signData() 则对任意字节数据签名,服务于身份认证与身份相关流程。
7 月 30 日发布的 1.6.0 版本为签名新增了第二条传输通道:ARC-27。这项 Algorand 标准允许浏览器扩展钱包直接响应 dApp 的请求,省去二维码往返。由于该功能由默认值为 false 的实验性开关控制,除非开发者主动开启,现有集成不会有任何变化。开启之后,连接弹窗会列出“使用 Pera 扩展连接”选项,通过一次 ARC-27 发现往返自动探测已安装的兼容扩展,若未找到则回退到二维码或 Pera Web。扩展路径支持 ARC-60 数据签名——请求域名会与页面来源进行校验——但不支持旧的任意数据签名,后者会抛出“不支持的操作”错误。同一版本还包含一批 ARC-60 规范合规性修复,目前 npm 的 beta 标签上已经出现了 1.6.1-beta.0。
过去一个月,该包录得 46,854 次下载,其中 11,724 次发生在最近一周,另有 46 个已注册的 npm 包依赖它。GitHub 仓库4 收获 70✓1 颗星,最近一次推送在 8 月 14 日,修复了 iOS Safari 签名流程和 signData 错误信息标注有误的问题——这样的维护节奏与钱包本身一致:团队维护的示例 dApp5 覆盖了 100 多种签名场景,从单笔支付到 1,000✓2 笔交易的批量打包。
文档中心的其他部分:数据、藏品与深度链接
另外三类入口解决的,是 dApp 在签名流程之外的需求。公开 API 由 mainnet.api.perawallet.app 提供服务,可返回网络上任意 ASA 的元数据——名称、单位名称、小数位、总供应量、创建者、标识、美元价值——以及 trusted、verified、unverified 或 suspicious 的验证等级,响应缓存 5 分钟。专门的 verified-assets 与 labeled-assets 接口可在单次响应中返回白名单,文档还提供了 Swagger UI 和可下载的 OpenAPI 规范。有两点需要留意:一份 2024 年的弃用通知把接口迁移到 /v1/public/ 路径,并从当年 8 月 1 日起设置重定向;此外,该 API 的使用要求实为品牌义务——被许可方必须标注“Data provided by Pera”并附上 Pera 标识,在每个 ASA 旁边显示 Verified 与 Suspicious 徽章,并链接到该 ASA 的 Pera Explorer 页面,配以醒目的“View on Pera Explorer”行动号召。
NFT 解析规范说明了 Pera 如何填充其藏品数据库:一个持续运行的任务会遍历每一个资产,通过专用 IPFS 网关获取元数据与媒体文件,把 JSON 对象归类为 ARC3 NFT(元数据),把图片或视频归类为 ARC69 NFT(媒体)。ARC69 的元数据可变,因此流水线每一轮都会从该资产最新的配置交易中重新解析;ARC3 的媒体则只获取一次并缓存。超过 100 MB 的文件会被忽略,获取失败会重试三次。移动端 URL Scheme 补齐了这套体系,通过 perawallet:// 链接直接打开应用并进入特定操作——添加观察账户、选择加入某个资产,或预填一笔带备注的 ALGO 或 ASA 转账——金额以微 algos 表示。
开发者要一并继承的取舍
文档没有着重说明的,是这些入口在多大程度上把一个项目绑定在单一供应商身上。深度链接方案只能打开 Pera,连接弹窗带有 Pera 品牌,公开 API 的条款要求展示 Pera 的标识和徽章,而不是中立地呈现数据——而且这些徽章是 Pera 自己的筛选结果,并非独立记录,其条款明确表示徽章不代表背书。无论文档还是发布说明,都没有提到 SDK 经过第三方安全审计,因此采用它的团队实际上是在信任 Pera 的工程能力与过往记录。这份记录确实存在——钱包的 7.0 重写和 SDK 的每月发布节奏都显示出活跃的维护——但这也意味着,作为生态默认钱包的 Pera,对其支撑的每一次集成都存在商业利益。希望保持距离的团队有两种缓解办法:README 推荐了钱包无关的 use-wallet6 封装以支持多钱包,开发者提问则汇集在 Pera Discord 的 #dev-support 频道。
实验性开关本身就是最诚实的说明:Pera 是用 ARC-27 表明方向,而不是承诺一套成熟的扩展方案;可选启用的门槛也意味着早期采用者是在测试,而不是在依赖。对于愿意把钱包基础设施交给 Pera 的团队,这个 SDK 是从零到可用“连接钱包”按钮的最快路径;对于希望在 Algorand 钱包阵营中保持中立的团队,封装层则提供了退出通道。无论如何,这个文档中心如今最清晰地描绘出:这款默认钱包打算把生态的开发者体验带向何方。
来源
- Pera Wallet 文档3
- npm 上的 @perawallet/connect2
- GitHub 上的 perawallet/connect4
- Pera Wallet 示例 dApp5
- docs.perawallet.app7
- docs.perawallet.app8
- Pera Connect | Pera Wallet 文档9
- NFT 解析规范 | Pera Wallet 文档10
- 移动应用 URL Scheme | Pera Wallet 文档11
- raw.githubusercontent.com12
- raw.githubusercontent.com13
- Pera Algorand Explorer14
- docs.perawallet.app15
- raw.githubusercontent.com16
- 简介 | Pera Wallet 文档17
- https://registry.npmjs.org/@perawallet/connect18
本文已核查 2 个数字。查看全部核查
来源
- 1Pera perawallet.app↩
- 2@perawallet/connect npmjs.com↩
- 3Pera 技术文档中心 docs.perawallet.app↩
- 4GitHub 仓库 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 解析规范 | Pera Wallet 文档 docs.perawallet.app↩
- 11移动应用 URL Scheme | 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↩
- 17简介 | Pera Wallet 文档 docs.perawallet.app↩
- 18registry.npmjs.org/@perawallet/connect registry.npmjs.org↩