Migración de Polkadot: Lo que los desarrolladores deben saber sobre la transición de Relay Chain a Asset Hub

¿Qué es la migración de Polkadot?

La migración de Polkadot se refiere a la transferencia de funciones centrales de la red (balances, staking y gobernanza) desde la Relay Chain a la parachain del sistema Asset Hub. Esto se ejecutó en Kusama el 7 de octubre de 2025 y en Polkadot el 4 de noviembre de 2025. Asset Hub es una parachain especializada diseñada para gestionar operaciones orientadas al usuario, mientras que la Relay Chain ahora se enfoca únicamente en el consenso, la seguridad y la interoperabilidad entre cadenas.

Este cambio arquitectónico reduce la hinchazón de estado en la Relay Chain, permite actualizaciones de runtime más rápidas y prepara la red para el protocolo JAM (Join-Accumulate Machine). Para los desarrolladores, significa que ciertos endpoints RPC y APIs de runtime se han movido. Las aplicaciones que anteriormente consultaban la Relay Chain para obtener datos de balance, staking o gobernanza ahora deben apuntar a Asset Hub.

• Balances, staking y gobernanza migraron a Asset Hub.
• La Relay Chain ahora maneja solo el consenso y la interoperabilidad.
• Migración completada el 4 de noviembre de 2025 para Polkadot.
• No se requiere acción para los usuarios finales; los desarrolladores deben actualizar los objetivos RPC.

Impacto técnico en los endpoints RPC

El impacto más inmediato para los desarrolladores es el cambio en qué cadena maneja llamadas RPC específicas. Anteriormente, consultas como system.account, staking.* y democracy.* eran servidas por la Relay Chain. Después de la migración, estas llamadas deben dirigirse al endpoint RPC de Asset Hub.

Por ejemplo, para obtener el saldo de DOT de un usuario, ahora debe consultar el almacenamiento system.account de Asset Hub. De manera similar, las operaciones de staking (bond, nominate, etc.) y las propuestas de gobernanza ahora se procesan en Asset Hub. El RPC de la Relay Chain seguirá funcionando para consultas relacionadas con el consenso (por ejemplo, chain.getBlock, chain.getHeader) e información de parachains.

Si está utilizando Substrate API Sidecar o herramientas similares, asegúrese de apuntar a la cadena correcta para cada endpoint. OnFinality proporciona endpoints RPC separados para Polkadot Relay Chain y Polkadot Asset Hub, lo que facilita el enrutamiento adecuado de las solicitudes.

Qué deben actualizar los desarrolladores

Para garantizar que sus dApps y servicios continúen funcionando correctamente después de la migración, revise las siguientes áreas:

1. **Configuración del endpoint RPC**: Actualice su aplicación para usar los endpoints RPC de Asset Hub para consultas de balance, staking y gobernanza. Si usa un proveedor como OnFinality, puede cambiar al endpoint específico de Asset Hub o usar una puerta de enlace unificada que enrute las solicitudes adecuadamente.

2. **Llamadas a la API de runtime**: Cualquier código que llame a APIs de runtime relacionadas con balances, staking o gobernanza debe actualizarse para apuntar a Asset Hub. Esto incluye scripts personalizados, bots y herramientas de monitoreo.

3. **Pruebas**: Ejecute un conjunto de pruebas completo contra el RPC de Asset Hub para verificar que todos los datos esperados se devuelvan correctamente. Preste especial atención a los casos extremos como cuentas multisig, cuentas proxy y cronogramas de vesting.

4. **Infraestructura**: Si ejecuta sus propios nodos, asegúrese de sincronizar tanto la Relay Chain como Asset Hub. Para producción, considere usar un proveedor administrado para evitar problemas de sincronización.

• Actualice los endpoints RPC a Asset Hub para balance, staking y gobernanza.
• Revise y actualice las llamadas a la API de runtime en su código.
• Pruebe a fondo contra la testnet o mainnet de Asset Hub.
• Asegúrese de que su infraestructura de nodos sincronice ambas cadenas.

Migración y hardware wallets Ledger

Para los usuarios con hardware wallets Ledger, la migración también implica pasar de las aplicaciones heredadas específicas de parachain a la nueva aplicación Polkadot Generic. Este es un proceso separado de la migración de Asset Hub pero igualmente importante. La aplicación Polkadot Migration y el Asistente de Migración de Polkadot (de Zondax) ayudan a los usuarios a transferir activos de cuentas antiguas de Kusama y parachain a nuevas cuentas Generic.

Los desarrolladores que crean integraciones de billeteras deben asegurarse de que su software sea compatible con la nueva aplicación Polkadot Generic y el proceso de migración. Esto incluye actualizar las rutas de derivación de cuentas y la lógica de firma. La migración no afecta a los DOT mantenidos directamente en la Relay Chain a través de la aplicación Polkadot antigua; solo los activos en parachains que usan aplicaciones heredadas necesitan migración.

• Las aplicaciones Ledger heredadas de parachain están obsoletas; use la aplicación Polkadot Generic.
• La aplicación Polkadot Migration ayuda a transferir activos a cuentas Generic.
• Los DOT en la Relay Chain a través de la aplicación Polkadot antigua no requieren migración.
• Los desarrolladores de billeteras deben ser compatibles con las nuevas rutas de derivación de la aplicación Generic.

Mejores prácticas de prueba y validación

Antes de implementar cambios en producción, siga estos pasos para validar la compatibilidad de su aplicación con la red Polkadot posterior a la migración:

1. **Use una testnet**: La testnet de Polkadot (Westend) y la testnet de Asset Hub están disponibles para pruebas. OnFinality proporciona endpoints RPC para ambas. Simule transferencias de saldo, operaciones de staking y votaciones de gobernanza para confirmar el comportamiento correcto.

2. **Monitoree las respuestas RPC**: Compare las respuestas de la Relay Chain y Asset Hub para las mismas consultas. Asegúrese de que la consistencia de los datos se mantenga y que no falten campos.

3. **Consulte la documentación**: Consulte las preguntas frecuentes oficiales de migración de Polkadot Asset Hub y las guías para desarrolladores para cualquier cambio adicional en las APIs de runtime o elementos de almacenamiento.

4. **Interactúe con la comunidad**: Únase al canal de Telegram de soporte de migración de Asset Hub o al Foro de Polkadot para mantenerse actualizado sobre cualquier problema o parche posterior a la migración.

• Pruebe en la testnet de Westend antes de mainnet.
• Compare las respuestas RPC entre la Relay Chain y Asset Hub.
• Revise la documentación oficial de migración para cambios en la API.
• Únase a los canales de la comunidad para soporte en tiempo real.

Cómo OnFinality respalda su migración

OnFinality ofrece una plataforma de infraestructura robusta que simplifica la transición. Nuestra API RPC de Polkadot proporciona endpoints dedicados tanto para la Relay Chain como para Asset Hub, lo que le permite enrutar solicitudes con cambios mínimos de configuración. También admitimos nodos dedicados para equipos que requieren rendimiento garantizado y configuraciones personalizadas.

Nuestra cobertura de red incluye Polkadot, Asset Hub y todas las parachains principales, lo que garantiza que tenga acceso a los datos que necesita. Ya sea que esté probando escenarios de migración o ejecutando aplicaciones de producción, la infraestructura de OnFinality está diseñada para brindar confiabilidad y facilidad de uso.

Para los desarrolladores que buscan migrar sus llamadas RPC, nuestra documentación proporciona ejemplos claros y mejores prácticas. Visite nuestra página de red de Polkadot para comenzar.

• Endpoints RPC separados para Relay Chain y Asset Hub.
• Opciones de nodos dedicados para cargas de trabajo de producción.
• Documentación y soporte integrales.
• Más de 50 redes compatibles, incluidas todas las parachains de Polkadot.

Preguntas frecuentes