El widget de swap de Pera lleva una caja de intercambio funcional dentro de otras aplicaciones de Algorand

Una caja de intercambio que no sale de la aplicación

El Pera Swap Widget es una caja de intercambio que una aplicación de Algorand puede colocar dentro de sus propias pantallas: el visitante conecta una billetera, elige dos activos, consulta una tasa y firma, todo sin abandonar la página. Detrás está P.E.R.A., el motor de enrutamiento que Pera Wallet¹ utiliza para los swaps de su propia aplicación y que ahora se ofrece a desarrolladores externos como un paquete que pueden integrar entero o invocar como API mientras diseñan su propia interfaz.

Dos formas de adoptarlo. La más rápida es un iframe que apunta al widget alojado de Pera², configurado a través de su URL: red, tema, el activo de entrada (ALGO salvo que se indique lo contrario) y el de salida (USDC por defecto). La más completa consiste en construir tu propia pantalla de swap sobre la API de swap; el README³ del paquete plantea la elección como integrar el widget 'en un iframe, firmando opcionalmente las transacciones con tu propia billetera⁴', o construir 'tu propia interfaz de swap sobre la Pera Swap API (cotizaciones, transacciones, activos)'.

La firma es lo que determina dónde reside la billetera. Con la firma desde la página anfitriona activada, el widget no abre ninguna conexión de billetera propia y pide a la página anfitriona que firme en su lugar; el README indica que la API de Pera ya ha firmado las transacciones que no proceden de la cuenta del usuario, de modo que la página anfitriona devuelve únicamente sus propias firmas.

El enrutamiento, en este planteamiento, pasa a ser una función que una aplicación invoca en lugar de un lugar que el usuario visita. La aplicación nunca se convierte en un exchange ni custodia el activo que se negocia; solo necesita ser el lugar donde el usuario ya está. El patrón se repite allí donde un servicio on-chain consiste sobre todo en enrutamiento, y convierte en cliente al desarrollador que está al otro lado.

Probarlo, y lo que exige al usuario

Los desarrolladores empiezan en un sitio de demostración⁵ que recorre cuatro formas de conexión: generar una URL de widget, construir el iframe en código, llamar directamente a la API de swap o delegar la firma en la página anfitriona. Las cotizaciones pueden solicitarse sin tener nada, pero preparar una operación requiere una cuenta con fondos: al pedir transacciones contra una dirección sin ALGO se obtuvo 'Algo balance is insufficient' y no se generó nada.

Un usuario corriente no instala nada. Se encuentra la caja dentro de la aplicación que la haya integrado, conecta una billetera y opera. Si el token que compra es nuevo para su cuenta, la billetera le pide que lo habilite como parte del swap.

Cuánto cuesta un swap y qué dice la línea de comisión

El centro de ayuda⁶ de Pera indica que la billetera cobra una comisión de hasta 1⁷% en los swaps, calculada sobre el valor del activo de origen y mostrada como Pera Fee en la pantalla de cotización antes de firmar. La misma página sitúa la comisión propia del pool del venue en un habitual 0,25⁸–0,3%, que según dice va a parar a los proveedores de liquidez; esa tasa es una convención de cada pool y no algo que fije la red, y varía según el venue. El mínimo fijo de Algorand es de 0,001 ALGO por transacción; la página de Pera sitúa la comisión de red por debajo de 0,01⁹ $ y señala que se aplica tanto si el swap sale bien como si falla, y que un solo swap puede ser varias transacciones de un mismo grupo.

En qué activo se cuenta la línea de comisión cambia su significado. La pantalla de revisión del propio widget muestra Pera Fee con la unidad ALGO, dividiendo el importe bruto entre un millón para obtenerla.

El panel de la demostración etiqueta esa misma cifra de otra manera. Sus cotizaciones del 5 de noviembre arrojaban una Pera Fee de 0,01 en un swap de 1 ALGO que devolvía 0,097522 USDC, y una Pera Fee de 1,00 en un swap de 100 ALGO que devolvía 9,748322 USDC, ambas etiquetadas como USDC. El código de ejemplo que hay detrás de ese panel formatea la comisión con los decimales y el nombre de unidad del activo de salida, y de ahí viene la etiqueta USDC. La cifra es el 1% de lo que el usuario aportó en ambos casos —0,01 de 1 ALGO, 1,00 de 100 ALGO—, mientras que leída como USDC equivaldría a alrededor de una décima parte de la operación, fuera del hasta 1% que describe la página de Pera. Así que la etiqueta ALGO del widget es la que coincide con la comisión publicada, y la etiqueta USDC de la demostración se lee como un desliz de formato en un ejemplo; lo que imprima una interfaz construida a mano depende de quien la construya.

Los venues que hay detrás de una tasa

El centro de ayuda¹⁰ de Pera nombra cuatro plataformas detrás del agregador: Vestige, Tinyman, Folks Finance y Deflex (TxnLabs). El paquete distribuido define tres nombres de proveedor que quien llama puede solicitar —tinyman, tinyman-swap-router y vestige-v4— y ningún valor para Folks Finance ni Deflex. Un desarrollador que lee la descripción del producto espera cuatro venues; el código acepta tres.

Quién lo construye y cómo va

Pera Wallet es un producto de Pera Wallet, Lda, y se describe como no custodial y autoalojado: las claves y los activos permanecen en el dispositivo del usuario, y la empresa afirma que no almacena ni recupera frases de recuperación. Nació como la Algorand Wallet oficial y cambió de marca en febrero de 2022, lanzó en agosto una reconstrucción completa 7.0¹¹ de sus aplicaciones móviles (esa historia) y en enero sustituyó su antigua on-ramp por un flujo de financiación nativo de la billetera, Pera Fund.

La API para desarrolladores se anunció en el blog de Pera¹² el 9 de octubre de 2025, donde se describe P.E.R.A. como el Pera Ecosystem Routing Aggregator y se ofrecen el paquete npm y una aplicación de demostración. El paquete¹³ llevaba en npm desde el 14 de agosto de 2025; 1.0.0¹⁴-beta.5, la versión actual, se publicó el 28 de octubre de 2026, aproximadamente un año después de la versión anterior. Se descargó 466 veces¹⁵ en los treinta días previos al 4 de noviembre, y el repositorio³ muestra cuatro estrellas, con el último push el 2 de noviembre. Las descargas contabilizan instalaciones automatizadas y réplicas igual de fácil que personas, así que ninguna de las dos cifras mide cuántas aplicaciones llevan la caja.

La entrada de lanzamiento también promete a los integradores 'Stable fee revenue — Earn swap fees in USDC or any preferred stable asset¹⁶'. Cómo se fija, se reparte o se cobra ese ingreso no aparece en ninguno de los materiales publicados en torno al paquete: el único control del cliente para ello es una URL de referrer opcional, documentada a efectos de atribución. Puede que se gestione en el servidor o mediante un campo que el README no muestra.

La alternativa es el Swap Widget propio de Tinyman¹⁷, documentado y mantenido por el equipo central de Tinyman, que enruta los swaps a través del Tinyman Swap Router: el router de un solo venue en lugar de un recorrido por varios.

Qué puede salir mal

Los términos de Pera sitúan la operación en manos de otro: afirman que Pera 'no opera, controla, ejecuta ni liquida transacciones de swap¹⁸' y que el precio, la ejecución y el enrutamiento proceden únicamente de un proveedor externo, de modo que una ejecución que salga mal es un asunto entre el usuario y el venue que la ejecutó. La línea de comisión es aparte: el cargo propio del widget, que el centro de ayuda de Pera sitúa en hasta 1¹⁹% para financiar el desarrollo y el mantenimiento de la billetera, se aplica por encima de la parte del pool.

Los términos también nombran a Estados Unidos, Canadá, China e Israel entre los lugares donde operar con ALGO puede estar prohibido, y se reservan el derecho a bloquear el acceso por territorio. Distribuir el widget a usuarios de esos países es una decisión que el desarrollador toma con esa página delante.

Un swap confirmado queda liquidado. Si se ejecuta a una tasa peor que la que mostraba la pantalla, dentro del slippage que el usuario permitió, la ejecución se mantiene. Un swap que falla cuesta igualmente las comisiones de las transacciones enviadas para él —un swap puede ser varias en un mismo grupo— y los activos permanecen en la billetera.

La versión 1.0.0-beta.5 cerró un agujero en la forma en que el widget integrado se comunica con la página que lo rodea. Según el registro de cambios, antes cualquier página o frame podía enviar una solicitud de firma, provocar una petición a la billetera y recibir las transacciones firmadas. Ahora el controlador acepta mensajes solo desde el origen del widget de Pera e ignora el resto con un aviso único en la consola, y quien aloje el widget en otro sitio debe indicar ese origen de forma explícita. Las versiones anteriores siguen en npm, así que la versión que fije el desarrollador determina si la protección está presente.

La red por defecto es la otra trampa, y hay dos valores por defecto. La propia página del widget usa testnet por defecto, de modo que un iframe escrito a mano que omita el parámetro de red coloca a los visitantes en una cadena donde las monedas no valen nada. Los helpers del paquete ahora envían siempre una red y la fijan por defecto en mainnet, así que un widget construido con ellos se abre en mainnet salvo que se indique lo contrario.

Y el propio centro de documentación²⁰ de Pera no menciona nada de esto: enumera Pera Connect, una API para datos de activos, especificaciones de análisis de NFT y esquemas de URL de aplicaciones, sin ninguna entrada para la API de swap ni para el widget. El descubrimiento pasa por el README, una entrada de blog y la demostración.

Lo que decide un desarrollador, por tanto, es una dependencia: una beta que se publica más o menos una vez al año y que rompe cuando cambia, y una lista de enrutamiento más corta en el código que en la página. Para el lector que se encuentra la caja dentro de la aplicación de otro, lo que importa está en la pantalla antes de firmar: el proveedor, el mínimo recibido, el impacto en el precio y la línea de comisión con su unidad comprobada.

Fuentes

• Swap (registry.npmjs.org)¹³
• Breaking Changes³
• Pera Wallet – How to Swap Tokens in Pera Wallet¹⁰
• Pera Wallet – Understanding Swap Fees and Slippage in Pera⁶
• Introducing the P.E.R.A. API: Seamless Swap Integration | by Joseph Cecala | Pera Wallet¹²
• Pera Swap Widget Examples⁵
• Swap Widget | Tinyman Docs¹⁷
• Pera Wallet – Terms of Service²¹
• Pera swap (github.com)³
• Swap (api.npmjs.org)¹⁵