Resumen
El endpoint de Scroll es la API JSON-RPC para la red Scroll de capa 2 de Ethereum. Esta página explica qué es el endpoint de Scroll, cómo configurar tu wallet o dApp, y cómo elegir el proveedor de RPC adecuado para cargas de trabajo de producción.
Recomendación rápida: ¿Qué endpoint de Scroll deberías usar?
Si estás construyendo una dApp, ejecutando un servicio backend o simplemente probando en Scroll, la elección del endpoint puede afectar la fiabilidad y el rendimiento de tu aplicación. Para desarrollo y uso ligero, el endpoint público es suficiente. Para cargas de trabajo de producción, deberías considerar un endpoint RPC dedicado o privado para evitar límites de tasa y garantizar una disponibilidad constante.
- Para pruebas rápidas y prototipos: Usa el endpoint público
https://scroll.api.onfinality.io/public. - Para dApps de producción: Usa un endpoint RPC privado de un proveedor como OnFinality, que ofrece nodos dedicados y mayor rendimiento.
- Para configuración de wallet: Usa la configuración de red a continuación para añadir Scroll a MetaMask u otras wallets.
¿Qué es el endpoint de Scroll?
El endpoint de Scroll es el endpoint de API JSON-RPC para la red Scroll, una solución de escalado de capa 2 de Ethereum que utiliza zk-rollups. Te permite interactuar con la blockchain de Scroll—enviando transacciones, consultando datos y desplegando contratos inteligentes—utilizando herramientas estándar de Ethereum como ethers.js, viem o curl.
Scroll está diseñado para ser compatible con EVM, lo que significa que la mayoría del código de Ethereum funciona sin modificaciones. El endpoint sirve como puerta de entrada a la red, y su rendimiento impacta directamente en la experiencia de usuario de tu aplicación.
Configuración de red de Scroll de un vistazo
Aquí están los parámetros clave de red que necesitas para configurar tu wallet o dApp:
| Parámetro | Valor |
|---|---|
| Nombre de la red | Scroll |
| Chain ID | 534352 |
| Moneda nativa | ETH (Ether) |
| Símbolo | ETH |
| Decimales | 18 |
| Explorador de bloques | https://scrollscan.com |
| URL de RPC pública | https://scroll.api.onfinality.io/public |
| URL de WebSocket | wss://scroll.api.onfinality.io/public-ws |
Estos ajustes son esenciales para añadir Scroll a tu wallet o configurar tu aplicación.
Cómo configurar tu wallet con el endpoint de Scroll
Para añadir Scroll a MetaMask u otra wallet, sigue estos pasos:
- Abre tu wallet y navega a la configuración de red.
- Haz clic en "Añadir red" o "RPC personalizado".
- Introduce los detalles de la tabla anterior.
- Guarda y cambia a la red Scroll.
Aquí tienes un ejemplo de un fragmento de configuración de wallet (por ejemplo, para MetaMask):
{
"chainId": "0x82750", // 534352 en hexadecimal
"chainName": "Scroll",
"nativeCurrency": {
"name": "Ether",
"symbol": "ETH",
"decimals": 18
},
"rpcUrls": ["https://scroll.api.onfinality.io/public"],
"blockExplorerUrls": ["https://scrollscan.com"]
}
Haciendo tu primera solicitud JSON-RPC a Scroll
Una vez que tengas el endpoint, puedes probarlo con un simple comando curl. Por ejemplo, para obtener el número de bloque actual:
curl https://scroll.api.onfinality.io/public \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
La respuesta se verá algo así:
{"jsonrpc":"2.0","id":1,"result":"0x..."}
El resultado es el número de bloque más reciente en hexadecimal. Puedes convertirlo a decimal para ver la altura de bloque actual.
Usando el endpoint de Scroll con ethers.js y viem
La mayoría de los desarrolladores usan librerías como ethers.js o viem para interactuar con la red Scroll. Así es como te conectas usando ethers.js:
const { ethers } = require("ethers");
const provider = new ethers.JsonRpcProvider("https://scroll.api.onfinality.io/public");
async function getBlockNumber() {
const blockNumber = await provider.getBlockNumber();
console.log("Número de bloque actual:", blockNumber);
}
getBlockNumber();
Y con viem:
import { createPublicClient, http } from 'viem';
const client = createPublicClient({
chain: {
id: 534352,
name: 'Scroll',
network: 'scroll',
nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
rpcUrls: {
default: { http: ['https://scroll.api.onfinality.io/public'] },
public: { http: ['https://scroll.api.onfinality.io/public'] },
},
blockExplorers: {
default: { name: 'ScrollScan', url: 'https://scrollscan.com' },
},
},
transport: http(),
});
const blockNumber = await client.getBlockNumber();
console.log("Número de bloque actual:", blockNumber);
Soporte de WebSocket para aplicaciones en tiempo real
Si tu aplicación necesita actualizaciones en tiempo real—como recibos de transacciones o nuevos bloques—puedes usar el endpoint de WebSocket. Esto es útil para indexadores, herramientas de monitoreo o dApps que necesitan reaccionar a eventos en cadena al instante.
Aquí tienes un ejemplo de suscripción a nuevos encabezados de bloque usando WebSocket:
const WebSocket = require('ws');
const ws = new WebSocket('wss://scroll.api.onfinality.io/public-ws');
ws.on('open', () => {
ws.send(JSON.stringify({
jsonrpc: '2.0',
method: 'eth_subscribe',
params: ['newHeads'],
id: 1
}));
});
ws.on('message', (data) => {
console.log('Nuevo bloque:', JSON.parse(data));
});
Endpoints de Scroll públicos vs. privados: ¿Cuál es la diferencia?
Los endpoints públicos son gratuitos y abiertos a todos, pero tienen limitaciones:
- Límites de tasa: Los endpoints públicos a menudo tienen límites de solicitudes para prevenir abusos.
- Fiabilidad: Pueden ser menos fiables bajo carga pesada.
- Privacidad: Tus solicitudes no son privadas; pueden ser vistas por el proveedor.
Los endpoints privados, por otro lado, ofrecen:
- Mayor rendimiento: Obtienes recursos dedicados, por lo que puedes manejar más solicitudes por segundo.
- Mejor fiabilidad: Los nodos dedicados son menos propensos a verse afectados por el tráfico de otros usuarios.
- Privacidad: Tus solicitudes no se comparten con otros usuarios.
Para aplicaciones de producción, un endpoint privado suele ser la elección correcta. OnFinality ofrece nodos dedicados de Scroll y endpoints RPC privados que se pueden adaptar a tus necesidades. Consulta nuestros precios de RPC para más detalles.
Errores comunes y solución de problemas con endpoints de Scroll
Aquí hay algunos problemas comunes que los desarrolladores enfrentan al usar endpoints de Scroll y cómo resolverlos:
| Síntoma | Causa probable | Solución |
|---|---|---|
eth_blockNumber devuelve un error | URL de endpoint incorrecta | Verifica la URL y asegúrate de que sea la red correcta |
| Errores de límite de tasa (HTTP 429) | Demasiadas solicitudes | Usa un endpoint privado o implementa lógica de reintento |
| La conexión WebSocket se cae | Inestabilidad de red | Implementa lógica de reconexión |
| Transacción no encontrada | Chain ID incorrecto | Asegúrate de que tu chain ID sea 534352 |
Cómo elegir un proveedor de RPC de Scroll para producción
Al seleccionar un proveedor de RPC de Scroll, considera los siguientes criterios:
- Disponibilidad y fiabilidad: Busca proveedores con un historial de alta disponibilidad.
- Rendimiento: Asegúrate de que el proveedor pueda manejar el volumen de solicitudes esperado.
- Soporte de WebSocket: Si necesitas datos en tiempo real, asegúrate de que WebSocket esté soportado.
- Datos de archivo: Si necesitas estado histórico, verifica si el proveedor ofrece nodos de archivo.
- Precios: Compara modelos de precios para encontrar uno que se ajuste a tu presupuesto.
OnFinality es una buena opción a considerar, ya que ofrece nodos dedicados y precios flexibles. Puedes explorar nuestras redes compatibles para ver si Scroll está listado y qué servicios están disponibles.
Conclusiones clave
- El endpoint de Scroll es la API JSON-RPC para la red de capa 2 de Scroll.
- Usa el endpoint público para pruebas, pero considera un endpoint privado para producción.
- Configura tu wallet con el chain ID correcto (534352) y la URL de RPC.
- El soporte de WebSocket está disponible para aplicaciones en tiempo real.
- Elige un proveedor que cumpla con tus necesidades de fiabilidad, rendimiento y presupuesto.
Preguntas frecuentes
¿Cuál es el chain ID de Scroll? El chain ID de Scroll es 534352.
¿Cuál es la moneda nativa de Scroll? Scroll usa ETH como su moneda nativa, con 18 decimales.
¿Puedo usar el endpoint de Scroll con MetaMask? Sí, puedes añadir Scroll como red personalizada usando la configuración de red proporcionada anteriormente.
¿Ofrece OnFinality un endpoint dedicado de Scroll? OnFinality proporciona infraestructura de nodos dedicados para varias redes. Consulta nuestra página de red para disponibilidad y detalles.
¿Cómo obtengo soporte para problemas de RPC de Scroll? Si estás usando OnFinality, puedes contactar a nuestro equipo de soporte. Para problemas generales, consulta la documentación de Scroll y los foros de la comunidad.