> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Investigación

> Rastreá fondos en un lienzo, guardá el caso con su evidencia sellada y analizá un robo desde la víctima, el atacante o la transacción.

Investigación es el producto de rastreo forense. Partís de una dirección, Blockgence sigue el dinero hacia adelante y hacia
atrás y lo dibuja como un grafo, con la identidad y el riesgo de cada dirección. Todo lo que ves trae su fuente y su
método, y lo que no se pudo leer queda declarado: una fuente caída nunca se muestra como «no hubo movimientos».

Se entra desde **app.blockgence.com → Investigación**. Tiene cuatro secciones:

> [card] Lienzo de rastreo
>
> El grafo de fondos de una dirección, con la línea de tiempo, la tabla de transacciones y el detalle de cada nodo.

> [card] Casos
>
> Investigaciones guardadas, compartidas con tu organización, con su evidencia sellada, off-ramps y pedido de congelamiento.

> [card] Incidentes
>
> Análisis de un robo o de un hack a partir de lo que tengas: la víctima, el drainer, el atacante, el protocolo o la transacción.

> [card] Fuentes y salud
>
> Qué fuentes de datos están configuradas y qué se puede consultar en cada red.

![Lienzo de rastreo de Investigación](https://mintcdn.com/blockgence/jIDqBW86tOU_Ini-/images/products/investigation/canvas.png?fit=max\&auto=format\&n=jIDqBW86tOU_Ini-\&q=85\&s=76055a9f8cfe2f122bb76effae6ca508)

El lienzo de rastreo con datos de ejemplo.

## Redes

Se rastrean **Ethereum, BSC, Polygon, Arbitrum, Base, Optimism y Tron**. Las demás redes (Bitcoin, Solana y otras)
aparecen solo como destino de un cruce entre redes, con la dirección del otro lado.

## Rastrear una dirección

**1. Elegí la dirección y la red**

Pegá la dirección en el campo de búsqueda (la tecla <kbd>/</kbd> lleva ahí) y elegí la red. Solo aparecen las redes
que se pueden consultar.

**2. Ajustá los parámetros**

En **Parámetros** elegís los saltos hacia adelante (1 a 20), las ramas por nodo (1 a 60), si se incluyen tokens,
si el flujo respeta el orden temporal, una ventana de fechas y el umbral de polvo en USD. Hacia atrás se rastrean
2 saltos.

**3. Rastreá**

Al rastrear corren en paralelo una sonda en las otras redes (si la dirección no tiene actividad en la red elegida,
te dice dónde sí la tiene) y la resolución de nombres ENS.

**4. Leé la franja de avisos**

Arriba del lienzo aparecen los avisos del rastreo: cobertura parcial (qué fuente falló y dónde), actividad en otras
redes y, cuando corresponde, el rastro desde una transacción de pérdida o las etapas de un ataque. Los avisos empujan
el grafo hacia abajo: nunca tapan los datos.

## Leer el grafo

* **Nodos.** El color dice la categoría (sancionada, mixer, scam, exchange, bridge, víctima, contrato, desconocida y
  otras), la forma separa contratos de billeteras y el tamaño dice el valor. El origen va resaltado.
* **Aristas.** El color dice el activo. Los cruces entre redes van en azul (punteados si son heurísticos), los swaps
  en teal y los reembolsos de bridges en naranja. Una arista con una marca (sin verificar, decimales desconocidos,
  reembolso) nunca pierde su rótulo.
* **Interacción.** Un click abre el detalle del nodo y resalta el camino desde el origen. Doble click expande un salto
  más. Los hexágonos **+N** revelan las contrapartes que el rastreo dejó afuera, de a 20.
* **Línea de tiempo y tabla.** Debajo del lienzo, la línea de tiempo filtra el grafo por fechas y la tabla lista cada
  flujo, con sus transacciones, sus cruces y sus swaps desplegables. Un click en una arista lleva a su fila y al revés.

El **detalle de un nodo** tiene seis pestañas:

| Pestaña | Qué muestra |
| - | - |
| Resumen | El riesgo confirmado y el riesgo con heurísticas, cada uno con sus razones; hallazgos (sanciones, bridge, exchange donde el rastro se enfría); quién la fondeó. |
| Flujos | Contrapartes en el rastreo y ocultas; en el origen, la exposición por categoría. |
| Identidad | La ficha on-chain y la atribución: cada etiqueta con su método, su confianza y su fuente. |
| Permisos | Delegaciones EIP-7702, approvals abiertos y movimientos de terceros. Todo de solo lectura. |
| Vector | Cómo se comprometió una wallet, por ventana de tiempo o por transacciones de pérdida. |
| Mensajes | Los mensajes on-chain de la dirección. |

> [!NOTE]
>
> El riesgo distingue lo **determinístico** (lo prueba un dato on-chain o un id criptográfico) de lo **probabilístico**
> (una inferencia con su confianza). El riesgo confirmado no incluye lo probabilístico.

## Casos

Un caso guarda la investigación entera: la dirección de partida, los parámetros, el grafo con sus expansiones, el filtro
de tiempo, la cobertura y los veredictos.

**1. Crear el caso**

Desde la barra superior. A partir de ahí se guarda solo, un segundo y medio después de cada cambio.

**2. Volver a abrirlo**

Un caso se abre tal como quedó, sin volver a consultar la cadena.

**3. Compartirlo**

Desde **Casos**, con personas de tu organización, para ver o para editar. Al abrirlo, Blockgence avisa si sus
direcciones ya están en otros casos que ves.

**4. Exportar la evidencia**

El paquete de evidencia es un JSON sellado con su sha256 y la firma de Blockgence (un documento sin firma lo dice),
y se puede acompañar con un informe en PDF. Cómo se comprueba, en [Metodología y evidencia](https://docs.blockgence.com/es/methodology/sealing.md).

Desde un caso también salen los **off-ramps** (exchanges alcanzados, con descarga en CSV) y el **pedido de
congelamiento**: el estado de cada dirección ante los emisores de stablecoins que pueden congelar, sus canales para
autoridades y los datos listos para copiar.

> [!WARNING]
>
> Blockgence no envía nada por vos: no presenta pedidos a exchanges, emisores ni autoridades, no revoca permisos y no
> firma transacciones. Te deja los datos listos para que los presentes.

## Incidentes

Pegás lo que tengas y elegís qué es. Blockgence muestra las vistas que corresponden:

| Lo que pegás | Lo que ves |
| - | - |
| La dirección de una víctima | El triage de la víctima (cómo le sacaron los fondos, a dónde fueron y qué se puede congelar), las salidas en transacciones que no envió, el envenenamiento de direcciones y el vector de compromiso. |
| La dirección de un drainer | Las víctimas del drainer. |
| La dirección de un estafador | Las víctimas de la estafa con evidencia, separadas de los indicios y de las contrapartes sin calificar. |
| La dirección de un atacante | Intentos fallidos y etapas del ataque. |
| La dirección de un protocolo | Si adoptó SEAL Safe Harbor, a una fecha. |
| El hash de una transacción | La transacción de pérdida, el análisis del exploit y las devoluciones. |
| El token de un caso | El borrador del post-mortem, con la estructura de SEAL. |

El **modo incidente** sigue un playbook para las primeras horas: pegás el hash, la víctima o las direcciones del
atacante, fijás un tope de créditos y seguís cada paso en vivo, con lo que cobró. Al terminar abre el caso o el
post-mortem.

![Sección Incidentes](https://mintcdn.com/blockgence/jIDqBW86tOU_Ini-/images/products/investigation/incidents.png?fit=max\&auto=format\&n=jIDqBW86tOU_Ini-\&q=85\&s=b5badd54f35e86d13c1b3166e0194b8a)

Incidentes: una dirección analizada como víctima, con datos de ejemplo.

## Fuentes y salud

Una tarjeta por fuente de datos: si está configurada, su estado, su licencia y su último error. Debajo, una matriz que
dice qué se puede consultar en cada red. Sirve para entender un aviso de cobertura parcial antes de sacar una conclusión.

## Por API

Todo lo de Investigación está en la API: el rastreo (`POST /v1/trace`), la ficha de una dirección, el fondeo, las
contrapartes, los cruces, los swaps, los casos (`/v1/cases`) y la evidencia. Cada consulta puede ir asociada a un caso
con el header `X-Case-Id`.

```bash Rastrear theme={null}
curl -X POST https://app.blockgence.com/v1/trace \
  -H "X-API-Key: $BKG_KEY" -H "Content-Type: application/json" \
  -d '{"address": "0x00000000000000000000000000000000000a11ce", "chain": "ethereum", "hops": 3, "fanout": 6}'
```

La respuesta es un grafo (`nodes` y `edges`) con la etiqueta, la categoría y el riesgo explicado de cada nodo, y los
exchanges alcanzados en `offramps`. Lo que no se pudo leer viaja en la misma respuesta. Detalle en la
[referencia de la API](https://docs.blockgence.com/es/api/reference.md).

## Qué no cubre

* **El grafo es una muestra**, acotada por saltos, ramas, polvo y topes de filas. No es el historial completo, y lo
  que queda afuera se declara.
* La **infraestructura compartida** (routers, pools, vaults) corta el rastro a propósito: lo que sale de ahí es de otros
  usuarios.
* Un bridge que no está entre los reconstruidos se nombra, pero no se cruza. Un cruce hacia una red que no se consulta
  se declara.
* El **demix** de mixers es solo de Tornado Cash en Ethereum, y lo que da son pistas, no pruebas.
* Los **NFTs** no se rastrean (aparecen en approvals y en el vector de compromiso), y los tokens sin precio publicado
  salen del rastreo como filtro de spam, declarados.
* La atribución sale de fuentes públicas, registros verificados y las etiquetas de tu organización. No es una base
  propietaria de entidades a escala.
* Las heurísticas de exploit no cubren errores de lógica de negocio, oráculos externos, gobernanza ni claves
  comprometidas. La mayoría de las heurísticas declara que su tasa de error no está medida.
* **Monero** no se rastrea: la red no publica remitentes, destinatarios ni montos. Solo hay screening y la prueba de
  pago.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.