Guía de Actualización a Stellar X-Ray, Protocolo 25

Esta guía está diseñada para ayudar a empresas y desarrolladores a prepararse para X-Ray, Protocolo 25, con fechas clave, información de lanzamiento, un registro de cambios y más.

Puedes leer todo sobre lo que se incluye en X-Ray en el blog de anuncios y mantenerte al día sobre todos y cada uno de los anuncios relacionados con X-Ray en el Discord de Desarrolladores de Stellar, donde el ecosistema se coordina y comparte información sobre la actualización.

• 15 de diciembre de 2025: Lanzamientos estables disponibles. ¡Completado!
• 7 de enero de 2026 a las 2100 UTC: Actualización de Testnet. ¡Completado!
• 22 de enero de 2026 a las 1700 UTC: Votación de actualización de Mainnet. ¡Completado!

Toma en cuenta: Este ciclo de lanzamiento ocurre durante el período festivo, por lo que hay más tiempo de lo usual entre la disponibilidad de los lanzamientos estables y la actualización de Testnet. Puedes actualizar el software tan pronto como los nuevos lanzamientos estén disponibles porque son compatibles con el protocolo actual. Sin embargo, reconocemos que muchas personas no están disponibles a finales de año. Si no puedes actualizar antes de fin de año (2025), por favor planea hacerlo la primera semana de enero de 2026.

Si usas un SDK de Stellar

Para tu integración de Testnet, actualiza a la última versión del SDK de Stellar relevante antes del 7 de enero de 2026. Para tu integración de Mainnet, actualiza a la última versión de los SDKs de Stellar relevantes antes del 22 de enero de 2026.

Si operas infraestructura de Stellar (Stellar Core, Horizon, RPC, Galexie)

Instala las versiones del Protocolo 25. Si usas imágenes de Docker, obtén las compilaciones del Protocolo 25 del registro de Docker. Si compilas desde el código fuente o nuestros paquetes Debian, asegúrate de también actualizar tus binarios de stellar-core, stellar-horizon y stellar-rpc a las compilaciones del Protocolo 25.

Ubuntu
Hemos publicado las imágenes para Ubuntu 24.04 y Ubuntu 22.04. Para compilar desde el código fuente puedes referirte a las Instrucciones de Instalación para los pasos de instalación.

Hemos descontinuado Ubuntu 20.04 (focal). Los operadores en Ubuntu 20.04 necesitarán actualizar su SO a 24.04 o 22.04. También hemos cambiado a llvm-20. Los operadores que usen Ubuntu 22.04 necesitarán agregar los repositorios de llvm-20 a sus sistemas para instalar los nuevos paquetes. Este paso no será necesario en Ubuntu 24.04. Consulta los detalles en las Instrucciones de Instalación de Ubuntu. La instalación basada en paquetes también se describe en la documentación de Stellar.

Docker
Hemos publicado la imagen de Docker de Stellar Core para el Protocolo 25, y la instalación basada en Docker también se describe en la documentación de Stellar.

Si operas un validador

La votación de actualización al Protocolo 25 está programada para el 22 de enero de 2026, a las 1700 UTC. Debes preparar tu validador con el siguiente comando:

upgrades?mode=set&upgradetime=2026-01-22T17:00:00Z&protocolversion=25

A continuación, se encuentran enlaces actualizados a todos los lanzamientos disponibles relevantes para el Protocolo 25. En general, asegúrate de revisar las notas de lanzamiento para instrucciones específicas y requisitos, y a menos que se indique lo contrario, opta por el “Último Lanzamiento”.

Infraestructura de Stellar

• Stellar Core
• Horizon
• RPC
• Galexie

SDKs

• SDK de Rust
• Base de JavaScript
• SDK de JavaScript
• SDK de Go (rpcclient & horizonclient & txnbuild)
• Java
• Python
• iOS
• PHP
• C# .NET
• Flutter
• SDK de Elixir Stellar

Para mantenerte al día sobre todos y cada uno de los anuncios relacionados con X-Ray, únete al Discord de Desarrolladores de Stellar, donde el ecosistema se coordina y comparte información sobre la actualización en el canal #protocol-next.

X-Ray introduce nuevas funciones de host para BN254, y primitivas de permutación Poseidon y Poseidon2, y no introduce ninguna incompatibilidad hacia atrás. Así que no hay cambios disruptivos en Stellar Core.

SDKs de GO

• Los SDKs de Golang (horizonclient, rpcclient y txnbuild) ahora se encuentran en un nuevo repositorio centralizado - https://github.com/stellar/go-stellar-sdk.
• Las aplicaciones cliente de Go que estaban usando estos SDKs desde github.com/stellar/go necesitarán cambiar su proyecto para usar el nuevo nombre del módulo go github.com/stellar/go-stellar-sdk
  • Renombra las declaraciones de importación del paquete de github.com/stellar/go/.. a github.com/stellar/go-stellar-sdk/..