bsc-listen-transactions/README.md

Real-time base transaction tracking library

# bsc-listen-transactions

A Node.js library for listening to real-time DEX transactions using the DexTracker API.

## Installation

```bash
npm install bsc-listen-transactions
```

## Usage

```javascript
import DexTracker from 'bsc-listen-transactions';

const tracker = new DexTracker();

tracker.on('trade', (trade) => {
  console.log('New trade:', trade);
});

tracker.connect('0xa4a2e2ca3fbfe21aed83471d28b6f65a233c6e00');
```

## API

### Methods

- `connect(network, address)` - Connect to track trades for a specific token
- `disconnect()` - Close the connection
- `isConnected()` - Check connection status

### Events

- `connected` - Fired when connection is established
- `trade` - Fired when a new trade is received
- `error` - Fired when an error occurs
- `disconnected` - Fired when connection is lost
- `reconnecting` - Fired during reconnection attempts

### Supported Networks

- `sol` - Solana
- `eth` - Ethereum
- `bsc` - Binance Smart Chain
- `base` - Base
- `tron` - Tron

## Trade Data Structure

```javascript
{
  type: 'buy' | 'sell',
  network: 'sol' | 'eth' | 'bsc' | 'base' | 'tron',
  volume: number, // USD amount
  price: number,  // USD price
  exchange: string,
  txn: string,    // Transaction ID
  walletAddress: string,
  pool: string    // Pool address
}
```