Guía de actualización de Adapter, Protocolo 28

Última actualización: 12 de agosto de 2026

Esta guía está diseñada para ayudar a empresas y desarrolladores a prepararse para Adapter, Protocolo 28, con fechas clave, información de lanzamientos, pasos de preparación y un resumen de los cambios incompatibles.

Puedes leer todo lo que incluye Adapter en el blog del anuncio, y mantenerte al día de todos los anuncios relacionados con Adapter en el Discord de Desarrolladores de Stellar, donde el ecosistema se coordina y comparte información sobre la actualización en el canal #protocol-next.

Fechas clave

• 13 de agosto de 2026—Versión estable de Stellar Core disponible.
• 14–21 de agosto de 2026—Lanzamientos estables adicionales (infraestructura y SDKs) disponibles.
• 27 de agosto de 2026, 1700 UTC—Actualización de Testnet.
• 16 de septiembre de 2026, 1700 UTC—Votación de actualización de Mainnet.

Si usas un SDK de Stellar

Actualiza a la última versión del SDK de Stellar correspondiente.

• Para tu integración en Testnet, actualiza antes del 27 de agosto de 2026.
• Para tu integración en Mainnet, actualiza antes del 16 de septiembre de 2026.

La mayoría de las integraciones solo necesitarán subir la versión del SDK. Si creas contratos inteligentes de Soroban, ten en cuenta que varias funciones del Protocolo 28 (CAP-85, CAP-86) aparecen a través de los SDKs actualizados—te sumarás a ellas al recompilar contra la nueva versión del SDK. Consulta “Cambios incompatibles” abajo para comprobar si algún cambio te afecta.

Si operas infraestructura de Stellar (Stellar Core, Horizon, RPC, Galexie)

Instala los lanzamientos del Protocolo 28 en cuanto estén disponibles (despliegue a partir del 13 de agosto de 2026, con todos los componentes disponibles para el 21 de agosto de 2026).

• Si usas imágenes de Docker, descarga las compilaciones del Protocolo 28 desde el registro de Docker.
• Si compilas desde el código fuente o usas nuestros paquetes de Debian, actualiza tus stellar-core, stellar-horizon, stellar-rpc, y stellar-galexie binarios a las compilaciones del Protocolo 28.

Ubuntu: Publicaremos imágenes para Ubuntu 24.04 y Ubuntu 22.04. Para compilar desde el código fuente, consulta las instrucciones de instalación; la instalación basada en paquetes se describe en la documentación de Stellar.

Docker: Publicaremos las imágenes de Docker de Stellar Core para el Protocolo 28; la instalación basada en Docker se describe en la documentación de Stellar.

Si consumes datos crudos del libro mayor (por ejemplo, a través de Galexie, un indexador o una canalización personalizada), lee la nota de CAP-83 en “Cambios incompatibles”—introduce un nuevo tipo de valor de libro mayor que querrás manejar.

Si operas un validador

Instala la versión de Stellar Core del Protocolo 28 y luego arma tu validador antes de la votación de actualización de Mainnet del 9 de septiembre de 2026, 1700 UTC:

upgrades?mode=set&upgradetime=2026-09-16T17:00:00Z&protocolversion=28

Además, el Protocolo 28 introduce una nueva función para que los libros mayores cierren más rápido y reducir la variación del tiempo de cierre. Esto requiere que todos los validadores tengan los relojes sincronizados; de lo contrario, el rendimiento de la red puede deteriorarse.

Los operadores de validadores deben ejecutar la sincronización NTP a partir del Protocolo 28. Para más información, consulta la guía de Sincronización del Reloj en la documentación para operadores de validadores.

Si operas una billetera, un exchange, un emisor, un on/off-ramp o un protocolo

Billeteras, on/off-ramps y emisores: En la mayoría de los casos, actualizar a la última versión del SDK (ver arriba) antes de la votación de Mainnet es todo lo que se requiere.

Exchanges y custodios: Actualiza cualquier SDK e infraestructura que operes antes de la votación correspondiente.

Protocolos y equipos de contratos inteligentes: CAP-85 (mejoras atómicas de flota) y CAP-86 (datos de contratos compatibles con migración) son funciones de adhesión voluntaria que adoptarás cuando recompiles contra el SDK de Soroban actualizado. No necesitas hacer nada para seguir siendo compatible, pero revisa los CAPs si alguna de estas capacidades es relevante para tu estrategia de despliegue y actualización.

No se espera que Adapter introduzca incompatibilidades retroactivas en Stellar Core. La mayoría de los cambios son aditivos. Los puntos siguientes indican dónde los consumidores aguas abajo podrían necesitar adaptarse.

CAP-83 (valor de consenso con conjunto de transacciones vacío): Introduce un nuevo StellarValue tipo, STELLAR_VALUE_EMPTY_TX_SET. StellarValue con este tipo tienen un txSetHash con un valor de 0x0. Los consumidores aguas abajo de datos crudos del libro mayor (StellarValue, LedgerCloseMeta, y cualquier cosa derivada de ellos—indexadores, canalizaciones de analítica, herramientas personalizadas) deben tratar los libros mayores que lleven este valor como libros mayores vacíos y manejar el nuevo tipo. No se requiere ninguna acción para las integraciones normales basadas en SDK. La descarga paralela de conjuntos de transacciones (que genera estos valores) se desplegará gradualmente y está deshabilitada por defecto.

CAP-85 (ejecutables de contratos administrados externamente): Añade un nuevo CONTRACT_EXECUTABLE_EXTERNAL_REF como tipo de ejecutable. Existe una incompatibilidad menor y puntual: los contratos de cuenta personalizada que analizan el contexto de autorización y no se actualicen para el nuevo tipo de ejecutable no podrán autorizar la creación de contratos que usen una referencia de ejecutable externa. Esto afecta solo al caso específico de una cuenta personalizada autorizando la creación de un contrato con referencia externa; las cuentas personalizadas actualizables pueden adaptarse.

CAP-86 (funciones host de mapa disperso): Añade nuevas sparse_map_new_from_linear_memory y sparse_map_unpack_to_linear_memory funciones host para datos de contratos compatibles con migración. No hay incompatibilidades retroactivas. Las funciones host existentes no cambian; los SDKs irán adoptando las nuevas funciones con el tiempo.

A continuación encontrarás enlaces a los lanzamientos relevantes para el Protocolo 28. Revisa las notas de cada lanzamiento para instrucciones y requisitos específicos y, salvo que se indique lo contrario, elige la “Última versión”.

Infraestructura de Stellar

• Stellar Core
• Horizon
• RPC
• Galexie

SDKs

• SDK de Rust (Soroban)
• SDK de JavaScript
• SDK de Go
• Java
• Python
• iOS
• PHP
• C# .NET
• Flutter
• Elixir

Ten en cuenta que algunos SDKs listados están mantenidos por la comunidad; revisa cada repositorio para la compatibilidad con el Protocolo 28 y fechas de lanzamiento.

• 13 de agosto de 2026—Guía inicial publicada.

Para mantenerte al día de todos los anuncios relacionados con Adapter, únete al Discord de Desarrolladores de Stellar, donde el ecosistema coordina la actualización en el canal #protocol-next.