[PERS SDK - v2.3.26](/sdk-reference/readme) / [Exports](/sdk-reference/modules) / WalletEventsManager

# Class: WalletEventsManager

Wallet Events Manager - Manages real-time blockchain event subscriptions

Low-level WS client wrapper. For auto-subscription based on auth type,
use `sdk.connectWalletEvents()` which handles subscription automatically.

## Table of contents

### Constructors

- [constructor](/sdk-reference/classes/walleteventsmanager#constructor)


### Methods

- [connect](/sdk-reference/classes/walleteventsmanager#connect)
- [disconnect](/sdk-reference/classes/walleteventsmanager#disconnect)
- [destroy](/sdk-reference/classes/walleteventsmanager#destroy)
- [subscribeWallets](/sdk-reference/classes/walleteventsmanager#subscribewallets)
- [subscribeChains](/sdk-reference/classes/walleteventsmanager#subscribechains)
- [unsubscribeWallets](/sdk-reference/classes/walleteventsmanager#unsubscribewallets)
- [unsubscribeChains](/sdk-reference/classes/walleteventsmanager#unsubscribechains)
- [getSubscriptionState](/sdk-reference/classes/walleteventsmanager#getsubscriptionstate)
- [bindNotificationChannel](/sdk-reference/classes/walleteventsmanager#bindnotificationchannel)
- [updateNotificationChannel](/sdk-reference/classes/walleteventsmanager#updatenotificationchannel)
- [getNotificationContext](/sdk-reference/classes/walleteventsmanager#getnotificationcontext)
- [onNotificationPending](/sdk-reference/classes/walleteventsmanager#onnotificationpending)
- [on](/sdk-reference/classes/walleteventsmanager#on)
- [onStateChange](/sdk-reference/classes/walleteventsmanager#onstatechange)
- [getState](/sdk-reference/classes/walleteventsmanager#getstate)
- [isConnected](/sdk-reference/classes/walleteventsmanager#isconnected)
- [hasReconnectGivenUp](/sdk-reference/classes/walleteventsmanager#hasreconnectgivenup)
- [retryAfterTokenRefresh](/sdk-reference/classes/walleteventsmanager#retryaftertokenrefresh)
- [getConnectionInfo](/sdk-reference/classes/walleteventsmanager#getconnectioninfo)


## Constructors

### constructor

• **new WalletEventsManager**(`apiClient`, `eventEmitter`, `config?`): [`WalletEventsManager`](/sdk-reference/classes/walleteventsmanager)

#### Parameters

| Name | Type |
|  --- | --- |
| `apiClient` | [`PersApiClient`](/sdk-reference/classes/persapiclient) |
| `eventEmitter` | [`PersEventEmitter`](/sdk-reference/classes/perseventemitter) |
| `config?` | [`WalletEventsConfig`](/sdk-reference/interfaces/walleteventsconfig) |


#### Returns

[`WalletEventsManager`](/sdk-reference/classes/walleteventsmanager)

#### Defined in

[managers/events-manager.ts:85](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L85)

## Methods

### connect

▸ **connect**(): `Promise`<`void`>

Connect to real-time wallet events

Establishes WebSocket connection to the WS relay server.
After connecting, call subscribeWallets() or subscribeChains() to start
receiving events.

For auto-subscription, use `sdk.connectWalletEvents()` instead.

#### Returns

`Promise`<`void`>

#### Defined in

[managers/events-manager.ts:118](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L118)

### disconnect

▸ **disconnect**(): `void`

Disconnect from real-time events

#### Returns

`void`

#### Defined in

[managers/events-manager.ts:236](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L236)

### destroy

▸ **destroy**(): `void`

Full cleanup - disconnect and remove all subscriptions including auth listener
Call this when completely done with the manager (e.g., SDK disposal)

#### Returns

`void`

#### Defined in

[managers/events-manager.ts:251](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L251)

### subscribeWallets

▸ **subscribeWallets**(`wallets`): `Promise`<`SubscribedPayload`>

Subscribe to wallet events

Receives events only for the specified wallet addresses.
Use this for user-facing SDK where you want to monitor specific wallets.

#### Parameters

| Name | Type | Description |
|  --- | --- | --- |
| `wallets` | `WalletInfo`[] | Array of wallet info (address + chainId) |


#### Returns

`Promise`<`SubscribedPayload`>

Promise that resolves when subscription is confirmed

**`Example`**

```typescript
await sdk.walletEvents.connect();
await sdk.walletEvents.subscribeWallets([
  { address: '0x123...', chainId: 39123 }
]);
```

#### Defined in

[managers/events-manager.ts:282](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L282)

### subscribeChains

▸ **subscribeChains**(`chains`): `Promise`<`SubscribedPayload`>

Subscribe to chain events (Admin Dashboard)

Receives ALL events on the specified chains.
Use for admin dashboards that need to monitor all activity.

#### Parameters

| Name | Type | Description |
|  --- | --- | --- |
| `chains` | `number`[] | Array of chain IDs to subscribe to |


#### Returns

`Promise`<`SubscribedPayload`>

Promise that resolves when subscription is confirmed

**`Example`**

```typescript
await sdk.walletEvents.connect();
await sdk.walletEvents.subscribeChains([39123, 137]);
```

#### Defined in

[managers/events-manager.ts:307](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L307)

### unsubscribeWallets

▸ **unsubscribeWallets**(`wallets`): `Promise`<`SubscribedPayload`>

Unsubscribe from wallet events

#### Parameters

| Name | Type | Description |
|  --- | --- | --- |
| `wallets` | `WalletInfo`[] | Array of wallet info to unsubscribe from |


#### Returns

`Promise`<`SubscribedPayload`>

Promise that resolves when unsubscription is confirmed

#### Defined in

[managers/events-manager.ts:323](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L323)

### unsubscribeChains

▸ **unsubscribeChains**(`chains`): `Promise`<`SubscribedPayload`>

Unsubscribe from chain events

#### Parameters

| Name | Type | Description |
|  --- | --- | --- |
| `chains` | `number`[] | Array of chain IDs to unsubscribe from |


#### Returns

`Promise`<`SubscribedPayload`>

Promise that resolves when unsubscription is confirmed

#### Defined in

[managers/events-manager.ts:336](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L336)

### getSubscriptionState

▸ **getSubscriptionState**(): `SubscribedPayload`

Get current subscription state

#### Returns

`SubscribedPayload`

#### Defined in

[managers/events-manager.ts:346](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L346)

### bindNotificationChannel

▸ **bindNotificationChannel**(`channelId`, `topicIds?`): `void`

Bind this socket to a personal notification channelId (from `sdk.notifications.getChannelId()`).
Safe to call before or after connect() — queued and sent once the socket is open.

#### Parameters

| Name | Type |
|  --- | --- |
| `channelId` | `string` |
| `topicIds?` | `string`[] |


#### Returns

`void`

#### Defined in

[managers/events-manager.ts:358](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L358)

### updateNotificationChannel

▸ **updateNotificationChannel**(`channelId`): `void`

Rebind the personal notification channelId on an already-connected socket.

#### Parameters

| Name | Type |
|  --- | --- |
| `channelId` | `string` |


#### Returns

`void`

#### Defined in

[managers/events-manager.ts:366](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L366)

### getNotificationContext

▸ **getNotificationContext**(): [`NotificationContext`](/sdk-reference/interfaces/notificationcontext)

Get the notification routing context (channelId + topicIds) resolved for this socket.

#### Returns

[`NotificationContext`](/sdk-reference/interfaces/notificationcontext)

#### Defined in

[managers/events-manager.ts:374](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L374)

### onNotificationPending

▸ **onNotificationPending**(`handler`): `BlockchainEventUnsubscribe`

Subscribe to real-time notification wake signals (`notification.pending`).
The signal carries no content — always follow up with `sdk.notifications.list()`.

#### Parameters

| Name | Type |
|  --- | --- |
| `handler` | [`NotificationPendingHandler`](/sdk-reference/modules#notificationpendinghandler) |


#### Returns

`BlockchainEventUnsubscribe`

#### Defined in

[managers/events-manager.ts:382](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L382)

### on

▸ **on**(`eventType`, `handler`): `BlockchainEventUnsubscribe`

Subscribe to blockchain events

#### Parameters

| Name | Type | Description |
|  --- | --- | --- |
| `eventType` | `string` | Event type ('Transfer', 'Approval', etc.) or '*' for all |
| `handler` | `BlockchainEventHandler` | Callback function when event is received |


#### Returns

`BlockchainEventUnsubscribe`

Unsubscribe function

**`Example`**

```typescript
const unsub = sdk.walletEvents.on('Transfer', (event) => {
  console.log(`Transfer: ${event.data.from} -> ${event.data.to}`);
});

// Later: stop listening
unsub();
```

#### Defined in

[managers/events-manager.ts:416](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L416)

### onStateChange

▸ **onStateChange**(`handler`): `BlockchainEventUnsubscribe`

Subscribe to connection state changes

#### Parameters

| Name | Type |
|  --- | --- |
| `handler` | (`state`: `EventConnectionState`) => `void` |


#### Returns

`BlockchainEventUnsubscribe`

#### Defined in

[managers/events-manager.ts:434](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L434)

### getState

▸ **getState**(): `EventConnectionState`

Get current connection state

#### Returns

`EventConnectionState`

#### Defined in

[managers/events-manager.ts:444](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L444)

### isConnected

▸ **isConnected**(): `boolean`

Check if connected

#### Returns

`boolean`

#### Defined in

[managers/events-manager.ts:451](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L451)

### hasReconnectGivenUp

▸ **hasReconnectGivenUp**(): `boolean`

Check if WS reconnection gave up (exhausted all attempts)
Used to determine if we should retry on token refresh

#### Returns

`boolean`

#### Defined in

[managers/events-manager.ts:459](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L459)

### retryAfterTokenRefresh

▸ **retryAfterTokenRefresh**(): `Promise`<`void`>

Retry connection after token refresh
Called when auth tokens are refreshed and WS had previously given up
Automatically resubscribes to previous subscriptions

#### Returns

`Promise`<`void`>

#### Defined in

[managers/events-manager.ts:468](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L468)

### getConnectionInfo

▸ **getConnectionInfo**(): `undefined` | `null` | { `userId`: `string` ; `wallets`: `WalletInfo`[] ; `activeChains`: `number`[]  }

Get connection info (wallets, active chains)

#### Returns

`undefined` | `null` | { `userId`: `string` ; `wallets`: `WalletInfo`[] ; `activeChains`: `number`[]  }

#### Defined in

[managers/events-manager.ts:491](https://github.com/eXplorins/PERS-sdks/blob/main/packages/pers-sdk/packages/pers-sdk/src/managers/events-manager.ts#L491)