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 lanzamiento, pasos de preparación y un resumen de cambios incompatibles.

Puedes leer todo lo que incluye Adapter en el blog del anuncio, y mantente al día sobre 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.
• 13–21 de agosto de 2026 — Lanzamientos estables adicionales (infraestructura y SDKs) disponibles.
• 27 de agosto de 2026, 1700 UTC — Votación de actualización de Testnet.
• 16 de septiembre de 2026, 1700 UTC — Votación de actualización de Mainnet.

Si usas un Stellar SDK

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

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

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

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

Instala los lanzamientos del Protocolo 28 cuando estén disponibles (desplegándose desde el 13 de agosto de 2026, con todos los componentes disponibles para el 21 de agosto de 2026).

• Si usas Docker imágenes, extrae las compilaciones del Protocolo 28 desde el registro de Docker.
• Si compilas desde el código fuente o usas nuestros paquetes 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 Stellar Core como imágenes de Docker para el Protocolo 28; la instalación basada en Docker se describe en la documentación de Stellar.

Si consumes datos de libro mayor en bruto (por ejemplo, vía Galexie, un indexador o un pipeline personalizado), 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, luego arma tu validador antes de la votación de actualización de Mainnet el 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 relojes sincronizados; de lo contrario, el rendimiento de la red puede deteriorarse.

Los operadores de validadores deben ejecutar sincronización NTP a partir del Protocolo 28. Para más información, consulta la guía de sincronización de 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 (actualizaciones atómicas de flota) y CAP-86 (datos de contrato compatibles con migración) son funciones optativas que adoptarás al recompilar con el SDK de Soroban actualizado. No se requiere ninguna acción para seguir siendo compatible, pero revisa los CAPs si alguna de estas capacidades es relevante para tu despliegue y estrategia de actualización.

No se espera que Adapter introduzca incompatibilidad hacia atrás en Stellar Core en sí. La mayoría de los cambios son aditivos. Los siguientes puntos indican dónde los consumidores aguas abajo pueden necesitar adaptarse.

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

CAP-85 (ejecutables de contrato gestionados externamente): Agrega un nuevo CONTRACT_EXECUTABLE_EXTERNAL_REF tipo de ejecutable. Hay una incompatibilidad menor y acotada: los contratos de cuenta personalizados que analizan el contexto de autorización y no estén actualizados 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 el 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): Agrega nuevas sparse_map_new_from_linear_memory y sparse_map_unpack_to_linear_memory funciones del host para datos de contrato aptos para migración. Sin incompatibilidades hacia atrás. Las funciones del host existentes no cambian; los SDKs adoptarán 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, opta por el “Último lanzamiento”.

Infraestructura de Stellar

• Stellar Core
• Horizon
• RPC
• Galexie

SDKs

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

Ten en cuenta que algunos SDKs listados son mantenidos por la comunidad; verifica cada repositorio para compatibilidad con el Protocolo 28 y tiempos de lanzamiento.

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

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