Guía de actualización del Protocolo 23

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

Puedes leer todo acerca de lo que incluye el Protocolo 23 en el blog de anuncios y mantenerte al día sobre cualquier anuncio relacionado con el Protocolo 23 en el Discord de Desarrolladores de Stellar, donde el ecosistema se coordina y comparte información sobre la actualización.

Fechas clave

• 17 de julio: Actualización del Testnet. ¡Completo!
• 14 de agosto: Reinicio del Testnet. ¡Completo!
• 14 de agosto: Lanzamientos estables disponibles. ¡Completo!
• 3 de septiembre: Votación de actualización del Mainnet. ¡Completo!

El reinicio del Testnet del 14 de agosto borrará todas las entradas del libro mayor del Testnet incluyendo datos de cuentas, activos y contratos, ¡así que prepárate para recrear cualquier cosa que necesites mantener! Para consejos y más información, consulta los documentos del Testnet.

Además, después del reinicio del Testnet del 14 de agosto, necesitarás actualizar a las nuevas versiones del software relacionado con Stellar incluyendo Stellar Core, RPC, Horizon y los SDKs de Stellar lo antes posible para asegurar la compatibilidad con el Testnet incluso si instalaste nuevas versiones antes de la actualización del Testnet del 17 de julio.

Disculpas por las molestias, y por el corto aviso: normalmente, no reiniciamos el Testnet como parte de una actualización de protocolo, pero esta vez es necesario debido a algunas actualizaciones en Stellar Core. El reinicio del Testnet del 14 de agosto reemplazará el reinicio del Testnet programado previamente para el tercer trimestre.

Si usas un SDK de Stellar

Para tu integración con Testnet, actualiza a la última versión del SDK de Stellar relevante el 14 de agosto.

Para tu integración con Mainnet, actualiza a la última versión de los SDKs de Stellar relevantes antes del 3 de septiembre.

Actualizaremos la sección de lanzamientos a continuación para indicar cuando una versión del SDK con soporte para el Protocolo 23 esté disponible, así que vuelve a consultar si un SDK que usas aún no está listado.

Si administras infraestructura de Stellar

Si usas imágenes de Docker, descarga las construcciones del Protocolo 23 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 23.

Si no administras tu propia infraestructura pero aún necesitas acceso a una instancia de Horizon o RPC, puedes usar un proveedor de infraestructura. Aquí hay listas para Horizon y RPC.

Si administras un validador

La votación de actualización al Protocolo 23 está programada para el 3 de septiembre de 2025 a las 1700 UTC. Debes preparar tu validador con el siguiente comando:

upgrades?mode=set&upgradetime=2025-09-03T17:00:00Z&protocolversion=23

A continuación, se encuentran enlaces actualizados a todos los lanzamientos disponibles relevantes para el Protocolo 23. 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
• Stellar RPC

SDKs

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

El Testnet está ejecutando el Protocolo 23, lo que significa que las versiones antiguas de Stellar Core no funcionarán en absoluto, y las versiones antiguas de Horizon, Stellar RPC, Galexie y los SDKs de Stellar probablemente se detendrán cuando encuentren algo que no reconocen.

Dicho esto, cuando el Testnet se reinicie el 14 de agosto, necesitarás instalar lanzamientos estables de todo el software relacionado con Stellar para asegurar la compatibilidad con un nuevo lanzamiento de Stellar Core. Además de los problemas generales de compatibilidad, aquí hay algunos otros cambios a tener en cuenta:

Rebranding de Stellar RPC

Soroban RPC fue oficialmente renombrado a Stellar RPC en el Protocolo 22. Aunque ha continuado publicándose bajo ambos nombres, a partir del Protocolo 23 las imágenes y paquetes de soroban-rpc ya no estarán disponibles.

XDR

• Ha habido cambios importantes y disruptivos en el XDR en el Protocolo 23, el más grande de los cuales es la introducción de una nueva estructura de meta de transacción, TransactionMetaV4, que reemplaza a TransactionMetaV3. Cualquier aplicación que lea meta de transacción cruda de Stellar Core, Horizon, Stellar RPC, Galexie, etc. se verá afectada. Esto puede incluir dapps, indexadores, exchanges, emisores y billeteras.
• El Protocolo 23 unifica los flujos de eventos entre las operaciones Clásicas y los contratos de Soroban. Los cambios clave incluyen la eliminación de temas administrativos de los eventos de acuñación, recuperación y establecimiento de autorizaciones, la adición de nuevos eventos de tarifas y que SAC emita eventos de acuñación/quema (en lugar de transferencia) cuando el emisor está involucrado. Los eventos de transferencia ahora admiten campos de datos basados en mapas para información de memos junto con enteros. Las operaciones Clásicas emitirán eventos estandarizados que coinciden con el formato de Soroban para un seguimiento consistente del movimiento de activos.
• También habrá una opción de configuración que modificará los eventos SAC pre-v23 para seguir los cambios relacionados con administración y emisores mencionados anteriormente.
• Consulta CAP-67 y Stellar XDR para más información sobre el formato TransactionMetaV4.

RPC

• El endpoint getLedgerEntry ha sido eliminado
• El campo pagingToken de resultados de getEvents ha sido eliminado
• Los campos en snake_case de getVersionInfo han sido eliminados (commit_hash, etc.)
• Los eventos diagnósticos ya no son retornados por getEvents
• El campo inSuccessfulContractCall de getEvents ahora está obsoleto y será eliminado en el Protocolo 24

Horizon

• El lanzamiento requiere una reconstrucción del estado y una migración. Consulta la Escalabilidad documentación para más información sobre cómo prepararse para posibles tiempos de inactividad.
• Las siguientes banderas de configuración han sido eliminadas
  • CAPTIVE_CORE_USE_DB
  • DEPRECATED_SQL_LEDGER_STATE
• El errorResultXdr campo de la respuesta del endpoint de envío de transacción asíncrona ha sido eliminado
• Los campos num_archived_contracts y archived_contracts_amount de la respuesta /assets han sido eliminados

SDKs

• horizonclient: Campos eliminados de la API de Horizon (mencionados arriba) han sido eliminados
• js-stellar-sdk: Node >= 20 es ahora requerido

Registro de cambios

3 de septiembre, 2025: Mainnet actualizada a Whisk (Protocolo 23)

26 de agosto, 2025: Cambiado el requisito de Node en JS SDK y actualizaciones de cambios importantes para RPC

14 de agosto, 2025: Lanzamientos de builds estables y reinicio de Testnet completados

6 de agosto, 2025: Añadido a cambios importantes en XDR

4 de agosto, 2025: Anunciado reinicio de Testnet el 14 de agosto, lanzamientos estables el 14 de agosto y nueva fecha de actualización de Mainnet el 3 de septiembre.

31 de julio, 2025: Fechas actualizadas de lanzamiento de builds estables y votación de Mainnet

25 de julio, 2025: Instrucciones para validadores actualizadas

22 de julio, 2025: Añadida la sección de Cambios Importantes

17 de julio, 2025: Cronograma actualizado para reflejar la actualización de testnet, y añadido SDK de Rust a los lanzamientos.

20 de junio, 2025: Cronograma actualizado para reflejar días extras requeridos para la implementación de Stellar Core, lo que retrasó las fechas de Testnet y Mainnet.