> For the complete documentation index, see [llms.txt](https://shinkalabs.gitbook.io/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shinkalabs.gitbook.io/hub/andromeda/api-reference/webhook-events.md).

# Webhook events

This is the catalogue of events Andromeda can deliver to your webhook endpoints. For delivery mechanics (HMAC signing, the replay window, retries, the dead-letter queue), see [Webhooks](/hub/andromeda/guides/webhooks.md). The exact payload schema per event is in the [OpenAPI spec](https://api.andromedainfra.pro/openapi.json).

## Two families

### Andromeda events

Lifecycle events the platform emits about your tenant's activity. There are six canonical types, covering things like:

* idempotency replays (a request served from the idempotency cache rather than executed),
* policy actions (a policy deployed, changed, or revoked),
* recovery actions (a recovery initiated, contributed to, finalised),
* future-sign actions (a trigger armed, fired, or completed),
* webhook configuration changes,
* audit-log appends.

These are also recorded in the [audit log](/hub/andromeda/guides/audit-log.md).

### On-chain events

Events parsed off Solana by the IDL-aware listener and fanned out to you. There are four Anchor self-CPI event types emitted by the Ika program. These tell you about on-chain state changes relevant to your dWallets without you having to subscribe to Solana yourself. The same stream feeds the "event" trigger type in [Future-Sign](/hub/andromeda/guides/future-sign.md).

## Common envelope

Every delivery includes (see the spec for exact field names):

* an **event id** (use it to dedupe; deliveries are at-least-once),
* an **event type**,
* a **timestamp** (reject if older than the replay window),
* the **payload** for that event type,
* and the **HMAC signature** header over the body.

## Handling guidance

* Verify the HMAC before parsing. See [Webhooks](/hub/andromeda/guides/webhooks.md).
* Dedupe on the event id; the same delivery can arrive more than once.
* Do not assume ordering; reconstruct state from the payloads.
* Return `2xx` fast; do the work asynchronously.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shinkalabs.gitbook.io/hub/andromeda/api-reference/webhook-events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.