Infraestructura y herramientas
Pera Connect SDK 1.6.0 estrena la firma experimental con extensión de navegador de ARC-27
Radiografía del centro para desarrolladores de Pera: @perawallet/connect 1.6.0 añade la firma mediante extensión de ARC-27, de activación opcional, junto con la API pública de datos de ASA, las especificaciones del analizador de NFT y los enlaces profundos de la aplicación móvil.

La puerta de entrada para desarrolladores de la billetera predeterminada de Algorand
Cuando una aplicación web de Algorand pide al visitante que conecte una billetera, la que suele abrirse es Pera1. Pera nació como la billetera oficial de la red, cambió de marca en febrero de 2022 y sigue siendo la opción móvil por defecto: la aplicación para iOS acumula una media de 4.8 estrellas sobre 7,952 valoraciones, y el equipo anunció el 11 de agosto una reconstrucción desde cero de ambas aplicaciones sobre una única base de código en React Native. Doce días antes de ese anuncio, el mismo equipo publicó la versión 1.6.0 de @perawallet/connect2, el SDK de JavaScript que permite a las aplicaciones web comunicarse con la billetera. La novedad estrella de la versión —solicitudes de firma a través de una extensión de navegador, estandarizadas como ARC-27— es deliberadamente conservadora: llega detrás de un indicador experimental desactivado por defecto.
El SDK ocupa el centro del centro de documentación técnica de Pera3, que organiza cuatro superficies de integración para desarrolladores externos. Cada una permite a un proyecto aprovechar infraestructura que Pera ya opera para sus propios productos en lugar de construirla desde cero.
| Superficie de integración | Qué abarca | Implicación en la práctica |
|---|---|---|
| Pera Connect SDK | Una biblioteca de JavaScript que conecta aplicaciones web con Pera Wallet | El código que hay detrás de la mayoría de los botones «Conectar billetera» de las dApps de Algorand |
| API pública | Endpoints que devuelven metadatos y etiquetas de verificación de cualquier Algorand Standard Asset | Las aplicaciones muestran nombres de tokens, logotipos, precios y los sellos de confianza de Pera sin necesidad de operar su propio indexador |
| Especificaciones del analizador de NFT | Cómo el pipeline de Pera descubre, obtiene y clasifica NFT a escala | Las billeteras y los exploradores representan los archivos multimedia y los atributos de los coleccionables sin que cada proyecto tenga que escribir su propio analizador |
| Esquemas de URL de la aplicación móvil | Enlaces profundos perawallet:// que aceptan las aplicaciones de iOS y Android | Cualquier página puede lanzar Pera directamente a un flujo de envío, de adhesión a un activo o de cuenta de observación |
Qué añade realmente la 1.6.0
Pera Connect funciona sobre el protocolo WalletConnect, que permite a una aplicación web conectarse a una billetera escaneando un código QR; así la aplicación puede leer la dirección de la billetera y solicitar transacciones firmadas sin custodiar nunca las claves privadas. Los métodos principales del SDK son pocos: connect() devuelve las direcciones de las cuentas; signTransaction() firma transacciones sueltas o grupos atómicos —conjuntos que se confirman todos o ninguno—; y signData() firma bytes arbitrarios para flujos de autenticación e identidad.
La versión 1.6.0, publicada el 30 de julio, añade una segunda vía de firma: ARC-27, el estándar de Algorand que permite a una billetera en forma de extensión de navegador responder directamente a las solicitudes de una dApp, sin el ida y vuelta del código QR. Como el soporte está condicionado por un indicador experimental que por defecto vale false, nada cambia para las integraciones existentes salvo que el desarrollador lo active. Una vez habilitado, la ventana de conexión incluye la opción «Conectar con la extensión de Pera», detecta automáticamente si hay instalada una extensión compatible mediante un intercambio de descubrimiento ARC-27 y, si no encuentra ninguna, recurre al código QR o a Pera Web. La vía de la extensión admite la firma de datos conforme a ARC-60 —con el dominio solicitante comprobado contra el origen de la página—, pero no la firma heredada de datos arbitrarios, que lanza un error de operación no admitida. La misma versión incluía una tanda de correcciones de conformidad con la especificación ARC-60, y la etiqueta beta de npm ya alberga una 1.6.1-beta.0.
El paquete registró 46,854 descargas en el último mes, 11,724 de ellas en la última semana, y otros 46 paquetes registrados en npm dependen de él. El repositorio de GitHub4 acumula 70✓1 estrellas y recibió su última actualización el 14 de agosto, con correcciones para un flujo de firma en Safari de iOS y para errores de signData mal etiquetados: un ritmo de mantenimiento que va a la par del de la propia billetera, ya que la dApp de ejemplo5 que mantiene el equipo pone a prueba más de cien escenarios de firma, desde pagos individuales hasta lotes de 1,000✓2 transacciones.
El resto del centro de documentación: datos, coleccionables y enlaces profundos
Las otras tres superficies cubren lo que una dApp necesita en torno al propio flujo de firma. La API pública, servida desde mainnet.api.perawallet.app, devuelve los metadatos de cualquier ASA de la red —nombre, nombre de unidad, decimales, suministro total, creador, logotipo y valor en USD— además de un nivel de verificación: trusted, verified, unverified o suspicious, con las respuestas en caché durante cinco minutos. Los endpoints específicos de activos verificados y de activos etiquetados devuelven listas autorizadas en una sola respuesta, y la documentación enlaza una interfaz Swagger y una especificación OpenAPI descargable. Hay dos advertencias: un aviso de obsolescencia de 2024 trasladó los endpoints a la ruta /v1/public/ con redirecciones desde el 1 de agosto de ese año, y los requisitos de uso de la API son obligaciones de marca: quien la utilice debe mostrar «Data provided by Pera» junto con el logotipo de Pera, exhibir los sellos Verified y Suspicious al lado de cada ASA y enlazar a la página del ASA en Pera Explorer con una llamada a la acción visible de «View on Pera Explorer».
La especificación del analizador de NFT explica cómo Pera llena su base de datos de coleccionables: una tarea en ejecución continua recorre cada activo, obtiene sus metadatos y sus archivos multimedia a través de una pasarela IPFS dedicada y clasifica un objeto JSON como NFT ARC3 (metadatos) y una imagen o un vídeo como NFT ARC69 (contenido multimedia). Los metadatos de ARC69 son mutables, así que el pipeline los vuelve a analizar en cada pasada a partir de la última transacción de configuración del activo, mientras que el contenido multimedia de ARC3 se descarga una sola vez y se guarda en caché; los archivos de más de 100 MB se ignoran y las descargas fallidas se reintentan tres veces. Los esquemas de URL de la aplicación móvil completan el conjunto con enlaces perawallet:// que abren la aplicación directamente en una acción concreta —añadir una cuenta de observación, adherirse a un activo o prerrellenar una transferencia de ALGO o de un ASA con una nota—, con los importes expresados en microalgos.
Las contrapartidas que hereda el desarrollador
Lo que la documentación no pone en primer plano es hasta qué punto estas superficies atan un proyecto a un único proveedor. El esquema de enlaces profundos solo abre Pera, la ventana de conexión lleva la marca de Pera y las condiciones de la API pública obligan a mostrar el logotipo y los sellos de Pera en lugar de presentar los datos de forma neutra; y esos sellos son una selección de la propia Pera, no un registro independiente, ya que sus condiciones especifican que un sello no constituye un aval. Ni la documentación ni las notas de la versión citan una auditoría de seguridad externa del SDK, de modo que los equipos que lo adoptan dependen de la ingeniería y la trayectoria de Pera. Esa trayectoria es real —la reconstrucción 7.0 de la billetera y el ciclo mensual de versiones del SDK demuestran un mantenimiento activo—, pero también significa que Pera, como billetera predeterminada del ecosistema, tiene un interés comercial en cada integración que impulsa. Para los equipos que quieran distancia hay dos atenuantes: el README apunta al envoltorio use-wallet6, independiente de la billetera, para dar soporte a varias billeteras, y las preguntas de los desarrolladores van a parar al canal #dev-support del Discord de Pera.
El indicador experimental es la advertencia honesta: Pera apunta una dirección con ARC-27 en lugar de prometer una historia cerrada de extensión, y el requisito de activación voluntaria implica que los primeros en adoptarlo están probando, no dependiendo. Para un equipo que no tenga inconveniente en convertir Pera en su infraestructura de billetera, el SDK es el camino más rápido de cero a un botón «Conectar billetera» funcional; para quien prefiera mantenerse neutral en el panorama de billeteras de Algorand, las capas envolventes ofrecen una vía de escape. En cualquier caso, el centro de documentación es ahora el mapa más claro de adónde pretende llevar la billetera predeterminada la experiencia de desarrollo del ecosistema.
Fuentes
- Documentación de Pera Wallet3
- @perawallet/connect en npm2
- perawallet/connect en GitHub4
- dApp de ejemplo de Pera Wallet5
- docs.perawallet.app7
- docs.perawallet.app8
- Pera Connect | Documentación de Pera Wallet9
- Especificaciones del analizador de NFT | Documentación de Pera Wallet10
- Esquemas de URL de la aplicación móvil | Documentación de Pera Wallet11
- raw.githubusercontent.com12
- raw.githubusercontent.com13
- Pera Algorand Explorer14
- docs.perawallet.app15
- raw.githubusercontent.com16
- Introducción | Documentación de Pera Wallet17
- https://registry.npmjs.org/@perawallet/connect18
2 cifras de esta historia están verificadas.Ver todas las comprobaciones
Fuentes
- 1Pera perawallet.app↩
- 2@perawallet/connect npmjs.com↩
- 3centro de documentación técnica de Pera docs.perawallet.app↩
- 4repositorio de GitHub github.com↩
- 5dApp de ejemplo 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 | Documentación de Pera Wallet docs.perawallet.app↩
- 10Especificaciones del analizador de NFT | Documentación de Pera Wallet docs.perawallet.app↩
- 11Esquemas de URL de la aplicación móvil | Documentación de 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↩
- 17Introducción | Documentación de Pera Wallet docs.perawallet.app↩
- 18registry.npmjs.org/@perawallet/connect registry.npmjs.org↩