Resumen
La testnet Sepolia es la red de pruebas principal de Ethereum con proof-of-stake. Replica el comportamiento de la mainnet lo suficiente como para desplegar contratos, ejecutar pruebas de integración y ensayar actualizaciones sin gastar ETH real. Los desarrolladores la usan porque es estable, ampliamente compatible con las herramientas y tiene un horizonte de soporte prolongado en comparación con testnets retiradas.
Conectarse a Sepolia es en gran medida un ejercicio de configuración: necesitas un endpoint RPC, el chain ID correcto (11155111), una cuenta de prueba con fondos y un explorador de bloques para verificar. La fricción suele venir de elegir un endpoint que pueda soportar tu carga de trabajo, mantener el flujo de fondos de prueba y depurar fallos que parecen bugs de mainnet pero que en realidad son problemas de configuración de la testnet.
Esta página te ofrece los ajustes de la cadena, una guía de decisión para elegir el endpoint, ejemplos de solicitudes y una ruta de depuración. También explica dónde encaja una API RPC gestionada o un nodo dedicado cuando los endpoints públicos no son suficientes.
Puntos clave
- Sepolia es una testnet de Ethereum con proof-of-stake, chain ID 11155111 y SepoliaETH como moneda nativa.
- Usa Sepolia para probar contratos, actualizaciones e integraciones antes de la mainnet; el ETH de prueba no tiene valor real.
- Un endpoint RPC fiable es la principal dependencia operativa para las pruebas en Sepolia y los pipelines de CI.
- Los endpoints públicos sirven para comprobaciones manuales, pero las cargas de trabajo automatizadas o de gran volumen necesitan un endpoint gestionado o dedicado.
- La mayoría de los fallos en Sepolia son problemas de configuración: chain ID incorrecto, cuenta sin fondos, nonce obsoleto o un endpoint que no admite el método que necesitas.
- OnFinality ofrece acceso RPC a Sepolia a través de su servicio de API y opciones de nodo dedicado; consulta la página de la red para los detalles actuales del endpoint.
Ajustes de la cadena Sepolia de un vistazo
Si solo necesitas añadir Sepolia a una wallet o a un framework de desarrollo, estos son los valores que debes usar. Guárdalos en un archivo de configuración compartido para que las pruebas, los scripts y la configuración de la wallet se mantengan coherentes.
Sepolia es una testnet de Ethereum, por lo que el comportamiento de la EVM y la superficie de JSON-RPC son cercanos a la mainnet. Por eso la mayoría de las herramientas de Ethereum la admiten con un simple cambio de red.
- Nombre de la red: Sepolia
- Chain ID: 11155111
- Símbolo de la moneda: SepoliaETH (ETH)
- Explorador de bloques: https://sepolia.etherscan.io
- Consenso: proof-of-stake
- Endpoint RPC: usa la URL de Sepolia de tu proveedor; los detalles del endpoint de OnFinality están en la página de la red Ethereum Sepolia
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Chain ID | 11155111 | Un chain ID incorrecto envía transacciones a la red equivocada o provoca errores en la wallet y el framework. |
| Moneda nativa | SepoliaETH (ETH), 18 decimales | La estimación de gas y la visualización de saldos dependen de los metadatos correctos de la moneda. |
| Explorador | sepolia.etherscan.io | Lo necesitas para verificar contratos e inspeccionar transacciones fallidas. |
| Transporte RPC | La compatibilidad con HTTP y WebSocket depende del proveedor | Las pruebas basadas en eventos y las suscripciones necesitan WebSocket; las lecturas y escrituras simples funcionan sobre HTTP. |
Guía de decisión: endpoint público, RPC gestionado o nodo dedicado
La configuración correcta de Sepolia depende de la frecuencia con la que ejecutas pruebas y del control que necesites. Un desarrollador que comprueba un despliegue puede usar un endpoint público. Un equipo que ejecuta CI en cada pull request normalmente necesita algo más predecible.
Usa esta tabla para decidir qué opción se ajusta a tu carga de trabajo. El objetivo no es elegir la opción más potente, sino la que elimina el modo de fallo que realmente estás encontrando.
- Endpoint público: sirve para comprobaciones rápidas y aprendizaje; espera capacidad compartida.
- API RPC gestionada: buena opción por defecto para equipos que quieren una URL estable sin ejecutar infraestructura.
- Nodo dedicado: adecuado cuando necesitas aislamiento, datos de archive o compatibilidad con métodos específicos a volumen.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Carga de trabajo | Despliegues manuales, ejecuciones ocasionales de scripts o CI automatizado en cada commit | Los endpoints públicos compartidos pueden tener límites de tasa o congestionarse cuando se ejecutan muchos trabajos a la vez. |
| Requisitos de métodos | ¿Necesitas eth_getLogs en rangos amplios, debug_traceTransaction o suscripciones WebSocket? | No todos los endpoints exponen métodos de trace o archive; los métodos ausentes provocan fallos que parecen bugs del contrato. |
| Profundidad de datos | ¿Las pruebas leen estado histórico o solo bloques recientes? | Se necesita acceso a archive para consultas de estado histórico y algunos flujos de depuración. |
| Aislamiento | ¿El tráfico de otros equipos puede afectar a tus ejecuciones de prueba? | Los nodos dedicados aíslan el rendimiento, lo que ayuda cuando las campañas de prueba tienen plazos ajustados. |
| Sobrecarga operativa | ¿Quieres ejecutar y actualizar tú mismo un nodo de Sepolia? | El autoalojamiento añade actualizaciones de cliente, gestión de disco y monitorización que no están relacionadas con tu producto. |
Conexión desde código: curl, viem y configuración de wallet
Una vez que tengas un endpoint, verifícalo con una llamada JSON-RPC simple antes de integrarlo en un framework. La comprobación del chain ID es la forma más rápida de confirmar que estás hablando con Sepolia y no con la mainnet.
Los ejemplos siguientes usan un marcador de posición para la URL de tu proveedor. Sustitúyelo por el endpoint de Sepolia de tu proveedor de RPC; los detalles del endpoint de OnFinality se listan en la página de la red Ethereum Sepolia.
curl -X POST <SEPOLIA_RPC_URL> -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' debería devolver 0xaa36a7 (11155111 en hexadecimal).- En viem, crea un objeto de cadena con id 11155111 y la URL RPC de Sepolia, y luego llama a getBlockNumber para confirmar la conectividad.
- En una wallet, añade una red personalizada con chain ID 11155111 y la URL del explorador de Sepolia para que los enlaces de verificación de contratos se resuelvan correctamente.
- Guarda el endpoint en una variable de entorno en lugar de codificarlo directamente, para que CI y el desarrollo local puedan usar proveedores distintos.
Obtener SepoliaETH y mantener disponibles los fondos de prueba
SepoliaETH no tiene valor monetario, pero aun así lo necesitas para pagar gas. Los faucets distribuyen pequeñas cantidades, y algunos requieren proof-of-work, una cuenta social o un saldo mínimo en la mainnet para reducir el abuso.
Para los equipos, el problema práctico no es financiar una wallet, sino mantener financiadas las cuentas de CI. Usa un número reducido de cuentas de prueba dedicadas, recárgalas de forma programada y evita compartir claves entre entornos.
- Usa cuentas separadas para desarrollo local, CI y pruebas manuales.
- Controla los saldos en tu configuración de pruebas y falla pronto con un mensaje claro cuando se necesite una recarga desde el faucet.
- No hagas commit de claves privadas de cuentas de prueba con fondos en un repositorio.
- Si un faucet no está disponible, consulta el explorador de Sepolia y las listas de faucets de la comunidad para buscar alternativas en lugar de reutilizar claves de mainnet.
Ruta de depuración para fallos comunes en Sepolia
La mayoría de los problemas de Sepolia se engloban en unas pocas categorías: red equivocada, fondos insuficientes, nonce obsoleto, método RPC no compatible o un contrato que se comporta de forma distinta porque el estado de la testnet difiere de la mainnet. Revisa los síntomas en orden antes de cambiar el código del contrato.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Síntoma | Causa probable | Siguiente paso |
| Transacción rechazada o enviada a la cadena equivocada | Chain ID de la wallet o del framework | Confirma 11155111 y que la URL RPC sea un endpoint de Sepolia |
| Fondos insuficientes para gas | Saldo de la cuenta y estado del faucet | Recarga la cuenta de prueba o cambia a una cuenta de CI con fondos |
| Nonce demasiado bajo o transacción de reemplazo con precio insuficiente | Transacciones pendientes y caché local de nonce | Espera a las transacciones pendientes o restablece el nonce de la cuenta en tus herramientas |
| Método no encontrado o no compatible | Disponibilidad del método RPC en tu endpoint | Cambia a un endpoint que admita métodos de trace, debug o archive si los necesitas |
| La llamada al contrato devuelve datos inesperados | Dirección del contrato y bloque de despliegue en Sepolia | Verifica que estás leyendo el despliegue de Sepolia, no una dirección de mainnet |
Dónde encaja OnFinality en un flujo de trabajo con Sepolia
OnFinality proporciona acceso a la API RPC e infraestructura de nodos dedicados en muchas redes, incluida Ethereum Sepolia. Para Sepolia, eso significa que puedes apuntar las pruebas y herramientas a un endpoint gestionado en lugar de depender de una URL pública compartida.
Si tu equipo ejecuta trabajos de CI con frecuencia, necesita métodos de archive o trace, o quiere capacidad aislada durante las campañas de prueba, revisa la página de la red Ethereum Sepolia y la página de precios de RPC antes de elegir un plan. Para criterios más amplios de evaluación de proveedores, consulta la guía de selección de proveedores de RPC.
- Usa un endpoint de Sepolia gestionado cuando quieras una URL estable para pruebas y scripts.
- Considera un nodo dedicado cuando necesites aislamiento, acceso a archive o compatibilidad con métodos específicos.
- Consulta las redes RPC compatibles para confirmar la disponibilidad actual de Sepolia y los detalles de transporte.
Preguntas frecuentes
¿Para qué se usa la testnet Sepolia?
Sepolia se usa para desplegar y probar contratos inteligentes, ejecutar pruebas de integración y ensayar actualizaciones de Ethereum antes de la mainnet. Se comporta como la mainnet de Ethereum pero usa ETH de prueba que no tiene valor real.
¿Cuál es el chain ID de Sepolia?
El chain ID de Sepolia es 11155111. En las respuestas JSON-RPC en hexadecimal aparece como 0xaa36a7.
¿Cómo obtengo SepoliaETH?
Usa un faucet de Sepolia. Algunos faucets requieren proof-of-work, una cuenta social o un saldo mínimo en la mainnet. Para los equipos, mantén financiado un pequeño conjunto de cuentas de prueba dedicadas en lugar de depender de una sola wallet.
¿Es Sepolia lo mismo que la mainnet de Ethereum?
No. Sepolia es una red de prueba separada con su propio estado y ETH de prueba. Los contratos y las herramientas son similares, pero las direcciones, los saldos y los contratos desplegados son distintos de los de la mainnet.
¿Puedo usar un endpoint RPC público de Sepolia para CI?
Los endpoints públicos pueden servir para un uso ligero, pero el CI automatizado a menudo necesita una capacidad más predecible. Una API RPC gestionada o un nodo dedicado suele encajar mejor para ejecuciones de prueba frecuentes o en paralelo.
¿OnFinality es compatible con Sepolia?
OnFinality proporciona acceso RPC a Ethereum Sepolia. Consulta la página de la red Ethereum Sepolia para los detalles actuales del endpoint y la compatibilidad de transportes.
Ethereum
Solana
Polygon
Base
Arbitrum
BNB Chain
Polkadot
Optimism
