API de las aplicaciones

Qué son

La interfaz de la cadena es el JSON-RPC. Todo lo que aparece en estas páginas es algo que una aplicación se construyó para sí misma y después dejó accesible: un índice Postgres sobre el spool de logs del secuenciador, un proceso que guarda una clave, un bucle de juego. Son cómodos, son de primera parte, y no son autoritativos.

Dónde responden

Ninguno de estos servicios tiene un nombre de host propio. Cada uno es un montaje /api/ sobre el origen de una interfaz, lo que convierte la base pública en un hecho de nginx más que en un hecho del servicio: un despliegue que mueve un sitio mueve su API con él, y la ruta interna sigue siendo la misma. En una pila que usted mismo ejecute, los mismos servicios responden en el bucle invertido, en el puerto que nombra la página de cada uno.

Autenticación

Ninguno de los cuatro pide autenticación, y la diferencia que importa es lo que cada uno puede hacer sin ella.

• El explorador, la API del DEX y el arcade no piden ninguna. Son de solo lectura y públicos. El explorador responde 405 a todo POST; la API del DEX no implementa ningún verbo salvo GET.
• El faucet tampoco pide ninguna, y escribe en la cadena. Esa es toda la razón de que su cuota sea estricta y se reserve antes de firmar nada.

Llamar a uno desde un navegador

El CORS se configura servicio por servicio y no se ponen de acuerdo, así que lo primero que hay que establecer es si una página de su origen puede siquiera llamar al que quiere.

• La API del DEX no envía ninguna cabecera CORS y no tiene manejador OPTIONS. Un fetch de origen cruzado desde un navegador falla en seco mientras la misma petición desde un servidor funciona, que es la forma de fallo que todo el mundo achaca a la red. Póngala tras un proxy, o llámela desde un backend.
• El explorador y el faucet mantienen listas de permitidos. Un preflight venido de un origen que no está en la lista se rechaza con 403, lo que al menos es una respuesta clara.
• El arcade comprueba el Origin al actualizar la conexión y rechaza con 403 antes del apretón de manos, así que el socket nunca se abre en lugar de abrirse y quedarse callado.

Límites y paginación

Solo el explorador limita la tasa de peticiones. Los otros tres se apoyan en un acotamiento, en una cuota o en un techo de conexiones.

Donde existe paginación es limit y offset, no un cursor. Eso quiere decir que una lista que crece por la cabeza se desliza bajo sus pies entre dos páginas: filas ya vistas reaparecen, y filas nunca vistas pueden saltarse. Para todo lo que deba estar completo, pagine por una clave que usted controle - un número de bloque, un hash - en lugar de por offset.

Convenciones

// The shape of a careful call against any of these: a timeout, a status check
// before the body, and a big-integer parse of anything that looks like money.
const res = await fetch(`${BASE}/pools`, { signal: AbortSignal.timeout(5000) });
if (!res.ok) throw new Error(`pools: ${res.status}`);          // never the message
const { pools } = await res.json();                              // an object, not an array
const reserve0 = BigInt(pools[0].reserve0);                      // a decimal string

Cuando uno está caído

Cada uno de los cuatro falla de forma distinta, y solo uno de esos fallos parece un fallo visto desde fuera.

• La API del DEX responde 503 index not ready cuando la base de datos es inalcanzable o el indexador nunca ha corrido, de modo que las tablas no existen. Ese es el caso honesto. El deshonesto es un indexador que se ha DETENIDO: todas las rutas siguen respondiendo con el estado al que llegó, y solo lagBlocks en /health lo dice.
• El explorador sigue sirviendo el índice cuando el nodo es inalcanzable, y las partes de una respuesta que exigen una lectura en vivo - un saldo, un registro del servicio de nombres, el saldo pendiente del enrutador de comisiones - vuelven nulas o ausentes en lugar de dar error. El campo indexLag en /stats es la cifra a vigilar.
• El faucet responde 502 cuando el nodo no contesta, y no se ha firmado nada. Un 503 quiere decir que se ha quedado sin fondos, o que el drip revirtió.
• El /ready del arcade responde 503 cuando su socket hacia el nodo está caído, o cuando el último minibloque que APLICÓ tiene más de cinco segundos. Medir la llegada en su lugar dejaba que un proceso atascado respondiera 200 sin que nada se moviera.

Qué está documentado en otra parte

• The node. Chain state, transactions, logs and subscriptions are JSON-RPC and are documented in this reference's own RPC pages, not here.
• Contracts. What the pools, the faucet and the games actually do on chain - their functions, their events and their revert reasons - is the contract reference.
• Prices. Several answers here carry a dollar figure or a price snapshot. Those fields come from a layer this page does not own; read its own reference for what the number means, how old it is and when it is absent.