Desarrolladores

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

Autor

Stellar Development Foundation

Fecha de publicación

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 cualquier anuncio relacionado con X-Ray en el Discord de Desarrolladores de Stellar, donde el ecosistema se coordina y comparte información sobre la actualización.

Fechas clave

  • 15 de diciembre, 2025: Lanzamientos 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 nota: 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.

¿Qué necesitas hacer para prepararte?

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.

Si operas un validador

La votación de actualización del 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


Lanzamientos de X-Ray

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

SDKs

Para mantenerte al día sobre cualquier anuncio relacionado 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.

Cambios importantes

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 importantes 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/..