Resumen
Esta página explica cómo conectarse a BNB Chain Testnet (BSC Testnet) mediante un endpoint RPC. Encontrará el endpoint público oficial de OnFinality, la configuración de red, las instrucciones del faucet y consejos comunes de depuración para construir y probar dApps en testnet.
Inicio rápido: Conéctese a BNB Chain Testnet
Si está desarrollando en BNB Chain (anteriormente BSC) y necesita un entorno de testnet, BNB Chain Testnet (ID de cadena 97) es el lugar para comenzar. Esta guía le proporciona el endpoint RPC exacto, la configuración de red y consejos de depuración para poner en marcha su dApp rápidamente.
Endpoint público de OnFinality: https://bnb-testnet.api.onfinality.io/public
Este endpoint es gratuito para desarrollo y pruebas ligeras. Para cargas de trabajo de producción o límites de tasa más altos, considere un nodo dedicado o un plan RPC gestionado.
Configuración de red de un vistazo
Antes de conectarse, asegúrese de que su billetera o dApp utilice los parámetros de red correctos. Aquí tiene una tabla de referencia rápida:
| Parámetro | Valor |
|---|---|
| Nombre de red | BNB Smart Chain Testnet |
| ID de cadena | 97 |
| Moneda nativa | tBNB (Token nativo de BNB Chain) |
| Símbolo | tBNB |
| Decimales | 18 |
| Explorador de bloques | https://testnet.bscscan.com |
| Endpoint RPC | https://bnb-testnet.api.onfinality.io/public |
Añadir BNB Testnet a su billetera
La mayoría de los desarrolladores añaden la testnet a MetaMask u otra billetera para interactuar con su dApp. Aquí tiene un fragmento de configuración común que puede usar:
{
"chainId": "0x61",
"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"]
}
Puede añadirlo mediante el flujo "Agregar red" de MetaMask o programáticamente usando wallet_addEthereumChain.
Obtener BNB de testnet del faucet
Para pagar el gas en la testnet, necesita tBNB. El faucet oficial de BNB Chain es la fuente principal. Visite el faucet de BNB Chain y conecte su billetera. Recibirá una pequeña cantidad de tBNB, generalmente suficiente para unas pocas transacciones. Si necesita más, puede solicitarlo de nuevo después de un período de espera.
Realizar su primera llamada JSON-RPC
Una vez que tenga el endpoint, puede probar la conectividad con una llamada simple eth_chainId. Aquí tiene un ejemplo con curl:
curl -X POST https://bnb-testnet.api.onfinality.io/public \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
Respuesta esperada:
{"jsonrpc":"2.0","id":1,"result":"0x61"}
El 0x61 es la representación hexadecimal del ID de cadena 97.
Usando ethers.js o viem
Si está utilizando una biblioteca de JavaScript, aquí tiene cómo conectarse con ethers.js:
const { ethers } = require("ethers");
const provider = new ethers.JsonRpcProvider("https://bnb-testnet.api.onfinality.io/public");
async function getBlockNumber() {
const blockNumber = await provider.getBlockNumber();
console.log("Bloque actual:", blockNumber);
}
getBlockNumber();
Y con viem:
import { createPublicClient, http } from 'viem';
import { bscTestnet } from 'viem/chains';
const client = createPublicClient({
chain: bscTestnet,
transport: http('https://bnb-testnet.api.onfinality.io/public')
});
const blockNumber = await client.getBlockNumber();
console.log("Bloque actual:", blockNumber);
Depuración de problemas comunes
Incluso con el endpoint correcto, puede encontrar problemas. Aquí tiene una tabla rápida de solución de problemas:
| Síntoma | Causa probable | Solución |
|---|---|---|
eth_chainId devuelve un valor incorrecto | Red seleccionada incorrecta | Verifique que el ID de cadena sea 97 |
| Transacción atascada o descartada | tBNB insuficiente para gas | Obtenga más del faucet |
Error nonce too low | Replay de transacción o nonce obsoleto | Restablezca la actividad de la cuenta en la billetera |
| Tiempos de espera de conexión | Límite de tasa del endpoint público | Use un nodo dedicado o clave API |
| La llamada a contrato revierte | Contrato no desplegado en testnet | Verifique la dirección del contrato en el explorador |
RPC público vs. dedicado para testnet
Para pruebas simples, el endpoint público es suficiente. Pero si está ejecutando pruebas automatizadas, pruebas de carga o un pipeline de CI/CD, puede alcanzar los límites de tasa. En ese caso, considere un nodo dedicado o un plan RPC gestionado que ofrezca mayor rendimiento y más fiabilidad.
OnFinality proporciona infraestructura compartida y dedicada para BNB Chain Testnet. Puede consultar la página de red para obtener detalles y obtener una clave API.
Conclusiones clave
- El endpoint RPC de BNB Chain Testnet es
https://bnb-testnet.api.onfinality.io/public. - El ID de cadena es 97 y la moneda nativa es tBNB.
- Use el faucet oficial para obtener BNB de testnet.
- Pruebe su conexión con
eth_chainIdantes de construir. - Para pruebas de nivel de producción, considere un nodo dedicado o un servicio RPC gestionado.
Preguntas frecuentes
¿Cuál es la URL RPC de BNB Chain Testnet?
La URL RPC pública es https://bnb-testnet.api.onfinality.io/public. También puede obtener un endpoint dedicado de OnFinality.
¿Cómo obtengo BNB de testnet?
Use el faucet oficial de BNB Chain en https://www.bnbchain.org/en/testnet-faucet.
¿Cuál es el ID de cadena para BNB Testnet?
El ID de cadena es 97.
¿Puedo usar el mismo RPC para mainnet?
No, mainnet usa un endpoint e ID de cadena diferentes (56). Consulte la página de BNB Chain mainnet para obtener detalles.
¿El endpoint público tiene límite de tasa?
Los endpoints públicos pueden tener límites de tasa. Para límites más altos, considere un nodo dedicado o precios de RPC.