Artículo de Blog
Guía de Actualización del Protocolo 19
Autor
Justin Rice
Fecha de publicación
El protocolo Stellar 19 la votación de actualización está programada para el 8 de junio de 2022. Para prepararte, asegúrate de instalar versiones actualizadas de todo tu software relacionado con Stellar, incluyendo Stellar Core, Horizon y cualquier SDK de Stellar que uses, antes de esa fecha. Las actualizaciones de red son inmediatas cuando los validadores aceptan una nueva versión del protocolo.
Todas las nuevas versiones funcionan con el protocolo actual, así que puedes instalar actualizaciones tan pronto como estén disponibles. Si tienes alguna pregunta, asegúrate de hacerla en el #protocol-19 canal en el Stellar Developer Discord, que es donde el ecosistema se está coordinando y compartiendo información sobre la actualización.
Fechas clave
- 26 de abril: Stellar Core lanzado
- 2 de mayo: Horizon lanzado
- 9 de mayo, 1500 UTC — Testnet actualizada
- 8 de junio, 1500 UTC — Votación de actualización de la red pública
Lanzamientos del Protocolo 19
Hemos recopilado una lista de software que necesita actualización a continuación. Por favor, asegúrate de revisar las notas de la versión para instrucciones específicas y requisitos.
Infraestructura de Stellar
Los operadores de nodos necesitan instalar la última versión de Stellar Core y Horizon. Para detalles específicos de configuración, consulta las secciones a continuación.
SDKs
Para desarrolladores, los enlaces a la página de lanzamiento relevante están aquí. La versión mínima requerida para admitir el Protocolo 19 se lista entre paréntesis, pero como siempre, te animamos a mantener tu integración actualizada instalando la última versión. Continuaremos actualizando esta lista a medida que salgan nuevas versiones.
Si ejecutas Stellar Core
Actualiza a Stellar Core v19.1.0, que incluye soporte para el Protocolo 19. Si tu nodo está ejecutando una versión anterior al 19 de Stellar Core cuando la red se actualice, inmediatamente mostrará un error y perderá sincronización.
También debes asegurarte de revisar tu configuración de conjunto de quórum, que puede necesitar ajustes debido a cambios recientes en la topología de la red. Para inspirarte, revisa la configuración de conjunto de quórum de SDF, que lista los validadores de Tier-1 actuales.
Si tu nodo es un validador, puedes armarlo para votar por la actualización de la red pública con el siguiente comando: upgrades?mode=set&upgradetime=2022-06-08T15:00:00Z&protocolversion=19
Para más información, consulta el documento Actualizando la Red. Para mantenerte al tanto mientras coordinamos esa votación, únete al canal stellar.public #validators en el Stellar Developer Discord.
Si ejecutas Horizon
Actualiza a Horizon v2.18.0, que tiene soporte completo para el Protocolo 19. Si estás ejecutando una versión anterior a v2.17.0 de Horizon cuando la red se actualice, se romperá tan pronto como intente ingerir una de las nuevas precondiciones de transacción o tipos de firma.
Actualizar también implica una migración de base de datos, que se describe en el Horizon CHANGELOG. Debería ejecutarse bastante rápido porque añade columnas que corresponden a nuevas extensiones de cuenta y precondiciones de transacción introducidas en el Protocolo 19, así que no implica ningún rellenado.
Por defecto, v2.17.0 ejecuta un mini-Stellar Core (conocido como Captive Core) como un subproceso de Horizon, así que no necesitas ejecutar un nodo Stellar Core independiente. Aunque aconsejamos a todos los que ejecutan Horizon que desplieguen la arquitectura Captive Core, también entendemos que algunas personas aún dependen de la arquitectura heredada y ejecutan Horizon junto con un nodo Stellar Core independiente. Si ese es tu caso, y te gustaría mantenerlo así, puedes desactivar Captive Core estableciendo ENABLE_CAPTIVE_CORE_INGESTION="false" variable de entorno.
Después de actualizar a la nueva versión de Horizon, los operadores de Horizon también necesitan actualizar Stellar Core a v19.1.0. Eso es cierto incluso si ejecutas la arquitectura Captive Core ya que Horizon utiliza cualquier paquete de Stellar Core que tengas instalado. También ten en cuenta que esta versión soluciona un problema con una versión anterior de Core que impedía que los nodos Captive Core aplicaran ciertos ledgers, así que si eso te está sucediendo, asegúrate de actualizar a v19.0.1.
Por favor, también asegúrate de revisar tu configuración de conjunto de quórum, que puede necesitar ajustes debido a cambios recientes en la topología de la red. Sigue instrucciones para configurar Captive Core, y echa un vistazo a la configuración de conjunto de quórum de SDF para una lista de los validadores de Tier-1 actuales.
Si tienes una integración personalizada de Stellar
Si estás usando Stellar pero no estás usando un SDK de Stellar, probablemente necesitarás actualizar tu código manualmente. Puede que quieras revisar el problema del SDK de Python que describe los cambios necesarios para adaptarse al Protocolo 19.
Además, por favor contáctame y házmelo saber todo lo que puedas sobre tu integración personalizada. Me encantaría saber más para que hagamos un mejor trabajo informando, asistiendo y acomodando a personas como tú: [email protected].
Cambios Clave
El Protocolo 19 implementa dos Propuestas de Avance del Núcleo, ambas facilitan la creación de canales de pago y soluciones de puente. CAP-21 añade nuevas pre-condiciones de transacción. CAP-40 añade un nuevo tipo de firmante. Para una explicación de alto nivel de las cosas que esos cambios te permiten construir, vea el Anunciando el Protocolo 19 post. Para un inventario de los cambios, revisa:
El primero resume los CAPS del Protocolo 19 y detalla cambios en la API de Horizon y los SDKs de Stellar; el segundo está diseñado para ayudar a los mantenedores de SDK a implementar esos cambios. Si los revisas cuidadosamente, deberías poder entender lo que viene.
Generalmente, sin embargo,instalar versiones actualizadas de todos y cada uno de los SDKs de Stellar que utilices(junto con Stellar Core y Horizon si operas un nodo) es suficiente para una transición suave al Protocolo 19.