sol-parser-sdk-nodejs 0.4.0 → 0.5.5

package/README.md

@@ -16,6 +16,12 @@
     <a href="https://discord.gg/vuazbGkqQE">Discord</a>
 </p>
 
+> ☕ **Support This Project**
+>
+> This SDK is completely free and open source. However, maintaining and continuously updating it requires significant AI computing resources and token consumption. If this SDK helps with your development, consider making a monthly SOL donation — any amount is appreciated and helps keep this project alive!
+>
+> **Donation Wallet:** `6oW7AXz1yRb57pYSxysuXnMs2aR1ha5rzGzReZ1MjPV8`
+
 ---
 
 ## Other language SDKs
@@ -29,6 +35,18 @@
 
 ---
 
+## Release notes
+
+### v0.5.5
+
+- Aligns ShredStream parsing with Rust/Python/Go for low-latency static-account paths.
+- Uses default pubkey placeholders for V0 ALT-loaded instruction accounts instead of dropping the instruction.
+- Adds discriminator fallback when the ShredStream outer program id is ALT-loaded.
+- Improves Pump.fun v2 short-account parsing, create/create_v2 handling, and event-type filter parity.
+- Refreshes multi-protocol routing for Pump.fun, PumpSwap, Pump Fees, Raydium, Orca, and Meteora paths.
+
+---
+
 ## How to use
 
 ### 1. Install
@@ -36,7 +54,7 @@
 **From npm**
 
 ```bash
-npm install sol-parser-sdk-nodejs
+npm install sol-parser-sdk-nodejs@0.5.5
 ```
 
 **From source** (folder may be named `sol-parser-sdk-ts` in a monorepo)
@@ -120,7 +138,7 @@ The client decodes gRPC `entries` bytes in **TypeScript** (same layout as the Go
 npx tsx examples/shredstream_example.ts -- --url=http://127.0.0.1:10800
 ```
 
-`shredstream_pumpfun_json.ts` also needs a Solana **`RPC_URL`** (or `--rpc`) for ALTs.
+Without RPC, V0 ALT-loaded account indexes are represented with default pubkey placeholders and parsed best-effort. `shredstream_pumpfun_json.ts` can also use Solana **`RPC_URL`** (or `--rpc`) to expand ALTs when exact loaded-account fields are required.
 
 ---
 
@@ -146,7 +164,7 @@ From the **package root** after `npm install`. Examples use `npx tsx` and load `
 | Meteora DAMM V2 events | `npx tsx examples/meteora_damm_grpc.ts` | [meteora_damm_grpc.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/meteora_damm_grpc.ts) |
 | **ShredStream** (HTTP, not Yellowstone gRPC; see **step 5** above) | | |
 | Ultra-low-latency subscribe + queue / latency stats. URL: `--url` / `SHREDSTREAM_URL` / `.env` (default `http://127.0.0.1:10800`). | `npx tsx examples/shredstream_example.ts` | [shredstream_example.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/shredstream_example.ts) |
-| PumpFun `DexEvent` JSON from ShredStream; needs Solana **RPC** for ALTs (`RPC_URL` or `--rpc`). | `npx tsx examples/shredstream_pumpfun_json.ts` | [shredstream_pumpfun_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/shredstream_pumpfun_json.ts) |
+| PumpFun `DexEvent` JSON from ShredStream; static ALT fallback works without RPC, and Solana **RPC** (`RPC_URL` or `--rpc`) expands full ALT accounts when needed. | `npx tsx examples/shredstream_pumpfun_json.ts` | [shredstream_pumpfun_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/shredstream_pumpfun_json.ts) |
 | **Multi-protocol** | | |
 | Subscribe to all DEX protocols | `npx tsx examples/multi_protocol_grpc.ts` | [multi_protocol_grpc.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/multi_protocol_grpc.ts) |
 | **Utility** | | |
@@ -165,7 +183,7 @@ From the **package root** after `npm install`. Examples use `npx tsx` and load `
 
 ## Protocols
 
-PumpFun, PumpSwap, Raydium AMM V4 / CLMM / CPMM, Orca Whirlpool, Meteora DAMM V2 / DLMM, Bonk Launchpad (see `src/instr/`).
+PumpFun, PumpSwap, Raydium AMM V4 / CLMM / CPMM, Orca Whirlpool, Meteora DAMM V2 / DLMM, Raydium LaunchLab (see `src/instr/`).
 
 ---
 

package/README_CN.md

@@ -16,6 +16,12 @@
     <a href="https://discord.gg/vuazbGkqQE">Discord</a>
 </p>
 
+> ☕ **支持本项目**
+>
+> 本 SDK 完全免费且开源。但维护和持续更新需要消耗大量 AI 算力与 Token。如果这个 SDK 对您的开发有帮助，欢迎每月捐赠任意数量的 SOL，您的支持将帮助这个项目持续运行！
+>
+> **捐赠钱包：** `6oW7AXz1yRb57pYSxysuXnMs2aR1ha5rzGzReZ1MjPV8`
+
 ---
 
 ## 其他语言 SDK
@@ -29,6 +35,18 @@
 
 ---
 
+## 发布说明
+
+### v0.5.5
+
+- ShredStream 低延迟静态账户路径与 Rust/Python/Go 对齐。
+- V0 ALT-loaded 指令账户不再整条跳过，而是用默认 pubkey 占位继续 best-effort 解析。
+- 当 ShredStream 外层 program id 来自 ALT 时，按 discriminator 做候选 program id fallback。
+- 改进 Pump.fun v2 短账户解析、create/create_v2 处理和事件类型过滤一致性。
+- 更新 Pump.fun、PumpSwap、Pump Fees、Raydium、Orca、Meteora 的多协议路由。
+
+---
+
 ## 怎么用
 
 ### 1. 安装
@@ -36,7 +54,7 @@
 **npm**
 
 ```bash
-npm install sol-parser-sdk-nodejs
+npm install sol-parser-sdk-nodejs@0.5.5
 ```
 
 **源码**（monorepo 里目录可能是 `sol-parser-sdk-ts`）
@@ -120,7 +138,7 @@ console.log("subscribed", sub.id);
 npx tsx examples/shredstream_example.ts -- --url=http://127.0.0.1:10800
 ```
 
-`shredstream_pumpfun_json.ts` 另需 Solana **`RPC_URL`**（或 `--rpc`）解析 ALT。
+无 RPC 时，V0 ALT-loaded 账户索引用默认 pubkey 占位并继续 best-effort 解析。若需要精确的 ALT 加载账户字段，`shredstream_pumpfun_json.ts` 也可以使用 Solana **`RPC_URL`**（或 `--rpc`）展开 ALT。
 
 ---
 
@@ -146,7 +164,7 @@ npx tsx examples/shredstream_example.ts -- --url=http://127.0.0.1:10800
 | Meteora DAMM V2 事件 | `npx tsx examples/meteora_damm_grpc.ts` | [meteora_damm_grpc.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/meteora_damm_grpc.ts) |
 | **ShredStream**（HTTP，**非** Yellowstone gRPC；端点见上文步骤 5） | | |
 | 超低延迟订阅、队列与延迟统计。端点：`--url` / `SHREDSTREAM_URL` / `.env`（默认 `http://127.0.0.1:10800`）。 | `npx tsx examples/shredstream_example.ts` | [shredstream_example.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/shredstream_example.ts) |
-| ShredStream → PumpFun `DexEvent` JSON；需 Solana **RPC** 解析 ALT（`RPC_URL` 或 `--rpc`）。 | `npx tsx examples/shredstream_pumpfun_json.ts` | [shredstream_pumpfun_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/shredstream_pumpfun_json.ts) |
+| ShredStream → PumpFun `DexEvent` JSON；无 RPC 时可静态 ALT fallback，配置 Solana **RPC**（`RPC_URL` 或 `--rpc`）时可展开完整 ALT 账户。 | `npx tsx examples/shredstream_pumpfun_json.ts` | [shredstream_pumpfun_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/shredstream_pumpfun_json.ts) |
 | **多协议** | | |
 | 同时订阅所有 DEX 协议 | `npx tsx examples/multi_protocol_grpc.ts` | [multi_protocol_grpc.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/multi_protocol_grpc.ts) |
 | **工具** | | |
@@ -165,7 +183,7 @@ npx tsx examples/shredstream_example.ts -- --url=http://127.0.0.1:10800
 
 ## 协议
 
-PumpFun、PumpSwap、Raydium AMM V4 / CLMM / CPMM、Orca Whirlpool、Meteora DAMM V2 / DLMM、Bonk Launchpad（见 `src/instr/`）。
+PumpFun、PumpSwap、Raydium AMM V4 / CLMM / CPMM、Orca Whirlpool、Meteora DAMM V2 / DLMM、Raydium LaunchLab（见 `src/instr/`）。
 
 ---
 

package/dist/accounts/mod.d.ts

@@ -5,6 +5,7 @@ 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 { parsePumpfunGlobal, parsePumpfunBondingCurve, parsePumpfunFeeConfig, parsePumpfunSharingConfig, parsePumpfunGlobalVolumeAccumulator, parsePumpfunUserVolumeAccumulator, parsePumpfunAccount, isPumpfunGlobalAccount, isPumpfunBondingCurveAccount, isPumpfunFeeConfigAccount, isPumpfunSharingConfigAccount, isPumpfunGlobalVolumeAccumulatorAccount, isPumpfunUserVolumeAccumulatorAccount, } from "./pumpfun.js";
 export { parsePumpswapGlobalConfig, parsePumpswapPool, parsePumpswapAccount, isGlobalConfigAccount, isPoolAccount, } from "./pumpswap.js";
 export { hasDiscriminator } from "./utils.js";
 export { userWalletPubkeyForOnchainAccount } from "./wallet_resolve.js";

package/dist/accounts/mod.js

@@ -1,16 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rpcResolveUserWalletPubkey = exports.userWalletPubkeyForOnchainAccount = exports.hasDiscriminator = exports.isPoolAccount = exports.isGlobalConfigAccount = exports.parsePumpswapAccount = exports.parsePumpswapPool = exports.parsePumpswapGlobalConfig = exports.parseTokenAccount = exports.isNonceAccount = exports.parseNonceAccount = void 0;
+exports.rpcResolveUserWalletPubkey = exports.userWalletPubkeyForOnchainAccount = exports.hasDiscriminator = exports.isPoolAccount = exports.isGlobalConfigAccount = exports.parsePumpswapAccount = exports.parsePumpswapPool = exports.parsePumpswapGlobalConfig = exports.isPumpfunUserVolumeAccumulatorAccount = exports.isPumpfunGlobalVolumeAccumulatorAccount = exports.isPumpfunSharingConfigAccount = exports.isPumpfunFeeConfigAccount = exports.isPumpfunBondingCurveAccount = exports.isPumpfunGlobalAccount = exports.parsePumpfunAccount = exports.parsePumpfunUserVolumeAccumulator = exports.parsePumpfunGlobalVolumeAccumulator = exports.parsePumpfunSharingConfig = exports.parsePumpfunFeeConfig = exports.parsePumpfunBondingCurve = exports.parsePumpfunGlobal = exports.parseTokenAccount = exports.isNonceAccount = exports.parseNonceAccount = void 0;
 exports.parseAccountUnified = parseAccountUnified;
+const types_js_1 = require("../grpc/types.js");
 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");
+const pumpfun_js_1 = require("./pumpfun.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 pumpfun_js_2 = require("./pumpfun.js");
+Object.defineProperty(exports, "parsePumpfunGlobal", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunGlobal; } });
+Object.defineProperty(exports, "parsePumpfunBondingCurve", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunBondingCurve; } });
+Object.defineProperty(exports, "parsePumpfunFeeConfig", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunFeeConfig; } });
+Object.defineProperty(exports, "parsePumpfunSharingConfig", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunSharingConfig; } });
+Object.defineProperty(exports, "parsePumpfunGlobalVolumeAccumulator", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunGlobalVolumeAccumulator; } });
+Object.defineProperty(exports, "parsePumpfunUserVolumeAccumulator", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunUserVolumeAccumulator; } });
+Object.defineProperty(exports, "parsePumpfunAccount", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunAccount; } });
+Object.defineProperty(exports, "isPumpfunGlobalAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunGlobalAccount; } });
+Object.defineProperty(exports, "isPumpfunBondingCurveAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunBondingCurveAccount; } });
+Object.defineProperty(exports, "isPumpfunFeeConfigAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunFeeConfigAccount; } });
+Object.defineProperty(exports, "isPumpfunSharingConfigAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunSharingConfigAccount; } });
+Object.defineProperty(exports, "isPumpfunGlobalVolumeAccumulatorAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunGlobalVolumeAccumulatorAccount; } });
+Object.defineProperty(exports, "isPumpfunUserVolumeAccumulatorAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunUserVolumeAccumulatorAccount; } });
 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; } });
@@ -25,10 +41,22 @@ var rpc_wallet_js_1 = require("./rpc_wallet.js");
 Object.defineProperty(exports, "rpcResolveUserWalletPubkey", { enumerable: true, get: function () { return rpc_wallet_js_1.rpcResolveUserWalletPubkey; } });
 const ACCOUNT_EVENT_TYPES = [
     "TokenAccount",
+    "TokenInfo",
     "NonceAccount",
+    "AccountPumpFunGlobal",
+    "AccountPumpFunBondingCurve",
+    "AccountPumpFunFeeConfig",
+    "AccountPumpFunSharingConfig",
+    "AccountPumpFunGlobalVolumeAccumulator",
+    "AccountPumpFunUserVolumeAccumulator",
     "AccountPumpSwapGlobalConfig",
     "AccountPumpSwapPool",
 ];
+function filterParsedEvent(ev, eventTypeFilter) {
+    if (!ev || !eventTypeFilter)
+        return ev;
+    return (0, types_js_1.eventTypeFilterShouldIncludeDexEvent)(eventTypeFilter, ev) ? ev : null;
+}
 /** 账户数据统一解析入口 */
 function parseAccountUnified(account, metadata, eventTypeFilter) {
     if (account.data.length === 0)
@@ -38,20 +66,39 @@ function parseAccountUnified(account, metadata, eventTypeFilter) {
         if (!shouldParse)
             return null;
     }
-    if (account.owner === program_ids_js_1.PUMPSWAP_PROGRAM_ID && eventTypeFilter) {
-        if (eventTypeFilter.shouldInclude("AccountPumpSwapGlobalConfig") ||
+    if (account.owner === program_ids_js_1.PUMPSWAP_PROGRAM_ID) {
+        if (!eventTypeFilter ||
+            eventTypeFilter.shouldInclude("AccountPumpSwapGlobalConfig") ||
             eventTypeFilter.shouldInclude("AccountPumpSwapPool")) {
             const ev = (0, pumpswap_js_1.parsePumpswapAccount)(account, metadata);
             if (ev)
-                return ev;
+                return filterParsedEvent(ev, eventTypeFilter);
         }
+        return null;
+    }
+    if (account.owner === program_ids_js_1.PUMPFUN_PROGRAM_ID || account.owner === program_ids_js_1.PUMP_FEES_PROGRAM_ID) {
+        if (!eventTypeFilter ||
+            eventTypeFilter.shouldInclude("AccountPumpFunGlobal") ||
+            eventTypeFilter.shouldInclude("AccountPumpFunBondingCurve") ||
+            eventTypeFilter.shouldInclude("AccountPumpFunFeeConfig") ||
+            eventTypeFilter.shouldInclude("AccountPumpFunSharingConfig") ||
+            eventTypeFilter.shouldInclude("AccountPumpFunGlobalVolumeAccumulator") ||
+            eventTypeFilter.shouldInclude("AccountPumpFunUserVolumeAccumulator")) {
+            const ev = (0, pumpfun_js_1.parsePumpfunAccount)(account, metadata);
+            if (ev)
+                return filterParsedEvent(ev, eventTypeFilter);
+        }
+        return null;
     }
     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"))
+    if (eventTypeFilter &&
+        !eventTypeFilter.shouldInclude("TokenAccount") &&
+        !eventTypeFilter.shouldInclude("TokenInfo")) {
         return null;
-    return (0, token_js_1.parseTokenAccount)(account, metadata);
+    }
+    return filterParsedEvent((0, token_js_1.parseTokenAccount)(account, metadata), eventTypeFilter);
 }

package/dist/accounts/pumpfun.d.ts

@@ -0,0 +1,16 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+import type { AccountData } from "./types.js";
+export declare function isPumpfunGlobalAccount(data: Uint8Array): boolean;
+export declare function isPumpfunBondingCurveAccount(data: Uint8Array): boolean;
+export declare function isPumpfunFeeConfigAccount(data: Uint8Array): boolean;
+export declare function isPumpfunSharingConfigAccount(data: Uint8Array): boolean;
+export declare function isPumpfunGlobalVolumeAccumulatorAccount(data: Uint8Array): boolean;
+export declare function isPumpfunUserVolumeAccumulatorAccount(data: Uint8Array): boolean;
+export declare function parsePumpfunGlobal(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunBondingCurve(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunFeeConfig(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunSharingConfig(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunGlobalVolumeAccumulator(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunUserVolumeAccumulator(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunAccount(account: AccountData, metadata: EventMetadata): DexEvent | null;