Artículo de Blog
Guía de Actualización del Protocolo 17
Autor
Justin Rice
Fecha de publicación
Actualización de protocolo
Recuperación de activo
Regulación
¡Es hora de prepararse para la actualización de la red Stellar al Protocolo 17! Esta versión del protocolo incluye una nueva característica de Recuperación de Activos que hemos documentado en detalle y descrito a un nivel alto en la Mejoras del Protocolo 17 entrada de blog, así que revísalos si estás interesado en saber más. El objetivo de esta guía es compartir fechas clave y acciones a realizar para ayudarte a prepararte.
Si desarrollas en Stellar, necesitas instalar versiones actualizadas de todo el software relacionado con Stellar — incluyendo Stellar Core, Horizon y cualquier SDK de Stellar que uses — antes de la actualización de la red. Si y cuando los validadores voten por aceptar el Protocolo 17, la actualización tiene efecto inmediatamente, y dado que todo el nuevo software es compatible con el protocolo actual, la mejor acción es actualizar cuanto antes. Hacerlo asegurará que tu integración con Stellar continúe funcionando cuando la red avance.
Fechas clave
- 4 de mayo de 2021 a las 1500 UTC — Testnet actualizada. ¡Ahora la testnet está ejecutando el Protocolo 17!
- 1 de junio de 2021 a las 1500 UTC — Voto de actualización de la red pública
Lanzamientos del Protocolo 17
Hemos recopilado una lista de software que requiere actualización a continuación. Asegúrate de revisar las notas de la versión para instrucciones específicas y detalles relevantes para entender todos los requisitos relevantes.
Infraestructura de Stellar
Los operadores de nodos necesitan instalar la última versión de Stellar Core y/o Horizon. Para detalles específicos de configuración, ve las secciones a continuación.
SDKs
Para desarrolladores, los enlaces a las versiones mínimas de SDK están aquí.
Si ejecutas Horizon
Actualiza a Horizon v2.3.0, que tiene soporte completo para el Protocolo 17. Si estás ejecutando una versión pre-v2.2.0 de Horizon cuando la red se actualice, tu instancia de Horizon no podrá ingerir o consultar operaciones de recuperación de activos, y se bloqueará cuando encuentre una.
Por defecto, v2.3.0 despliega la nueva arquitectura de Horizon. 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, y no necesitas tomar pasos adicionales para actualizar Stellar Core. Simplemente actualiza a esta versión de Horizon, y estarás listo para continuar.
Aunque aconsejamos a todos los que ejecutan Horizon desplegar la nueva arquitectura, también entendemos que algunas personas todavía dependen de la arquitectura legada 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. En este caso, también necesitarás actualizar Stellar Core por separado a v17.0.0.
Si ejecutas Stellar Core
Actualiza a Stellar Core v17.1.0. Si tu nodo está ejecutando una versión pre-17.0.0 de Stellar Core cuando la red se actualice, lanzará un error y perderá sincronización.
Si tu nodo es un validador, puedes armarlo para votar por la actualización con el siguiente comando: upgrades?mode=set&upgradetime=2021-06-01T15:00:00Z&protocolversion=17
Para más información, ve el documento de Actualización de la Red. Para mantenerte al tanto mientras coordinamos esa votación, únete al canal stellar.public #validators en Keybase.
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 de JS SDK que describe los cambios necesarios para adaptarse al Protocolo 17.
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].