Migración de la red Polkadot: ¿Qué cambia y cómo afecta a tus endpoints RPC?

Lista de verificación para la migración de Asset Hub de Polkadot

---

Antecedentes: La migración de Asset Hub

El 4 de noviembre de 2025, Polkadot completó una de sus actualizaciones más significativas: la migración de Asset Hub (AHM). Las funciones centrales de la red (saldos, staking y gobernanza) se trasladaron de la Relay Chain de Polkadot a Asset Hub de Polkadot, una parachain del sistema especializada diseñada para manejar operaciones dirigidas al usuario. La Relay Chain ahora se centra exclusivamente en el consenso, la seguridad y la interoperabilidad a través de XCM (Cross-Consensus Messaging).

Esta migración no fue solo una actualización de red; cambió fundamentalmente hacia dónde deben dirigirse las llamadas RPC. Para desarrolladores, operadores de infraestructura y mantenedores de dApps, entender qué se movió y qué permaneció es crítico para mantener las aplicaciones funcionando sin problemas.

---

Qué se movió y qué no

Movido a Asset Hub

• Saldos: system.account, transferencias y todo el pallet de saldos.
• Staking: Pools de nominación, validadores y lógica de pago de eras.
• Gobernanza: Referéndums, votación y gestión de tesorería. Nota: El pallet de staking de Relay Chain está obsoleto; usa el pallet de staking de Asset Hub.

Permaneció en Relay Chain

• Consenso: Producción de bloques, finalidad (GRANDPA) y BABE.
• Subastas de ranuras de parachain y gestión.
• Infraestructura de enrutamiento XCM central.

---

Impacto en endpoints RPC y operaciones de nodo

Para endpoints RPC

Tu proveedor de RPC ahora debe exponer tanto el endpoint de Relay Chain como un endpoint de Asset Hub. Las consultas orientadas al usuario (saldo, staking, gobernanza) deben apuntar a Asset Hub. Los endpoints de Relay Chain devolverán datos de usuario limitados después de la migración.

Ejemplo: Consultar la Relay Chain para obtener un saldo de DOT después de la migración devuelve un estado cero o desactualizado:

# Post-migración: esto ya no funcionará para saldos de usuario
curl -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "system.account",
  "params": ["13m5yA..."],
  "id": 1
}' https://polkadot-rpc.publicnode.com

En su lugar, dirígete al endpoint de Asset Hub:

# Destino correcto: Asset Hub
curl -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "method": "system.account",
  "params": ["13m5yA..."],
  "id": 1
}' https://asset-hub-polkadot-rpc.publicnode.com

Para operadores de nodos

Si ejecutas tu propio nodo, debes:

• Sincronizar un nodo de Relay Chain (para datos de consenso) y un nodo de parachain de Asset Hub (para datos de usuario), o
• Usar un proveedor que ofrezca una API fusionada, como los endpoints RPC de Polkadot de OnFinality que enrutan automáticamente las llamadas a la cadena correcta según el método.

---

Cómo actualizar tus conexiones RPC

1. Consulta la documentación de tu proveedor para las URLs de los endpoints de Asset Hub. Muchos proveedores los listan como asset-hub-polkadot.rpc... o similar.
2. Reescribe la lógica de tu aplicación para enrutar las consultas de usuario (saldo, staking, gobernanza) a Asset Hub.
3. Prueba exhaustivamente usando una testnet que refleje la migración (la migración de Asset Hub de Kusama ocurrió primero).
4. Monitorea errores como "Method not found" o devoluciones vacías; estos a menudo indican un destino de cadena incorrecto.

---

Errores comunes durante la migración

• Asumir que Relay Chain aún contiene saldos: Después del bloque de migración, system.account de Relay Chain devuelve cero para cuentas de usuario.
• Usar el pallet de staking de Relay Chain: Las RPC de staking ahora deben hacer referencia al pallet de staking de Asset Hub; las llamadas heredadas fallan.
• Ignorar el enrutamiento XCM: Las aplicaciones entre cadenas que antes enviaban fondos de usuario a través de Relay Chain pueden necesitar dirigirlos a través de Asset Hub.
• Almacenar en caché especificaciones de cadena antiguas: Actualiza tus archivos de especificación de cadena; la Relay Chain y Asset Hub tienen diferentes hashes de génesis y tipos.

---

Conclusiones clave

1. La migración de Asset Hub se completó el 4 de noviembre de 2025; no se requirió ninguna acción del usuario, pero las actualizaciones de dApps e infraestructura son esenciales.
2. Los saldos, el staking y la gobernanza ahora residen en Asset Hub; Relay Chain maneja el consenso y las operaciones de parachain.
3. Los endpoints RPC deben apuntar a la cadena correcta según la operación: Asset Hub para datos de usuario, Relay Chain para datos de protocolo.
4. OnFinality proporciona endpoints RPC de Polkadot que simplifican este enrutamiento, admitiendo consultas tanto de Relay Chain como de Asset Hub a través de una API unificada.
5. Si operas tu propio nodo, necesitas ejecutar tanto un nodo de Relay Chain como un nodo de parachain de Asset Hub, o usar un servicio RPC administrado para evitar la sobrecarga operativa.

---

Preguntas frecuentes

P: ¿Mi saldo de DOT se mostrará incorrectamente si aún uso el endpoint antiguo de Relay Chain? R: Sí. Después de la migración, las consultas a system.account de Relay Chain devolverán cero. Debes consultar Asset Hub para ver tu saldo real.

P: ¿Necesito actualizar las llamadas a contratos inteligentes? R: Solo si esas llamadas hacen referencia a saldos o staking en cadena. Las interacciones de contratos en parachains no se ven afectadas, pero cualquier interacción con pallets que se haya movido a Asset Hub debe redirigirse.

P: ¿Qué pasa con la gobernanza? ¿Puedo votar aún a través de Relay Chain? R: No. Las funciones de gobernanza se han trasladado a Asset Hub. Usa una billetera o aplicación que apunte al endpoint de Asset Hub para votar.

P: ¿Se perderán los datos históricos de RPC (archivo)? R: No, pero necesitas nodos de archivo para ambas cadenas para reconstruir el estado anterior a la migración. La mayoría de los proveedores de RPC conservan los datos de archivo de Relay Chain durante un período.

P: ¿Cómo sé si mi proveedor de RPC admite Asset Hub? R: Revisa su lista de redes. Si listan "Polkadot Asset Hub" o "AssetHub Polkadot" como una red separada, lo hacen. OnFinality admite ambas bajo nuestra red Polkadot.