Arbitrum SDK

¿Qué es Arbitrum SDK?

Arbitrum SDK es un kit de herramientas para desarrolladores que permite crear aplicaciones que interactúan con las cadenas de Arbitrum, especialmente cuando una aplicación necesita realizar puentes de tokens, mensajería cross-chain, detección de redes, seguimiento de transacciones o acceder a los contratos del bridge de Arbitrum.

En el mundo cripto, el término suele referirse al paquete de TypeScript @arbitrum/sdk, diseñado para las interacciones del lado del cliente con las redes de Arbitrum.

El SDK ayuda a los desarrolladores a evitar escribir desde cero la lógica de bajo nivel del bridge, ya que ofrece clases tipadas y métodos auxiliares para operaciones habituales en Arbitrum.

Según el repositorio oficial de Arbitrum SDK en GitHub, el SDK proporciona funciones auxiliares y acceso a las interfaces de los contratos inteligentes subyacentes para crear aplicaciones en Arbitrum.

Para los usuarios, Arbitrum SDK es una infraestructura invisible que puede hacer posibles acciones como depositar ETH, transferir tokens ERC-20 mediante un bridge, retirar activos o comprobar si una transacción cross-chain ha finalizado.

Para los desarrolladores, Arbitrum SDK es una capa práctica entre una aplicación y los contratos inteligentes que gestionan la comunicación de la cadena principal a la cadena secundaria y de la cadena secundaria a la principal.

Cómo encaja Arbitrum SDK en el ecosistema de Arbitrum

Arbitrum es un ecosistema de escalado de Ethereum que permite ejecutar transacciones con costes más bajos, ofrecer experiencias más rápidas a los usuarios y crear entornos blockchain específicos para aplicaciones cripto.

La documentación general de Arbitrum lo describe como una infraestructura para aplicaciones, tokenización y cadenas específicas, lo que hace que las herramientas SDK sean importantes tanto para los desarrolladores de aplicaciones como para los operadores de cadenas.

El SDK principal suele utilizarse con Arbitrum One, Arbitrum Nova y cadenas de Arbitrum personalizadas que siguen el modelo de cadena principal y cadena secundaria.

En este modelo, una cadena principal es la que proporciona liquidación, mensajería o soporte de infraestructura, mientras que una cadena secundaria es la cadena de Arbitrum que recibe activos, mensajes o solicitudes de ejecución.

Esta terminología de cadena principal y cadena secundaria cobró más importancia en Arbitrum SDK v4, porque el SDK ahora utiliza términos más generales que sirven tanto para entornos Layer 2 como Layer 3.

La guía oficial de migración a Arbitrum SDK v4 explica que muchas referencias anteriores a L1 y L2 se sustituyeron por la terminología de cadena principal y secundaria para dar mejor cabida al ecosistema más amplio de Arbitrum.

Por qué es importante Arbitrum SDK

Arbitrum SDK es importante porque resulta difícil crear aplicaciones cripto cross-chain seguras sin herramientas fiables.

Para el usuario, un bridge de tokens sencillo puede parecer una sola transferencia, pero internamente puede implicar aprobaciones, gateways, contratos Inbox, tickets reintentables, comprobaciones de estado, periodos de disputa y ejecución en Outbox.

El SDK reduce esta complejidad al agrupar muchos de estos pasos en clases y métodos reutilizables.

Esto es importante para wallets, aplicaciones descentralizadas, bridges, paneles, aplicaciones de videojuegos, herramientas de pago, interfaces de trading y productos financieros on-chain que necesitan mover activos o mensajes entre cadenas.

Sin un SDK, los desarrolladores tendrían que interactuar directamente con los contratos del bridge y gestionar manualmente muchos casos especiales.

Con un SDK, pueden centrarse más en la experiencia de usuario, la seguridad de las transacciones, la visualización de saldos y la lógica de la aplicación.

Funciones principales de Arbitrum SDK

Transferencia de activos mediante un bridge

Uno de los usos más importantes de Arbitrum SDK es transferir activos mediante un bridge entre una cadena principal y una cadena secundaria de Arbitrum.

El SDK incluye clases bridger, como EthBridger y Erc20Bridger, para transferir activos nativos y tokens ERC-20.

La descripción general oficial de Arbitrum sobre los bridges explica que la transferencia de tokens entre cadenas y la mensajería cross-chain son elementos fundamentales para desarrollar en Arbitrum.

Cuando un usuario deposita ETH u otro token nativo en una cadena de Arbitrum, el SDK puede ayudar a preparar y enviar la transacción necesaria.

Cuando un usuario deposita tokens ERC-20, el SDK puede ayudar a aprobar el gateway, iniciar el depósito y esperar a que la transacción se procese en la cadena secundaria.

La guía oficial de Arbitrum para depositar tokens muestra cómo se utiliza Erc20Bridger para aprobar un gateway y depositar tokens ERC-20.

Mensajería cross-chain

Arbitrum SDK también admite mensajería cross-chain, que permite a un contrato o una aplicación enviar datos o instrucciones entre una cadena principal y una secundaria.

Los mensajes cross-chain son importantes porque muchas aplicaciones cripto necesitan algo más que transferencias de tokens.

Un sistema de gobernanza puede necesitar transmitir instrucciones de ejecución, una aplicación de pagos puede necesitar activar la lógica de liquidación y un juego puede necesitar sincronizar el estado entre cadenas.

La guía oficial de Arbitrum sobre mensajería cross-chain describe @arbitrum/sdk como una biblioteca de TypeScript para transferir tokens mediante bridges y enviar mensajes entre cadenas principales y secundarias de Arbitrum.

El SDK proporciona interfaces tipadas que facilitan la creación, las pruebas y la supervisión de estos flujos de mensajes.

Seguimiento del estado de las transacciones

Arbitrum SDK ayuda a los desarrolladores a realizar un seguimiento de si una transacción cross-chain está pendiente, se ha completado, ha fallado o está lista para el siguiente paso.

Esto resulta especialmente útil porque la actividad cross-chain suele tener más de un ciclo de vida de transacción.

Un depósito desde una cadena principal a una secundaria puede implicar una transacción en la cadena principal seguida de la ejecución en la secundaria.

Una retirada desde una cadena secundaria a una principal puede implicar el inicio en la cadena secundaria, un periodo de disputa y la ejecución final en la cadena principal.

El SDK proporciona herramientas para recuperar mensajes a partir de los recibos de transacción y comprobar su estado.

Esto permite que las aplicaciones muestren a los usuarios el progreso real, en lugar de dejarlos confundidos tras enviar la primera transacción.

Configuración de la red

Arbitrum SDK puede ayudar a identificar las redes de Arbitrum y recuperar la configuración correcta de una cadena secundaria de destino.

Esto es importante porque las distintas cadenas de Arbitrum pueden tener diferentes ID de cadena, direcciones de bridge, direcciones de gateway de tokens, tokens nativos y relaciones de liquidación.

Una configuración de red correcta reduce el riesgo de enviar una transacción al contrato de bridge equivocado.

También permite que las aplicaciones admitan varias cadenas de Arbitrum sin tener que codificar manualmente todas las direcciones.

Clases importantes de Arbitrum SDK

EthBridger

EthBridger se utiliza cuando una aplicación necesita transferir ETH o el token nativo de una cadena de Arbitrum compatible mediante un bridge.

Los desarrolladores pueden utilizarlo para depositar activos desde una cadena principal en una secundaria o para iniciar retiradas desde una cadena secundaria de vuelta a una principal.

La guía oficial sobre depósitos de ETH y mensajes muestra cómo EthBridger puede simplificar los depósitos en una cadena secundaria de Arbitrum.

Esta clase resulta útil para wallets, aplicaciones de pago y cualquier interfaz cripto que necesite admitir movimientos de activos nativos en Arbitrum.

Erc20Bridger

Erc20Bridger se utiliza para depositar y retirar tokens ERC-20.

Puede ayudar con los flujos de aprobación, la interacción con gateways, las transacciones de depósito, el inicio de retiradas y el seguimiento de mensajes.

Transferir tokens ERC-20 mediante un bridge es más complejo que transferir activos nativos, ya que los tokens pueden tener que pasar por gateways estándar, gateways personalizados u otra lógica de bridge de tokens.

El SDK simplifica el proceso al proporcionar a los desarrolladores una interfaz uniforme para muchas tareas habituales de transferencia de tokens mediante un bridge.

ParentToChildMessage

ParentToChildMessage representa un mensaje enviado desde una cadena principal a una cadena secundaria de Arbitrum.

Esta clase resulta útil cuando una aplicación necesita supervisar si se ha ejecutado en la cadena secundaria un depósito o un ticket reintentable.

Los mensajes de cadena principal a cadena secundaria se utilizan a menudo para depósitos, llamadas a contratos e instrucciones cross-chain.

Están estrechamente relacionados con los tickets reintentables, un mecanismo esencial de Arbitrum para ejecutar mensajes de forma fiable.

ChildToParentMessage

ChildToParentMessage representa un mensaje enviado desde una cadena secundaria de Arbitrum a una cadena principal.

Esta clase es importante para las retiradas, ya que los mensajes de cadena secundaria a cadena principal requieren un periodo de espera antes de poder ejecutarse en la cadena principal.

La guía oficial de Arbitrum para retirar tokens explica que las retiradas tardan aproximadamente 6.4 días en finalizar debido al periodo de disputa.

Las aplicaciones pueden utilizar las herramientas de mensajes del SDK para indicar si una retirada sigue en espera, está lista para ejecutarse o se ha completado.

Tickets reintentables y Arbitrum SDK

Los tickets reintentables son una parte fundamental de la mensajería de cadena principal a cadena secundaria en Arbitrum.

Un ticket reintentable es un mecanismo que permite que una transacción de la cadena principal genere una solicitud de ejecución en la cadena secundaria.

La documentación oficial de Arbitrum sobre tickets reintentables explica que estos separan el envío en la cadena principal de la ejecución en la secundaria.

Este diseño resulta útil porque la ejecución cross-chain puede depender de los límites de gas, los costes de envío, las pujas de comisiones, el tamaño de los datos de llamada y la comisión base de la cadena secundaria.

Arbitrum SDK puede ayudar a estimar los parámetros de gas de los tickets reintentables y preparar los datos de transacción necesarios para crearlos.

Para un usuario cripto, los tickets reintentables suelen permanecer ocultos tras la interfaz de un bridge o una aplicación.

Para un desarrollador, son uno de los mecanismos más importantes que debe comprender para crear depósitos y llamadas a contratos fiables en Arbitrum.

Arbitrum SDK v4 y la compatibilidad con cadenas principales y secundarias

Arbitrum SDK v4 introdujo cambios que mejoran la compatibilidad con estructuras de cadenas de Arbitrum más flexibles.

La actualización más visible es el paso de la antigua nomenclatura L1 y L2 a la terminología de cadena principal y cadena secundaria.

Este cambio resulta útil porque, según su diseño, una cadena secundaria de Arbitrum puede liquidarse en Ethereum, en otra cadena de Arbitrum o en una configuración distinta de cadena principal.

La guía de migración v4 también menciona cambios en los tipos de red, AssetBridger, Erc20Bridger y las clases de mensajes.

Los desarrolladores que actualicen integraciones antiguas deben consultar la guía oficial de migración antes de actualizar el código de producción.

Esto es especialmente importante para las interfaces de bridge, los sistemas de seguimiento de retiradas y las aplicaciones compatibles con varias cadenas de Arbitrum.

Arbitrum SDK frente a Arbitrum Chain SDK

Arbitrum SDK y Arbitrum Chain SDK están relacionados, pero no son la misma herramienta.

Arbitrum SDK, que normalmente se instala como @arbitrum/sdk, se utiliza principalmente para tareas a nivel de aplicación, como transferencias mediante bridges, mensajería y consulta de datos de redes de Arbitrum.

Arbitrum Chain SDK, que normalmente se instala como @arbitrum/chain-sdk, está diseñado para crear, desplegar y configurar cadenas de Arbitrum personalizadas.

La guía oficial de despliegue de Arbitrum Chain SDK explica cómo Chain SDK puede ayudar a crear una nueva cadena de Arbitrum preparando la configuración y los parámetros de despliegue.

Chain SDK también puede ayudar a generar la configuración de un nodo Nitro una vez desplegada la cadena.

La guía oficial de Arbitrum para configurar nodos explica que prepareNodeConfig puede generar un objeto de configuración JSON para un nodo Nitro.

Una forma sencilla de recordar la diferencia es que Arbitrum SDK sirve para las aplicaciones que utilizan cadenas de Arbitrum, mientras que Arbitrum Chain SDK sirve a los equipos que lanzan u operan cadenas de Arbitrum.

Cómo instalar Arbitrum SDK

Los desarrolladores suelen instalar Arbitrum SDK mediante npm con el nombre de paquete @arbitrum/sdk.

El comando de instalación suele ser npm install @arbitrum/sdk.

Según la configuración del proyecto, los desarrolladores también pueden utilizar gestores de paquetes como yarn o pnpm.

Tras la instalación, el desarrollador conecta el SDK a los proveedores, firmantes y ajustes de red de las cadenas principales y secundarias que vaya a utilizar.

A continuación, la aplicación utiliza clases del SDK como EthBridger, Erc20Bridger, ParentToChildMessage y ChildToParentMessage para crear el flujo deseado.

Como el SDK interactúa con transacciones reales de blockchain, los desarrolladores deben probar las integraciones en redes de prueba compatibles antes de utilizar fondos reales.

Ejemplos de uso de Arbitrum SDK

Transferencias de activos desde una wallet

Una wallet de criptomonedas puede utilizar Arbitrum SDK para permitir a los usuarios mover activos hacia y desde las cadenas de Arbitrum.

La wallet puede utilizar las herramientas de estado del SDK para indicar cuándo ha llegado un depósito a la cadena secundaria o cuándo está lista una retirada para ejecutarse en la principal.

Esto mejora la experiencia de usuario, ya que las transacciones cross-chain pueden resultar confusas o parecer incompletas.

Aplicaciones descentralizadas

Una aplicación descentralizada puede utilizar Arbitrum SDK para permitir que los usuarios financien su cuenta en una cadena de Arbitrum directamente desde una cadena principal.

Esto resulta útil para aplicaciones DeFi, de pagos, videojuegos, NFT y activos del mundo real que buscan facilitar la incorporación de usuarios.

La aplicación puede combinar transferencias mediante un bridge, seguimiento del estado y llamadas a contratos inteligentes en un único flujo guiado.

Emisores de tokens

Un emisor de tokens puede utilizar las herramientas del SDK y la documentación de los bridges de Arbitrum para permitir el movimiento de tokens entre cadenas principales y secundarias.

Esto puede facilitar el uso del token en aplicaciones basadas en Arbitrum.

Los emisores de tokens deben revisar cuidadosamente los requisitos de los gateways, ya que el comportamiento de un token personalizado puede requerir una configuración específica del bridge.

Operadores de cadenas

Los equipos que lanzan cadenas de Arbitrum personalizadas pueden utilizar Arbitrum Chain SDK para preparar los parámetros de despliegue, configurar los ajustes del rollup y generar la configuración de los nodos.

También pueden utilizar @arbitrum/sdk en la capa de aplicación una vez que la cadena esté operativa.

Esta combinación permite al equipo gestionar tanto la configuración de la infraestructura como los flujos de las aplicaciones dirigidos a los usuarios.

Ventajas de Arbitrum SDK

• • Simplifica los depósitos y las retiradas de tokens entre cadenas principales y secundarias.
  • Proporciona acceso tipado a los contratos inteligentes de bridges y mensajería.
  • Reduce la gestión manual de los recibos de transacciones cross-chain.
  • Ayuda a los desarrolladores a estimar y realizar un seguimiento de la ejecución de los tickets reintentables.
  • En SDK v4 admite relaciones más flexibles entre cadenas principales y secundarias.
  • Mejora la experiencia de usuario de las aplicaciones al ayudarles a mostrar el progreso exacto de las transacciones.

Riesgos y aspectos que deben tener en cuenta los desarrolladores

Arbitrum SDK facilita el desarrollo, pero no elimina la necesidad de realizar una revisión de seguridad cuidadosa.

Los desarrolladores deben seguir protegiendo las claves privadas, validando las direcciones de los tokens, confirmando la configuración de red y probando todos los flujos de bridge.

Un ID de cadena incorrecto, un endpoint RPC equivocado, una dirección de gateway errónea o una cantidad de gas insuficiente pueden provocar transacciones fallidas o retrasadas.

Los usuarios también deben tener en cuenta que las retiradas de una cadena secundaria a una principal pueden tardar varios días, ya que el sistema debe respetar el periodo de disputa.

Las aplicaciones deben explicar claramente este plazo antes de que el usuario inicie una retirada.

Los desarrolladores deben evitar las aprobaciones ilimitadas de tokens, salvo que el producto tenga una razón de peso para solicitarlas.

También deben supervisar las actualizaciones de las dependencias, ya que los paquetes del SDK pueden introducir cambios incompatibles, especialmente al pasar a una versión principal nueva.

Buenas prácticas para utilizar Arbitrum SDK

Antes de crear una integración para producción, los desarrolladores deben consultar la documentación oficial y el repositorio oficial de GitHub.

Deben utilizar la versión actual del SDK y revisar las notas de migración al actualizar desde versiones anteriores.

Antes del lanzamiento, deben probar los depósitos, las retiradas, los tickets reintentables fallidos, el canje manual y la ejecución en Outbox en un entorno seguro.

Deben mostrar a los usuarios estados claros de la transacción, como pendiente, enviada, en espera del periodo de disputa, lista para ejecutarse, completada y fallida.

Deben validar los metadatos de los tokens y la configuración del bridge antes de mostrar un token como compatible con la transferencia mediante bridge.

Deben evitar ocultar el plazo de las retiradas, ya que los usuarios necesitan saber cuándo estarán disponibles los fondos en la cadena principal.

Deben diseñar interfaces que expliquen las comisiones, los requisitos de gas y el funcionamiento de los reembolsos antes de que el usuario firme una transacción.

Preguntas frecuentes

¿Qué es Arbitrum SDK en pocas palabras?

Arbitrum SDK es un kit de herramientas para desarrolladores que ayuda a las aplicaciones cripto a transferir activos mediante bridges, enviar mensajes y realizar un seguimiento de las transacciones entre cadenas de Arbitrum.

¿Arbitrum SDK solo sirve para los bridges de tokens?

No. Arbitrum SDK se utiliza habitualmente para los bridges de tokens, pero también admite mensajería cross-chain, configuración de redes, gestión de recibos de transacciones y seguimiento del estado de los mensajes.

¿Qué lenguaje de programación utiliza Arbitrum SDK?

El paquete principal @arbitrum/sdk es una biblioteca de TypeScript que suele utilizarse en aplicaciones cripto de JavaScript y TypeScript.

¿Cuál es la diferencia entre EthBridger y Erc20Bridger?

EthBridger se utiliza para transferir ETH o un token nativo, mientras que Erc20Bridger se utiliza para depositar y retirar tokens ERC-20.

¿Por qué tardan las retiradas de Arbitrum?

Las retiradas desde una cadena secundaria de Arbitrum a una cadena principal requieren un periodo de disputa antes de que el mensaje pueda ejecutarse en la cadena principal.

¿Arbitrum SDK permite lanzar nuevas cadenas de Arbitrum?

El paquete principal @arbitrum/sdk se utiliza sobre todo para los flujos de bridge y mensajería a nivel de aplicación, mientras que @arbitrum/chain-sdk es la herramienta para crear y configurar cadenas de Arbitrum.

¿Los usuarios tienen que instalar Arbitrum SDK?

Los usuarios normales no tienen que instalar Arbitrum SDK, ya que los desarrolladores lo utilizan dentro de wallets, bridges, paneles y aplicaciones descentralizadas.

¿Dónde pueden encontrar los desarrolladores recursos oficiales de Arbitrum SDK?

Los desarrolladores pueden consultar el repositorio oficial del SDK, la página del paquete npm y la documentación de Arbitrum sobre mensajería cross-chain.

Conclusión

Arbitrum SDK es un kit de herramientas esencial para los desarrolladores que crean aplicaciones cripto con bridges, mensajería y flujos de transacciones cross-chain de Arbitrum.

Ayuda a los desarrolladores a interactuar con contratos de bridge complejos mediante clases de TypeScript y métodos auxiliares más sencillos.

Entre sus funciones más importantes se encuentran la transferencia mediante bridge de activos nativos y tokens ERC-20, la mensajería de cadena principal a secundaria, el seguimiento de mensajes de cadena secundaria a principal, la compatibilidad con tickets reintentables y la configuración de redes.

Arbitrum SDK v4 es especialmente importante porque refleja el modelo más amplio de cadenas principales y secundarias utilizado en las implementaciones modernas de Arbitrum.

Para los usuarios, el SDK puede ofrecer experiencias de bridge más fluidas y un seguimiento más claro de las transacciones.

Para los desarrolladores, reduce el trabajo de integración de bajo nivel, aunque siguen siendo necesarias pruebas cuidadosas, revisiones de seguridad y una comunicación clara con los usuarios.

A medida que Arbitrum siga dando soporte a más aplicaciones y entornos de cadenas específicas, Arbitrum SDK continuará siendo una de las principales herramientas para conectar productos cripto con el ecosistema de Arbitrum.