Uniswap Aggregator Hooks: varios pares pueden compartir un solo pool

La etiqueta del pool solo muestra la entrada

El 22 de octubre de 2026, Uniswap Labs anunció que Aggregator Hooks estaba disponible en su Web App y su API en Ethereum mainnet, Base y Robinhood Chain. El mecanismo envuelve fuentes externas de liquidez en una interfaz v4. Por tanto, el enrutador puede encontrar un pool v4 cuyo intercambio utiliza liquidez situada en otro lugar. La disponibilidad procede del anuncio del proveedor; este artículo no verifica de forma independiente los despliegues de cada cadena.^[1]

Octubre fue una expansión, no el primer lanzamiento. El 18 de marzo, Labs ya había descrito el primer despliegue activo en Tempo: un aggregator hook que presenta el DEX nativo de stablecoins de esa cadena como un conjunto de pools v4. La interfaz incorpora otra fuente al enrutamiento sin convertirla en un pool nativo convencional de v4.^[2]

Varios pares pueden utilizar las mismas reservas

La implementación pública permite concretar esa diferencia. BaseAggregatorHook rechaza los intentos de añadir liquidez mediante el callback de liquidez del núcleo de v4. Su callback de intercambio invoca, en cambio, la ruta de liquidación del hook. El código explica el diseño del adaptador; que una integración figure en el repositorio no demuestra que esté activa en todas las cadenas anunciadas.^[4][1]

Curve ofrece un ejemplo claro. El repositorio documenta un hook por pool subyacente de Curve y un par v4 distinto por cada combinación de tokens. En su ejemplo de ocho tokens aparecen 28 pares, todos con el mismo hook y el mismo pool subyacente. Es una ilustración de la correspondencia, no una observación de un pool concreto de ocho tokens desplegado.^[3]

Esas 28 vistas de pares no representan 28 conjuntos independientes de reservas. Un intercambio modifica el pool compartido y afecta a otras direcciones que incluyan alguno de los tokens utilizados. Si una ruta pasa más de una vez por la misma fuente, debe tener en cuenta ese estado compartido. Contar etiquetas de pares no permite determinar cuánta liquidez es independiente.^[3]

La regla depende del adaptador. Para fuentes compatibles con V2, un único hook puede atender muchos pares externos distintos, localizando cada uno mediante una fábrica y sus dos tokens. Las correspondencias compatibles con V3 también utilizan el nivel de comisión o el espaciado entre ticks pertinente. Repetir una dirección de hook identifica un pool compartido en el diseño de Curve descrito; no es una prueba universal de reservas compartidas.^[3]

La API enlazada utiliza una beta de activación explícita

El anuncio de la expansión afirma que la Web App incluye automáticamente liquidez externa. Sus enlaces a la API llevan a la documentación de Guidestar Routing (Beta). Esta beta admite actualmente intercambios EXACT_INPUT entre dos tokens distintos de una misma cadena en Ethereum, Base y Robinhood Chain. EXACT_INPUT fija la cantidad de entrada. Es el alcance documentado de la API, no una limitación atribuible por inferencia a todos los contratos de aggregator hooks.^[1][5]

Para solicitar Guidestar explícitamente hacen falta ambas cabeceras: x-api-experimental: true y x-universal-router-swapsteps: true. La cabecera swapsteps por sí sola no selecciona Guidestar. Este devuelve cotizaciones CLASSIC de AMM con enrutamiento BEST_PRICE. No considera UniswapX aunque la solicitud lo incluya junto a protocolos AMM.^[5]

Una solicitud explícita a Guidestar nunca pasa automáticamente al enrutamiento estándar. Las solicitudes no admitidas devuelven HTTP 400; una solicitud válida para la que no encuentra cotización devuelve HTTP 404. Durante la beta, la documentación aconseja pedir por separado y en paralelo una cotización estándar, sin esas dos cabeceras. Es un comportamiento que debe implementar quien llama a la API.^[5]

Un array route vacío no implica que no haya ruta

Una respuesta de Guidestar deja quote.route como un array vacío. La secuencia de ejecución aparece en quote.swapSteps, que debe usarse para mostrar o validar la ruta. La presencia de swapSteps permite identificar una cotización de Guidestar. El campo aparte quote.routeString es texto libre para depuración, no un formato estable que deba analizarse como ruta.^[5]

Leer una ruta exige, por tanto, algo más que contar pools o revisar un campo conocido. Conviene identificar la fuente subyacente, si otro par toca el mismo estado, qué motor produjo la respuesta y si realmente devolvió una cotización. La correspondencia del hook y la respuesta de la API explican partes distintas de esa misma operación.^[3][5]