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

# Overview

> Event subscriptions and signed webhook deliveries for on-chain events.

The **Blockchain Events** service watches contracts on supported chains, decodes the events you subscribe
to, and delivers them to your webhook as signed payloads. Every endpoint requires a
token with project + business context and a per-operation capability. See the
[Blockchain Events webhooks & capabilities](/guides/indexer-webhooks) guide for the capability
matrix, supported networks, the event payload, and signature verification.

## The subscription object

| Attribute         | Type             | Description                                                  |
| ----------------- | ---------------- | ------------------------------------------------------------ |
| `id`              | `string`         | Unique subscription id.                                      |
| `projectId`       | `string`         | Project that owns the subscription.                          |
| `network`         | `string`         | One of `ATC`, `BSC`, `ETH`, `BASE`, `POL`, `SOL`, `LISK`.    |
| `contractAddress` | `string`         | Contract being watched.                                      |
| `webhookUrl`      | `string`         | HTTPS URL events are delivered to.                           |
| `events`          | `string[]`       | Subscribed catalog keys (e.g. `transfer`, `mint`).           |
| `status`          | `string`         | `active`, `paused`, or `deleted`.                            |
| `createdBy`       | `string`         | Actor that created the subscription.                         |
| `createdAt`       | `string`         | ISO 8601 UTC timestamp.                                      |
| `updatedAt`       | `string`         | ISO 8601 UTC timestamp.                                      |
| `lastDeliveryAt`  | `string \| null` | Last successful delivery, or `null`.                         |
| `deliveredCount`  | `integer`        | Successful deliveries to date.                               |
| `failedCount`     | `integer`        | Failed deliveries to date.                                   |
| `signingSecret`   | `string`         | HMAC signing secret, returned **only** on create and rotate. |