Artículo de Blog
Guía de Actualización del Protocolo 19
Autor
Justin Rice
Fecha de publicación
El Stellar Protocolo 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 utilices, antes de esa fecha. Las actualizaciones de la 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 #protocolo-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 está listada 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á la 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 del conjunto de quórum de SDF, que lista los validadores 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 de Actualización de 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 la v2.17.0 de Horizon cuando la red se actualice, se romperá tan pronto como intente procesar una de las nuevas precondiciones de transacción o tipos de firma.
La actualización también implica una migración de la base de datos, que se describe en el Horizon CHANGELOG. Debería ejecutarse bastante rápido porque agrega 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, la v2.17.0 ejecuta un mini-Stellar Core (también conocido como Captive Core) como un subproceso de Horizon, así que no necesitas ejecutar un nodo de Stellar Core independiente. Aunque aconsejamos a todos los que ejecutan Horizon que desplieguen la arquitectura Captive Core, también entendemos que algunas personas todavía dependen de la arquitectura heredada y ejecutan Horizon junto con un nodo de 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 del conjunto de quórum de SDF para una lista de los validadores Tier-1 actuales.
Si tienes una integración personalizada de Stellar
Si estás usando Stellar pero no estás utilizando 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 hacer 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 precondiciones 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, consulta la publicación Anunciando el Protocolo 19. Para un inventario de los cambios, revisa:
El primero resume las 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.
En general, 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.