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

# Events

> Connection, account, and transaction events emitted by the dApp SDK.

The dApp SDK emits events so your UI can stay in sync with the wallet's state. Subscribe
with the `on*` functions and unsubscribe with the matching `off*` function. For usage
examples, see [Handle Events](/sdks-tools/sdks/dapp-sdk/guides/handle-events).

## `onStatusChanged(handler)` / `offStatusChanged(handler)`

Fires when the connection status or session state changes.

| Payload field            | Type      | Description                            |
| ------------------------ | --------- | -------------------------------------- |
| `connection.isConnected` | `boolean` | Whether a session is currently active. |

## `onAccountsChanged(handler)` / `offAccountsChanged(handler)`

Fires when accounts are added or removed, or the primary account changes.

| Payload    | Type        | Description                 |
| ---------- | ----------- | --------------------------- |
| `accounts` | `Account[]` | The current set of parties. |

## `onTxChanged(handler)` / `offTxChanged(handler)`

Fires as a transaction submitted via `prepareExecute` moves through its lifecycle.

| Payload field      | Type                                              | Description                                 |
| ------------------ | ------------------------------------------------- | ------------------------------------------- |
| `status`           | `'pending' \| 'signed' \| 'executed' \| 'failed'` | Current transaction state.                  |
| `payload.updateId` | `string`                                          | Ledger update ID (present when `executed`). |

## Related

* [Handle Events](/sdks-tools/sdks/dapp-sdk/guides/handle-events) — Examples for subscribing to and cleaning up these events.
* [SDK Methods](/sdks-tools/sdks/dapp-sdk/reference/sdk-methods) — The functions that trigger these events.