Endpoint de Mantle: Configuración de red, URLs RPC y depuración

Endpoint de Mantle de un vistazo

Mantle es una red de capa 2 de Ethereum que utiliza una arquitectura de rollup optimista con una capa de disponibilidad de datos modular. Si estás construyendo una dApp, un indexador o un servicio backend en Mantle, lo primero que necesitas es un endpoint RPC confiable para leer el estado de la cadena y enviar transacciones.

Aquí están los detalles esenciales de la red para la red principal de Mantle:

Esta tabla es el mínimo que necesitas para configurar una billetera, una dApp o un servicio backend. Para cargas de trabajo de producción, probablemente querrás un endpoint RPC dedicado en lugar de uno público compartido. Cubriremos esa decisión en la siguiente sección.

Recomendación rápida: ¿Endpoint público o dedicado?

Antes de copiar una URL RPC en tu código, decide qué tipo de endpoint se adapta a tu caso de uso. La elección correcta depende de tu tráfico, tu tolerancia a los límites de velocidad y si necesitas datos de archivo.

• Prototipado o pruebas de bajo volumen: Un endpoint público como https://mantle.api.onfinality.io/public es suficiente. Te permite validar llamadas a contratos y enviar algunas transacciones sin configuración.
• dApp de producción o backend: Usa un endpoint RPC dedicado. Los endpoints públicos son compartidos y pueden estar limitados en velocidad bajo carga pesada. Un nodo dedicado te da un rendimiento consistente y evita problemas de vecinos ruidosos.
• Indexación o análisis: Si necesitas estado histórico o quieres evitar los límites de eth_getLogs, considera un nodo de archivo o un proveedor que soporte datos de archivo.

Si no estás seguro, comienza con un endpoint público para desarrollo y luego migra a un endpoint dedicado antes del lanzamiento. OnFinality ofrece tanto acceso RPC público como nodos dedicados para Mantle, para que puedas escalar sin cambiar tu código.

Opciones de endpoint RPC de Mantle

Hay varias formas de acceder a los endpoints RPC de Mantle. Cada opción tiene compensaciones en costo, confiabilidad y control.

Endpoints públicos

Los endpoints públicos son gratuitos y fáciles de usar. Son adecuados para desarrollo, proyectos pequeños y consultas ocasionales. Sin embargo, son compartidos entre muchos usuarios, por lo que pueden ser más lentos o estar limitados en velocidad durante horas pico.

OnFinality proporciona un endpoint público de Mantle en https://mantle.api.onfinality.io/public. Este es un buen punto de partida para pruebas.

Nodos dedicados

Un nodo dedicado te da un endpoint RPC privado con recursos dedicados. No compartes el nodo con otros usuarios, lo que significa un rendimiento más consistente y límites de velocidad claros impuestos por otros inquilinos.

Los nodos dedicados son ideales para dApps de producción, servicios de alto tráfico y aplicaciones que necesitan hacer muchas solicitudes por segundo. El servicio de nodos dedicados de OnFinality te permite desplegar un nodo de Mantle con tu propio endpoint, y puedes elegir entre nodos de archivo y completos según tus necesidades.

Proveedores de terceros

Muchos proveedores de RPC ofrecen endpoints de Mantle. Al comparar proveedores, considera lo siguiente:

• Límites de rendimiento: ¿Cuál es el máximo de solicitudes por segundo (RPS) en el plan que estás considerando?
• Datos de archivo: ¿El proveedor ofrece nodos de archivo? Si es así, ¿a qué costo adicional?
• Soporte de WebSocket: ¿Necesitas actualizaciones en tiempo real? Asegúrate de que el proveedor soporte WSS.
• Distribución geográfica: ¿Los nodos están ubicados cerca de tus usuarios para reducir la latencia?

OnFinality es una opción entre varias. Recomendamos evaluar proveedores según tu carga de trabajo específica, no solo por el precio.

Configuración de red para billeteras y dApps

Cuando agregas Mantle a una billetera como MetaMask, o configuras una dApp, necesitas la configuración de red correcta. Aquí tienes un fragmento JSON que puedes usar:

{
  "chainId": "0x1388",
  "chainName": "Mantle",
  "nativeCurrency": {
    "name": "Mantle",
    "symbol": "MNT",
    "decimals": 18
  },
  "rpcUrls": ["https://mantle.api.onfinality.io/public"],
  "blockExplorerUrls": ["https://mantlescan.xyz"]
}

Ten en cuenta que el ID de cadena es 5000 en decimal, que es 0x1388 en hexadecimal. Algunas herramientas requieren el formato hexadecimal, por lo que es útil conocer ambos.

Haciendo llamadas JSON-RPC a Mantle

Una vez que tengas un endpoint, puedes interactuar con Mantle usando métodos JSON-RPC estándar de Ethereum. Aquí tienes un ejemplo básico de curl para obtener el número de bloque más reciente:

curl -X POST https://mantle.api.onfinality.io/public \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

También puedes usar bibliotecas como ethers.js o viem en tu dApp. Aquí tienes un ejemplo con ethers.js:

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://mantle.api.onfinality.io/public");

async function getBlockNumber() {
  const blockNumber = await provider.getBlockNumber();
  console.log("Número de bloque actual:", blockNumber);
}

getBlockNumber();

Para actualizaciones en tiempo real, puedes usar WebSocket. El endpoint público de OnFinality soporta WSS, pero para producción, debes usar un endpoint dedicado con una URL WSS estable. Aquí tienes un ejemplo simple de suscripción WebSocket:

const WebSocket = require('ws');
const ws = new WebSocket('wss://mantle.api.onfinality.io/public');

ws.on('open', function open() {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    method: 'eth_subscribe',
    params: ['newHeads'],
    id: 1
  }));
});

ws.on('message', function incoming(data) {
  console.log(data);
});

Modos de fallo comunes y cómo solucionarlos

Incluso con un endpoint correcto, puedes encontrar problemas. Aquí hay problemas comunes y sus soluciones.

Límite de velocidad

Si ves errores como 429 Too Many Requests o rate limit exceeded, estás alcanzando los límites del endpoint público. La solución es reducir la frecuencia de tus solicitudes o actualizar a un nodo dedicado con límites más altos.

Tiempos de espera de conexión

Si tus solicitudes agotan el tiempo de espera, el endpoint puede estar sobrecargado o tu conexión de red puede ser inestable. Verifica tu conexión a Internet e inténtalo de nuevo. Si el problema persiste, considera usar un nodo dedicado con un acuerdo de nivel de servicio.

ID de cadena incorrecto

Si estás enviando transacciones y fallan, verifica que estás usando el ID de cadena correcto (5000). Usar el ID de cadena incorrecto puede causar que las transacciones sean rechazadas.

Datos de archivo faltantes

Si necesitas datos históricos y tu nodo no es un nodo de archivo, puedes obtener errores al consultar estados antiguos. En ese caso, necesitas un nodo de archivo. OnFinality ofrece nodos de archivo para Mantle; consulta nuestra página de red para más detalles.

Depurando tu conexión a Mantle

Cuando algo sale mal, un enfoque sistemático ayuda. Aquí hay una ruta de depuración:

1. Verifica el endpoint: Asegúrate de que la URL sea correcta y accesible. Usa curl para hacer una llamada simple a eth_chainId.
2. Verifica el ID de cadena: Asegúrate de que tu cliente esté usando 5000.
3. Verifica el método: Algunos métodos pueden no ser compatibles con endpoints públicos. Por ejemplo, eth_getLogs con un rango de bloques amplio puede estar restringido.
4. Verifica la carga útil: Asegúrate de que tu solicitud JSON-RPC esté bien formada.
5. Verifica la respuesta: Observa el mensaje de error. A menudo te dice exactamente qué está mal.

Aquí tienes un comando curl para verificar el ID de cadena:

curl -X POST https://mantle.api.onfinality.io/public \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

Si obtienes una respuesta con result: "0x1388", tu endpoint está funcionando correctamente.

Monitoreando la salud de tu endpoint

Para aplicaciones de producción, debes monitorear tu endpoint RPC para detectar problemas temprano. Puedes configurar una verificación de salud simple que llame a eth_blockNumber cada pocos segundos y alerte si la solicitud falla o el número de bloque no avanza.

Aquí tienes un script de monitoreo simple usando Node.js:

const { ethers } = require("ethers");

const provider = new ethers.JsonRpcProvider("https://mantle.api.onfinality.io/public");

async function checkHealth() {
  try {
    const blockNumber = await provider.getBlockNumber();
    console.log(`Saludable. Bloque: ${blockNumber}`);
  } catch (error) {
    console.error("La verificación de salud falló:", error);
  }
}

setInterval(checkHealth, 30000);

Para un monitoreo más avanzado, puedes rastrear tiempos de respuesta, tasas de error y retraso en la altura del bloque. Si estás usando un nodo dedicado, también puedes monitorear el uso de recursos del nodo.

Conclusiones clave

• La red principal de Mantle usa el ID de cadena 5000 y el token nativo MNT.
• El endpoint RPC público https://mantle.api.onfinality.io/public es adecuado para desarrollo y pruebas.
• Para cargas de trabajo de producción, considera un endpoint RPC dedicado para evitar límites de velocidad y asegurar un rendimiento consistente.
• Siempre verifica el ID de cadena y usa los métodos JSON-RPC correctos.
• Monitorea la salud de tu endpoint para detectar problemas antes de que afecten a tus usuarios.

Preguntas frecuentes

¿Cuál es la URL RPC de Mantle?

La URL RPC pública para la red principal de Mantle es https://mantle.api.onfinality.io/public. Para uso en producción, es posible que desees un endpoint dedicado de un proveedor como OnFinality.

¿Cuál es el ID de cadena de Mantle?

El ID de cadena de Mantle es 5000 (decimal) o 0x1388 (hexadecimal).

¿Cómo agrego Mantle a MetaMask?

Puedes agregar Mantle a MetaMask usando la configuración de red proporcionada en este artículo. Alternativamente, puedes usar una herramienta de cambio de red que soporte Mantle.

¿Por qué falla mi solicitud RPC de Mantle?

Las razones comunes incluyen URL de endpoint incorrecta, ID de cadena incorrecto, límite de velocidad o problemas de red. Verifica el mensaje de error y consulta la sección de depuración anterior.

¿Ofrece OnFinality nodos dedicados de Mantle?

Sí, OnFinality ofrece nodos dedicados para Mantle. Puedes encontrar más información en nuestra página de nodos dedicados y página de red de Mantle.

Para más detalles sobre precios y redes compatibles, consulta nuestra página de precios de RPC y lista de redes compatibles.