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 sobre lo que incluye el Protocolo 23 en el blog de anuncios y mantenerte al día sobre todos y cada uno de los anuncios relacionados 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 de 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 de 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 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 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 de 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 un lanzamiento de 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 operas infraestructura de Stellar

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

Si no operas 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 operas un validador

La votación de actualización al Protocolo 23 está programada para el 3 de septiembre de 2025 a las 1700 UTC. Deberías 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 Elixir Stellar

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 siendo publicado 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 significativos rompedores 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 operaciones Clásicas y contratos de Soroban. Los cambios clave incluyen la eliminación de temas administrativos de los eventos de mint, clawback y set_authorized, la adición de nuevos eventos de tarifas y que SAC emita eventos de mint/burn (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 memo 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 la administración y el emisor mencionados anteriormente.
• Consulta CAP-67 y Stellar XDR para más información sobre el formato TransactionMetaV4.

RPC

• El punto final getLedgerEntry ha sido eliminado
• El campo pagingToken de getEvents ha sido eliminado
• Los campos en snake_case de getVersionInfo han sido eliminados (commit_hash, etc.)
• Los eventos de diagnóstico ya no son devueltos 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 documentación de Escalabilidad 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 punto de conexión de envío de transacciones asíncronas 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: Ahora se requiere Node >= 20

Registro de cambios

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

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

14 de agosto, 2025: Lanzamientos de construcciones estables y reinicio de Testnet completado

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 construcciones 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.