Puedes conocer en detalle todo lo que incluye X-Ray en el blog oficial de anuncios:
👉 https://stellar.org/blog/developers/stellar-x-ray-protocol-25-upgrade-guide
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.
Fechas clave
15 de diciembre de 2025 — Versiones estables disponibles
7 de enero de 2026, 21:00 UTC — Actualización de Testnet
22 de enero de 2026, 17:00 UTC — Votación de actualización de Mainnet
Importante:
Este ciclo de lanzamiento ocurre durante el período festivo, por lo que hay más tiempo del habitual entre la disponibilidad de las versiones estables y la actualización de Testnet.
Las nuevas versiones son compatibles con el protocolo actual, por lo que puedes actualizar el software tan pronto como estén disponibles.
Si no puedes hacerlo antes de finalizar 2025, se recomienda planificar la actualización durante la primera semana de enero de 2026.
¿Qué necesitas hacer para prepararte?
Si usas un SDK de Stellar
Testnet: actualiza a la última versión del SDK correspondiente antes del 7 de enero de 2026
Mainnet: actualiza a la última versión de los SDKs relevantes antes del 22 de enero de 2026
📚 Documentación de SDKs:
👉 https://developers.stellar.org/docs/tools/sdks
Si operas infraestructura de Stellar
(Stellar Core, Horizon, RPC o Galexie)
Instala las versiones correspondientes al Protocolo 25.
Si utilizas Docker, descarga las imágenes del Protocolo 25 desde el registro oficial
Si compilas desde código fuente o usas paquetes Debian, asegúrate de actualizar los binarios de:
stellar-corestellar-horizonstellar-rpc
Consideraciones por sistema operativo
Ubuntu
Se ha 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
Imagen oficial de Stellar Core para Protocolo 25 ya publicada
Instalación y uso documentados en la documentación oficial de Stellar
🐳 Guía Docker:
👉 https://developers.stellar.org/docs/run-core-node/docker
Si operas un validador
La votación para la actualización al Protocolo 25 está programada para el 22 de enero de 2026 a las 17:00 UTC.
Debes preparar tu validador ejecutando el siguiente comando:
upgrades?mode=set&upgradetime=2026-01-22T17:00:00Z&protocolversion=25
📘 Guía para validadores:
👉 https://developers.stellar.org/docs/validators
Lanzamientos incluidos en X-Ray (Protocolo 25)
Infraestructura de Stellar
👉 Lista completa de versiones y releases:
https://developers.stellar.org/docs/networks/software-versions
SDKs disponibles
📚 Acceso a todos los SDKs:
👉 https://developers.stellar.org/docs/tools/sdks
Cambios relevantes
X-Ray introduce nuevas funciones de host para:
BN254
Poseidon
Poseidon2
No se introducen incompatibilidades con versiones anteriores.
No hay cambios disruptivos (breaking changes) en Stellar Core.
Nota importante para proyectos en Go
Los SDKs de Go (horizonclient, rpcclient y txnbuild) ahora se encuentran en un nuevo repositorio centralizado:
Si tu aplicación utilizaba:
github.com/stellar/go
Debes:
Cambiar el módulo a
github.com/stellar/go-stellar-sdkActualizar los imports desde
github.com/stellar/go/...
agithub.com/stellar/go-stellar-sdk/...
