Artículo de Blog

Guía de Actualización del Protocolo 20

Autor

Stellar Development Foundation

Fecha de publicación

Actualización de protocolo

Soroban

El 20 de febrero a las 1700 UTC, el Stellar Mainnet se actualizó al Protocolo 20, que introduce la funcionalidad de contratos inteligentes en la red de Stellar. Esta guía está diseñada para ayudar a las empresas y desarrolladores que aún no lo han hecho a actualizarse al Protocolo 20 ahora que está disponible en Mainnet. Para asegurar que tu proyecto, protocolo, producto o servicio sea compatible con el Protocolo 20, por favor verifica que tu software relacionado con Stellar esté actualizado.


Para estar al tanto de las importantes discusiones sobre el desarrollo del Protocolo 20, únete al Discord o la lista de correo de desarrolladores, y lee la publicación del blog sobre la votación de actualización del Protocolo 20.

Fechas clave

  • 6 de febrero: Reinicio + Actualización de Testnet. ¡Completo!
  • 9 de febrero: Stellar Core v20.2.0. ¡Completo!
  • 20 de febrero: Votación de Actualización del Protocolo 20 + Fase 0. ¡Completo!
  • 19 de marzo: Votación de Configuraciones de Red de la Fase 2. ¡Completo!
  • ¡Stellar Mainnet brinda soporte a contratos inteligentes! ¡Despliega cuando estés listo!

¿Qué necesitas hacer para asegurar que tu integración con Stellar sea compatible?

Ahora que la red se ha actualizado al Protocolo 20, debes instalar versiones actualizadas de todo el software relacionado con Stellar que utilices. Si no lo haces, tu integración con Stellar será incompatible con el Protocolo 20 y probablemente fallará.

Si usas un SDK de Stellar

Deberías estar ejecutando la última versión del SDK. Incluso si tu aplicación no involucra funcionalidad relacionada con Soroban, es necesario actualizar tu SDK para que pueda decodificar operaciones relacionadas con Soroban, las cuales puede encontrar mientras ingiere datos de la red.

Advertencia justa: si estás actualizando el JS SDK, y no lo has hecho en un tiempo, el proceso puede tomar tiempo y esfuerzo extra debido a cambios importantes que renovaron el sistema de construcción introducido en v9.0.0. Para más información, consulta la Guía de Migración.

Si administras infraestructura de Testnet

Actualiza a la última versión de Stellar Core y/o Horizon. Si usas imágenes de Docker, obtén la última del registro de Docker. Deberías estar en Stellar Core v20.2.0 o superior.

Si administras infraestructura de Mainnet

Actualiza a la última versión de Stellar Core y/o Horizon. Deberías estar en Stellar Core v20.2.0 o superior.

Importante: La versión de Horizon compatible con el Protocolo 20 requiere una reconstrucción del estado, la primera reconstrucción del estado desde la versión lanzada el año pasado. Para evitar tiempo de inactividad durante esta reconstrucción, consulta la documentación de Escalabilidad: recomendamos tener una copia de seguridad caliente redundante.

Si usas el RPC de Soroban

Si administras el tuyo, ¡asegúrate de actualizar tu software! Si no, ten en cuenta que Stellar Development Foundation no planea ofrecer una instancia RPC gratuita para Mainnet, por lo que podrías necesitar elegir un proveedor de infraestructura para usar. Aquí hay una lista.

Si administras un validador

Puedes ver las configuraciones de red actuales, ver un historial de actualizaciones de protocolo y ver propuestas pendientes para futuras actualizaciones aquí: https://stellar.expert/explorer/public/protocol-history

En el futuro, habrá más votaciones para ajustar las configuraciones de red basadas en el uso de la red así como actualizaciones de protocolo subsiguientes, así que por favor asegúrate de mantenerte al día en el canal #validators en el Stellar Dev Discord. ¡Es crucial para los validadores mantenerse informados y participar en la gobernanza de la red!

Si estás interesado en aprender más sobre las configuraciones de red de Soroban, consulta la documentación: https://github.com/stellar/stellar-core/blob/master/docs/software/soroban-settings.md

Lanzamientos del Protocolo 20

A continuación, se encuentran enlaces actualizados a todos los lanzamientos relevantes disponibles. En general, asegúrate de revisar las notas de lanzamiento para instrucciones específicas y requisitos, y a menos que se indique lo contrario, opta por el “Último Lanzamiento”.

Infraestructura de Stellar

SDKs


Junto con los lanzamientos del SDK de JavaScript del Protocolo 20 enlazados arriba, el cliente de soroban también ha sido actualizado, pero ya no será mantenido. Los usuarios deben usar el SDK de JavaScript para sus necesidades de aplicaciones, incluyendo la comunicación con el RPC de Soroban, ya que los cambios futuros solo se realizarán allí. Por favor, lee la Guía de Migración para cómo actualizar a ese paquete.

Contexto

Desde enero de 2022, colaboradores a través del ecosistema de Stellar han estado trabajando arduamente en Soroban, una plataforma amigable para desarrolladores, con todo incluido, que añadirá funcionalidad de contratos inteligentes a Stellar. A lo largo de 10 lanzamientos en el Futurenet (una red de prueba para desarrolladores áspera y tumultuosa) y tres en el Testnet “con T mayúscula” (la red de prueba más estable para todo el ecosistema), los desarrolladores experimentaron, prototiparon y proporcionaron retroalimentación, y el stack de Soroban fue probado, fortalecido y refinado.

En este punto, las versiones estables de todo el software habilitado para el Protocolo-20 — que es la versión del protocolo que habilita las capacidades de Soroban — están disponibles.

Ahora que la red pública se ha actualizado al Protocolo 20, el objetivo es que cada proyecto en el ecosistema que aún no lo haya hecho actualice su software para asegurar la compatibilidad continua, evitar interrupciones y tiempos de inactividad, y prevenir errores no forzados.

Para mantenerte informado, hacer preguntas, hacer sugerencias o compartir información, asegúrate de unirte al Stellar Dev Discord y revisa el canal #protocol-20, que es donde el ecosistema está coordinando y compartiendo información sobre la actualización.

Cambios Importantes

Como de costumbre, las versiones antiguas del software de Stellar no funcionarán muy bien — si es que funcionan — ahora que la red se ha actualizado a una nueva versión del protocolo. En este momento, tanto Testnet como Mainnet están ejecutando el Protocolo 20, lo que significa que las versiones antiguas de Stellar Core no funcionarán en absoluto, y las versiones antiguas de Horizon y los SDKs de Stellar probablemente se detendrán cuando encuentren algo que no reconocen (como una transacción de Soroban). Para continuar construyendo, actualiza lo antes posible. Además de los problemas generales de compatibilidad, aquí hay algunos otros cambios a tener en cuenta:


Horizon y RPC:

  • Hay cambios en el protocolo que rompen en el parche de reinicio de Testnet del 6 de febrero. Consulta la lista completa de cambios en este parche.

Horizon:

  • Requiere una reconstrucción del estado. Consulta la Escalabilidad documentación para más información sobre cómo prepararse para posibles tiempos de inactividad.

Base de JavaScript y SDK de JavaScript :

  • El nombre del paquete NPM `@stellar/stellar-base` ha sido cambiado de `stellar-base`.
  • El nombre del paquete NPM `@stellar/stellar-sdk` ha sido cambiado de `stellar-sdk`.
  • Node 18 es la nueva versión mínima para usar los SDKs.
  • La biblioteca soroban-client ha sido fusionada en el paquete `@stellar/stellar-sdk`, causando cambios significativos detallados en una guía de migración.
  • Consulta las notas de la versión enlazadas arriba para todos los cambios importantes causados por estas actualizaciones de paquetes.

Registro de Cambios

19/03/2024 — La Fase 2 está completa. Ahora esta guía ayudará a cualquier rezagado a actualizar.

15/03/2024 — La votación de actualización de la Fase 2 está programada para el 19 de marzo. Se añadieron fechas clave e instrucciones para reflejar esta votación programada.

27/02/2024 — La red ahora está en la Fase 1. El siguiente paso será la votación de la Fase 2, fecha por determinar. Se añadió contexto e instrucciones adicionales tras esta actualización.

21/02/2024 — Fechas clave actualizadas para incluir la fecha programada de votación de la Fase 1 e incluyó instrucciones para que los validadores voten para aumentar los límites y mover la red a la Fase 1.

20/02/2024 — Los validadores votaron para actualizar la red pública al Protocolo 20, trayendo funcionalidad de contratos inteligentes a Stellar. Se añadió contexto, actualizaciones e instrucciones adicionales tras la votación de actualización de Mainnet que ocurrió el 20 de febrero.

09/02/2024 — Stellar Core v20.2.0 se hizo disponible: la copia fue actualizada con nuevas instrucciones para operadores de infraestructura de red.

06/02/2024 — Cronograma actualizado y copia para reflejar el hecho de que Testnet se actualizó con éxito.

30/01/2024 — Instrucciones de actualización del Protocolo 20 y cronogramas actualizados, incluyendo la nueva fecha de votación objetivo programada para el 20 de febrero.

29/01/2024 — Se añadió contexto respecto a la decisión de SDF de desarmar sus validadores en favor de posponer la votación de actualización del Protocolo 20.

19/12/2023 — Actualizado para señalar que la actualización de Testnet está completa, las versiones estables están disponibles para todo el software del Protocolo 20, la votación de actualización de Mainnet está programada para el 30 de enero, y todos tienen hasta entonces para instalar el software del Protocolo 20

13/12/2023 — Se añadió información sobre la reconstrucción del estado de Horizon y las instrucciones de actualización relacionadas.

12/12/2023 — Información corregida para entidades que ejecutan infraestructura de Testnet: las actualizaciones a Stellar Core y Horizon deberían ocurrir después del reinicio de Testnet el 18 de diciembre, no antes.

11/12/2023 — Se añadieron versiones de lanzamiento de Testnet de Stellar Core y Horizon.

08/12/2023 — Se añadieron enlaces, notas y cambios importantes para las versiones estables del SDK de JavaScript del Protocolo 20.

Próximos pasos

Más para que explores

Artículo

Protocolo 20: Preparándose para Contratos Inteligentes en Stellar

Contratos Inteligentes

Desarrolladores

Descubre la próxima actualización del Protocolo 20 en la red de Stellar, introduciendo contratos inteligentes de Soroban. Aprende sobre el proceso de…

Saber Más

Artículo

El Despliegue por Fases de Contratos Inteligentes de la Red Stellar: El Camino a Mainnet

Soroban

Contratos inteligentes

Desarrolladores

Actualización de protocolo

La liberación de un conjunto completo de software que admite el Protocolo 20, que traerá contratos inteligentes Soroban a Stellar está disponible.…

Ver