sol-parser-sdk 0.5.19 → 0.5.20

package/README.md

@@ -24,15 +24,21 @@ Parser SDK language versions and related Rust SDKs:
 
 | Language | Repository | Description | Version |
 |----------|------------|-------------|---------|
-| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX transaction and account event parsing | `v0.7.13` |
-| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript for Node.js | `v0.5.19` |
-| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | Async/await native support | `v0.5.12` |
-| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go transaction and account event parsing | `v0.5.12` |
-| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Raw Solana shred decoding and ShredStream DEX event parsing | `v4.0.4` |
-| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX trade construction and transaction execution | `v6.0.1` |
+| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX transaction and account event parsing | `v0.7.14` |
+| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript for Node.js | `v0.5.20` |
+| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | Async/await native support | `v0.5.13` |
+| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go transaction and account event parsing | `v0.5.13` |
+| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Raw Solana shred decoding and ShredStream DEX event parsing | `v4.0.5` |
+| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX trade construction and transaction execution | `v6.0.2` |
 
 ---
 
+## v0.5.20 — Pump routes and offline replay
+
+Adds native Pump route-intent parsing for official multi-hop instructions and the exact RapidBuy/BuyPumpDelta wrapper layouts captured in reported transactions. Adds locally cached ALT resolution and rejects unresolved account identities by default, with explicit best-effort compatibility APIs where supported. Route intents expose instruction constraints and hop identities; confirmed execution amounts require execution metadata.
+
+Includes the latest complete implementation, signed transaction fixtures, native offline-bank regression examples and reproducible local hot-path benchmarks. Unknown wrapper layouts are not inferred from embedded bytes. Local tests do not measure production network latency.
+
 ## v0.5.19 — Pump depth-2 compatibility
 
 Adds signed Pump depth-2 create-event replay coverage, including ALT-loaded accounts and executed logs. Existing event layouts and public parsing interfaces remain unchanged.
@@ -119,7 +125,7 @@ Validation includes local CPU benchmarks and offline signed-bank scenarios. Meas
 **From npm**
 
 ```bash
-npm install sol-parser-sdk@0.5.19
+npm install sol-parser-sdk@0.5.20
 ```
 
 **From source** (folder may be named `sol-parser-sdk-ts` in a monorepo)
@@ -286,7 +292,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
 ```
 
-Without `connection` or prewarmed ALT snapshots, V0 ALT-loaded indexes retain the static-account, default-pubkey best-effort behavior. With `connection` or `address_lookup_tables`, parsing uses complete cached ALT snapshots only: a cache miss skips the entire transaction, increments `getReceiveStats().altCacheMissTransactions`, and is never replayed. `connection` performs RPC only during explicit `await client.preloadAddressLookupTables(altAddresses)` before subscribing and in the independent background refresher (default 1000 ms, at most one request in flight). Supply already loaded tables via `config.address_lookup_tables` to avoid cold misses. The cache and pending refresh queue each retain at most 2048 tables; refreshed snapshots apply only to later messages. `shredstream_pumpfun_json.ts` uses **`RPC_URL`** (or `--rpc`) for this background refresh; its entry parsing never waits for RPC.
+Without `connection` or prewarmed ALT snapshots, instructions containing unresolved indexes are skipped. Legacy placeholder behavior is available only through the explicit `dexEventsFromShredWasmTxBestEffort` API. With `connection` or `address_lookup_tables`, parsing uses complete cached ALT snapshots only: a cache miss skips the entire transaction, increments `getReceiveStats().altCacheMissTransactions`, and is never replayed. `connection` performs RPC only during explicit `await client.preloadAddressLookupTables(altAddresses)` before subscribing and in the independent background refresher (default 1000 ms, at most one request in flight). Supply already loaded tables via `config.address_lookup_tables` to avoid cold misses. The cache and pending refresh queue each retain at most 2048 tables; refreshed snapshots apply only to later messages. `shredstream_pumpfun_json.ts` uses **`RPC_URL`** (or `--rpc`) for this background refresh; its entry parsing never waits for RPC.
 
 ---
 
@@ -297,29 +303,29 @@ From the **package root** after `npm install`. Examples use `npx tsx` and load `
 | Description | Run command | Source |
 |-------------|-------------|--------|
 | **Scripts** | | |
-| gRPC integration test (PumpFun + PumpSwap, account-filled `DexEvent`) | `npx tsx scripts/test-grpc-ts.ts` | [test-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/test-grpc-ts.ts) | `v0.5.19` |
-| Debug: print `metaRaw` / log structure | `npx tsx scripts/debug-grpc-ts.ts` | [debug-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/debug-grpc-ts.ts) | `v0.5.19` |
+| gRPC integration test (PumpFun + PumpSwap, account-filled `DexEvent`) | `npx tsx scripts/test-grpc-ts.ts` | [test-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/test-grpc-ts.ts) | `v0.5.20` |
+| Debug: print `metaRaw` / log structure | `npx tsx scripts/debug-grpc-ts.ts` | [debug-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/debug-grpc-ts.ts) | `v0.5.20` |
 | **PumpFun** | | |
-| CREATE + dev BUY/SELL, long-running low latency | `npx tsx examples/devtrades_low_latency.ts` | [devtrades_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_low_latency.ts) | `v0.5.19` |
-| PumpFun + full-volume PumpSwap dev trades/liquidity | `npm run example:grpc:devtrades:pumpswap` | [devtrades_pumpfun_pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_pumpfun_pumpswap_low_latency.ts) | `v0.5.19` |
-| Pretty-print full JSON `DexEvent` over gRPC | `npx tsx examples/pumpfun_grpc_json.ts` | [pumpfun_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_grpc_json.ts) | `v0.5.19` |
-| PumpFun events + metrics | `npx tsx examples/pumpfun_with_metrics.ts` | [pumpfun_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_with_metrics.ts) | `v0.5.19` |
-| PumpFun trade filter | `npx tsx examples/pumpfun_trade_filter.ts` | [pumpfun_trade_filter.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_trade_filter.ts) | `v0.5.19` |
-| Quick PumpFun connection test | `npx tsx examples/pumpfun_quick_test.ts` | [pumpfun_quick_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_quick_test.ts) | `v0.5.19` |
+| CREATE + dev BUY/SELL, long-running low latency | `npx tsx examples/devtrades_low_latency.ts` | [devtrades_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_low_latency.ts) | `v0.5.20` |
+| PumpFun + full-volume PumpSwap dev trades/liquidity | `npm run example:grpc:devtrades:pumpswap` | [devtrades_pumpfun_pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_pumpfun_pumpswap_low_latency.ts) | `v0.5.20` |
+| Pretty-print full JSON `DexEvent` over gRPC | `npx tsx examples/pumpfun_grpc_json.ts` | [pumpfun_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_grpc_json.ts) | `v0.5.20` |
+| PumpFun events + metrics | `npx tsx examples/pumpfun_with_metrics.ts` | [pumpfun_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_with_metrics.ts) | `v0.5.20` |
+| PumpFun trade filter | `npx tsx examples/pumpfun_trade_filter.ts` | [pumpfun_trade_filter.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_trade_filter.ts) | `v0.5.20` |
+| Quick PumpFun connection test | `npx tsx examples/pumpfun_quick_test.ts` | [pumpfun_quick_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_quick_test.ts) | `v0.5.20` |
 | **PumpSwap** | | |
-| Pretty-print full JSON `DexEvent` over gRPC | `npx tsx examples/pumpswap_grpc_json.ts` | [pumpswap_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_grpc_json.ts) | `v0.5.19` |
-| PumpSwap events + metrics | `npx tsx examples/pumpswap_with_metrics.ts` | [pumpswap_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_with_metrics.ts) | `v0.5.19` |
-| PumpSwap swaps, pool creation, and liquidity events (ultra-low latency) | `npm run example:grpc:pumpswap` | [pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_low_latency.ts) | `v0.5.19` |
+| Pretty-print full JSON `DexEvent` over gRPC | `npx tsx examples/pumpswap_grpc_json.ts` | [pumpswap_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_grpc_json.ts) | `v0.5.20` |
+| PumpSwap events + metrics | `npx tsx examples/pumpswap_with_metrics.ts` | [pumpswap_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_with_metrics.ts) | `v0.5.20` |
+| PumpSwap swaps, pool creation, and liquidity events (ultra-low latency) | `npm run example:grpc:pumpswap` | [pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_low_latency.ts) | `v0.5.20` |
 | **Meteora DAMM** | | |
-| 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) | `v0.5.19` |
+| 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) | `v0.5.20` |
 | **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) | `v0.5.19` |
-| PumpFun `DexEvent` JSON from ShredStream; RPC (`RPC_URL` or `--rpc`) refreshes ALT snapshots outside parsing. Cold cache misses are skipped, counted, and not replayed; prewarm required tables. | `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) | `v0.5.19` |
+| 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) | `v0.5.20` |
+| PumpFun `DexEvent` JSON from ShredStream; RPC (`RPC_URL` or `--rpc`) refreshes ALT snapshots outside parsing. Cold cache misses are skipped, counted, and not replayed; prewarm required tables. | `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) | `v0.5.20` |
 | **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) | `v0.5.19` |
+| 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) | `v0.5.20` |
 | **Utility** | | |
-| Verify `onUpdate` sync errors do not kill the gRPC stream | `npx tsx examples/grpc_onupdate_error_test.ts` | [grpc_onupdate_error_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/grpc_onupdate_error_test.ts) | `v0.5.19` |
-| Parse tx by signature (`parseTransactionFromRpc`; not gRPC). Set `TX_SIGNATURE` in `.env` or env. | `npx tsx examples/parse_tx_by_signature.ts` | [parse_tx_by_signature.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/parse_tx_by_signature.ts) | `v0.5.19` |
+| Verify `onUpdate` sync errors do not kill the gRPC stream | `npx tsx examples/grpc_onupdate_error_test.ts` | [grpc_onupdate_error_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/grpc_onupdate_error_test.ts) | `v0.5.20` |
+| Parse tx by signature (`parseTransactionFromRpc`; not gRPC). Set `TX_SIGNATURE` in `.env` or env. | `npx tsx examples/parse_tx_by_signature.ts` | [parse_tx_by_signature.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/parse_tx_by_signature.ts) | `v0.5.20` |
 
 **`npm run` aliases** (same source files as the ShredStream rows above):
 
@@ -366,3 +372,24 @@ Full cross-language API parity is still in progress. See the [API migration guid
 实时 parser → trade 接入使用 Yellowstone **gRPC**；见 [gRPC 缓存接入与三语言示例](docs/USAGE.md#grpc-cache)。此路径不使用 WebSocket，报价和构建热路径不调用 RPC。
 
 Shared PumpFun create/create_v2 mainnet fixtures, replay instructions and verification limits are documented in the [validation guide](https://github.com/0xfnzero/sol-parser-sdk-golang/tree/main/validation/pumpfun_create_20261007).
+
+### Offline Pump ShredStream regressions
+
+Pump route intents, strict cached ALT resolution and native signed replay/SBF simulation examples are documented in [examples/offline_bank/README.md](examples/offline_bank/README.md). Run the language-native examples and tests from this repository; no other-language test driver or RPC endpoint is needed. Unresolved instructions now skip by default; use the explicit best-effort API only for legacy behavior. Route intents must not be treated as confirmed fills.
+
+### Repeatable local hot-path benchmark
+
+```sh
+npx tsx examples/hotpath_benchmark.ts
+# Optional: pass the path to your edited JSON configuration
+npx tsx examples/hotpath_benchmark.ts examples/hotpath_benchmark.json
+```
+
+The checked-in JSON config controls warmup, sample count and batch size. Fixture
+loading and setup occur before timing; timed loops perform no RPC or network I/O.
+The fixed workloads use captured signed wrapped-program transactions, including
+ALTs, and measure resolved parsing and wire decoding plus parsing separately.
+Output reports p50/p95/p99 of batch-normalized microseconds per transaction, a
+checksum and runtime metadata. These local CPU distributions include scheduling
+and GC effects; they measure neither provider/network latency nor production
+landing speed. Compare warmed runs with the same runtime, config and host load.

package/README_CN.md

@@ -24,12 +24,12 @@
 
 | 语言 | 仓库 | 描述 | 版本 |
 |------|------|------|
-| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX 交易与账户事件解析 | `v0.7.13` |
-| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript，Node.js 支持 | `v0.5.19` |
-| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | 原生 async/await 支持 | `v0.5.12` |
-| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go 交易与账户事件解析 | `v0.5.12` |
-| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Solana 原始 shred 解码与 ShredStream DEX 事件解析 | `v4.0.4` |
-| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX 交易构建与交易执行 | `v6.0.1` |
+| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX 交易与账户事件解析 | `v0.7.14` |
+| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript，Node.js 支持 | `v0.5.20` |
+| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | 原生 async/await 支持 | `v0.5.13` |
+| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go 交易与账户事件解析 | `v0.5.13` |
+| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Solana 原始 shred 解码与 ShredStream DEX 事件解析 | `v4.0.5` |
+| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX 交易构建与交易执行 | `v6.0.2` |
 
 ---
 
@@ -48,6 +48,12 @@
 
 ## 发布说明
 
+## v0.5.20 — Pump routes and offline replay
+
+Adds native Pump route-intent parsing for official multi-hop instructions and the exact RapidBuy/BuyPumpDelta wrapper layouts captured in reported transactions. Adds locally cached ALT resolution and rejects unresolved account identities by default, with explicit best-effort compatibility APIs where supported. Route intents expose instruction constraints and hop identities; confirmed execution amounts require execution metadata.
+
+Includes the latest complete implementation, signed transaction fixtures, native offline-bank regression examples and reproducible local hot-path benchmarks. Unknown wrapper layouts are not inferred from embedded bytes. Local tests do not measure production network latency.
+
 ## v0.5.19 — Pump depth-2 compatibility
 
 Adds signed Pump depth-2 create-event replay coverage, including ALT-loaded accounts and executed logs. Existing event layouts and public parsing interfaces remain unchanged.
@@ -119,7 +125,7 @@ Validation includes local CPU benchmarks and offline signed-bank scenarios. Meas
 **npm**
 
 ```bash
-npm install sol-parser-sdk@0.5.19
+npm install sol-parser-sdk@0.5.20
 ```
 
 **源码**（monorepo 里目录可能是 `sol-parser-sdk-ts`）
@@ -279,7 +285,7 @@ mint 或 quote mint 映射到 pool，再将 `PumpSwapLiquidityAdded.user` 与该
 npx tsx examples/shredstream_example.ts -- --url=http://127.0.0.1:10800
 ```
 
-未配置 `connection` 或预热 ALT 快照时，保留静态账户表及默认 pubkey 占位的 best-effort 行为。配置 `connection` 或 `address_lookup_tables` 后，解析只读取完整的 ALT 缓存快照：缓存 miss 跳过整笔交易，累计 `getReceiveStats().altCacheMissTransactions`，不会重放。`connection` 仅用于订阅前显式调用 `await client.preloadAddressLookupTables(altAddresses)` 预热，以及独立后台刷新任务（默认间隔 1000 毫秒，最多一个请求在途）；也可通过 `config.address_lookup_tables` 注入已加载的快照。缓存和待刷新队列各最多保留 2048 张表，刷新结果只供后续消息使用。`shredstream_pumpfun_json.ts` 的 **`RPC_URL`**（或 `--rpc`）用于后台刷新，Entry 解析不等待 RPC。
+未配置 `connection` 或预热 ALT 快照时，默认跳过含未解析索引的指令；旧占位行为仅通过显式 `dexEventsFromShredWasmTxBestEffort` API 提供。配置 `connection` 或 `address_lookup_tables` 后，解析只读取完整的 ALT 缓存快照：缓存 miss 跳过整笔交易，累计 `getReceiveStats().altCacheMissTransactions`，不会重放。`connection` 仅用于订阅前显式调用 `await client.preloadAddressLookupTables(altAddresses)` 预热，以及独立后台刷新任务（默认间隔 1000 毫秒，最多一个请求在途）；也可通过 `config.address_lookup_tables` 注入已加载的快照。缓存和待刷新队列各最多保留 2048 张表，刷新结果只供后续消息使用。`shredstream_pumpfun_json.ts` 的 **`RPC_URL`**（或 `--rpc`）用于后台刷新，Entry 解析不等待 RPC。
 
 ---
 
@@ -290,29 +296,29 @@ npx tsx examples/shredstream_example.ts -- --url=http://127.0.0.1:10800
 | 描述 | 运行命令 | 源码 |
 |------|----------|------|
 | **本包脚本** | | |
-| gRPC 集成测试（PumpFun + PumpSwap，账户填充后的 `DexEvent`） | `npx tsx scripts/test-grpc-ts.ts` | [test-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/test-grpc-ts.ts) | `v0.5.19` |
-| 调试：打印 `metaRaw` / 日志结构 | `npx tsx scripts/debug-grpc-ts.ts` | [debug-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/debug-grpc-ts.ts) | `v0.5.19` |
+| gRPC 集成测试（PumpFun + PumpSwap，账户填充后的 `DexEvent`） | `npx tsx scripts/test-grpc-ts.ts` | [test-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/test-grpc-ts.ts) | `v0.5.20` |
+| 调试：打印 `metaRaw` / 日志结构 | `npx tsx scripts/debug-grpc-ts.ts` | [debug-grpc-ts.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/scripts/debug-grpc-ts.ts) | `v0.5.20` |
 | **PumpFun** | | |
-| CREATE + dev BUY/SELL 长时间低延迟订阅 | `npx tsx examples/devtrades_low_latency.ts` | [devtrades_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_low_latency.ts) | `v0.5.19` |
-| PumpFun + 全量 PumpSwap 开发者交易/加池 | `npm run example:grpc:devtrades:pumpswap` | [devtrades_pumpfun_pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_pumpfun_pumpswap_low_latency.ts) | `v0.5.19` |
-| gRPC 输出完整 JSON `DexEvent` | `npx tsx examples/pumpfun_grpc_json.ts` | [pumpfun_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_grpc_json.ts) | `v0.5.19` |
-| PumpFun 事件 + 性能指标 | `npx tsx examples/pumpfun_with_metrics.ts` | [pumpfun_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_with_metrics.ts) | `v0.5.19` |
-| PumpFun 交易类型过滤 | `npx tsx examples/pumpfun_trade_filter.ts` | [pumpfun_trade_filter.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_trade_filter.ts) | `v0.5.19` |
-| PumpFun 快速连接测试 | `npx tsx examples/pumpfun_quick_test.ts` | [pumpfun_quick_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_quick_test.ts) | `v0.5.19` |
+| CREATE + dev BUY/SELL 长时间低延迟订阅 | `npx tsx examples/devtrades_low_latency.ts` | [devtrades_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_low_latency.ts) | `v0.5.20` |
+| PumpFun + 全量 PumpSwap 开发者交易/加池 | `npm run example:grpc:devtrades:pumpswap` | [devtrades_pumpfun_pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/devtrades_pumpfun_pumpswap_low_latency.ts) | `v0.5.20` |
+| gRPC 输出完整 JSON `DexEvent` | `npx tsx examples/pumpfun_grpc_json.ts` | [pumpfun_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_grpc_json.ts) | `v0.5.20` |
+| PumpFun 事件 + 性能指标 | `npx tsx examples/pumpfun_with_metrics.ts` | [pumpfun_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_with_metrics.ts) | `v0.5.20` |
+| PumpFun 交易类型过滤 | `npx tsx examples/pumpfun_trade_filter.ts` | [pumpfun_trade_filter.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_trade_filter.ts) | `v0.5.20` |
+| PumpFun 快速连接测试 | `npx tsx examples/pumpfun_quick_test.ts` | [pumpfun_quick_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpfun_quick_test.ts) | `v0.5.20` |
 | **PumpSwap** | | |
-| gRPC 输出完整 JSON `DexEvent` | `npx tsx examples/pumpswap_grpc_json.ts` | [pumpswap_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_grpc_json.ts) | `v0.5.19` |
-| PumpSwap 事件 + 性能指标 | `npx tsx examples/pumpswap_with_metrics.ts` | [pumpswap_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_with_metrics.ts) | `v0.5.19` |
-| PumpSwap 交易、创建池及流动性事件（超低延迟） | `npm run example:grpc:pumpswap` | [pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_low_latency.ts) | `v0.5.19` |
+| gRPC 输出完整 JSON `DexEvent` | `npx tsx examples/pumpswap_grpc_json.ts` | [pumpswap_grpc_json.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_grpc_json.ts) | `v0.5.20` |
+| PumpSwap 事件 + 性能指标 | `npx tsx examples/pumpswap_with_metrics.ts` | [pumpswap_with_metrics.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_with_metrics.ts) | `v0.5.20` |
+| PumpSwap 交易、创建池及流动性事件（超低延迟） | `npm run example:grpc:pumpswap` | [pumpswap_low_latency.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/pumpswap_low_latency.ts) | `v0.5.20` |
 | **Meteora DAMM** | | |
-| 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) | `v0.5.19` |
+| 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) | `v0.5.20` |
 | **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) | `v0.5.19` |
-| ShredStream → PumpFun `DexEvent` JSON；RPC（`RPC_URL` 或 `--rpc`）只后台刷新 ALT，冷缓存 miss 跳过并计数、不重放；应预热所需表。 | `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) | `v0.5.19` |
+| 超低延迟订阅、队列与延迟统计。端点：`--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) | `v0.5.20` |
+| ShredStream → PumpFun `DexEvent` JSON；RPC（`RPC_URL` 或 `--rpc`）只后台刷新 ALT，冷缓存 miss 跳过并计数、不重放；应预热所需表。 | `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) | `v0.5.20` |
 | **多协议** | | |
-| 同时订阅所有 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) | `v0.5.19` |
+| 同时订阅所有 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) | `v0.5.20` |
 | **工具** | | |
-| 验证 onUpdate 同步错误不会打断 gRPC 流 | `npx tsx examples/grpc_onupdate_error_test.ts` | [grpc_onupdate_error_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/grpc_onupdate_error_test.ts) | `v0.5.19` |
-| 按签名解析交易（`parseTransactionFromRpc`；非 gRPC）。在 `.env` 或环境中设置 `TX_SIGNATURE`。 | `npx tsx examples/parse_tx_by_signature.ts` | [parse_tx_by_signature.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/parse_tx_by_signature.ts) | `v0.5.19` |
+| 验证 onUpdate 同步错误不会打断 gRPC 流 | `npx tsx examples/grpc_onupdate_error_test.ts` | [grpc_onupdate_error_test.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/grpc_onupdate_error_test.ts) | `v0.5.20` |
+| 按签名解析交易（`parseTransactionFromRpc`；非 gRPC）。在 `.env` 或环境中设置 `TX_SIGNATURE`。 | `npx tsx examples/parse_tx_by_signature.ts` | [parse_tx_by_signature.ts](https://github.com/0xfnzero/sol-parser-sdk-nodejs/blob/main/examples/parse_tx_by_signature.ts) | `v0.5.20` |
 
 **`npm run` 别名**（与上表 ShredStream 行同一源码文件，每行一条）：
 
@@ -356,3 +362,17 @@ MIT — https://github.com/0xfnzero/sol-parser-sdk-nodejs
 完整跨语言 API 对齐仍在进行；公开行为和支持边界见 [API 迁移说明](docs/USAGE.md#api-compatibility)，使用方法见 examples 目录。
 
 PumpFun create/create_v2 的共享主网样本、重放方法和验证边界见 [验证说明](https://github.com/0xfnzero/sol-parser-sdk-golang/tree/main/validation/pumpfun_create_20261007)。
+
+### Pump ShredStream 离线回归
+
+已同步路由意图事件、严格 ALT 缓存解析和本语言原生签名回放／SBF 模拟示例。运行命令、缓存 API、冻结数据来源与测试范围见 [examples/offline_bank/README.md](examples/offline_bank/README.md)。默认跳过账户未解析完整的指令；旧行为需显式使用 best-effort 入口。路由意图不等于已成交事件，解析热路径不调用 RPC。
+
+### 可重复的本地热路径基准
+
+运行 `npx tsx examples/hotpath_benchmark.ts`；可选第二个参数为 JSON
+配置路径。默认配置在 `examples/hotpath_benchmark.json`，可修改预热次数、
+样本数与批大小。固定工作负载覆盖真实签名的包装程序和 ALT 交易，分别测量
+完整账户解析与 wire 解码加解析。文件读取、配置及样例准备均在计时之外，
+计时循环无 RPC/网络请求。输出 p50/p95/p99 为每批折算的单交易微秒分布，
+包含调度和 GC 影响；这不是生产延迟或上链速度保证。比较时保持运行时、
+配置和主机负载一致，双方均需先预热。

package/dist/core/dex_event.d.ts

@@ -1,8 +1,11 @@
+import type { PumpRouteIntentEvent } from "../instr/pump_routes.js";
 import type { PumpFunPostCompleteBuyEvent, PumpFunSweepBondingCurveFeeEvent, PumpFunCompleteEvent, PumpSwapSweepPoolFeeEvent } from "../logs/pump_upgrade.js";
 import type { RawAccountSnapshotEvent, LiquidityAccountSnapshotEvent } from '../liquidity_snapshot.js';
 import type { EventMetadata } from "./metadata.js";
 /** 统一 DEX 事件：外部标签 JSON（单键对象）；键名清单见 `scripts/dex-event-variant-names.json` */
 export type DexEvent = {
+    PumpRouteIntent: PumpRouteIntentEvent;
+} | {
     PumpFunPostCompleteBuy: PumpFunPostCompleteBuyEvent;
 } | {
     PumpFunSweepBondingCurveFee: PumpFunSweepBondingCurveFeeEvent;

package/dist/grpc/types.d.ts

@@ -154,7 +154,7 @@ export declare function accountFilterFromProgramOwners(programIds: string[]): Ac
  */
 export declare function accountFilterMemcmp(offset: number, bytes: Uint8Array): SubscribeRequestFilterAccountsFilter;
 /** 事件类型过滤标签 */
-export type EventType = "AccountRawSnapshot" | "AccountLiquiditySnapshot" | "BlockMeta" | "RaydiumLaunchlabTrade" | "RaydiumLaunchlabPoolCreate" | "RaydiumLaunchlabMigrateAmm" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpFeesCreateFeeSharingConfig" | "PumpFeesInitializeFeeConfig" | "PumpFeesResetFeeSharingConfig" | "PumpFeesRevokeFeeSharingAuthority" | "PumpFeesTransferFeeSharingAuthority" | "PumpFeesUpdateAdmin" | "PumpFeesUpdateFeeConfig" | "PumpFeesUpdateFeeShares" | "PumpFeesUpsertFeeTiers" | "PumpFunPostCompleteBuy" | "PumpFunSweepBondingCurveFee" | "PumpSwapSweepPoolFee" | "PumpFunMigrateBondingCurveCreator" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumClmmSwap" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmClosePosition" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmLiquidityChange" | "RaydiumClmmConfigChange" | "RaydiumClmmCreatePersonalPosition" | "RaydiumClmmLiquidityCalculate" | "RaydiumClmmOpenLimitOrder" | "RaydiumClmmIncreaseLimitOrder" | "RaydiumClmmDecreaseLimitOrder" | "RaydiumClmmSettleLimitOrder" | "RaydiumClmmUpdateRewardInfos" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmCollectFee" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4Initialize2" | "RaydiumAmmV4WithdrawPnl" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2InitializePool" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2ClaimPositionFee" | "MeteoraDammV2ClaimReward" | "MeteoraDlmmClaimReward" | "MeteoraDammV2ClosePosition" | "MeteoraDammV2UpdateDelegatePermission" | "MeteoraDammV2WithdrawDeadLiquidityReward" | "MeteoraDammV2WithdrawIneligibleReward" | "MeteoraDammV2UpdateRewardFunder" | "MeteoraDammV2UpdateRewardDuration" | "MeteoraDammV2InitializeReward" | "MeteoraDammV2FundReward" | "MeteoraDammV2CreateConfig" | "MeteoraDammV2CreateDynamicConfig" | "MeteoraDbcSwap" | "MeteoraDbcInitializePool" | "MeteoraDbcCurveComplete" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpFunGlobal" | "AccountPumpFunBondingCurve" | "AccountPumpFunFeeConfig" | "AccountPumpFunSharingConfig" | "AccountPumpFunGlobalVolumeAccumulator" | "AccountPumpFunUserVolumeAccumulator" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool" | "AccountRaydiumClmmAmmConfig" | "AccountRaydiumClmmPoolState" | "AccountRaydiumClmmTickArrayState" | "AccountRaydiumCpmmAmmConfig" | "AccountRaydiumCpmmPoolState" | "AccountOrcaWhirlpool" | "AccountOrcaPosition" | "AccountOrcaTickArray" | "AccountOrcaFeeTier" | "AccountOrcaWhirlpoolsConfig";
+export type EventType = "PumpRouteIntent" | "AccountRawSnapshot" | "AccountLiquiditySnapshot" | "BlockMeta" | "RaydiumLaunchlabTrade" | "RaydiumLaunchlabPoolCreate" | "RaydiumLaunchlabMigrateAmm" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpFeesCreateFeeSharingConfig" | "PumpFeesInitializeFeeConfig" | "PumpFeesResetFeeSharingConfig" | "PumpFeesRevokeFeeSharingAuthority" | "PumpFeesTransferFeeSharingAuthority" | "PumpFeesUpdateAdmin" | "PumpFeesUpdateFeeConfig" | "PumpFeesUpdateFeeShares" | "PumpFeesUpsertFeeTiers" | "PumpFunPostCompleteBuy" | "PumpFunSweepBondingCurveFee" | "PumpSwapSweepPoolFee" | "PumpFunMigrateBondingCurveCreator" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumClmmSwap" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmClosePosition" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmLiquidityChange" | "RaydiumClmmConfigChange" | "RaydiumClmmCreatePersonalPosition" | "RaydiumClmmLiquidityCalculate" | "RaydiumClmmOpenLimitOrder" | "RaydiumClmmIncreaseLimitOrder" | "RaydiumClmmDecreaseLimitOrder" | "RaydiumClmmSettleLimitOrder" | "RaydiumClmmUpdateRewardInfos" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmCollectFee" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4Initialize2" | "RaydiumAmmV4WithdrawPnl" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2InitializePool" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2ClaimPositionFee" | "MeteoraDammV2ClaimReward" | "MeteoraDlmmClaimReward" | "MeteoraDammV2ClosePosition" | "MeteoraDammV2UpdateDelegatePermission" | "MeteoraDammV2WithdrawDeadLiquidityReward" | "MeteoraDammV2WithdrawIneligibleReward" | "MeteoraDammV2UpdateRewardFunder" | "MeteoraDammV2UpdateRewardDuration" | "MeteoraDammV2InitializeReward" | "MeteoraDammV2FundReward" | "MeteoraDammV2CreateConfig" | "MeteoraDammV2CreateDynamicConfig" | "MeteoraDbcSwap" | "MeteoraDbcInitializePool" | "MeteoraDbcCurveComplete" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpFunGlobal" | "AccountPumpFunBondingCurve" | "AccountPumpFunFeeConfig" | "AccountPumpFunSharingConfig" | "AccountPumpFunGlobalVolumeAccumulator" | "AccountPumpFunUserVolumeAccumulator" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool" | "AccountRaydiumClmmAmmConfig" | "AccountRaydiumClmmPoolState" | "AccountRaydiumClmmTickArrayState" | "AccountRaydiumCpmmAmmConfig" | "AccountRaydiumCpmmPoolState" | "AccountOrcaWhirlpool" | "AccountOrcaPosition" | "AccountOrcaTickArray" | "AccountOrcaFeeTier" | "AccountOrcaWhirlpoolsConfig";
 /** 与 Rust `grpc::EventType`（由 `StreamingEventType` 导出）一致 */
 export type StreamingEventType = EventType;
 /** 所有事件类型列表 */

package/dist/grpc/types.js

@@ -30,6 +30,7 @@ exports.eventTypeFilterIncludesRaydiumAmmV4 = eventTypeFilterIncludesRaydiumAmmV
 exports.eventTypeFilterIncludesOrcaWhirlpool = eventTypeFilterIncludesOrcaWhirlpool;
 exports.eventTypeFilterIncludesRaydiumLaunchlab = eventTypeFilterIncludesRaydiumLaunchlab;
 exports.eventTypeFilterAllowsInstructionParsing = eventTypeFilterAllowsInstructionParsing;
+const pump_routes_js_1 = require("../instr/pump_routes.js");
 const metadata_js_1 = require("../core/metadata.js");
 function defaultClientConfig() {
     return {
@@ -260,6 +261,7 @@ exports.ALL_EVENT_TYPES = [
     "PumpFunPostCompleteBuy",
     "PumpFunSweepBondingCurveFee",
     "PumpSwapSweepPoolFee",
+    "PumpRouteIntent",
 ];
 const ALL_EVENT_TYPE_SET = new Set(exports.ALL_EVENT_TYPES);
 const PUMPFUN_BUY_FAMILY = ["PumpFunBuy", "PumpFunBuyExactSolIn"];
@@ -390,6 +392,7 @@ const RAYDIUM_LAUNCHLAB_FILTER_TYPES = [
     "RaydiumLaunchlabMigrateAmm",
 ];
 const INSTRUCTION_EVENT_TYPES = [
+    "PumpRouteIntent",
     ...PUMPFUN_FILTER_TYPES,
     ...PUMP_FEES_EVENT_TYPES,
     ...PUMPSWAP_FILTER_TYPES,
@@ -436,6 +439,8 @@ function eventTypeFromDexEvent(event) {
     return ALL_EVENT_TYPE_SET.has(variant) ? variant : null;
 }
 function eventTypeFilterShouldIncludeDexEvent(filter, event) {
+    if ("PumpRouteIntent" in event)
+        return (0, pump_routes_js_1.allowsPumpRoute)(filter, event.PumpRouteIntent.program);
     const eventType = eventTypeFromDexEvent(event);
     return eventType === null || filter.shouldInclude(eventType);
 }

package/dist/index.d.ts

@@ -48,7 +48,7 @@ export { connectYellowstoneGeyser, defaultGeyserConnectConfig, geyserGrpcChannel
 /** 与 Rust `sol_parser_sdk::grpc::event_parser` 模块对应 */
 export * as event_parser from "./grpc/event_parser.js";
 export { connectYellowstoneGeyser as connect_yellowstone_geyser, defaultGeyserConnectConfig as default_geyser_connect_config, geyserGrpcChannelOptions as geyser_grpc_channel_options, } from "./grpc/geyser_connect.js";
-export { ShredStreamClient, ShredEventQueue, dexEventsFromShredWasmTx, dexEventsFromShredWasmTxWithFullKeys, fullAccountKeyStringsFromShredTx, loadAddressLookupTableAccounts, bincodeVecEntryCount, decodeEntriesBincodeFlat, decodeEntriesBincodeNested, decodeShredstreamEntriesBincode, wireBytesToShredWasmTx, type ShredStreamReceiveStats, type ShredWasmTx, type ShredWasmCompiledIx, type ShredStreamConfig, type DecodedWireTransaction, defaultShredStreamConfig, lowLatencyShredStreamConfig, highThroughputShredStreamConfig, type SubscribeEntriesRequest, type ShredstreamEntryMessage, } from "./shredstream/index.js";
+export { ShredStreamClient, ShredEventQueue, dexEventsFromShredWasmTx, dexEventsFromShredWasmTxBestEffort, dexEventsFromShredWasmTxWithLoadedAddresses, dexEventsFromShredWasmTxWithFullKeys, fullAccountKeyStringsFromShredTx, loadAddressLookupTableAccounts, bincodeVecEntryCount, decodeEntriesBincodeFlat, decodeEntriesBincodeNested, decodeShredstreamEntriesBincode, wireBytesToShredWasmTx, type ShredStreamReceiveStats, type ShredWasmTx, type ShredWasmCompiledIx, type ShredStreamConfig, type DecodedWireTransaction, defaultShredStreamConfig, lowLatencyShredStreamConfig, highThroughputShredStreamConfig, type SubscribeEntriesRequest, type ShredstreamEntryMessage, } from "./shredstream/index.js";
 export { defaultShredStreamConfig as default_shred_stream_config, lowLatencyShredStreamConfig as low_latency_shred_stream_config, highThroughputShredStreamConfig as high_throughput_shred_stream_config, } from "./shredstream/index.js";
 export { decodeWireTransaction, type WireMessage, type WireInstruction, type DecodedWireTransaction as NativeWireTransaction } from './wire_transaction.js';
 export * from './transaction_route.js';
@@ -59,3 +59,4 @@ export { parseBlockMetaUpdate } from "./grpc/block_meta.js";
 export { buildSubscribeRequestWithEventFilter } from "./grpc/subscribe_builder.js";
 export type { LaunchLabPoolCreateEvent, StonkFunPoolCreateEvent, LaunchLabTradeEvent, StonkFunTradeEvent, } from "./core/dex_event.js";
 export * from "./logs/pump_upgrade.js";
+export * from "./instr/pump_routes.js";

package/dist/index.js

@@ -40,7 +40,7 @@ exports.pubkeyBytesToBs58 = exports.grpcTxIndexFromInfo = exports.parseDexEvents
 exports.RAYDIUM_CPMM_PROGRAM_ID = exports.RAYDIUM_LAUNCHLAB_PROGRAM_ID = exports.PUMP_FEES_PROGRAM_ID = exports.PUMPSWAP_FEES_PROGRAM_ID = exports.PUMPSWAP_PROGRAM_ID = exports.PUMPFUN_PROGRAM_ID = exports.PROTOCOL_PROGRAM_IDS = exports.all_event_types = exports.ALL_EVENT_TYPES = exports.eventTypeFilterAllowsInstructionParsing = exports.eventTypeFilterIncludesPumpFees = exports.eventTypeFilterIncludesRaydiumLaunchlab = exports.eventTypeFilterIncludesOrcaWhirlpool = exports.eventTypeFilterIncludesRaydiumAmmV4 = exports.eventTypeFilterIncludesRaydiumCpmm = exports.eventTypeFilterIncludesRaydiumClmm = exports.eventTypeFilterIncludesMeteoraDlmm = exports.eventTypeFilterIncludesMeteoraPools = exports.eventTypeFilterIncludesMeteoraDbc = exports.eventTypeFilterIncludesMeteoraDammV2 = exports.eventTypeFilterIncludesPumpswap = exports.eventTypeFilterIncludesPumpfun = exports.eventTypeFilterExclude = exports.eventTypeFilterIncludeOnly = exports.accountFilterMemcmp = exports.accountFilterFromProgramOwners = exports.slotFilterMaxSlot = exports.slotFilterMinSlot = exports.newSlotFilter = exports.newAccountFilter = exports.transactionFilterFromProgramIds = exports.newTransactionFilter = exports.highThroughputClientConfig = exports.lowLatencyClientConfig = exports.defaultClientConfig = exports.try_yellowstone_signature = exports.collect_watch_transfer_counterparty_pairs = exports.spl_token_counterparty_by_owner = exports.token_balance_raw_amount = exports.heuristic_sol_counterparties_for_watched_keys = exports.lamport_balance_deltas = exports.collect_account_keys_bs58 = exports.pubkey_bytes_to_bs58 = exports.tryYellowstoneSignature = exports.collectWatchTransferCounterpartyPairs = exports.splTokenCounterpartyByOwner = exports.tokenBalanceRawAmount = exports.heuristicSolCounterpartiesForWatchedKeys = exports.lamportBalanceDeltas = exports.collectAccountKeysBs58 = void 0;
 exports.discriminatorToProtocol = exports.discriminator_to_name = exports.discriminatorToName = exports.parse_log_unified = exports.parse_log_optimized = exports.parse_meteora_dlmm_log = exports.parse_meteora_damm_log = exports.parseProgramCompleteInfo = exports.parseLogUnified = exports.parseLogOptimizedWithProgramId = exports.parseLogOptimized = exports.parseInvokeInfo = exports.build_subscribe_transaction_filters_named = exports.build_subscribe_request_with_commitment = exports.build_subscribe_request = exports.CommitmentLevel = exports.buildSubscribeTransactionFiltersNamed = exports.buildSubscribeRequestWithCommitment = exports.buildSubscribeRequest = exports.exclude_types = exports.include_only = exports.event_type_filter_exclude = exports.event_type_filter_include_only = exports.account_filter_memcmp = exports.account_filter_from_program_owners = exports.slot_filter_max_slot = exports.slot_filter_min_slot = exports.new_slot_filter = exports.new_account_filter = exports.transaction_filter_from_program_ids = exports.new_transaction_filter = exports.high_throughput_client_config = exports.low_latency_client_config = exports.default_client_config = exports.account_filter_for_protocols = exports.transaction_filter_for_protocol_accounts = exports.transaction_filter_for_protocols = exports.get_program_ids_for_protocols = exports.protocol_program_ids = exports.accountFilterForProtocols = exports.transactionFilterForProtocolAccounts = exports.transactionFilterForProtocols = exports.getProgramIdsForProtocols = exports.METEORA_DBC_PROGRAM_ID = exports.METEORA_DLMM_PROGRAM_ID = exports.METEORA_DAMM_V2_PROGRAM_ID = exports.METEORA_POOLS_PROGRAM_ID = exports.ORCA_WHIRLPOOL_PROGRAM_ID = exports.RAYDIUM_AMM_V4_PROGRAM_ID = exports.RAYDIUM_CLMM_PROGRAM_ID = void 0;
 exports.event_parser = exports.geyserGrpcChannelOptions = exports.defaultGeyserConnectConfig = exports.connectYellowstoneGeyser = exports.YellowstoneGrpc = exports.programIds = exports.parse_pump_fees_instruction = exports.parse_meteora_pools_instruction = exports.parse_meteora_dlmm_instruction = exports.parse_meteora_damm_instruction = exports.parse_pumpswap_instruction = exports.parse_pumpfun_instruction = exports.parse_instruction_unified = exports.parsePumpFeesInstruction = exports.parseMeteoraPoolsInstruction = exports.parseMeteoraDlmmInstruction = exports.parseMeteoraDammInstruction = exports.parsePumpswapInstruction = exports.parsePumpfunInstruction = exports.parseInstructionUnified = exports.user_wallet_pubkey_for_onchain_account = exports.rpc_resolve_user_wallet_pubkey = exports.parse_pumpswap_pool = exports.parse_pumpswap_global_config = exports.parse_pumpfun_global = exports.parse_token_account = exports.parse_nonce_account = exports.parse_account_unified = exports.rpcResolveUserWalletPubkey = exports.userWalletPubkeyForOnchainAccount = exports.hasDiscriminator = exports.isPoolAccount = exports.isGlobalConfigAccount = exports.parsePumpswapAccount = exports.parsePumpswapPool = exports.parsePumpswapGlobalConfig = exports.isPumpfunGlobalAccount = exports.parsePumpfunAccount = exports.parsePumpfunGlobal = exports.parseTokenAccount = exports.isNonceAccount = exports.parseNonceAccount = exports.parseAccountUnified = exports.u64leDiscriminator = exports.PUMPSWAP_DISC = exports.PROGRAM_LOG_DISC = exports.parseMeteoraDammLog = exports.lookup_discriminator = exports.lookupDiscriminator = exports.discriminator_to_protocol = void 0;
-exports.buildSubscribeRequestWithEventFilter = exports.parseBlockMetaUpdate = exports.analyzeSimulationRoutes = exports.decodeWireTransaction = exports.high_throughput_shred_stream_config = exports.low_latency_shred_stream_config = exports.default_shred_stream_config = exports.highThroughputShredStreamConfig = exports.lowLatencyShredStreamConfig = exports.defaultShredStreamConfig = exports.wireBytesToShredWasmTx = exports.decodeShredstreamEntriesBincode = exports.decodeEntriesBincodeNested = exports.decodeEntriesBincodeFlat = exports.bincodeVecEntryCount = exports.loadAddressLookupTableAccounts = exports.fullAccountKeyStringsFromShredTx = exports.dexEventsFromShredWasmTxWithFullKeys = exports.dexEventsFromShredWasmTx = exports.ShredEventQueue = exports.ShredStreamClient = exports.geyser_grpc_channel_options = exports.default_geyser_connect_config = exports.connect_yellowstone_geyser = void 0;
+exports.buildSubscribeRequestWithEventFilter = exports.parseBlockMetaUpdate = exports.analyzeSimulationRoutes = exports.decodeWireTransaction = exports.high_throughput_shred_stream_config = exports.low_latency_shred_stream_config = exports.default_shred_stream_config = exports.highThroughputShredStreamConfig = exports.lowLatencyShredStreamConfig = exports.defaultShredStreamConfig = exports.wireBytesToShredWasmTx = exports.decodeShredstreamEntriesBincode = exports.decodeEntriesBincodeNested = exports.decodeEntriesBincodeFlat = exports.bincodeVecEntryCount = exports.loadAddressLookupTableAccounts = exports.fullAccountKeyStringsFromShredTx = exports.dexEventsFromShredWasmTxWithFullKeys = exports.dexEventsFromShredWasmTxWithLoadedAddresses = exports.dexEventsFromShredWasmTxBestEffort = exports.dexEventsFromShredWasmTx = exports.ShredEventQueue = exports.ShredStreamClient = exports.geyser_grpc_channel_options = exports.default_geyser_connect_config = exports.connect_yellowstone_geyser = void 0;
 var constants_js_1 = require("./common/constants.js");
 Object.defineProperty(exports, "DEFAULT_CHANNEL_SIZE", { enumerable: true, get: function () { return constants_js_1.DEFAULT_CHANNEL_SIZE; } });
 Object.defineProperty(exports, "DEFAULT_CONNECT_TIMEOUT", { enumerable: true, get: function () { return constants_js_1.DEFAULT_CONNECT_TIMEOUT; } });
@@ -290,6 +290,8 @@ var index_js_1 = require("./shredstream/index.js");
 Object.defineProperty(exports, "ShredStreamClient", { enumerable: true, get: function () { return index_js_1.ShredStreamClient; } });
 Object.defineProperty(exports, "ShredEventQueue", { enumerable: true, get: function () { return index_js_1.ShredEventQueue; } });
 Object.defineProperty(exports, "dexEventsFromShredWasmTx", { enumerable: true, get: function () { return index_js_1.dexEventsFromShredWasmTx; } });
+Object.defineProperty(exports, "dexEventsFromShredWasmTxBestEffort", { enumerable: true, get: function () { return index_js_1.dexEventsFromShredWasmTxBestEffort; } });
+Object.defineProperty(exports, "dexEventsFromShredWasmTxWithLoadedAddresses", { enumerable: true, get: function () { return index_js_1.dexEventsFromShredWasmTxWithLoadedAddresses; } });
 Object.defineProperty(exports, "dexEventsFromShredWasmTxWithFullKeys", { enumerable: true, get: function () { return index_js_1.dexEventsFromShredWasmTxWithFullKeys; } });
 Object.defineProperty(exports, "fullAccountKeyStringsFromShredTx", { enumerable: true, get: function () { return index_js_1.fullAccountKeyStringsFromShredTx; } });
 Object.defineProperty(exports, "loadAddressLookupTableAccounts", { enumerable: true, get: function () { return index_js_1.loadAddressLookupTableAccounts; } });
@@ -317,3 +319,4 @@ Object.defineProperty(exports, "parseBlockMetaUpdate", { enumerable: true, get:
 var subscribe_builder_js_3 = require("./grpc/subscribe_builder.js");
 Object.defineProperty(exports, "buildSubscribeRequestWithEventFilter", { enumerable: true, get: function () { return subscribe_builder_js_3.buildSubscribeRequestWithEventFilter; } });
 __exportStar(require("./logs/pump_upgrade.js"), exports);
+__exportStar(require("./instr/pump_routes.js"), exports);

package/dist/instr/pump_routes.d.ts

@@ -0,0 +1,27 @@
+/** Program-bound wire intents. No RPC, fills, balances or reserves are inferred. */
+import type { EventMetadata } from '../core/metadata.js';
+import type { EventTypeFilter } from '../grpc/types.js';
+export interface PumpRouteHop {
+    base_mint: string;
+    quote_mint: string;
+    venue: string;
+    base_vault: string;
+    quote_vault: string;
+}
+export interface PumpRouteIntentEvent {
+    metadata: EventMetadata;
+    kind: 'MultiHopSwap' | 'MultiHopCurveSwap' | 'RapidBuy' | 'BuyPumpDelta';
+    program: string;
+    instruction_index: number;
+    user: string;
+    input_account: string;
+    output_account: string;
+    amount_in: bigint | null;
+    min_amount_out: bigint | null;
+    hops: PumpRouteHop[];
+    instruction_data: number[];
+}
+export declare function mayParsePumpRoute(program: string, data: Uint8Array): boolean;
+export declare function allowsPumpRoute(filter: EventTypeFilter | undefined, program: string): boolean;
+export declare function pumpMultiHopArgs(program: string, data: Uint8Array, a: readonly string[]): [bigint, bigint] | null;
+export declare function parsePumpRoute(program: string, data: Uint8Array, a: readonly string[], metadata: EventMetadata, index: number, filter?: EventTypeFilter): PumpRouteIntentEvent | null;

package/dist/instr/pump_routes.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mayParsePumpRoute = mayParsePumpRoute;
+exports.allowsPumpRoute = allowsPumpRoute;
+exports.pumpMultiHopArgs = pumpMultiHopArgs;
+exports.parsePumpRoute = parsePumpRoute;
+const PUMP = '6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P', AMM = 'pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA', RAPID = 'rapidV5DAKtecYzetwCNoxXWHpezjeg4hGt9BGiVcGW', DELTA = 'J7pourVwqP1VtRNBiFNqbdGxwkx7ta2LHAURURRRJqmd', TOKEN = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA', TOKEN22 = 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb', SYSTEM = '11111111111111111111111111111111', ATA = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL', GLOBAL = '4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf', EVENT = 'Ce6TQqeHC9p8KetsN6JsjHK7UTZk7nasjjnr7XxXp9F1', FEES = 'pfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ';
+function matches(data, at, bytes) { return bytes.every((v, i) => data[at + i] === v); }
+const MULTI = [43, 100, 73, 19, 233, 246, 111, 148], CURVE = [225, 154, 117, 22, 215, 86, 246, 103];
+function mayParsePumpRoute(program, data) {
+    return (program === AMM && matches(data, 0, MULTI)) || (program === PUMP && matches(data, 0, CURVE))
+        || (program === DELTA && data.length === 28 && matches(data, 0, [122, 28, 94, 147, 180, 45, 240, 97]))
+        || (program === RAPID && data.length === 41 && data[0] === 0 && matches(data, 9, [1, 0, 0, 27, 15, 14, 8, 24]) && matches(data, 17, [194, 171, 28, 70, 104, 77, 91, 47]) && matches(data, 25, Array(8).fill(0)));
+}
+function allowsPumpRoute(filter, program) {
+    if (!filter)
+        return true;
+    const excluded = filter.exclude_types ?? [];
+    if (excluded.includes('PumpRouteIntent') || excluded.includes('PumpFunTrade') || (program === AMM && excluded.includes('PumpSwapTrade')))
+        return false;
+    const included = filter.include_only;
+    return included ? included.includes('PumpRouteIntent') || included.includes('PumpFunTrade') || (program === AMM && included.includes('PumpSwapTrade')) : filter.shouldInclude('PumpRouteIntent');
+}
+function context(a, pairs) { return Object.entries(pairs).every(([i, v]) => a[Number(i)] === v); }
+function pumpMultiHopArgs(program, data, a) {
+    if (program !== AMM || data.length !== 24 || !matches(data, 0, MULTI) || a.length < 21 || (a.length - 16) % 5 || !context(a, { 7: TOKEN, 8: TOKEN22, 9: SYSTEM, 11: AMM, 12: PUMP }))
+        return null;
+    const d = new DataView(data.buffer, data.byteOffset, data.byteLength), amount = d.getBigUint64(8, true);
+    return amount ? [amount, d.getBigUint64(16, true)] : null;
+}
+function parsePumpRoute(program, data, a, metadata, index, filter) {
+    if (!mayParsePumpRoute(program, data) || !allowsPumpRoute(filter, program))
+        return null;
+    const d = new DataView(data.buffer, data.byteOffset, data.byteLength), u = (at) => d.getBigUint64(at, true);
+    let kind, fixed, user, input, output, amount, minimum;
+    if (program === AMM) {
+        const args = pumpMultiHopArgs(program, data, a);
+        if (!args)
+            return null;
+        [kind, fixed, user, input, output, amount, minimum] = ['MultiHopSwap', 16, 0, 1, 2, ...args];
+    }
+    else if (program === PUMP) {
+        if (data.length < 20)
+            return null;
+        const count = d.getUint32(16, true);
+        if (!count || data.length !== 20 + count || a.length !== 13 + count * 5 || !context(a, { 8: TOKEN, 9: TOKEN22, 10: SYSTEM, 11: EVENT, 12: PUMP }))
+            return null;
+        [kind, fixed, user, input, output, amount, minimum] = ['MultiHopCurveSwap', 13, 3, 5, 6, u(8), null];
+    }
+    else if (program === RAPID) {
+        if (a.length !== 33 || a[0] !== a[19] || a[2] !== a[8] || ![TOKEN, TOKEN22].includes(a[9]) || !context(a, { 3: TOKEN, 4: SYSTEM, 5: PUMP, 6: GLOBAL, 10: TOKEN, 11: ATA, 29: FEES, 30: SYSTEM, 31: EVENT, 32: PUMP }))
+            return null;
+        [kind, fixed, user, input, output, amount, minimum] = ['RapidBuy', 0, 0, 21, 20, u(1), u(33)];
+    }
+    else {
+        if (a.length !== 30 || a[0] !== a[14] || ![TOKEN, TOKEN22].includes(a[4]) || ![TOKEN, TOKEN22].includes(a[5]) || !context(a, { 1: GLOBAL, 6: ATA, 24: FEES, 25: SYSTEM, 26: EVENT, 27: PUMP }))
+            return null;
+        [kind, fixed, user, input, output, amount, minimum] = ['BuyPumpDelta', 0, 0, 16, 15, null, null];
+    }
+    if (amount === 0n)
+        return null;
+    const hop = (h) => ({ base_mint: h[0], quote_mint: h[1], venue: h[2], base_vault: h[3], quote_vault: h[4] });
+    const hops = [];
+    if (fixed) {
+        for (let i = fixed; i < a.length; i += 5)
+            hops.push(hop(a.slice(i, i + 5)));
+    }
+    else
+        hops.push(hop((program === RAPID ? [7, 2, 16, 17, 18] : [2, 3, 11, 12, 13]).map(i => a[i])));
+    return { metadata, kind, program, instruction_index: index, user: a[user], input_account: a[input], output_account: a[output], amount_in: amount, min_amount_out: minimum, hops, instruction_data: Array.from(data) };
+}

package/dist/logs/pump_upgrade.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pumpUpgradeEventType = pumpUpgradeEventType;
 exports.parsePumpUpgradeEvent = parsePumpUpgradeEvent;
 exports.decodePumpMultiHopIntent = decodePumpMultiHopIntent;
+const pump_routes_js_1 = require("../instr/pump_routes.js");
 const binary_js_1 = require("../util/binary.js");
 function pumpUpgradeEventType(disc, programId) {
     if (disc === 18146529233607700591n &&
@@ -99,15 +100,10 @@ function parsePumpUpgradeEvent(disc, data, metadata, programId) {
 }
 /** Intent amounts are limits, not execution. Each hop emits its own actual trade. */
 function decodePumpMultiHopIntent(program, data, accounts) {
-    if (program !== "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA" ||
-        data.length !== 24 ||
-        (0, binary_js_1.readU64LE)(data, 0) !== 10696039120939607083n ||
-        accounts.length < 21 ||
-        (accounts.length - 16) % 5 !== 0)
-        return null;
-    const amountIn = (0, binary_js_1.readU64LE)(data, 8), minAmountOut = (0, binary_js_1.readU64LE)(data, 16);
-    if (!amountIn || !minAmountOut)
+    const args = (0, pump_routes_js_1.pumpMultiHopArgs)(program, data, accounts);
+    if (!args)
         return null;
+    const [amountIn, minAmountOut] = args;
     const hops = [];
     for (let i = 16; i < accounts.length; i += 5)
         hops.push({

package/dist/shredstream/index.d.ts

@@ -5,12 +5,12 @@
  * - ALT 仅使用预热缓存；启用缓存后 miss 会跳过该交易并记录 altCacheMissTransactions，不回放
  * - 无 inner instructions，无法 CPI 解析
  * - 无 block_time
- * - 无交易日志（program logs）；客户端使用外层指令解析。未配置 ALT 缓存时保留静态账户 best-effort 行为。
+ * - 无交易日志（program logs）；客户端使用外层指令解析。未配置 ALT 缓存时仅解析账户完整的静态指令。
  * - `metadata.tx_index` 为**单条 gRPC `Entry` 消息内**跨所有 Solana `Entry` 分组的连续下标（与 golang `shredstream_entries` 扁平 `ti` 对齐），非 slot 级全局序号
  */
 export { type ShredStreamConfig, defaultShredStreamConfig, lowLatencyShredStreamConfig, highThroughputShredStreamConfig, } from "./config.js";
 export { ShredStreamClient, ShredEventQueue, type ShredStreamReceiveStats, } from "./client.js";
-export { dexEventsFromShredWasmTx, dexEventsFromShredWasmTxWithFullKeys, type ShredWasmTx, type ShredWasmCompiledIx, } from "./instruction_parse.js";
+export { dexEventsFromShredWasmTx, dexEventsFromShredWasmTxBestEffort, dexEventsFromShredWasmTxWithLoadedAddresses, dexEventsFromShredWasmTxWithFullKeys, type ShredWasmTx, type ShredWasmCompiledIx, } from "./instruction_parse.js";
 export { fullAccountKeyStringsFromShredTx, loadAddressLookupTableAccounts } from "./alt_lookup.js";
 export type { SubscribeEntriesRequest, ShredstreamEntryMessage } from "./proto_types.js";
 export { bincodeVecEntryCount, decodeEntriesBincodeFlat, decodeEntriesBincodeNested, decodeShredstreamEntriesBincode, type DecodedWireTransaction, } from "./entries_decode.js";

package/dist/shredstream/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AddressLookupTableCache = exports.wireBytesToShredWasmTx = exports.decodeShredstreamEntriesBincode = exports.decodeEntriesBincodeNested = exports.decodeEntriesBincodeFlat = exports.bincodeVecEntryCount = exports.loadAddressLookupTableAccounts = exports.fullAccountKeyStringsFromShredTx = exports.dexEventsFromShredWasmTxWithFullKeys = exports.dexEventsFromShredWasmTx = exports.ShredEventQueue = exports.ShredStreamClient = exports.highThroughputShredStreamConfig = exports.lowLatencyShredStreamConfig = exports.defaultShredStreamConfig = void 0;
+exports.AddressLookupTableCache = exports.wireBytesToShredWasmTx = exports.decodeShredstreamEntriesBincode = exports.decodeEntriesBincodeNested = exports.decodeEntriesBincodeFlat = exports.bincodeVecEntryCount = exports.loadAddressLookupTableAccounts = exports.fullAccountKeyStringsFromShredTx = exports.dexEventsFromShredWasmTxWithFullKeys = exports.dexEventsFromShredWasmTxWithLoadedAddresses = exports.dexEventsFromShredWasmTxBestEffort = exports.dexEventsFromShredWasmTx = exports.ShredEventQueue = exports.ShredStreamClient = exports.highThroughputShredStreamConfig = exports.lowLatencyShredStreamConfig = exports.defaultShredStreamConfig = void 0;
 /**
  * Jito ShredStream 超低延迟订阅（与 Rust `sol-parser-sdk::shredstream` 对齐）。
  *
@@ -8,7 +8,7 @@ exports.AddressLookupTableCache = exports.wireBytesToShredWasmTx = exports.decod
  * - ALT 仅使用预热缓存；启用缓存后 miss 会跳过该交易并记录 altCacheMissTransactions，不回放
  * - 无 inner instructions，无法 CPI 解析
  * - 无 block_time
- * - 无交易日志（program logs）；客户端使用外层指令解析。未配置 ALT 缓存时保留静态账户 best-effort 行为。
+ * - 无交易日志（program logs）；客户端使用外层指令解析。未配置 ALT 缓存时仅解析账户完整的静态指令。
  * - `metadata.tx_index` 为**单条 gRPC `Entry` 消息内**跨所有 Solana `Entry` 分组的连续下标（与 golang `shredstream_entries` 扁平 `ti` 对齐），非 slot 级全局序号
  */
 var config_js_1 = require("./config.js");
@@ -20,6 +20,8 @@ Object.defineProperty(exports, "ShredStreamClient", { enumerable: true, get: fun
 Object.defineProperty(exports, "ShredEventQueue", { enumerable: true, get: function () { return client_js_1.ShredEventQueue; } });
 var instruction_parse_js_1 = require("./instruction_parse.js");
 Object.defineProperty(exports, "dexEventsFromShredWasmTx", { enumerable: true, get: function () { return instruction_parse_js_1.dexEventsFromShredWasmTx; } });
+Object.defineProperty(exports, "dexEventsFromShredWasmTxBestEffort", { enumerable: true, get: function () { return instruction_parse_js_1.dexEventsFromShredWasmTxBestEffort; } });
+Object.defineProperty(exports, "dexEventsFromShredWasmTxWithLoadedAddresses", { enumerable: true, get: function () { return instruction_parse_js_1.dexEventsFromShredWasmTxWithLoadedAddresses; } });
 Object.defineProperty(exports, "dexEventsFromShredWasmTxWithFullKeys", { enumerable: true, get: function () { return instruction_parse_js_1.dexEventsFromShredWasmTxWithFullKeys; } });
 var alt_lookup_js_1 = require("./alt_lookup.js");
 Object.defineProperty(exports, "fullAccountKeyStringsFromShredTx", { enumerable: true, get: function () { return alt_lookup_js_1.fullAccountKeyStringsFromShredTx; } });

package/dist/shredstream/instruction_parse.d.ts

@@ -26,9 +26,11 @@ export type ShredWasmTx = {
     recentBlockhash?: Uint8Array;
     addressTableLookups?: ShredAddressTableLookup[];
 };
-/**
- * 使用已解析的完整账户表（静态+ALT）解析外层指令。
- */
-export declare function dexEventsFromShredWasmTxWithFullKeys(tx: ShredWasmTx, fullAccountKeys: string[], slot: number | bigint | string, txIndex: number | bigint | string, grpcRecvUs: number | bigint | string, eventTypeFilter?: EventTypeFilter): DexEvent[];
-/** 仅静态账户表（无 RPC 时；V0+ALT 缺失账户以默认 pubkey 占位） */
+/** 仅静态账户表（无 RPC；跳过未解析账户的指令） */
 export declare function dexEventsFromShredWasmTx(tx: ShredWasmTx, slot: number | bigint | string, txIndex: number | bigint | string, grpcRecvUs: number | bigint | string, eventTypeFilter?: EventTypeFilter): DexEvent[];
+/** Full-key entry point rejects inconsistent ALT counts and indices before emitting anything. */
+export declare function dexEventsFromShredWasmTxWithFullKeys(tx: ShredWasmTx, keys: string[], slot: number | bigint | string, txIndex: number | bigint | string, recvUs: number | bigint | string, filter?: EventTypeFilter): DexEvent[];
+/** Explicit legacy placeholder/discriminator fallback; route adapters always require resolved keys. */
+export declare function dexEventsFromShredWasmTxBestEffort(tx: ShredWasmTx, slot: number | bigint | string, txIndex: number | bigint | string, recvUs: number | bigint | string, filter?: EventTypeFilter): DexEvent[];
+/** Separate writable/readonly validation avoids ambiguous counts between the two classes. */
+export declare function dexEventsFromShredWasmTxWithLoadedAddresses(tx: ShredWasmTx, writable: readonly string[], readonly: readonly string[], slot: number | bigint | string, txIndex: number | bigint | string, recvUs: number | bigint | string, filter?: EventTypeFilter): DexEvent[];

package/dist/shredstream/instruction_parse.js

@@ -1,7 +1,15 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dexEventsFromShredWasmTxWithFullKeys = dexEventsFromShredWasmTxWithFullKeys;
 exports.dexEventsFromShredWasmTx = dexEventsFromShredWasmTx;
+exports.dexEventsFromShredWasmTxWithFullKeys = dexEventsFromShredWasmTxWithFullKeys;
+exports.dexEventsFromShredWasmTxBestEffort = dexEventsFromShredWasmTxBestEffort;
+exports.dexEventsFromShredWasmTxWithLoadedAddresses = dexEventsFromShredWasmTxWithLoadedAddresses;
+const bs58_1 = __importDefault(require("bs58"));
+const metadata_js_1 = require("../core/metadata.js");
+const pump_routes_js_1 = require("../instr/pump_routes.js");
 const dex_event_js_1 = require("../core/dex_event.js");
 const pumpfun_fee_enrich_js_1 = require("../core/pumpfun_fee_enrich.js");
 const types_js_1 = require("../grpc/types.js");
@@ -42,19 +50,32 @@ function ixAccountStrings(fullAccountKeys, accBytes) {
 /**
  * 使用已解析的完整账户表（静态+ALT）解析外层指令。
  */
-function dexEventsFromShredWasmTxWithFullKeys(tx, fullAccountKeys, slot, txIndex, grpcRecvUs, eventTypeFilter) {
+function parseShredKeys(tx, fullAccountKeys, slot, txIndex, grpcRecvUs, eventTypeFilter, bestEffort = false) {
     const ixs = tx.instructions;
     if (!ixs?.length || fullAccountKeys.length === 0)
         return [];
     if (!shouldParseShredInstructions(eventTypeFilter))
         return [];
     const out = [];
-    for (const rawIx of ixs) {
+    for (const [instructionIndex, rawIx] of ixs.entries()) {
         const pidIdx = rawIx.programIdIndex;
-        if (!Number.isFinite(pidIdx) || pidIdx < 0)
+        if (!Number.isInteger(pidIdx) || pidIdx < 0)
             continue;
         const accBytes = asU8(rawIx.accounts);
         const data = asU8(rawIx.data);
+        const resolved = pidIdx < fullAccountKeys.length && accBytes.every(i => i < fullAccountKeys.length);
+        if (!resolved && !bestEffort)
+            continue;
+        const pid = fullAccountKeys[pidIdx];
+        if (pid && (0, pump_routes_js_1.mayParsePumpRoute)(pid, data)) {
+            if (resolved && (0, pump_routes_js_1.allowsPumpRoute)(eventTypeFilter, pid)) {
+                const metadata = (0, metadata_js_1.makeMetadata)(tx.signature, slot, txIndex, undefined, grpcRecvUs);
+                const intent = (0, pump_routes_js_1.parsePumpRoute)(pid, data, Array.from(accBytes, i => fullAccountKeys[i]), metadata, instructionIndex, eventTypeFilter);
+                if (intent)
+                    out.push({ PumpRouteIntent: intent });
+            }
+            continue;
+        }
         const accountStrs = ixAccountStrings(fullAccountKeys, accBytes);
         if (pidIdx >= fullAccountKeys.length) {
             for (const programId of UNKNOWN_PROGRAM_CANDIDATES) {
@@ -71,10 +92,37 @@ function dexEventsFromShredWasmTxWithFullKeys(tx, fullAccountKeys, slot, txIndex
         if (ev)
             out.push(ev);
     }
+    if (tx.recentBlockhash && out.length) {
+        const recentBlockhash = bs58_1.default.encode(tx.recentBlockhash);
+        for (const event of out) {
+            const metadata = (0, dex_event_js_1.metadataForDexEvent)(event);
+            if (metadata)
+                metadata.recent_blockhash = recentBlockhash;
+        }
+    }
     (0, pumpfun_fee_enrich_js_1.enrichPumpfunSameTxPostMerge)(out);
     return out;
 }
-/** 仅静态账户表（无 RPC 时；V0+ALT 缺失账户以默认 pubkey 占位） */
+/** 仅静态账户表（无 RPC；跳过未解析账户的指令） */
 function dexEventsFromShredWasmTx(tx, slot, txIndex, grpcRecvUs, eventTypeFilter) {
-    return dexEventsFromShredWasmTxWithFullKeys(tx, tx.accounts, slot, txIndex, grpcRecvUs, eventTypeFilter);
+    return parseShredKeys(tx, tx.accounts, slot, txIndex, grpcRecvUs, eventTypeFilter);
+}
+/** Full-key entry point rejects inconsistent ALT counts and indices before emitting anything. */
+function dexEventsFromShredWasmTxWithFullKeys(tx, keys, slot, txIndex, recvUs, filter) {
+    const loaded = (tx.addressTableLookups ?? []).reduce((n, l) => n + l.writableIndexes.length + l.readonlyIndexes.length, 0);
+    if (keys.length !== tx.accounts.length + loaded || tx.accounts.some((k, i) => keys[i] !== k)
+        || tx.instructions?.some(ix => !Number.isInteger(ix.programIdIndex) || ix.programIdIndex < 0 || ix.programIdIndex >= keys.length || ix.accounts.some(i => i >= keys.length)))
+        throw new RangeError('Inconsistent ALT keys or instruction index');
+    return parseShredKeys(tx, keys, slot, txIndex, recvUs, filter);
+}
+/** Explicit legacy placeholder/discriminator fallback; route adapters always require resolved keys. */
+function dexEventsFromShredWasmTxBestEffort(tx, slot, txIndex, recvUs, filter) {
+    return parseShredKeys(tx, tx.accounts, slot, txIndex, recvUs, filter, true);
+}
+/** Separate writable/readonly validation avoids ambiguous counts between the two classes. */
+function dexEventsFromShredWasmTxWithLoadedAddresses(tx, writable, readonly, slot, txIndex, recvUs, filter) {
+    const lookups = tx.addressTableLookups ?? [];
+    if (writable.length !== lookups.reduce((n, l) => n + l.writableIndexes.length, 0) || readonly.length !== lookups.reduce((n, l) => n + l.readonlyIndexes.length, 0))
+        throw new RangeError('ALT address counts do not match transaction');
+    return dexEventsFromShredWasmTxWithFullKeys(tx, [...tx.accounts, ...writable, ...readonly], slot, txIndex, recvUs, filter);
 }

package/dist/shredstream/wire_to_shred_tx.js

@@ -1,21 +1,17 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wireBytesToShredWasmTx = wireBytesToShredWasmTx;
 /** Native wire decoding shared with RPC routes, including V1 without ALT. */
-const bs58_1 = __importDefault(require("bs58"));
 const wire_transaction_js_1 = require("../wire_transaction.js");
 function wireBytesToShredWasmTx(raw) {
     try {
-        const { transaction: tx } = (0, wire_transaction_js_1.decodeWireTransaction)(raw), msg = tx.message;
+        const { transaction: tx } = (0, wire_transaction_js_1.decodeWireTransactionBytes)(raw), msg = tx.message;
         if (!tx.signatures[0])
             return null;
         return { signature: tx.signatures[0], accounts: msg.accountKeys,
-            instructions: msg.instructions.map(ix => ({ programIdIndex: ix.programIdIndex, accounts: Uint8Array.from(ix.accounts), data: bs58_1.default.decode(ix.data) })),
+            instructions: msg.instructions.map(ix => ({ programIdIndex: ix.programIdIndex, accounts: Uint8Array.from(ix.accounts), data: ix.data })),
             messageVersion: tx.version === 'legacy' ? 'legacy' : tx.version === 0 ? 'v0' : 'v1', header: msg.header,
-            recentBlockhash: bs58_1.default.decode(msg.recentBlockhash),
+            recentBlockhash: msg.recentBlockhash,
             addressTableLookups: msg.addressTableLookups.map(l => ({ ...l, writableIndexes: Uint8Array.from(l.writableIndexes), readonlyIndexes: Uint8Array.from(l.readonlyIndexes) })) };
     }
     catch {

package/dist/wire_transaction.d.ts

@@ -29,7 +29,24 @@ export interface DecodedWireTransaction {
     message: WireMessage;
     version: "legacy" | 0 | 1;
 }
+type DecodedInstruction<T> = Omit<WireInstruction, "data"> & {
+    data: T;
+};
+type DecodedMessage<T> = Omit<WireMessage, "recentBlockhash" | "instructions"> & {
+    recentBlockhash: T;
+    instructions: DecodedInstruction<T>[];
+};
+type DecodedTransaction<T> = Omit<DecodedWireTransaction, "message"> & {
+    message: DecodedMessage<T>;
+};
+/** Public string representation retained for RPC/log consumers. */
 export declare function decodeWireTransaction(data: Uint8Array, offset?: number, requireComplete?: boolean): {
     transaction: DecodedWireTransaction;
     length: number;
 };
+/** Internal Shred adapter path avoids Base58 round trips; returned payload bytes are owned copies. */
+export declare function decodeWireTransactionBytes(data: Uint8Array, offset?: number, requireComplete?: boolean): {
+    transaction: DecodedTransaction<Uint8Array>;
+    length: number;
+};
+export {};

package/dist/wire_transaction.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.decodeWireTransaction = decodeWireTransaction;
+exports.decodeWireTransactionBytes = decodeWireTransactionBytes;
 /** Native canonical Solana Legacy, V0 and V1 decoder; no Rust runtime. */
 const bs58_1 = __importDefault(require("bs58"));
 class Reader {
@@ -16,7 +17,8 @@ class Reader {
     take(n) {
         if (!Number.isSafeInteger(n) || n < 0 || this.pos + n > this.data.length)
             throw new Error("Truncated transaction");
-        const value = this.data.slice(this.pos, this.pos + n);
+        // Views stay internal; public text output encodes synchronously and binary output copies.
+        const value = this.data.subarray(this.pos, this.pos + n);
         this.pos += n;
         return value;
     }
@@ -50,7 +52,7 @@ class Reader {
         throw new Error("Invalid short-u16");
     }
 }
-function decodeWireTransaction(data, offset = 0, requireComplete = true) {
+function decodeWireTransactionInternal(encode, data, offset = 0, requireComplete = true) {
     if (!Number.isInteger(offset) || offset < 0 || offset >= data.length)
         throw new Error("Invalid wire offset");
     const r = new Reader(data, offset);
@@ -92,7 +94,7 @@ function decodeWireTransaction(data, offset = 0, requireComplete = true) {
         instructions = headers.map(([programIdIndex, n, length]) => ({
             programIdIndex,
             accounts: Array.from(r.take(n)),
-            data: bs58_1.default.encode(r.take(length)),
+            data: encode(r.take(length)),
         }));
         signatures = Array.from({ length: header[0] }, () => r.take(64));
         if (r.pos - offset > 4096)
@@ -125,7 +127,7 @@ function decodeWireTransaction(data, offset = 0, requireComplete = true) {
             instructions.push({
                 programIdIndex,
                 accounts,
-                data: bs58_1.default.encode(payload),
+                data: encode(payload),
             });
         }
         if (version === 0) {
@@ -148,8 +150,9 @@ function decodeWireTransaction(data, offset = 0, requireComplete = true) {
         header[1] >= header[0] ||
         header[2] > keys.length - header[0])
         throw new Error("Invalid message header");
+    const accountKeys = keys.map((k) => bs58_1.default.encode(k));
     if (version === 1) {
-        if (new Set(keys.map((k) => bs58_1.default.encode(k))).size !== keys.length)
+        if (new Set(accountKeys).size !== keys.length)
             throw new Error("Duplicate V1 accounts");
     }
     let accountCount = keys.length;
@@ -162,7 +165,9 @@ function decodeWireTransaction(data, offset = 0, requireComplete = true) {
     if (accountCount > 256)
         throw new Error("Too many resolved account keys");
     for (const ix of instructions)
-        if (ix.programIdIndex === 0 || ix.programIdIndex >= keys.length || ix.accounts.some(i => i >= accountCount))
+        if (ix.programIdIndex === 0 ||
+            ix.programIdIndex >= keys.length ||
+            ix.accounts.some((i) => i >= accountCount))
             throw new Error("Invalid instruction index");
     if (requireComplete && r.pos !== data.length)
         throw new Error("Trailing transaction bytes");
@@ -172,13 +177,12 @@ function decodeWireTransaction(data, offset = 0, requireComplete = true) {
             numReadonlySignedAccounts: header[1],
             numReadonlyUnsignedAccounts: header[2],
         },
-        accountKeys: keys.map((k) => bs58_1.default.encode(k)),
-        recentBlockhash: bs58_1.default.encode(hash),
+        accountKeys,
+        recentBlockhash: encode(hash),
         instructions,
         addressTableLookups: lookups,
+        ...(config ? { config } : {}),
     };
-    if (config)
-        message.config = config;
     return {
         transaction: {
             signatures: signatures.map((s) => bs58_1.default.encode(s)),
@@ -188,3 +192,11 @@ function decodeWireTransaction(data, offset = 0, requireComplete = true) {
         length: r.pos - offset,
     };
 }
+/** Public string representation retained for RPC/log consumers. */
+function decodeWireTransaction(data, offset = 0, requireComplete = true) {
+    return decodeWireTransactionInternal(bs58_1.default.encode, data, offset, requireComplete);
+}
+/** Internal Shred adapter path avoids Base58 round trips; returned payload bytes are owned copies. */
+function decodeWireTransactionBytes(data, offset = 0, requireComplete = true) {
+    return decodeWireTransactionInternal((bytes) => Uint8Array.from(bytes), data, offset, requireComplete);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sol-parser-sdk",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "description": "High-performance Solana DEX event parser for Node.js/TypeScript (Yellowstone gRPC, log parsing)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,10 @@
     "example:shredstream:subscribe": "tsx examples/shredstream_example.ts",
     "example:shredstream:pumpfun-json": "tsx examples/shredstream_pumpfun_json.ts",
     "example:shredstream": "tsx examples/shredstream_example.ts",
-    "example:shredstream:pumpfun": "tsx examples/shredstream_pumpfun_json.ts"
+    "example:shredstream:pumpfun": "tsx examples/shredstream_pumpfun_json.ts",
+    "example:pump:replay": "tsx examples/pump_shred_routes.ts",
+    "example:pump:bank": "tsx examples/pump_offline_bank.ts",
+    "check:pump-examples": "tsc --noEmit --target ES2022 --module NodeNext --moduleResolution NodeNext --strict --esModuleInterop --skipLibCheck examples/pump_shred_routes.ts examples/pump_offline_bank.ts examples/hotpath_benchmark.ts"
   },
   "keywords": [
     "solana",
@@ -49,8 +52,10 @@
   ],
   "license": "MIT",
   "devDependencies": {
+    "@solana/kit": "8.5.0",
     "@types/node": "^22.19.17",
     "dotenv": "^17.4.1",
+    "litesvm": "1.6.0",
     "tsx": "^4.21.0",
     "typescript": "^5.6.3",
     "vitest": "^2.1.9"