Resumen
El explorador de NEAR Intents es un panel de solo lectura para la actividad cross-chain basada en intents. Muestra el volumen agregado, los swaps recientes, las clasificaciones de referidos y afiliados, y un feed consultable de intents individuales con remitente, destinatario, activo, estado y marca temporal. Resulta útil para verificar que un swap cross-chain se liquidó, auditar el comportamiento de los solvers o crear una vista de monitorización del flujo de intents.
Si necesitas los mismos datos dentro de tus propias herramientas, el explorador no es la superficie de integración. La historia de intents se consulta a través de la API de solo lectura del explorador, y el estado subyacente de la cadena NEAR se consulta a través de un endpoint NEAR RPC. Son tareas distintas: la API del explorador responde a «qué ocurrió con este intent», mientras que RPC responde a «cuál es el estado on-chain actual de esta cuenta, bloque o transacción».
Esta página separa ambas cosas para que puedas elegir la fuente de datos adecuada, evitar construir sobre una UI que nunca se pensó como backend y mantener tu propio indexador o panel fiable. Para los equipos que ejecutan cargas de trabajo NEAR en producción, OnFinality ofrece acceso a la API NEAR RPC e infraestructura de nodos dedicados junto con muchas otras redes compatibles.
Puntos clave
- El explorador de NEAR Intents es una vista de solo lectura de la actividad de intents: volumen, swaps, referidos, afiliados y estado por intent.
- La UI del explorador y la API del explorador tienen propósitos distintos; ninguna sustituye a un endpoint NEAR RPC para el estado de la cadena.
- Usa la API del explorador para registros históricos de intents y NEAR RPC para el estado de cuentas, bloques y transacciones.
- Los valores de estado de intent como processing y success describen el progreso de la liquidación, no la finalidad de la cadena de destino.
- Para monitorización en producción, combina una fuente de datos de intents de solo lectura con un proveedor NEAR RPC fiable y tus propias alertas.
- OnFinality ofrece acceso a la API NEAR RPC y opciones de nodos dedicados; consulta la página de redes compatibles para ver la cobertura actual.
Qué muestra realmente el explorador de NEAR Intents
El explorador de NEAR Intents es un panel sobre la actividad cross-chain basada en intents. Sus paneles principales son el volumen agregado (histórico, 24 h, 7 d, 30 d), una lista de los principales swaps, clasificaciones de referidos y afiliados, y un feed en vivo de intents individuales. Cada fila de intent suele exponer el activo y la cantidad, las direcciones de remitente y destinatario, la ruta o la fuente de referido, una etiqueta de estado y una marca temporal relativa.
Eso lo convierte en una herramienta de verificación y observabilidad, no en un terminal de trading ni en un explorador de cadena. Responde a preguntas como: si este swap cross-chain se liquidó, qué solver o referido lo enrutó y cuánto volumen se movió en un periodo determinado. No sustituye a un explorador de bloques NEAR general para saldos de cuentas, estado de contratos o recibos de transacciones en bruto.
- Paneles de volumen agregado para histórico, 24 h, 7 d y 30 d
- Principales swaps por tamaño nocional en las últimas 24 horas
- Clasificaciones de referidos y afiliados por número de transacciones y volumen
- Feed por intent con activo, cantidad, remitente, destinatario, estado y marca temporal
- Búsqueda por dirección de wallet, dirección de depósito o hash de transacción
UI del explorador, API del explorador o NEAR RPC: elige la fuente correcta
La mayor parte de la confusión en torno al explorador de NEAR Intents viene de tratar tres fuentes de datos distintas como intercambiables. No lo son. La UI del explorador es para personas. La API del explorador es una interfaz histórica de solo lectura para registros de intents. Un endpoint NEAR RPC es la interfaz de cadena para el estado de cuentas, bloques y transacciones. Elegir la incorrecta lleva a scrapers frágiles o a datos faltantes.
Una regla práctica: si la pregunta es sobre el ciclo de vida y el enrutamiento de un intent, empieza por la API del explorador. Si la pregunta es sobre el estado on-chain, como el saldo de una cuenta, el resultado de una llamada a un contrato o la altura de un bloque, usa NEAR RPC. Si necesitas ambos en un mismo producto, ejecutarás dos rutas de datos y las unirás en tu propio backend.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| UI del explorador | Paneles legibles para personas, cuadro de búsqueda, etiquetas de estado | Es rápida para verificación manual, pero no es una superficie de integración estable ni está diseñada para polling automatizado. |
| API del explorador | Endpoints históricos de solo lectura para intents y estados de transacciones | Es la mejor opción para paneles, tareas de conciliación y analítica del flujo de intents sin hacer scraping de la UI. |
| NEAR RPC | Métodos JSON-RPC para cuentas, bloques, transacciones y llamadas a contratos | Es necesario cuando necesitas el estado actual de la cadena o debes confirmar los efectos on-chain de una liquidación. |
| Tu propio indexador | Almacenamiento, reintentos y uniones entre registros de intents y estado de la cadena | La monitorización en producción suele necesitar una copia duradera para no depender de una única fuente en vivo. |
Guía de decisión: qué fuente encaja con tu carga de trabajo
Usa esta breve guía antes de escribir código. Evita el error habitual de construir un backend sobre una UI que cambia sin aviso, o de saturar un endpoint RPC con datos que una API histórica ya devuelve.
- Verificar un swap a mano: usa la búsqueda de la UI del explorador por dirección o hash de transacción.
- Crear un panel de volumen y estados de intents: usa la API del explorador y cachea los resultados.
- Comprobar el saldo de una cuenta o el estado de un contrato: usa NEAR RPC, no el explorador.
- Conciliar la liquidación entre cadenas: une los registros de intents de la API del explorador con lecturas RPC de la cadena de destino.
- Ejecutar alertas sobre intents atascados: consulta la API del explorador de forma programada y almacena las transiciones de estado.
- Necesitar rendimiento predecible para lecturas de alto volumen: usa un endpoint NEAR RPC gestionado o dedicado en lugar de uno público compartido.
Consultar datos de intents sin hacer scraping de la UI
El explorador expone una API de solo lectura para datos históricos de intents y estados de transacciones. Trátala como una fuente de datos con sus propios límites de tasa, paginación y esquema, y lee su documentación antes de depender de los nombres de campos. El patrón siguiente muestra la forma de una solicitud típica; sustituye la ruta y los parámetros por los que documente la API que estés llamando.
Mantén la lógica de solicitudes en un único módulo adaptador para que los cambios de esquema queden contenidos. Guarda la respuesta en bruto junto a tu registro normalizado para poder reproducir o volver a derivar campos más adelante.
- Pagina de forma explícita y registra el cursor o token de página que usaste por última vez.
- Trata las respuestas no 200 y los conjuntos de resultados vacíos como estados normales, no como excepciones.
- Persiste el payload en bruto antes de normalizar para que los cambios de esquema sean recuperables.
- Registra el ID de solicitud o la marca temporal de cada consulta para facilitar la revisión de incidentes.
Leer el estado de la cadena NEAR con JSON-RPC
Cuando necesites confirmar el estado on-chain, llama a un endpoint NEAR RPC. El ejemplo siguiente usa la forma JSON-RPC estándar para una consulta de bloque. Usa la URL de endpoint que te proporcione tu proveedor de RPC; para OnFinality, consulta la página de la red NEAR para ver el endpoint actual en lugar de codificar una URL pública compartida.
Mantén las lecturas de cadena separadas de las lecturas de intents en tu código. Un patrón de producción habitual es un poller de intents que escribe en una cola y un lector de cadena que resuelve las referencias on-chain de cada elemento en cola.
- Usa los métodos de bloque o chunk para confirmar que existe un bloque referenciado.
- Usa los métodos de cuenta y view para leer saldos y estado de contratos.
- Define tiempos de espera explícitos y reintenta con backoff ante errores transitorios.
- No asumas que un estado de intent exitoso significa que la cadena de destino ha finalizado; verifícalo en la cadena de destino cuando sea importante.
Modos de fallo que debes esperar al monitorizar intents
La monitorización de intents falla de formas predecibles. La tabla siguiente relaciona síntomas con causas probables y el siguiente paso de depuración, para que puedas hacer triaje sin adivinar.
| Criterio | Qué revisar | Por qué importa |
|---|---|---|
| Intent atascado en processing | Disponibilidad del solver, congestión de la cadena de destino y la ruta del intent | Processing es un estado de liquidación, no un error; comprueba la cadena de destino antes de escalar. |
| La API del explorador devuelve vacío para un hash conocido | Paginación, ventana temporal y si el hash es de depósito o de destino | Distintos identificadores resuelven a distintos registros; buscar el equivocado parece un dato faltante. |
| Tiempos de espera de RPC durante el polling | Tasa de solicitudes, salud del endpoint y configuración de reintentos | Los endpoints públicos compartidos tienen límites de tasa; el polling sostenido necesita un endpoint gestionado o dedicado. |
| El estado no coincide entre el explorador y tu panel | Intervalo de polling, estado en caché y lógica de normalización | Las cachés obsoletas y el mapeo incorrecto de campos son la causa habitual, no los datos subyacentes. |
| Los totales de volumen difieren de tu propia suma | Fuente de precios de activos, límites de la ventana temporal y reglas de inclusión | Los paneles agregados pueden usar precios o filtros distintos de los de una suma bruta de intents. |
Lista de comprobación de producción antes de lanzar un monitor de intents
Antes de poner un monitor de intents delante de los usuarios, confirma lo básico de operación. Estos puntos son baratos de comprobar y caros de descubrir en producción.
- Tienes una fuente de datos documentada para cada campo que muestras.
- Los registros de intents y las lecturas de cadena se almacenan por separado y se unen en tu backend.
- Los intervalos de polling respetan los límites de la API del explorador y de tu proveedor de RPC.
- Tienes alertas sobre intents atascados y sobre tasas de error de RPC.
- Tienes un endpoint RPC de respaldo o un proveedor gestionado para failover.
- Has revisado los precios de RPC para que el volumen de polling no te sorprenda.
- Has comprobado las redes RPC compatibles para ver la cobertura actual de NEAR antes del lanzamiento.
Preguntas frecuentes
¿Es el explorador de NEAR Intents lo mismo que un explorador de bloques NEAR?
No. El explorador de NEAR Intents se centra en la actividad cross-chain basada en intents, como swaps, referidos y estado de liquidación. Un explorador de bloques NEAR muestra datos generales de la cadena, como bloques, cuentas y llamadas a contratos. Usa ambos cuando necesites conciliar un intent con sus efectos on-chain.
¿Puedo usar la API del explorador en lugar de ejecutar un nodo NEAR?
Solo para datos históricos de intents. La API del explorador es de solo lectura y está limitada a registros de intents. Si necesitas el estado actual de cuentas, llamadas a contratos o datos de bloques, necesitas un endpoint NEAR RPC, ya sea autoalojado o de un proveedor gestionado.
¿Por qué un intent aparece como processing durante mucho tiempo?
Processing suele significar que el intent se ha enviado pero la liquidación no se ha completado. Comprueba la disponibilidad del solver, la congestión de la cadena de destino y la ruta. Si persiste, verifica la cadena de destino directamente en lugar de confiar solo en la etiqueta de estado.
¿Cómo busco un intent específico?
Usa la búsqueda del explorador con una dirección de wallet, una dirección de depósito o un hash de transacción. Ten en cuenta que los identificadores de depósito y de destino pueden resolver a registros distintos, así que prueba ambos si la primera búsqueda no devuelve nada.
¿Ofrece OnFinality acceso a NEAR RPC?
OnFinality ofrece acceso a la API RPC e infraestructura de nodos dedicados en muchas redes. Consulta la página de redes RPC compatibles para ver la cobertura actual de NEAR y los detalles del endpoint, y revisa los precios de RPC para los planes basados en solicitudes.
Ethereum
Solana
Polygon
Base
Arbitrum
BNB Chain
Polkadot
Optimism
