Guía de actualización del protocolo 21

Si usas Testnet

La lista de lanzamientos necesarios para soportar el Protocolo 21 en Testnet ha sido actualizada en la página de lanzamientos de los docs. Por favor, consulta allí para ver lo que necesitas instalar antes de la actualización de Testnet del 14 de mayo. Dado que la actualización de Testnet ocurre antes de que todos los lanzamientos estables estén disponibles, necesitarás instalar versiones previas de algunos softwares. Para hacer eso, usa el siguiente comando:

cargo install --locked soroban-cli --version 21.0.0-preview.1

El lanzamiento estable estará disponible pronto, y mantendremos la lista a continuación actualizada a medida que los lanzamientos estén disponibles. Para prepararte para la votación de actualización de Mainnet, asegúrate de instalar versiones actualizadas de cualquier y todo software relacionado con Stellar que uses antes del 18 de junio de 2024.

Si usas un SDK de Stellar

Deberías estar ejecutando la última versión del SDK. Actualizaremos la sección de lanzamientos a continuación para indicar cuándo un lanzamiento del SDK con soporte para el Protocolo 21 esté disponible, así que vuelve a consultar si un SDK que usas aún no está listado.

Si ejecutas infraestructura de Stellar

Actualiza al último lanzamiento de Stellar Core y/o Horizon. Si usas imágenes de Docker, tira de la última del registro de Docker. Deberías estar en Stellar Core v21.0.0 o superior.

Si usas el RPC de Soroban

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

Si ejecutas un validador

La versión 21.0 de stellar-core introducirá una nueva bandera de configuración llamada DEPRECATED_SQL_LEDGER_STATE. Si esta bandera no está configurada, stellar-core no podrá iniciar. Esta bandera debe configurarse cuando un nodo se actualice al paquete stellar-core 21.0. Esta bandera debe configurarse cuando se despliegue el paquete, no cuando la red actualice realmente al Protocolo 21.La configuración predeterminada de esta bandera, y la configuración que la mayoría de los operadores de validadores deberían usar, es DEPRECATED_SQL_LEDGER_STATE=false. Si DEPRECATED_SQL_LEDGER_STATE=true, el nodo puede experimentar degradación del rendimiento y quedarse atrás del resto de la red.DEPRECATED_SQL_LEDGER_STATE solo debe configurarse en true si:

1. Debes ejecutar stellar-core con la bandera de modo “en memoria”.
2. Consultas directamente datos del backend SQL de stellar-core, y los datos consultados no son compatibles con BucketListDB (ver las “Características Obsoletas” listadas en el blog de BucketListDB).

Solo los operadores que ejecuten un nodo validador o de observación independiente necesitarán configurar esta bandera. Si captive-core está ejecutándose como parte de Horizon o RPC, la bandera se configurará automáticamente y no se requiere ninguna acción.

Para información adicional, contexto e instrucciones relacionadas con la actualización de BucketListDB, por favor lee el blog de BucketListDB y únete al canal #validators en Stellar Dev Discord.

La votación de actualización al Protocolo 21 está programada para el 18 de junio a las 1700 UTC. Aquí está el comando para armar tus nodos para la actualización:

upgrades?mode=set&upgradetime=2024-06-18T17:00:00Z&protocolversion=21

El 20 de febrero de 2024, los validadores votaron para actualizar al Protocolo 20, introduciendo contratos inteligentes de Soroban a la red pública de Stellar. Desde entonces, desarrolladores de todo el mundo han estado desplegando con éxito contratos inteligentes en Stellar Mainnet.

Actualmente, se está trabajando de arriba abajo en la pila de Stellar para evaluar, endurecer y poner los toques finales en el código para soportar el Protocolo 21, que introduce cinco nuevas CAPs en Mainnet. Para leer más sobre cada una de las CAPs incluidas en el Protocolo 21, ve el post del blog de anuncio del Protocolo 21 y los siguientes enlaces:

• CAP-0051 Funcionalidad de Host de Contrato Inteligente: Verificación Secp256r1
• CAP-0053 Funciones de host separadas para extender el TTL para la instancia del contrato y el código del contrato
• CAP-0054 Modelo de costo de instanciación de VM refinado de Soroban
• CAP-0055 Enlace simplificado de Soroban
• CAP-0056 Caché de módulo intra-transacción de Soroban

El 18 de junio, después de una actualización de Testnet y lanzamientos estables de Stellar Core, Horizon y RPC, programados para mayo, los validadores de la red pública de Stellar votarán si actualizan la red pública al Protocolo 21. Las votaciones de actualización son programáticas — son parte de una ronda regular de consenso — y cuando se aprueban, la actualización tiene efecto inmediato.

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