¿Cómo agrego BNB Smart Chain Testnet a MetaMask?

Respuesta rápida: BNB Smart Chain Testnet en MetaMask

BNB Smart Chain Testnet (también llamado BSC Testnet) es una red de prueba pública que replica la red principal de BNB Smart Chain. Puedes agregarla a MetaMask en menos de un minuto usando la configuración de red a continuación. La red usa el ID de cadena 97 y el token nativo es BNB de prueba (tBNB), que no tiene valor real y se obtiene de un faucet.

{
  "chainId": "97",
  "chainName": "BNB Smart Chain Testnet",
  "nativeCurrency": {
    "name": "BNB Chain Native Token",
    "symbol": "tBNB",
    "decimals": 18
  },
  "rpcUrls": ["https://bnb-testnet.api.onfinality.io/public"],
  "blockExplorerUrls": ["https://testnet.bscscan.com"]
}

Configuración de red de un vistazo

Estos valores son el endpoint público oficial de OnFinality. Si usas un proveedor de RPC diferente, asegúrate de que el ID de cadena y el símbolo coincidan exactamente; las discrepancias hacen que MetaMask rechace la red o muestre un saldo incorrecto.

Paso a paso: Agregar BNB Smart Chain Testnet a MetaMask

1. Abre MetaMask y haz clic en el selector de red en la parte superior de la billetera.
2. Haz clic en Agregar red (o Agregar una red manualmente si ya tienes una red personalizada abierta).
3. Completa el formulario con los valores de la tabla anterior.
4. Haz clic en Guardar y luego cambia a la nueva red.
5. Solicita tBNB de prueba desde un faucet (ver más abajo) y confirma que el saldo aparezca.

Si prefieres una opción de un solo clic, algunos faucets y dApps ofrecen un botón "Agregar a MetaMask" que rellena automáticamente los detalles de la red. Siempre verifica el ID de cadena y la URL RPC antes de aprobar.

Financiando tu billetera con tBNB

Los tokens de testnet son gratuitos y no tienen valor monetario. Para obtener tBNB, usa un faucet oficial de BNB Chain. Muchos faucets requieren que conectes tu billetera y completes un captcha. Después de la solicitud, los tokens suelen llegar en menos de un minuto.

Si el faucet no funciona, prueba:

• Cambiar a un faucet diferente (busca "BNB Smart Chain testnet faucet").
• Verificar que tu billetera esté conectada a la red de testnet.
• Esperar unos minutos y reintentar, ya que los faucets limitan la frecuencia de solicitudes.

Elegir el endpoint RPC adecuado para el desarrollo en testnet

Para pruebas simples de billetera, el endpoint RPC público anterior es suficiente. Pero si estás construyendo una dApp, ejecutando pruebas automatizadas o necesitas un rendimiento consistente, considera la diferencia entre endpoints públicos y administrados.

Endpoints RPC públicos

Los endpoints públicos son gratuitos y fáciles de usar. Son adecuados para solicitudes ocasionales, pero a menudo tienen límites de frecuencia y pueden volverse lentos durante el alto tráfico. Si tu aplicación hace muchas llamadas, puedes encontrar errores 429 Too Many Requests.

Servicios RPC administrados

Los servicios administrados como OnFinality proporcionan endpoints RPC dedicados o compartidos con mayor rendimiento, soporte WebSocket y datos de archivo. Están diseñados para cargas de trabajo de producción y te dan una URL estable que no cambia cuando reinicias tu nodo.

Para el desarrollo en testnet, un endpoint administrado te ayuda a evitar límites de frecuencia cuando estás depurando o ejecutando pruebas de carga. Puedes comenzar con el endpoint público gratuito y actualizar cuando necesites más capacidad.

Errores comunes de MetaMask y cómo solucionarlos

"Error: Chain ID mismatch"

Esto ocurre cuando el endpoint RPC devuelve un ID de cadena diferente al que ingresaste. Verifica que el ID de cadena sea 97 y que la URL RPC apunte a la testnet, no a la mainnet.

"Error: Network not added"

MetaMask a veces falla al agregar una red si la URL RPC no es accesible. Prueba con una URL RPC diferente o verifica tu conexión a internet. También puedes agregar la red manualmente ingresando los detalles nuevamente.

"Transaction hangs"

Si las transacciones quedan pendientes, tu endpoint RPC puede estar sobrecargado. Cambia a un endpoint más confiable o aumenta el precio del gas. En testnet, también puedes intentar restablecer tu cuenta en MetaMask (Configuración > Avanzado > Borrar datos de la pestaña de actividad).

"Insufficient funds"

Necesitas tBNB para pagar el gas. Si tu saldo es cero, solicita más desde un faucet. Recuerda que los tokens de testnet son separados del BNB de mainnet.

Usando la testnet con ethers.js y viem

Una vez que la red esté en MetaMask, puedes conectar tu dApp a ella usando una biblioteca como ethers.js o viem. Aquí hay un ejemplo con ethers.js:

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://bnb-testnet.api.onfinality.io/public");
const signer = await provider.getSigner(); // cuando uses MetaMask, usa el proveedor del navegador en su lugar

const balance = await provider.getBalance("0xYourAddress");
console.log("tBNB balance:", ethers.formatEther(balance));

Para un entorno de navegador, usa window.ethereum para obtener el firmante:

const provider = new ethers.BrowserProvider(window.ethereum);
await provider.send("wallet_switchEthereumChain", [{ chainId: "0x61" }]); // 97 en hexadecimal
const signer = await provider.getSigner();

¿Cuándo vale la pena un nodo dedicado para testnet?

Si solo estás agregando la red a MetaMask para probar una dApp, un endpoint público es suficiente. Pero si eres un desarrollador que ejecuta un conjunto de pruebas o un entorno de staging, es posible que necesites más.

Considera un nodo dedicado cuando:

• Necesitas un rendimiento consistente para pruebas automatizadas.
• Requieres datos de archivo para consultar el estado histórico.
• Quieres evitar límites de frecuencia durante las pruebas de carga.
• Necesitas soporte WebSocket para actualizaciones en tiempo real.

OnFinality ofrece nodos compartidos y dedicados para BNB Chain Testnet. Puedes comparar opciones en la página de precios de RPC y ver la lista completa de redes compatibles en la página de redes.

Conclusiones clave

• BNB Smart Chain Testnet usa el ID de cadena 97 y el token tBNB.
• El endpoint RPC público oficial es https://bnb-testnet.api.onfinality.io/public.
• Agregar la red a MetaMask es un proceso manual; verifica todos los campos para evitar errores.
• Los tokens de testnet son gratuitos y se obtienen de faucets.
• Para cargas de trabajo de desarrollo, considera un servicio RPC administrado para evitar límites de frecuencia y obtener mayor confiabilidad.

Preguntas frecuentes

¿Cuál es la URL RPC de BNB Smart Chain Testnet?

La URL RPC pública oficial es https://bnb-testnet.api.onfinality.io/public. También puedes encontrarla en la página de red de BNB Chain Testnet.

¿Cómo agrego BNB Smart Chain Testnet a MetaMask?

Abre MetaMask, ve a Configuración > Redes > Agregar red, e ingresa el ID de cadena 97, la URL RPC y el símbolo tBNB. Consulta la guía paso a paso anterior.

¿Dónde puedo obtener BNB de prueba?

Usa un faucet oficial de BNB Chain. Busca "BNB Smart Chain testnet faucet" y sigue las instrucciones. Los tokens son gratuitos y solo para pruebas.

¿Por qué mi transacción está atascada en BNB testnet?

Las transacciones atascadas a menudo se deben a un endpoint RPC lento o a un precio de gas bajo. Intenta cambiar a un endpoint RPC diferente o aumentar el límite de gas. También puedes borrar los datos de actividad de MetaMask.

¿Puedo usar la misma URL RPC para mainnet?

No. Mainnet usa un ID de cadena diferente (56) y una URL RPC diferente (https://bnb.api.onfinality.io/public). No los mezcles, o tus transacciones fallarán.

¿OnFinality soporta BNB Smart Chain Testnet?

Sí. OnFinality proporciona endpoints RPC públicos y dedicados para BNB Chain Testnet. Visita la página de red de BNB Chain Testnet para más detalles.