Artículo del Blog

Guía para la Preparación del Protocolo 13

Autor

Justin Rice

Fecha de publicación

Actualización de protocolo

SDK

El Protocolo Stellar 13 está en camino, y puedes leer todo sobre las nuevas características que introduce en este post del blog. Como la mayoría de las actualizaciones de protocolo, requiere una buena cantidad de orquestación: Horizon, los SDKs de Stellar y todo el variado y maravilloso software construido sobre Stellar necesitan ser actualizados para acomodar los cambios en las estructuras de datos subyacentes utilizadas por Stellar Core. No importa quién seas o qué hagas con Stellar, vas a necesitar tomar algo de tiempo para atender tu software.

Queríamos empezar a hablar de la actualización más pronto que tarde para darte tiempo de prepararte, y para hacer el proceso lo más indoloro posible, estamos reuniendo recursos relevantes en esta guía. Nuevas versiones de Horizon y los SDKs de Stellar continuarán llegando en las próximas semanas, y conforme lo hagan, actualizaremos enlaces e información.

El 18/06/2020, la red pública vota para actualizar‍

La red de prueba se actualizó el 07/05/2020. Si estás construyendo algo en la red de prueba y tienes problemas, puede que necesites actualizar cualquier SDK que uses así como cualquier software personalizado que acceda directamente a Horizon o Stellar Core.

Los validadores de la red pública votarán sobre la actualización del Protocolo 13 el 18/06/2020, que es dos semanas más tarde del plan original para que la gente tenga un poco más de tiempo para prepararse. Si tu software no está actualizado y la red se actualiza, tu integración con Stellar probablemente se romperá.

Esto es lo que necesitas hacer antes de esas fechas:

Si usas un SDK de Stellar:

Descarga la nueva versión tan pronto como esté lista. Los SDKs son compatibles hacia atrás, así que continuarán soportando el Protocolo 12 por el resto de su corta vida. Sin embargo, si estás usando una versión antigua cuando la red se actualice al Protocolo 13, probablemente se confundirá, lanzará errores y dejará de funcionar como se espera.

En este momento, no todos los SDKs soportan el Protocolo 13. Anunciaremos nuevas versiones conforme sean lanzadas, y las añadiremos a la lista abajo. También puedes seguir su progreso en este problema de Github. SDKs que están listos para descargar:

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 JS que expone todos los cambios necesarios para adaptarse al Protocolo 13. Es la plantilla que están siguiendo los otros SDKs, y puede servirte bien también.

Además, por favor contáctame y házme 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].

Si ejecutas Horizon:

Descarga Horizon 1.4.0 lo antes posible. Si estás actualizando desde Horizon 1.1.0 o 1.2.2, debería ser bastante rápido y fácil. Si estás actualizando desde una versión anterior, necesitarás asegurarte de asignar tiempo para una migración de base de datos requerida. Cuando lo hicimos, nos tomó casi nueve horas. Si no actualizas, tu Horizon no podrá ingerir o enviar transacciones del Protocolo 13, así que solo funcionará parcialmente cuando la red se actualice.

Si ejecutas Stellar Core:‍

Stellar Core v13.1.0 es la última versión de Stellar Core, y soporta el Protocolo 13. Si no estás ejecutándola (o la v13.0.0) cuando la red se actualice, tu nodo lanzará un "Invalid upgrade" y se caerá. Punto. Si ejecutas un validador, también deberías asegurarte de armarlo para votar por la actualización el 18/06/2020. Para mantenerte en el bucle mientras coordinamos esa votación, únete al canal Keybase stellar.public #validators.

Si ejecutas un validador, puedes armarlo para actualizar usando el siguiente comando:

/upgrades?mode=set&upgradetime=2020-06-18T16:00:00Z&protocolversion=13