> ## 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.

# Guard

> Vigilancia activa de wallets, las tuyas o las de un atacante, con alertas en la app, por webhook firmado y por correo.

Guard deja una wallet vigilada y te avisa lo que hace, bloque a bloque. Sirve para dos cosas:

> [card] Tus wallets
>
> Hot wallets, tesorería: una salida grande, una salida que la wallet no firmó, un approval nuevo, una delegación o una
> contraparte de riesgo.

> [card] La wallet de un atacante
>
> Cada movimiento que sale y adónde va: a un exchange (el momento de pedir el congelamiento), a un bridge, a un mixer, o
> a una cuenta nueva que Guard puede seguir sola.

Se entra desde **app.blockgence.com → Guard**. Las pestañas son **Alertas** y **Wallets**, más **Avisos** (la
configuración de webhooks y correo) y **Protocolos** (Watchtower).

![Wallets vigiladas en Guard](https://mintcdn.com/blockgence/jIDqBW86tOU_Ini-/images/products/guard/wallets.png?fit=max\&auto=format\&n=jIDqBW86tOU_Ini-\&q=85\&s=5299e405c6f439a568308cf126492c43)

Wallets vigiladas, con datos sintéticos.

## Vigilar una wallet

**1. Cargá la dirección y la red**

En **Wallets**, pegá la dirección y elegí la red. La pantalla dice arriba qué redes vigila Guard y si el monitor las
está leyendo.

**2. Elegí el propósito**

**Propia** o **de un atacante**. Cada propósito trae sus reglas por defecto, y después las podés ajustar.

**3. Compartila, si querés**

Una vigilancia compartida la ve toda tu organización, y cualquiera que la vea puede operar sus alertas.

Guard vigila **desde que se carga la wallet, no hacia atrás**: el detalle de cada vigilancia dice desde qué bloque se
miró, y las pausas y los huecos del monitor. Para lo anterior, usá el rastreo de [Investigación](https://docs.blockgence.com/es/products/investigation.md).

También se puede vigilar desde otras partes de la app: el link **vigilar** de una dirección en [Monitor](https://docs.blockgence.com/es/products/monitor.md),
el último paso del modo incidente (carga las cuentas del atacante) y el copiloto, si se lo pedís.

## Qué cuenta como actividad

La transacción que firma la wallet (aunque revierta), la moneda nativa con sus movimientos internos, tokens ERC-20,
NFTs ERC-721 y ERC-1155, approvals (también Permit2), delegaciones EIP-7702 (aunque las presente otro) y los contratos
que crea. Cada evento va valuado en USD, con la etiqueta de la contraparte.

El **ruido** se guarda marcado y no alerta: tokens de spam, transferencias de monto 0 (la firma del envenenamiento de
direcciones), remitentes falsificados y polvo.

## Reglas

| Regla | Qué dispara | Severidad | Propia | Atacante |
| - | - | - | - | - |
| Salida grande | Una salida con precio desde un umbral (por defecto US\$10,000) | Alta | Sí | No |
| Entrada grande | Una entrada con precio desde un umbral (por defecto US\$1,000) | Media | No | Sí |
| Toda salida | Toda transacción firmada y toda salida de fondos | Media | No | Sí |
| Salida no firmada | Un tercero tira de un allowance de la wallet | Crítica en una propia | Sí | Sí |
| Approval | Un approval nuevo (no las revocaciones) | Alta; crítica si el spender es de riesgo | Sí | Sí |
| Delegación | Una delegación EIP-7702 | Crítica | Sí | Sí |
| Contraparte de riesgo | Fondos hacia o desde una dirección sancionada, de darknet, de scam, un mixer o un atacante conocido | Crítica si sale, alta si entra | Sí | Sí |
| Exchange | Una salida hacia un exchange | Crítica | No | Sí |
| Bridge | Una salida hacia un bridge | Alta | No | Sí |
| Contrato creado | La wallet despliega un contrato | Alta | No | Sí |
| Seguir los saltos | Vigilar también las cuentas nuevas a las que manda fondos | Alta | No | Apagada por defecto |

Una transacción da **una sola alerta** por vigilancia, con la regla más grave y la lista de todas las que disparó.

### Seguir los saltos

En la wallet de un atacante, **Seguir los saltos** hace que Guard vigile también las cuentas a las que manda fondos,
desde US\$1,000 acumulados por destino. Así el atacante no se escapa cambiando de dirección. La vigilancia derivada
hereda las reglas, sigue sus propios saltos hasta 2 de profundidad (10 derivadas por árbol, ajustable) y cuenta contra
el tope de tu plan.

> [!NOTE]
>
> Solo sigue hacia una cuenta común sin etiqueta. No sigue hacia exchanges, bridges, routers, mixers, contratos ni
> cuentas delegadas por EIP-7702, y cada corte queda a la vista con su motivo. Una cuenta que recibió fondos del atacante
> no es necesariamente suya: la derivada se puede borrar.

## Operar las alertas

Cada alerta dice qué pasó y adónde fue, con la transacción y el bloque. Se **reconoce**, se **asigna**, se **resuelve**
con un motivo o se **descarta**, y cada cambio queda en su historia. Con **abrir un caso en Investigación** la alerta pasa
a un caso, con el grafo de la transacción, sin cobrar créditos. Si una reorganización saca la transacción de la
cadena, la alerta se retracta (no se borra) y vuelve si la transacción reaparece.

![Detalle de una alerta de Guard](https://mintcdn.com/blockgence/jIDqBW86tOU_Ini-/images/products/guard/alert.png?fit=max\&auto=format\&n=jIDqBW86tOU_Ini-\&q=85\&s=df1aa0f8a9e7b0c2409b6536aafc4c53)

Una alerta, con datos sintéticos.

## Avisos fuera de la app

> [tab] Webhook firmado
>
> Un POST JSON por alerta (nueva, retractada o que volvió), firmado con HMAC-SHA256 según **Standard Webhooks**, con un
> secreto por destino que se puede rotar. El alcance puede ser una vigilancia, las tuyas o las compartidas de tu
> organización. Los envíos se reintentan durante unas 15 horas. Desde **Avisos** podés mandar una prueba y ver las
> entregas.

> [tab] Resumen por correo
>
> Uno por persona, nunca uno por alerta. Por defecto solo incluye las alertas de severidad alta o crítica.

> [!WARNING]
>
> El webhook avisa alertas, no cada movimiento, y no avisa los cambios que hace una persona (reconocer, resolver).

## Watchtower: los contratos de un protocolo

Un protocolo registra sus contratos en **Protocolos** y Guard los vigila con reglas propias: un retiro grande neto por
transacción en USD (por defecto US\$1,000,000), cambio de owner, admin o rol de administración, upgrade del proxy, pausa
y los traspasos de owner o admin en dos pasos (avisa la propuesta antes de que se acepte). También lee los eventos que
el protocolo declare, y si se registra su timelock o su governor, avisa qué cambiaría una llamada programada antes de
que se ejecute.

> [!NOTE]
>
> Watchtower se habilita por servidor. Si no está prendido, la pestaña **Protocolos** lo dice.

## Por API

Las mismas funciones están en `/v1/guard/*`, con una API key **asignada a una persona** (una key sin dueño recibe 403).
Guard no cobra créditos: el tope es la cantidad de vigilancias de tu plan.

```bash Vigilar una wallet theme={null}
curl -X POST https://app.blockgence.com/v1/guard/watches \
  -H "X-API-Key: $BKG_KEY" -H "Content-Type: application/json" \
  -d '{"chain": "ethereum", "address": "0x2222222222222222222222222222222222222222", "name": "Tesorería", "purpose": "own"}'
```

```bash Alertas activas theme={null}
curl https://app.blockgence.com/v1/guard/alerts -H "X-API-Key: $BKG_KEY"
```

Detalle de cada ruta en la [referencia de la API](https://docs.blockgence.com/es/api/reference.md).

## Qué no cubre

* **Vigila desde que se carga**, no hacia atrás.
* Ethereum se lee bloque a bloque. En Base, Optimism, Arbitrum, BSC y Polygon, cuando están habilitadas, Guard lee los
  logs de las wallets vigiladas: la cobertura es menor, y lo que no se puede ubicar se declara por evento.
* La **tasa de alertas falsas** sobre wallets reales no está medida.
* Watchtower solo ve lo que el contrato emite. El dueño de un ProxyAdmin, el de un Safe o el upgrade de un beacon
  quedan afuera, salvo que también se registren esos contratos, y la respuesta lo declara.
* Guard no bloquea transacciones ni revoca permisos: avisa.


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