Migración de Kusama: qué cambió y cómo actualizar tus endpoints RPC

Puntos de verificación rápidos para la migración

Si eres desarrollador u operador de infraestructura en Kusama, la migración a Asset Hub cambia dónde envías ciertas llamadas RPC. Aquí tienes una lista rápida para actualizar tus endpoints:

• Identifica de qué cadena depende tu dApp. Si usabas la Relay Chain para transferencias de saldo, staking o gobernanza, probablemente necesites cambiar a Asset Hub Kusama.
• Actualiza tu configuración de red. Cambia el endpoint RPC y el chain ID a Asset Hub Kusama. Consulta la página de red de Asset Hub Kusama para ver el endpoint oficial.
• Prueba con una transacción pequeña. Antes de salir a producción, envía una transferencia de prueba para confirmar que tu wallet y backend usan la cadena correcta.
• Monitorea errores. Presta atención a errores como InvalidTransaction o UnknownConnection que indican que todavía apuntas a la cadena antigua.

Si no estás seguro de qué cadena requiere tu caso de uso, la siguiente sección detalla la migración y su impacto.

Qué cambió realmente con la migración de Kusama

La migración de Kusama, ejecutada el 7 de octubre de 2025, trasladó la funcionalidad principal de la Kusama Relay Chain a Asset Hub Kusama. Esto forma parte de una hoja de ruta más amplia para hacer la red más escalable y accesible. La migración se completó en aproximadamente 3 horas y 13 minutos, moviendo todos los activos, pallets, cuentas y proxies.

Para los desarrolladores, el cambio clave es que Asset Hub Kusama es ahora la cadena principal para transferencias y gestión de activos. La Relay Chain sigue existiendo, pero ya no es el lugar para enviar transferencias de KSM ni interactuar con activos. Esto significa que tus endpoints RPC deben actualizarse para apuntar a Asset Hub Kusama para estas operaciones.

Por qué esto importa para tu dApp

Si tu dApp maneja transferencias de KSM, consulta saldos o interactúa con activos, ahora debe comunicarse con Asset Hub Kusama. Usar el endpoint de la Relay Chain antigua resultará en errores o datos obsoletos. La migración también trajo varias mejoras:

• Saldo mínimo más bajo: reducido de 0.00003 KSM a 0.000003 KSM.
• Tarifas de transacción más bajas: reducidas de 0.00053 KSM a 0.00009 KSM.
• Más soporte de tokens: USDT, USDC, DOT y otros tokens del ecosistema.
• Acceso unificado: KSM, activos, staking y gobernanza en un solo lugar.
• Pago de tarifas en cualquier token: paga las tarifas de transacción con cualquier activo compatible.

Estos cambios son beneficiosos, pero requieren que actualices tu infraestructura para aprovecharlos.

Configuración de la cadena de un vistazo

Estos son los ajustes clave para Asset Hub Kusama. Úsalos para actualizar tu configuración de red.

Nota: El endpoint RPC no está fijo aquí porque puede variar según el proveedor. Usa el endpoint público oficial de OnFinality que aparece en la página de red.

Actualización de tu endpoint RPC

Para actualizar tu dApp, necesitas cambiar el endpoint RPC en tu configuración. Aquí tienes un ejemplo usando una biblioteca común de JavaScript como polkadot-js:

const { ApiPromise, WsProvider } = require('@polkadot/api');

// Reemplaza con el endpoint oficial de Asset Hub Kusama
const wsProvider = new WsProvider('wss://assethub-kusama-rpc.polkadot.io');

async function main() {
  const api = await ApiPromise.create({ provider: wsProvider });
  console.log(`Conectado a la cadena: ${await api.rpc.system.chain()}`);
}

main().catch(console.error);

Si usas una API REST u otra biblioteca, el mismo principio aplica: actualiza la URL del endpoint y asegúrate de que el chain ID coincida.

Errores comunes y cómo evitarlos

Estos son los problemas más comunes que enfrentan los desarrolladores después de la migración y cómo evitarlos:

Lista de verificación de migración para aplicaciones en producción

Antes de implementar, revisa esta lista para asegurar una transición sin problemas:

• Actualiza todos los endpoints RPC a Asset Hub Kusama.
• Actualiza el chain ID en todas las configuraciones.
• Prueba con una transferencia pequeña en la nueva cadena.
• Verifica que las consultas de saldo devuelvan datos correctos.
• Monitorea los registros en busca de errores después de la implementación.
• Comunica los cambios a tus usuarios si usan tu aplicación para transferencias de KSM.

Elegir el proveedor RPC adecuado

Al actualizar tus endpoints, también puedes evaluar tu proveedor RPC. La migración es un buen momento para asegurarte de que tu proveedor soporte Asset Hub Kusama y ofrezca la confiabilidad que necesitas. Considera lo siguiente:

• Cobertura de red: ¿El proveedor soporta Asset Hub Kusama y otras parachains de Kusama?
• Opciones de transporte: ¿Necesitas WebSocket, HTTPS o ambos?
• Límites de tasa: ¿Hay límites que puedan afectar tu tráfico?
• Soporte: ¿Hay un canal de soporte dedicado para problemas?

OnFinality ofrece servicios RPC para Asset Hub Kusama y muchas otras redes. Puedes consultar redes RPC compatibles y precios de RPC para ver si se ajusta a tus necesidades. OnFinality también proporciona nodos dedicados para aplicaciones de alto tráfico.

Conclusiones clave

• La migración de Kusama trasladó la funcionalidad principal a Asset Hub Kusama.
• Actualiza tus endpoints RPC a Asset Hub Kusama para transferencias de activos y consultas de saldo.
• Usa el chain ID correcto (1000) y prueba antes de salir a producción.
• Monitorea errores comunes como InvalidTransaction.
• Evalúa tu proveedor RPC para asegurarte de que soporte la nueva cadena.

Preguntas frecuentes

¿Necesito migrar mis tokens KSM?

No. La migración fue automática. Tus tokens KSM se movieron a Asset Hub Kusama sin ninguna acción de tu parte.

¿Qué pasa con mi historial de transacciones antiguo?

El historial de transacciones antiguo permanece en la Kusama Relay Chain. Aún puedes consultarlo, pero las nuevas transacciones estarán en Asset Hub Kusama.

¿Puedo seguir usando la Relay Chain para staking?

La funcionalidad de staking se ha movido a Asset Hub Kusama. Debes actualizar tu dApp o wallet de staking para usar la nueva cadena.

¿Cómo encuentro el endpoint RPC oficial?

Consulta la página de red de Asset Hub Kusama para ver el endpoint público oficial de OnFinality.

¿Qué pasa si uso un wallet que no soporta Asset Hub Kusama?

Es posible que necesites cambiar a un wallet que soporte la migración. Muchos wallets se han actualizado, pero algunos como Trust Wallet tuvieron problemas. Consulta la documentación de tu wallet para ver el soporte de migración.