sol-parser-sdk-nodejs 0.3.0

package/README_CN.md

@@ -0,0 +1,343 @@
+<div align="center">
+    <h1>⚡ Sol Parser SDK - Node.js</h1>
+    <h3><em>高性能 Solana DEX 事件解析器，专为 Node.js/TypeScript 设计</em></h3>
+</div>
+
+<p align="center">
+    <strong>通过 Yellowstone gRPC 实时解析 Solana DEX 事件的 Node.js/TypeScript 库</strong>
+</p>
+
+<p align="center">
+    <a href="https://www.npmjs.com/package/sol-parser-sdk-nodejs">
+        <img src="https://img.shields.io/badge/npm-sol--parser--sdk--nodejs-red.svg" alt="npm">
+    </a>
+    <a href="https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/LICENSE">
+        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
+    </a>
+</p>
+
+<p align="center">
+    <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
+    <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
+    <img src="https://img.shields.io/badge/Solana-9945FF?style=for-the-badge&logo=solana&logoColor=white" alt="Solana">
+    <img src="https://img.shields.io/badge/gRPC-4285F4?style=for-the-badge&logo=grpc&logoColor=white" alt="gRPC">
+</p>
+
+<p align="center">
+    <a href="./README_CN.md">中文</a> |
+    <a href="./README.md">English</a> |
+    <a href="https://fnzero.dev/">官网</a> |
+    <a href="https://t.me/fnzero_group">Telegram</a> |
+    <a href="https://discord.gg/vuazbGkqQE">Discord</a>
+</p>
+
+---
+
+## 📦 SDK 版本
+
+本 SDK 提供多种语言版本：
+
+| 语言 | 仓库 | 描述 |
+|------|------|------|
+| **Rust** | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | 超低延迟，SIMD 优化 |
+| **Node.js** | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript，Node.js 支持 |
+| **Python** | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | 原生 async/await 支持 |
+| **Go** | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | 并发安全，goroutine 支持 |
+
+---
+
+## 📊 性能亮点
+
+### ⚡ 实时解析
+- **零延迟** 基于日志的事件解析
+- **gRPC 流式传输** 支持 Yellowstone/Geyser 协议
+- **多协议** 单次订阅同时监听多个 DEX
+- **事件类型过滤** 精准解析所需事件
+
+### 🏗️ 支持的协议
+- ✅ **PumpFun** - Meme 代币交易
+- ✅ **PumpSwap** - PumpFun 交换协议
+- ✅ **Raydium AMM V4** - 自动做市商
+- ✅ **Raydium CLMM** - 集中流动性
+- ✅ **Raydium CPMM** - 集中池
+- ✅ **Orca Whirlpool** - 集中流动性 AMM
+- ✅ **Meteora DAMM V2** - 动态 AMM
+- ✅ **Meteora DLMM** - 动态流动性做市商
+- ✅ **Bonk Launchpad** - 代币发射平台
+
+---
+
+## 🔥 快速开始
+
+### 安装
+
+```bash
+git clone https://github.com/0xfnzero/sol-parser-sdk-nodejs
+cd sol-parser-sdk-nodejs
+npm install --ignore-scripts
+npm run build
+```
+
+### 性能测试
+
+在**本包根目录**（`sol-parser-sdk-ts/`）执行，需先 `npm run build`：
+
+```bash
+# 集成测试：PumpFun + PumpSwap，含账户填充的 DexEvent（与 Rust gRPC 路径一致）
+GRPC_URL=https://solana-yellowstone-grpc.publicnode.com:443 GRPC_TOKEN=你的token npm run test:grpc
+
+# PumpFun 详细性能指标（单事件明细 + 每 10 秒统计）
+GRPC_TOKEN=你的token node examples/pumpfun_with_metrics.mjs
+
+# PumpSwap 详细性能指标（单事件明细 + 每 10 秒统计）
+GRPC_TOKEN=你的token node examples/pumpswap_with_metrics.mjs
+
+# PumpSwap 超低延迟测试
+GRPC_TOKEN=你的token node examples/pumpswap_low_latency.mjs
+```
+
+### 环境变量（gRPC 示例）
+
+| 变量 | 说明 |
+|------|------|
+| **`GRPC_URL`** | Yellowstone gRPC 端点（优先使用）。例：`https://solana-yellowstone-grpc.publicnode.com:443` |
+| **`GRPC_TOKEN`** | 对应端点的 `x-token`（优先使用） |
+| **`GEYSER_ENDPOINT`** | 与 `GRPC_URL` 同义，兼容旧配置 |
+| **`GEYSER_API_TOKEN`** | 与 `GRPC_TOKEN` 同义，兼容旧配置 |
+| **`MAX_EVENTS`** | `*_grpc_json.mjs` 与 `npm run test:grpc`：解析满 N 条事件后退出；`0` 表示持续运行直到 Ctrl+C |
+| **`TIMEOUT_MS`** | 仅 `npm run test:grpc`：运行 N 毫秒后自动退出；`0` 表示不超时（可与 `MAX_EVENTS` 同时设，先满足任一条件即退出） |
+| **`JSON_PRETTY`** | `npm run test:grpc`：设为 `1` 或 `true` 时多行缩进打印（默认单行紧凑 JSON） |
+| **`JSON_MAX_CHARS`** | `npm run test:grpc`：每条事件 JSON 最大字符数；不设或 `0` 表示不截断 |
+
+部分脚本对公共节点带默认 token；生产环境请显式设置 `GRPC_TOKEN`。
+
+### 示例列表
+
+以下命令均在**本包根目录**执行，且已 `npm run build`。
+
+| 描述 | 运行命令 | 源码 |
+|------|----------|------|
+| **本包脚本** | | |
+| gRPC 集成测试（PumpFun + PumpSwap，账户填充后的 DexEvent） | `npm run test:grpc` | [scripts/test-grpc-ts.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/test-grpc-ts.mjs) |
+| 调试：打印 meta / 日志结构 | `npm run debug:grpc` | [scripts/debug-grpc-ts.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/debug-grpc-ts.mjs) |
+| **PumpFun** | | |
+| gRPC 订阅并输出**完整 JSON** DexEvent（字段与 Rust 对齐） | `node examples/pumpfun_grpc_json.mjs` | [examples/pumpfun_grpc_json.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_grpc_json.mjs) |
+| PumpFun 事件解析 + 性能指标 | `node examples/pumpfun_with_metrics.mjs` | [examples/pumpfun_with_metrics.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_with_metrics.mjs) |
+| PumpFun 交易类型过滤 | `node examples/pumpfun_trade_filter.mjs` | [examples/pumpfun_trade_filter.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_trade_filter.mjs) |
+| PumpFun 快速连接测试 | `node examples/pumpfun_quick_test.mjs` | [examples/pumpfun_quick_test.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_quick_test.mjs) |
+| **PumpSwap** | | |
+| gRPC 订阅并输出**完整 JSON** DexEvent（字段与 Rust 对齐） | `node examples/pumpswap_grpc_json.mjs` | [examples/pumpswap_grpc_json.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_grpc_json.mjs) |
+| PumpSwap 事件 + 性能统计 | `node examples/pumpswap_with_metrics.mjs` | [examples/pumpswap_with_metrics.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_with_metrics.mjs) |
+| PumpSwap 超低延迟 | `node examples/pumpswap_low_latency.mjs` | [examples/pumpswap_low_latency.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_low_latency.mjs) |
+| **Meteora DAMM** | | |
+| Meteora DAMM V2 事件 | `node examples/meteora_damm_grpc.mjs` | [examples/meteora_damm_grpc.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/meteora_damm_grpc.mjs) |
+| **多协议** | | |
+| 同时订阅所有 DEX 协议 | `node examples/multi_protocol_grpc.mjs` | [examples/multi_protocol_grpc.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/multi_protocol_grpc.mjs) |
+| **工具 / 测试** | | |
+| 验证 onUpdate 同步抛错不会打断 gRPC 流 | `node examples/grpc_onupdate_error_test.mjs` | [examples/grpc_onupdate_error_test.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/grpc_onupdate_error_test.mjs) |
+| 通过签名解析交易（RPC，非 gRPC） | `TX_SIGNATURE=<sig> node examples/parse_tx_by_signature.mjs` | [examples/parse_tx_by_signature.mjs](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/parse_tx_by_signature.mjs) |
+
+### 基本用法
+
+**推荐（与 Rust gRPC `parse_logs` 一致）：** 在解析 `Program data` 日志后，用订阅里的 **`transactionRaw` + `metaRaw`** 做账户填充，得到完整 `DexEvent`（如 PumpSwap 的 `base_mint`、池子 ATA 等）：
+
+```javascript
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+import path from "path";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const {
+  YellowstoneGrpc,
+  parseDexEventsFromGrpcTransactionInfo,
+  dexEventToJsonString,
+} = require(path.join(__dirname, "../dist/index.js"));
+
+const ENDPOINT =
+  process.env.GRPC_URL ||
+  process.env.GEYSER_ENDPOINT ||
+  "https://solana-yellowstone-grpc.publicnode.com:443";
+const X_TOKEN =
+  process.env.GRPC_TOKEN || process.env.GEYSER_API_TOKEN || "";
+
+const client = new YellowstoneGrpc(ENDPOINT, X_TOKEN);
+
+const filter = {
+  account_include: [
+    "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P", // PumpFun
+    "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", // PumpSwap（Pump AMM）
+  ],
+  account_exclude: [],
+  account_required: [],
+  vote: false,
+  failed: false,
+};
+
+const sub = await client.subscribeTransactions(filter, {
+  onUpdate: (update) => {
+    if (!update.transaction?.transaction) return;
+    const txInfo = update.transaction.transaction;
+    const slot = update.transaction.slot;
+    if (!txInfo.transactionRaw || !txInfo.metaRaw) return;
+
+    const events = parseDexEventsFromGrpcTransactionInfo(txInfo, slot, undefined);
+    for (const ev of events) {
+      console.log(dexEventToJsonString(ev, 2));
+    }
+  },
+  onError: (err) => console.error("错误:", err.message),
+  onEnd: () => console.log("流已结束"),
+});
+
+console.log(`已订阅: ${sub.id}`);
+```
+
+**仅日志（更轻）：** `parseLogsOnly(logs, signature, slot, blockTimeUs)` 不需要 `transactionRaw`；部分账户字段可能仍为占位零地址，除非自行对 `VersionedTransaction.message` + `meta` 调用 `applyAccountFillsToLogEvents`。
+
+---
+
+## 🏗️ 支持的协议与事件
+
+### 事件类型
+每个协议均支持：
+- 📈 **交易/兑换事件** - 买入/卖出交易
+- 💧 **流动性事件** - 存入/提取
+- 🏊 **池子事件** - 池子创建/初始化
+- 🎯 **仓位事件** - 开仓/平仓（CLMM）
+
+### PumpFun 事件
+- `PumpFunBuy` - 买入代币
+- `PumpFunSell` - 卖出代币
+- `PumpFunBuyExactSolIn` - 指定 SOL 数量买入
+- `PumpFunCreate` - 创建新代币
+- `PumpFunTrade` - 通用交易（兜底）
+
+### PumpSwap 事件
+- `PumpSwapBuy` - 通过池子买入代币
+- `PumpSwapSell` - 通过池子卖出代币
+- `PumpSwapCreatePool` - 创建流动性池
+- `PumpSwapLiquidityAdded` - 添加流动性
+- `PumpSwapLiquidityRemoved` - 移除流动性
+
+### Raydium 事件
+- `RaydiumAmmV4Swap` - AMM V4 兑换
+- `RaydiumClmmSwap` - CLMM 兑换
+- `RaydiumCpmmSwap` - CPMM 兑换
+
+### Orca 事件
+- `OrcaWhirlpoolSwap` - Whirlpool 兑换
+
+### Meteora 事件
+- `MeteoraDammV2Swap` - DAMM V2 兑换
+- `MeteoraDammV2AddLiquidity` - 添加流动性
+- `MeteoraDammV2RemoveLiquidity` - 移除流动性
+- `MeteoraDammV2CreatePosition` - 创建仓位
+- `MeteoraDammV2ClosePosition` - 关闭仓位
+
+### Bonk 事件
+- `BonkTrade` - Bonk Launchpad 交易
+
+---
+
+## 📁 项目结构
+
+```
+sol-parser-sdk-ts/   （npm 包名：sol-parser-sdk-nodejs）
+├── src/
+│   ├── core/
+│   │   ├── unified_parser.ts   # parseLogsOnly 等
+│   │   ├── dex_event.ts        # DexEvent 类型定义
+│   │   ├── rpc_invoke_map.ts   # 程序 invoke 映射、accountKeyToBase58
+│   │   └── json_utils.ts       # dexEventToJsonString
+│   ├── grpc/
+│   │   ├── client.ts           # YellowstoneGrpc 客户端
+│   │   ├── yellowstone_parse.ts # parseDexEventsFromGrpcTransactionInfo
+│   │   └── types.ts            # ClientConfig、TransactionFilter 等
+│   ├── rpc_transaction.ts      # parseRpcTransaction、applyAccountFillsToLogEvents
+│   ├── logs/
+│   │   └── optimized_matcher.ts  # 日志解析（所有协议）
+│   ├── instr/
+│   │   └── *.ts                  # 指令解析器
+│   └── index.ts                  # 公共 API 导出
+├── dist/                         # 编译后的 JavaScript
+├── scripts/
+│   ├── test-grpc-ts.mjs          # npm run test:grpc
+│   └── debug-grpc-ts.mjs         # npm run debug:grpc
+├── examples/
+│   ├── pumpfun_grpc_json.mjs
+│   ├── pumpswap_grpc_json.mjs
+│   ├── grpc_onupdate_error_test.mjs
+│   ├── pumpfun_with_metrics.mjs
+│   ├── pumpfun_trade_filter.mjs
+│   ├── pumpfun_quick_test.mjs
+│   ├── pumpswap_with_metrics.mjs
+│   ├── pumpswap_low_latency.mjs
+│   ├── meteora_damm_grpc.mjs
+│   ├── multi_protocol_grpc.mjs
+│   └── parse_tx_by_signature.mjs
+└── package.json
+```
+
+---
+
+## 🔧 高级用法
+
+### 自定义 gRPC 端点
+
+```javascript
+const ENDPOINT =
+  process.env.GRPC_URL ||
+  process.env.GEYSER_ENDPOINT ||
+  "https://solana-yellowstone-grpc.publicnode.com:443";
+const TOKEN =
+  process.env.GRPC_TOKEN || process.env.GEYSER_API_TOKEN || "";
+const client = new YellowstoneGrpc(ENDPOINT, TOKEN);
+```
+
+### gRPC 辅助 API（与 Rust 对齐）
+
+- **`parseDexEventsFromGrpcTransactionInfo(txInfo, slot, options?)`** — 先解析日志，再执行与 Rust gRPC 相同的账户/数据填充。需要 `txInfo.transactionRaw` 与 `txInfo.metaRaw`。
+- **`applyAccountFillsToLogEvents(events, message, meta)`** — 若你已有日志解析结果，用手里的 message + meta 补全字段。
+- **`parseRpcTransaction` / `parseTransactionFromRpc`** — 完整 RPC 交易解析（指令 + 日志 + 填充）。
+
+### 取消订阅
+
+```javascript
+const sub = await client.subscribeTransactions(filter, callbacks);
+
+// 稍后取消：
+client.unsubscribe(sub.id);
+```
+
+### JSON 序列化
+
+```javascript
+const { dexEventToJsonString } = require("./dist/index.js");
+
+for (const ev of events) {
+  // 正确处理 BigInt 序列化
+  console.log(dexEventToJsonString(ev));
+}
+```
+
+### 性能建议
+
+1. **使用事件过滤** — 按程序 ID 过滤可获得 60-80% 性能提升
+2. **gRPC 场景优先 `parseDexEventsFromGrpcTransactionInfo`** — 在提供 `transactionRaw` + `metaRaw` 时，`DexEvent` 字段与 Rust SDK 一致（mint、池子账户等）
+3. **仅解析一次日志** — `parseLogsOnly` 热路径无堆分配
+4. **避免对 BigInt 使用 JSON.stringify** — 请使用 `dexEventToJsonString`
+5. **监控延迟** — 生产环境检查 `metadata.grpc_recv_us`
+
+---
+
+## 📄 许可证
+
+MIT License
+
+## 📞 联系我们
+
+- **仓库**: https://github.com/0xfnzero/sol-parser-sdk-nodejs
+- **官网**: https://fnzero.dev/
+- **Telegram**: https://t.me/fnzero_group
+- **Discord**: https://discord.gg/vuazbGkqQE

package/dist/accounts/mod.d.ts

@@ -0,0 +1,11 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+import type { AccountData } from "./types.js";
+import type { EventTypeFilter } from "../grpc/types.js";
+export type { AccountData } from "./types.js";
+export { parseNonceAccount, isNonceAccount } from "./nonce.js";
+export { parseTokenAccount } from "./token.js";
+export { parsePumpswapGlobalConfig, parsePumpswapPool, parsePumpswapAccount, isGlobalConfigAccount, isPoolAccount, } from "./pumpswap.js";
+export { hasDiscriminator } from "./utils.js";
+/** 账户数据统一解析入口 */
+export declare function parseAccountUnified(account: AccountData, metadata: EventMetadata, eventTypeFilter?: EventTypeFilter): DexEvent | null;

package/dist/accounts/mod.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasDiscriminator = exports.isPoolAccount = exports.isGlobalConfigAccount = exports.parsePumpswapAccount = exports.parsePumpswapPool = exports.parsePumpswapGlobalConfig = exports.parseTokenAccount = exports.isNonceAccount = exports.parseNonceAccount = void 0;
+exports.parseAccountUnified = parseAccountUnified;
+const program_ids_js_1 = require("../instr/program_ids.js");
+const nonce_js_1 = require("./nonce.js");
+const token_js_1 = require("./token.js");
+const pumpswap_js_1 = require("./pumpswap.js");
+var nonce_js_2 = require("./nonce.js");
+Object.defineProperty(exports, "parseNonceAccount", { enumerable: true, get: function () { return nonce_js_2.parseNonceAccount; } });
+Object.defineProperty(exports, "isNonceAccount", { enumerable: true, get: function () { return nonce_js_2.isNonceAccount; } });
+var token_js_2 = require("./token.js");
+Object.defineProperty(exports, "parseTokenAccount", { enumerable: true, get: function () { return token_js_2.parseTokenAccount; } });
+var pumpswap_js_2 = require("./pumpswap.js");
+Object.defineProperty(exports, "parsePumpswapGlobalConfig", { enumerable: true, get: function () { return pumpswap_js_2.parsePumpswapGlobalConfig; } });
+Object.defineProperty(exports, "parsePumpswapPool", { enumerable: true, get: function () { return pumpswap_js_2.parsePumpswapPool; } });
+Object.defineProperty(exports, "parsePumpswapAccount", { enumerable: true, get: function () { return pumpswap_js_2.parsePumpswapAccount; } });
+Object.defineProperty(exports, "isGlobalConfigAccount", { enumerable: true, get: function () { return pumpswap_js_2.isGlobalConfigAccount; } });
+Object.defineProperty(exports, "isPoolAccount", { enumerable: true, get: function () { return pumpswap_js_2.isPoolAccount; } });
+var utils_js_1 = require("./utils.js");
+Object.defineProperty(exports, "hasDiscriminator", { enumerable: true, get: function () { return utils_js_1.hasDiscriminator; } });
+const ACCOUNT_EVENT_TYPES = [
+    "TokenAccount",
+    "NonceAccount",
+    "AccountPumpSwapGlobalConfig",
+    "AccountPumpSwapPool",
+];
+/** 账户数据统一解析入口 */
+function parseAccountUnified(account, metadata, eventTypeFilter) {
+    if (account.data.length === 0)
+        return null;
+    if (eventTypeFilter?.include_only) {
+        const shouldParse = eventTypeFilter.include_only.some((t) => ACCOUNT_EVENT_TYPES.includes(t));
+        if (!shouldParse)
+            return null;
+    }
+    if (account.owner === program_ids_js_1.PUMPSWAP_PROGRAM_ID && eventTypeFilter) {
+        if (eventTypeFilter.shouldInclude("AccountPumpSwapGlobalConfig") ||
+            eventTypeFilter.shouldInclude("AccountPumpSwapPool")) {
+            const ev = (0, pumpswap_js_1.parsePumpswapAccount)(account, metadata);
+            if (ev)
+                return ev;
+        }
+    }
+    if ((0, nonce_js_1.isNonceAccount)(account.data)) {
+        if (eventTypeFilter && !eventTypeFilter.shouldInclude("NonceAccount"))
+            return null;
+        return (0, nonce_js_1.parseNonceAccount)(account, metadata);
+    }
+    if (eventTypeFilter && !eventTypeFilter.shouldInclude("TokenAccount"))
+        return null;
+    return (0, token_js_1.parseTokenAccount)(account, metadata);
+}

package/dist/accounts/nonce.d.ts

@@ -0,0 +1,5 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+import type { AccountData } from "./types.js";
+export declare function isNonceAccount(data: Uint8Array): boolean;
+export declare function parseNonceAccount(account: AccountData, metadata: EventMetadata): DexEvent | null;

package/dist/accounts/nonce.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNonceAccount = isNonceAccount;
+exports.parseNonceAccount = parseNonceAccount;
+const utils_js_1 = require("./utils.js");
+const bs58_1 = __importDefault(require("bs58"));
+const NONCE_SIZE = 80;
+const NONCE_DISC = Uint8Array.from([1, 0, 0, 0, 1, 0, 0, 0]);
+function isNonceAccount(data) {
+    return data.length >= 8 && (0, utils_js_1.hasDiscriminator)(data, NONCE_DISC);
+}
+function parseNonceAccount(account, metadata) {
+    const { data } = account;
+    if (data.length !== NONCE_SIZE)
+        return null;
+    const authority = bs58_1.default.encode(data.subarray(8, 40));
+    const nonce = bs58_1.default.encode(data.subarray(40, 72));
+    const ev = {
+        metadata,
+        pubkey: account.pubkey,
+        executable: account.executable,
+        lamports: account.lamports,
+        owner: account.owner,
+        rent_epoch: account.rent_epoch,
+        nonce,
+        authority,
+    };
+    return { NonceAccount: ev };
+}

package/dist/accounts/pumpswap.d.ts

@@ -0,0 +1,8 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+import type { AccountData } from "./types.js";
+export declare function isGlobalConfigAccount(data: Uint8Array): boolean;
+export declare function isPoolAccount(data: Uint8Array): boolean;
+export declare function parsePumpswapGlobalConfig(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpswapPool(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpswapAccount(account: AccountData, metadata: EventMetadata): DexEvent | null;

package/dist/accounts/pumpswap.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGlobalConfigAccount = isGlobalConfigAccount;
+exports.isPoolAccount = isPoolAccount;
+exports.parsePumpswapGlobalConfig = parsePumpswapGlobalConfig;
+exports.parsePumpswapPool = parsePumpswapPool;
+exports.parsePumpswapAccount = parsePumpswapAccount;
+const utils_js_1 = require("./utils.js");
+const binary_js_1 = require("../util/binary.js");
+const program_ids_js_1 = require("../instr/program_ids.js");
+const GLOBAL_DISC = Uint8Array.from([149, 8, 156, 202, 160, 252, 176, 217]);
+const POOL_DISC = Uint8Array.from([241, 154, 109, 4, 17, 177, 109, 188]);
+const GLOBAL_BODY = 634;
+const POOL_BODY = 244;
+function isGlobalConfigAccount(data) {
+    return (0, utils_js_1.hasDiscriminator)(data, GLOBAL_DISC);
+}
+function isPoolAccount(data) {
+    return (0, utils_js_1.hasDiscriminator)(data, POOL_DISC);
+}
+function parsePumpswapGlobalConfig(account, metadata) {
+    if (account.data.length < 8 + GLOBAL_BODY)
+        return null;
+    if (!isGlobalConfigAccount(account.data))
+        return null;
+    const d = account.data.subarray(8);
+    let o = 0;
+    const admin = (0, binary_js_1.readPubkey)(d, o);
+    if (admin === null)
+        return null;
+    o += 32;
+    const lp_fee_basis_points = (0, binary_js_1.readU64LE)(d, o);
+    if (lp_fee_basis_points === null)
+        return null;
+    o += 8;
+    const protocol_fee_basis_points = (0, binary_js_1.readU64LE)(d, o);
+    if (protocol_fee_basis_points === null)
+        return null;
+    o += 8;
+    const disable_flags = (0, binary_js_1.readU8)(d, o);
+    if (disable_flags === null)
+        return null;
+    o += 1;
+    const protocol_fee_recipients = [];
+    for (let i = 0; i < 8; i++) {
+        const pk = (0, binary_js_1.readPubkey)(d, o);
+        if (pk === null)
+            return null;
+        protocol_fee_recipients.push(pk);
+        o += 32;
+    }
+    const coin_creator_fee_basis_points = (0, binary_js_1.readU64LE)(d, o);
+    if (coin_creator_fee_basis_points === null)
+        return null;
+    o += 8;
+    const admin_set_coin_creator_authority = (0, binary_js_1.readPubkey)(d, o);
+    if (admin_set_coin_creator_authority === null)
+        return null;
+    o += 32;
+    const whitelist_pda = (0, binary_js_1.readPubkey)(d, o);
+    if (whitelist_pda === null)
+        return null;
+    o += 32;
+    const reserved_fee_recipient = (0, binary_js_1.readPubkey)(d, o);
+    if (reserved_fee_recipient === null)
+        return null;
+    o += 32;
+    const mayhem_b = (0, binary_js_1.readU8)(d, o);
+    if (mayhem_b === null)
+        return null;
+    const mayhem_mode_enabled = mayhem_b !== 0;
+    o += 1;
+    const reserved_fee_recipients = [];
+    for (let i = 0; i < 7; i++) {
+        const pk = (0, binary_js_1.readPubkey)(d, o);
+        if (pk === null)
+            return null;
+        reserved_fee_recipients.push(pk);
+        o += 32;
+    }
+    const global_config = {
+        admin,
+        lp_fee_basis_points,
+        protocol_fee_basis_points,
+        disable_flags,
+        protocol_fee_recipients,
+        coin_creator_fee_basis_points,
+        admin_set_coin_creator_authority,
+        whitelist_pda,
+        reserved_fee_recipient,
+        mayhem_mode_enabled,
+        reserved_fee_recipients,
+    };
+    const ev = {
+        metadata,
+        pubkey: account.pubkey,
+        executable: account.executable,
+        lamports: account.lamports,
+        owner: account.owner,
+        rent_epoch: account.rent_epoch,
+        global_config,
+    };
+    return { PumpSwapGlobalConfigAccount: ev };
+}
+function parsePumpswapPool(account, metadata) {
+    if (account.data.length < 8 + POOL_BODY)
+        return null;
+    if (!isPoolAccount(account.data))
+        return null;
+    const d = account.data.subarray(8);
+    let o = 0;
+    const pool_bump = (0, binary_js_1.readU8)(d, o);
+    if (pool_bump === null)
+        return null;
+    o += 1;
+    const index = (0, binary_js_1.readU16LE)(d, o);
+    if (index === null)
+        return null;
+    o += 2;
+    const creator = (0, binary_js_1.readPubkey)(d, o);
+    if (creator === null)
+        return null;
+    o += 32;
+    const base_mint = (0, binary_js_1.readPubkey)(d, o);
+    if (base_mint === null)
+        return null;
+    o += 32;
+    const quote_mint = (0, binary_js_1.readPubkey)(d, o);
+    if (quote_mint === null)
+        return null;
+    o += 32;
+    const lp_mint = (0, binary_js_1.readPubkey)(d, o);
+    if (lp_mint === null)
+        return null;
+    o += 32;
+    const pool_base_token_account = (0, binary_js_1.readPubkey)(d, o);
+    if (pool_base_token_account === null)
+        return null;
+    o += 32;
+    const pool_quote_token_account = (0, binary_js_1.readPubkey)(d, o);
+    if (pool_quote_token_account === null)
+        return null;
+    o += 32;
+    const lp_supply = (0, binary_js_1.readU64LE)(d, o);
+    if (lp_supply === null)
+        return null;
+    o += 8;
+    const coin_creator = (0, binary_js_1.readPubkey)(d, o);
+    if (coin_creator === null)
+        return null;
+    o += 32;
+    const mayhem = (0, binary_js_1.readU8)(d, o);
+    if (mayhem === null)
+        return null;
+    o += 1;
+    const cashback = (0, binary_js_1.readU8)(d, o);
+    if (cashback === null)
+        return null;
+    const pool = {
+        pool_bump,
+        index,
+        creator,
+        base_mint,
+        quote_mint,
+        lp_mint,
+        pool_base_token_account,
+        pool_quote_token_account,
+        lp_supply,
+        coin_creator,
+        is_mayhem_mode: mayhem !== 0,
+        is_cashback_coin: cashback !== 0,
+    };
+    const ev = {
+        metadata,
+        pubkey: account.pubkey,
+        executable: account.executable,
+        lamports: account.lamports,
+        owner: account.owner,
+        rent_epoch: account.rent_epoch,
+        pool,
+    };
+    return { PumpSwapPoolAccount: ev };
+}
+function parsePumpswapAccount(account, metadata) {
+    if (account.owner !== program_ids_js_1.PUMPSWAP_PROGRAM_ID)
+        return null;
+    if (isGlobalConfigAccount(account.data))
+        return parsePumpswapGlobalConfig(account, metadata);
+    if (isPoolAccount(account.data))
+        return parsePumpswapPool(account, metadata);
+    return null;
+}

package/dist/accounts/token.d.ts

@@ -0,0 +1,5 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+import type { AccountData } from "./types.js";
+/** SPL Token 账户解析（快速路径 + 扩展长度回退） */
+export declare function parseTokenAccount(account: AccountData, metadata: EventMetadata): DexEvent | null;