WebSocket Connections

Connecting to Sei via WebSocket for real-time block and event subscriptions

WebSocket Connections

Sei supports eth_subscribe over WebSocket. You can subscribe to new blocks, event logs, and pending transactions using standard library WebSocket transports.

Endpoints

Network	WebSocket endpoint
Mainnet	wss://evm-ws.sei-apis.com
Testnet	wss://evm-ws-testnet.sei-apis.com
Devnet	wss://evm-ws-arctic-1.sei-apis.com

Connecting

viem

import { createPublicClient, webSocket } from 'viem';
import { sei } from '@sei-js/precompiles/viem';

const client = createPublicClient({
  chain: sei,
  transport: webSocket('wss://evm-ws.sei-apis.com'),
});

Watching New Blocks

viem

const unwatch = client.watchBlocks({
  onBlock: (block) => {
    console.log('New block:', block.number);
  },
});

// Stop watching
unwatch();

Watching Contract Events

viem

import { parseAbiItem } from 'viem';

const unwatch = client.watchEvent({
  address: '0xContractAddress',
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  onLogs: (logs) => {
    console.log('Transfer events:', logs);
  },
});

Watching ERC-20 Transfers Across All Contracts

viem

import { parseAbiItem } from 'viem';

const unwatch = client.watchEvent({
  event: parseAbiItem('event Transfer(address indexed from, address indexed to, uint256 value)'),
  onLogs: (logs) => {
    logs.forEach((log) => {
      console.log(`Transfer on ${log.address}:`, log.args);
    });
  },
});

Notes

• Sei’s instant finality means every block emitted over WebSocket is already final — no need to wait for additional confirmations before acting on an event.
• Pending transaction subscriptions (newPendingTransactions) are supported at the RPC level but Sei does not guarantee Ethereum-style pending state visibility.