Resumen
La URL RPC de BNB Smart Chain (BSC) es el endpoint que tu dApp, billetera o script utiliza para enviar solicitudes JSON-RPC a la red BSC. El endpoint público oficial de OnFinality es https://bnb.api.onfinality.io/public. Este artículo explica cómo configurarlo, qué verificar al elegir un proveedor de RPC y cómo depurar problemas comunes.
Respuesta rápida: la URL RPC de BNB Smart Chain
La URL RPC de BNB Smart Chain (BSC) es el endpoint que tu aplicación utiliza para comunicarse con la red BSC a través de JSON-RPC. El endpoint público oficial de OnFinality es:
https://bnb.api.onfinality.io/public
Esta URL funciona tanto para conexiones HTTP como WebSocket. Puedes usarla en MetaMask, Hardhat, ethers.js, viem o cualquier otra herramienta Web3 que admita endpoints RPC personalizados.
Configuración de la cadena de un vistazo
Antes de conectarte, asegúrate de que tu configuración coincida con los parámetros de la red principal de BSC:
| Configuración | Valor |
|---|---|
| Nombre de la red | BNB Smart Chain Mainnet |
| Chain ID | 56 |
| Moneda nativa | BNB (18 decimales) |
| Explorador de bloques | https://bscscan.com |
| URL RPC (OnFinality) | https://bnb.api.onfinality.io/public |
| URL WebSocket | wss://bnb.api.onfinality.io/public/ws |
Para desarrollo en testnet, usa la BNB Chain Testnet con chain ID 97 y el endpoint https://bnb-testnet.api.onfinality.io/public.
Cómo configurar la URL RPC en una billetera
Si quieres agregar BSC a MetaMask u otra billetera, usa la configuración de cadena anterior. Aquí tienes un ejemplo para MetaMask:
- Abre MetaMask y haz clic en el menú desplegable de redes.
- Haz clic en Agregar red.
- Completa los detalles:
- Nombre de la red: BNB Smart Chain
- Nueva URL RPC: https://bnb.api.onfinality.io/public
- Chain ID: 56
- Símbolo de moneda: BNB
- URL del explorador de bloques: https://bscscan.com
- Haz clic en Guardar.
Ahora tu billetera puede interactuar con BSC.
Usando la URL RPC en código
Aquí te mostramos cómo usar el endpoint con ethers.js y viem.
ethers.js
const { ethers } = require("ethers");
const provider = new ethers.JsonRpcProvider("https://bnb.api.onfinality.io/public");
async function getBlockNumber() {
const blockNumber = await provider.getBlockNumber();
console.log("Current block:", blockNumber);
}
getBlockNumber();
viem
import { createPublicClient, http } from 'viem';
import { bsc } from 'viem/chains';
const client = createPublicClient({
chain: bsc,
transport: http('https://bnb.api.onfinality.io/public'),
});
const blockNumber = await client.getBlockNumber();
console.log('Current block:', blockNumber);
RPC público vs. gestionado: ¿cuál deberías usar?
Los endpoints RPC públicos como el anterior son excelentes para desarrollo, pruebas y aplicaciones de bajo tráfico. Sin embargo, son compartidos entre muchos usuarios, lo que puede provocar limitación de velocidad y respuestas más lentas en momentos de alta demanda.
Para aplicaciones de producción, deberías considerar un proveedor de RPC gestionado. OnFinality ofrece precios de RPC y redes RPC compatibles que incluyen BSC. Los endpoints gestionados proporcionan mayor confiabilidad, mejor rendimiento y opciones dedicadas.
Cómo elegir un proveedor de RPC para BSC
Al evaluar proveedores de RPC para BSC, considera estos factores:
| Criterio | Qué verificar | Por qué importa |
|---|---|---|
| Tiempo de actividad y confiabilidad | Historial de tiempo de actividad, SLAs | El tiempo de inactividad significa que tu dApp no está disponible |
| Rendimiento y límites de velocidad | Solicitudes por segundo, capacidad de ráfaga | Las aplicaciones de alto tráfico necesitan margen |
| Datos de archivo | ¿El proveedor ofrece nodos de archivo? | Necesario para consultas históricas y análisis |
| Soporte WebSocket | ¿Admite wss://? | Requerido para suscripciones en tiempo real |
| Opciones dedicadas | ¿Puedes obtener un nodo dedicado? | Aísla tu tráfico de vecinos ruidosos |
| Modelo de precios | Pago por uso vs. suscripción | Costos predecibles para tu presupuesto |
OnFinality ofrece nodos BSC tanto compartidos como dedicados. Para cargas de trabajo de alto rendimiento, un nodo dedicado te brinda un rendimiento más consistente. Consulta nuestra comparación de proveedores de RPC de BNB Chain para más detalles.
Errores comunes de RPC y cómo depurarlos
Aquí hay algunos problemas comunes que podrías encontrar al usar una URL RPC de BSC:
| Error | Causa probable | Solución |
|---|---|---|
connection refused | URL incorrecta o problema de red | Verifica la URL y tu conexión a internet |
rate limit exceeded | Demasiadas solicitudes en un endpoint compartido | Usa un proveedor gestionado o agrega lógica de reintento |
invalid chain id | Chain ID incorrecto en tu configuración | Establece el chain ID a 56 para mainnet |
method not found | Uso de un método JSON-RPC no compatible | Verifica el soporte de métodos del proveedor |
timeout | Red lenta o proveedor sobrecargado | Aumenta el tiempo de espera o usa un nodo dedicado |
Depuración con curl
Puedes probar tu endpoint RPC con un simple comando curl:
curl -X POST https://bnb.api.onfinality.io/public \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
Una respuesta exitosa se ve así:
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x1a2b3c"
}
Suscripciones WebSocket
Para datos en tiempo real, usa el endpoint WebSocket. Aquí tienes un ejemplo con ethers.js:
const { ethers } = require("ethers");
const provider = new ethers.WebSocketProvider("wss://bnb.api.onfinality.io/public/ws");
provider.on("block", (blockNumber) => {
console.log("New block:", blockNumber);
});
Conclusiones clave
- La URL RPC de BNB Smart Chain es la puerta de entrada a BSC para tu dApp o billetera.
- El endpoint público de OnFinality es https://bnb.api.onfinality.io/public.
- Siempre verifica el chain ID (56) y otros ajustes al configurar tu entorno.
- Para producción, considera un proveedor de RPC gestionado para mayor confiabilidad y rendimiento.
- Usa los consejos de depuración anteriores para resolver problemas comunes de RPC rápidamente.
Preguntas frecuentes
¿Cuál es la URL RPC de BNB Smart Chain?
La URL RPC pública oficial de OnFinality es https://bnb.api.onfinality.io/public. Admite HTTP y WebSocket.
¿Puedo usar la URL RPC de BSC gratis?
Sí, el endpoint público es gratuito para desarrollo y uso ligero. Para producción, consulta precios de RPC para opciones gestionadas.
¿Cuál es la URL RPC de la testnet de BSC?
La URL RPC de la BNB Chain Testnet es https://bnb-testnet.api.onfinality.io/public con chain ID 97.
¿Cómo agrego BSC a MetaMask?
Usa la configuración de cadena proporcionada en este artículo para agregar BSC como una red personalizada.
¿Qué debo hacer si me limitan la velocidad?
Cambia a un proveedor de RPC gestionado o implementa lógica de reintento con retroceso exponencial. OnFinality ofrece opciones escalables para cargas de trabajo de producción.