Migrando a WalletConnect v2

Prepara tu dApp para la actualización v2 en 5 minutos o menos

El protocolo WalletConnect v1 se cerrará el 28 de junio de 2023, y RainbowKit te respalda para hacer la transición súper simple.

El soporte para WalletConnect v2 ahora es estándar en RainbowKit, sin cambios que rompan la compatibilidad. Solo actualiza y consulta la guía a continuación para obtener detalles adicionales.

Entendiendo WalletConnect v2

WalletConnect es el protocolo que permite a los usuarios conectar sus billeteras móviles a tu dApp, y es una base importante de RainbowKit. El reciente lanzamiento de WalletConnect v2 trae una serie de mejoras importantes para hacer la experiencia de la billetera y la dApp aún mejor.

Con v2, tus usuarios ahora pueden conectarse simultáneamente a múltiples cadenas, por lo que puedes olvidarte del apretón de manos para el cambio de cadena. También amplía el soporte para más redes y trae mejoras que hacen que Iniciar sesión con Ethereum sea aún más rápido.

Actualizando tu dApp

Si ya has seguido las guías de migración para RainbowKit 0.12.x y 1.0.x, ¡ya estás casi listo! Solo actualiza a la última versión de parche y pruébala.

RainbowKit habilitó WalletConnect v2 de manera predeterminada con 0.12.15 y 1.0.2. Continuamos dando soporte para 0.12.x en caso de que tu dApp aún no haya actualizado a wagmi v1 y RainbowKit v1.

1. Actualizando dependencias

npm i @rainbow-me/rainbowkit@^1.0.2 wagmi@^1.2

Si estás usando una versión de RainbowKit anterior a 0.12.x o 1.0.x, simplemente sigue las Guías de Migración para estar al día.

Se recomienda que las dApps 0.12.x comiencen a actualizarse a wagmi v1, ya que las mejoras de estabilidad para WalletConnect v2 solo se incluirán en futuras versiones de wagmi.

2. Suministrando un projectId

Cada dApp que depende de WalletConnect ahora necesita obtener un projectId de WalletConnect Cloud. Esto es absolutamente gratuito y solo lleva unos minutos.

Proporcione su projectId a getDefaultWallets y a los conectores individuales de cartera de RainbowKit como en el siguiente ejemplo:

const projectId = 'YOUR_PROJECT_ID';
const { wallets } = getDefaultWallets({
  appName: 'My RainbowKit App',
  projectId,
  chains,
});
const connectors = connectorsForWallets([
  ...wallets,
  {
    groupName: 'Other',
    wallets: [
      argentWallet({ projectId, chains }),
      trustWallet({ projectId, chains }),
      ledgerWallet({ projectId, chains }),
    ],
  },
]);

RainbowKit es seguro en términos de tipos y te advertirá cuando un projectId falte. Consulte nuestros ejemplos para ver la v2 en acción:

Consulta el docs para otras opciones soportadas.