Guía de Actualización de 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 incluye X-Ray en el blog de anuncios y mantenerte al día sobre todos los anuncios relacionados con X-Ray en el Discord de Desarrolladores de Stellar, donde el ecosistema coordina y comparte información sobre la actualización.

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

Toma en cuenta: Este ciclo de lanzamiento ocurre durante el período festivo, por lo que hay más tiempo de lo habitual entre la disponibilidad de las versiones estables y la actualización de Testnet. Puedes actualizar el software tan pronto como las nuevas versiones 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, descarga las construcciones del Protocolo 25 del registro de Docker. Si construyes 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 construcciones del Protocolo 25.

Ubuntu
Hemos publicado las imágenes para Ubuntu 24.04 y Ubuntu 22.04. Para construir 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. Ve 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 documentación.

Docker
Hemos publicado la imagen de Docker de Stellar Core imagen de Docker 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 todas las versiones disponibles relevantes para el Protocolo 25. En general, asegúrate de revisar las notas de la versión para instrucciones específicas y requisitos, y a menos que se indique lo contrario, opta por la “Última Versión”.

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 los anuncios relacionados con X-Ray, únete al Discord de Desarrolladores de Stellar, donde el ecosistema 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. Por lo tanto, 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 deberá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 de paquetes de github.com/stellar/go/.. a github.com/stellar/go-stellar-sdk/..