@posit/parser

Overview

The parser package processes Solana transactions and extracts normalized swap data from multiple DEX protocols. It handles the complexity of aggregated routes, multi-hop swaps, and protocol-specific quirks.

Installation

# Within the monorepo
pnpm add @posit/parser --filter @posit/web

Basic Usage

import { parseTransaction } from '@posit/parser';

const result = await parseTransaction(transaction, {
  walletAddress: 'YOUR_WALLET_ADDRESS',
});

// Result contains normalized swap data
console.log(result.swaps);

Supported Protocols

Normalizer Architecture

Each protocol has a dedicated normalizer that converts protocol-specific transaction data into a common NormalizedSwap format:

interface NormalizedSwap {
  signature: string;
  timestamp: number;
  protocol: string;
  inputMint: string;
  inputAmount: bigint;
  outputMint: string;
  outputAmount: bigint;
  fee?: bigint;
  feeMint?: string;
  success: boolean;
}

Jupiter Normalizer

Handles aggregated routes by flattening inner legs to net in/out amounts. Correctly processes multi-hop routes and extracts platform fees.

Pump.fun Normalizer

Handles bonding curve swaps and migration events. Properly attributes fees and handles the unique pump.fun transaction structure.

Testing

# Run parser tests
pnpm --filter @posit/parser test

# Run with coverage
pnpm --filter @posit/parser test:coverage

# Update snapshots
pnpm --filter @posit/parser test -- -u

Adding a New Normalizer

1. Create src/normalizers/{protocol}.ts
2. Implement the Normalizer interface
3. Add program IDs to constants.ts
4. Register in normalizers/index.ts
5. Add snapshot tests with real transactions