sol-parser-sdk-python 0.5.9__tar.gz → 0.5.11__tar.gz

sol_parser_sdk_python-0.5.11/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.DS_Store
+.env
+
+# Generated reports and local tooling outputs
+/NATIVE_*EVIDENCE*.json
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.benchmarks/
+.coverage
+htmlcov/

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sol-parser-sdk-python
-Version: 0.5.9
+Version: 0.5.11
 Summary: Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)
 Requires-Python: >=3.10
 Requires-Dist: base58>=2.0
@@ -8,6 +8,7 @@ Requires-Dist: grpcio-tools>=1.64.0
 Requires-Dist: grpcio>=1.64.0
 Requires-Dist: python-dotenv>=1.0.0
 Provides-Extra: dev
+Requires-Dist: cryptography>=44.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
 Requires-Dist: pytest-benchmark>=4.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
@@ -50,17 +51,27 @@ Description-Content-Type: text/markdown
 
 ---
 
-## Other language SDKs
+## 📦 SDK Versions and Related SDKs
 
-| Language | Repository |
-|----------|------------|
-| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) |
-| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) |
-| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) |
-| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) |
+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 |
+| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript for Node.js |
+| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | Async/await native support |
+| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go transaction and account event parsing |
+| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Raw Solana shred decoding and ShredStream DEX event parsing | `v4.0.3` |
+| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX trade construction and transaction execution | `v6.0.0` |
 
 ---
 
+## v0.5.11 — Signed transaction and hot-path hardening
+
+Hardens signed transaction sanitization, loaded-address boundaries, ordered stream filtering and parser lifecycle. Aligns CLMM and DEX instruction/event layouts, nested CPI route attribution and liquidity/reward accounting. Adds independently signed wire fixtures, ALT failure cases and offline bank regressions.
+
+Validation includes local CPU benchmarks and offline signed-bank scenarios. Measured hot paths use cached inputs without RPC. Benchmarks do not establish production network or transaction-landing latency. No funded mainnet transactions were broadcast.
+
 ## What This SDK Is For
 
 This is the Python implementation of the FnZero Solana DEX parser SDK for asyncio services, research scripts, indexers, copy-trading systems, sniper pipelines, and backend jobs that need normalized real-time DEX events.
@@ -76,6 +87,13 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 
 ## Release notes
 
+### v0.5.10
+
+- Matches PumpFun create/create_v2 accounts by the actual instruction discriminator and event mint, including CPI calls; ambiguous matches are left unspecified.
+- Stops inferring quote mint/vault/token-program fields from arbitrary remaining create_v2 accounts and preserves authoritative decoded fields.
+- Restores historical CreateEvent decoding and verifies successful and failed transactions using saved mainnet fixtures.
+- Suppresses rolled-back DEX events from failed transactions and preserves failure status through RPC/gRPC adapters.
+
 ### v0.5.9
 
 - Adds native gRPC lifecycle and block metadata support, instruction-level route analysis and StonkFun registry/snapshot examples.
@@ -117,7 +135,7 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 **From PyPI**
 
 ```bash
-pip install sol-parser-sdk-python==0.5.9
+pip install sol-parser-sdk-python==0.5.11
 ```
 
 **From source**
@@ -339,12 +357,11 @@ MIT — https://github.com/0xfnzero/sol-parser-sdk-python
 - **Telegram**: https://t.me/fnzero_group  
 - **Discord**: https://discord.gg/vuazbGkqQE  
 
-## Native alignment status
-
-See [NATIVE_ALIGNMENT.md](NATIVE_ALIGNMENT.md) for implemented native APIs, Rust golden tests, mainnet simulation evidence, examples, and remaining parity gaps. Full cross-language parity is still in progress.
+## API compatibility
 
+Full cross-language API parity is still in progress. See the [API migration guide](docs/USAGE.md#api-compatibility) for public behavior and support boundaries, and the examples directory for usage.
 
-实时 parser → trade 接入使用 Yellowstone **gRPC**；见 [gRPC 缓存接入与三语言示例](examples/GRPC_CACHE.md)。此路径不使用 WebSocket，报价和构建热路径不调用 RPC。
 
+实时 parser → trade 接入使用 Yellowstone **gRPC**；见 [gRPC 缓存接入与三语言示例](docs/USAGE.md#grpc-cache)。此路径不使用 WebSocket，报价和构建热路径不调用 RPC。
 
-[本轮原生对齐 API 迁移](NATIVE_MIGRATION.md)（实施中，尚未发布）。
+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).

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.11}/README.md

@@ -32,17 +32,27 @@
 
 ---
 
-## Other language SDKs
+## 📦 SDK Versions and Related SDKs
 
-| Language | Repository |
-|----------|------------|
-| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) |
-| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) |
-| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) |
-| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) |
+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 |
+| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript for Node.js |
+| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | Async/await native support |
+| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go transaction and account event parsing |
+| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Raw Solana shred decoding and ShredStream DEX event parsing | `v4.0.3` |
+| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX trade construction and transaction execution | `v6.0.0` |
 
 ---
 
+## v0.5.11 — Signed transaction and hot-path hardening
+
+Hardens signed transaction sanitization, loaded-address boundaries, ordered stream filtering and parser lifecycle. Aligns CLMM and DEX instruction/event layouts, nested CPI route attribution and liquidity/reward accounting. Adds independently signed wire fixtures, ALT failure cases and offline bank regressions.
+
+Validation includes local CPU benchmarks and offline signed-bank scenarios. Measured hot paths use cached inputs without RPC. Benchmarks do not establish production network or transaction-landing latency. No funded mainnet transactions were broadcast.
+
 ## What This SDK Is For
 
 This is the Python implementation of the FnZero Solana DEX parser SDK for asyncio services, research scripts, indexers, copy-trading systems, sniper pipelines, and backend jobs that need normalized real-time DEX events.
@@ -58,6 +68,13 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 
 ## Release notes
 
+### v0.5.10
+
+- Matches PumpFun create/create_v2 accounts by the actual instruction discriminator and event mint, including CPI calls; ambiguous matches are left unspecified.
+- Stops inferring quote mint/vault/token-program fields from arbitrary remaining create_v2 accounts and preserves authoritative decoded fields.
+- Restores historical CreateEvent decoding and verifies successful and failed transactions using saved mainnet fixtures.
+- Suppresses rolled-back DEX events from failed transactions and preserves failure status through RPC/gRPC adapters.
+
 ### v0.5.9
 
 - Adds native gRPC lifecycle and block metadata support, instruction-level route analysis and StonkFun registry/snapshot examples.
@@ -99,7 +116,7 @@ This is the Python implementation of the FnZero Solana DEX parser SDK for asynci
 **From PyPI**
 
 ```bash
-pip install sol-parser-sdk-python==0.5.9
+pip install sol-parser-sdk-python==0.5.11
 ```
 
 **From source**
@@ -321,12 +338,11 @@ MIT — https://github.com/0xfnzero/sol-parser-sdk-python
 - **Telegram**: https://t.me/fnzero_group  
 - **Discord**: https://discord.gg/vuazbGkqQE  
 
-## Native alignment status
-
-See [NATIVE_ALIGNMENT.md](NATIVE_ALIGNMENT.md) for implemented native APIs, Rust golden tests, mainnet simulation evidence, examples, and remaining parity gaps. Full cross-language parity is still in progress.
+## API compatibility
 
+Full cross-language API parity is still in progress. See the [API migration guide](docs/USAGE.md#api-compatibility) for public behavior and support boundaries, and the examples directory for usage.
 
-实时 parser → trade 接入使用 Yellowstone **gRPC**；见 [gRPC 缓存接入与三语言示例](examples/GRPC_CACHE.md)。此路径不使用 WebSocket，报价和构建热路径不调用 RPC。
 
+实时 parser → trade 接入使用 Yellowstone **gRPC**；见 [gRPC 缓存接入与三语言示例](docs/USAGE.md#grpc-cache)。此路径不使用 WebSocket，报价和构建热路径不调用 RPC。
 
-[本轮原生对齐 API 迁移](NATIVE_MIGRATION.md)（实施中，尚未发布）。
+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).

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.11}/README_CN.md

@@ -32,14 +32,18 @@
 
 ---
 
-## 其他语言 SDK
+## 📦 SDK 版本与相关项目
 
-| 语言 | 仓库 |
-|------|------|
-| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) |
-| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) |
-| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) |
-| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) |
+解析 SDK 的各语言版本及相关 Rust SDK：
+
+| 语言 | 仓库 | 描述 | 版本 |
+|------|------|------|
+| Rust | [sol-parser-sdk](https://github.com/0xfnzero/sol-parser-sdk) | Solana DEX 交易与账户事件解析 |
+| Node.js | [sol-parser-sdk-nodejs](https://github.com/0xfnzero/sol-parser-sdk-nodejs) | TypeScript/JavaScript，Node.js 支持 |
+| Python | [sol-parser-sdk-python](https://github.com/0xfnzero/sol-parser-sdk-python) | 原生 async/await 支持 |
+| Go | [sol-parser-sdk-golang](https://github.com/0xfnzero/sol-parser-sdk-golang) | Go 交易与账户事件解析 |
+| **Rust** | [sol-shred-sdk](https://github.com/0xfnzero/sol-shred-sdk) | Solana 原始 shred 解码与 ShredStream DEX 事件解析 | `v4.0.3` |
+| **Rust** | [sol-trade-sdk](https://github.com/0xfnzero/sol-trade-sdk) | Solana DEX 交易构建与交易执行 | `v6.0.0` |
 
 ---
 
@@ -58,6 +62,19 @@
 
 ## 发布说明
 
+## v0.5.11 — Signed transaction and hot-path hardening
+
+Hardens signed transaction sanitization, loaded-address boundaries, ordered stream filtering and parser lifecycle. Aligns CLMM and DEX instruction/event layouts, nested CPI route attribution and liquidity/reward accounting. Adds independently signed wire fixtures, ALT failure cases and offline bank regressions.
+
+Validation includes local CPU benchmarks and offline signed-bank scenarios. Measured hot paths use cached inputs without RPC. Benchmarks do not establish production network or transaction-landing latency. No funded mainnet transactions were broadcast.
+
+### v0.5.10
+
+- 按实际指令 discriminator 和事件 mint 匹配 PumpFun create/create_v2 账户，支持 CPI，并拒绝猜测有歧义的匹配。
+- 停止从 create_v2 的任意尾部账户推断 quote mint、vault、token program，保留权威解码字段。
+- 恢复历史 CreateEvent 布局，并通过保存的真实主网成功、失败交易验证。
+- 过滤失败交易中已经回滚的 Create/Buy 等 DEX 事件，并在 RPC/gRPC 转换中保留失败状态。
+
 ### v0.5.9
 
 - Adds native gRPC lifecycle and block metadata support, instruction-level route analysis and StonkFun registry/snapshot examples.
@@ -99,7 +116,7 @@
 **PyPI**
 
 ```bash
-pip install sol-parser-sdk-python==0.5.9
+pip install sol-parser-sdk-python==0.5.11
 ```
 
 **源码**
@@ -293,9 +310,8 @@ MIT — https://github.com/0xfnzero/sol-parser-sdk-python
 - **Telegram**: https://t.me/fnzero_group  
 - **Discord**: https://discord.gg/vuazbGkqQE  
 
-## Native alignment status
-
-See [NATIVE_ALIGNMENT.md](NATIVE_ALIGNMENT.md) for implemented native APIs, Rust golden tests, mainnet simulation evidence, examples, and remaining parity gaps. Full cross-language parity is still in progress.
+## API 兼容性
 
+完整跨语言 API 对齐仍在进行；公开行为和支持边界见 [API 迁移说明](docs/USAGE.md#api-compatibility)，使用方法见 examples 目录。
 
-[本轮原生对齐 API 迁移](NATIVE_MIGRATION.md)（实施中，尚未发布）。
+PumpFun create/create_v2 的共享主网样本、重放方法和验证边界见 [验证说明](https://github.com/0xfnzero/sol-parser-sdk-golang/tree/main/validation/pumpfun_create_20261007)。

sol_parser_sdk_python-0.5.11/docs/USAGE.md

@@ -0,0 +1,161 @@
+# Sol Parser SDK python usage
+
+[English](../README.md) · [中文](../README_CN.md)
+
+- [API compatibility](#api-compatibility)
+- [gRPC account cache](#grpc-cache)
+- [Simulation routes](#simulation-routes)
+
+## API compatibility
+
+以下说明当前公开行为和仍需调用方处理的边界；完整跨语言功能对齐仍在审核。
+
+### 元数据精度
+
+Node 的 `EventMetadata.slot`、`tx_index`、`block_time_us`、`grpc_recv_us` 现在是 `bigint`。输入支持 bigint、十进制字符串及安全整数 Number；超出安全整数范围的 Number、浮点数、越界 u64/i64 拒绝。根入口导出 `exactU64`、`exactI64`、`exactInteger`。使用 `dexEventToJsonString` 或 `bigintToJsonReplacer` 输出 JSON；直接 JSON.stringify(bigint) 会失败。
+
+```ts
+const slot = exactU64("18446744073709551615");
+const latency = Number(BigInt(nowUs()) - event.metadata.grpc_recv_us);
+console.log(JSON.stringify(event, bigintToJsonReplacer));
+```
+
+只在计算显示用延迟时将差值转为 Number。slot、index、时间及金额参与解析和排序时保留精确整数。
+
+Go `EventMetadata` 保持 uint64/int64，JSON 输出上述四个字段为十进制字符串；Unmarshal 接受整数文本或十进制字符串，并检查范围，不接受 null/float/bool。Python `EventMetadata` 将十进制字符串归一为 int，拒绝 bool/float/越界；公开 JSON 工具输出上述元数据字段为字符串。各语言省略元数据整数时仍默认 0。未知实际净到账继续使用明确未知值，不能用 0 代替。
+
+其余全部事件整数/JSON 字段的行为审核尚未完成。
+
+### 事件别名
+
+三语言提供 `LaunchLabPoolCreateEvent`、`StonkFunPoolCreateEvent`、`LaunchLabTradeEvent`、`StonkFunTradeEvent`。它们复用已有 RaydiumLaunchlab 结构。平台归属仍需池配置或迁移记录，不能仅凭共享 program ID 断言 StonkFun。
+
+### gRPC 生命周期
+
+一个 client 同时管理一个 DEX 订阅。再次订阅会停止并等待原订阅；动态更新和停止串行进行。Node `sub.join()` / Go `sub.Join()` 等待全部 worker；Python `await client.stop()` 等待任务。Node 使用 grpc-js + proto-loader，安装 SDK 不再包含 Yellowstone Rust N-API 客户端依赖。
+
+Node `sub.states` / `sub.status()`、Go `sub.States` / `sub.Status()`、Python `queue.states` / `queue.status()` 提供连接、重连、连续性中断、丢弃及停止状态；保留原事件和错误消费方式。状态通知有界，状态快照可读取当前累计信息。重连成功不会自动清除连续性中断。调用方需中止交易准备，在选定 fork 下重新验证缓存，再恢复 readiness。
+
+节点停止可能使事件消费结束或队列停止产出；Python 队列消费者同时观察状态以终止 get 等待。完整实时缓存恢复、新 array 发现和 commitment/fork 自动关联仍在实现。
+
+示例见 [gRPC 缓存接入](#grpc-cache)；PublicNode 接入读取 GRPC_URL/GRPC_TOKEN，不打印凭据。
+
+
+### DAMM route 解析
+
+新增 legacy swap/swap2 route；mode 0/1 exact-in，mode 2 第一个金额为期望输出、第二个为最大输入，其它 mode unknown。失败保留意图、实际成交未知；Token-2022 缺净到账证据不填零。历史模拟 expected 新增 DAMM leg，调用方不可依赖旧的空 legs。
+
+<a id="grpc-cache"></a>
+
+## gRPC account cache
+
+实时交易数据以 Rust sol-parser-sdk 的 Yellowstone gRPC 接口为准。三个原生 parser 使用相同来源：交易事件提供 pool/mint/方向线索，原始账户事件提供当前字节、owner、slot、write_version，Clock 提供 epoch/时间，BlockMeta 或显式 gRPC unary 提供 blockhash。
+
+此流程不使用 WebSocket。parser 没有 WebSocket 订阅接口；parser 的 SubscriptionHandle/Subscription 管理 gRPC 流。trade-sdk 中另有通用 WebSocket 兼容模块，其实现与测试不是 parser gRPC 能力的证明。
+
+| 语言 | parser 实时入口 | 原始账户写入 trade cache |
+| --- | --- | --- |
+| Node.js | YellowstoneGrpc.subscribeDexEvents | SubscriptionAccountCache.updateFromParser(raw) |
+| Python | YellowstoneGrpc.subscribe_dex_events | SubscriptionAccountCache.update_from_parser(raw) |
+| Go | YellowstoneGrpc.SubscribeDexEvents | SubscriptionAccountCache.UpdateRaw(pubkey, owner, data, lamports, slot, writeVersion) |
+
+Node/Python 传原始账户事件的 payload，而非最外层 DexEvent wrapper。Go 将事件公钥解析为 solana.PublicKey；解析失败必须返回错误。账户关闭（lamports=0）保留为 tombstone，不复用旧字节。不要从 swap 事件伪造账户完整状态、当前手续费或 slot。
+
+推荐接入顺序：
+
+1. 在 parser 订阅交易与 AccountRawSnapshot；raw snapshot 需要显式开启事件过滤。按已知 pool/config/vault/mint/tick/bin/Clock 地址订阅。路由候选是线索，用户可选择 SOL、WSOL、USDC 或股票作为支付/收款资产。
+2. 原始账户更新写入选定 fork 的本地 cache，保留真实版本。缺失配置/新 array 必须在交易前通过订阅或冷启动补齐；不会用 WebSocket 或热路径 RPC 自动兜底。
+3. 冻结 cache.snapshot()，替换为用户的钱包、金额与资产，使用 cached prepare/route。本地校验 owner、pool/mint 连通性、状态、费率、Token-2022 费用及 freshness 后报价和构建。本次买入或卖出是独立交易。
+4. 模拟可显式调用 simulateTransaction；这是验证步骤。读取模拟结果用 parser 的 simulation_routes 示例，不等于真实发送。
+
+gRPC 流不保证首次提供所有静态账户。pool 已更新不等于 mint/config 已新鲜；不得把其它账户 slot 改成 Clock slot。重连后须确认缺失更新和 fork，缓存就绪前暂停构建。缺失数据或过期状态明确失败。
+
+### 完整示例
+
+两个 SDK 安装在各自环境中即可运行，也可分别在对应仓库运行。快照文件是两个示例间的明确接口，安装和运行不需要 Rust。
+
+| 语言 | parser 仓库：gRPC 刷新 | trade 仓库：本地构建 |
+| --- | --- | --- |
+| Node.js | npx tsx examples/stonkfun_snapshot_refresh.ts /absolute/snapshot.json --require-pool-update | npx tsx examples/cached_trade.ts /absolute/snapshot.json |
+| Python | python examples/stonkfun_snapshot_refresh.py /absolute/snapshot.json --require-pool-update | python examples/cached_trade.py /absolute/snapshot.json |
+| Go | go run ./examples/stonkfun_snapshot_refresh /absolute/snapshot.json --require-pool-update | go run ./examples/cached_trade /absolute/snapshot.json |
+
+使用与 cached_trade 匹配的 accounts[]、legs[] 完整快照，例如现有 cached_tip_route_* 样本；更换自己的钱包、金额和本次方向。CPMM 的 named snapshot 应交给 cached_cpmm 示例。不要直接用历史快照实时交易。
+
+parser 刷新读取 GRPC_URL / GRPC_TOKEN，保留没更新账户的原 slot，可能因 provider 没有发送 pool 更新而超时；trade 默认不联网。需要模拟时为 trade 示例增加 --simulate，并配置 RPC_URL。冷启动与显式模拟允许 RPC，交易报价和构建热路径禁止 RPC。
+
+本文件描述已实现的接入接口；完整自动重连恢复、fork 一致性策略、新 array 发现和全部协议缓存仍须逐项验证。之前十轮报告中的 WebSocket 修复仅属于 trade-sdk 通用模块，不计入这些 gRPC 对齐能力。
+
+<a id="simulation-routes"></a>
+
+## Simulation routes
+
+运行trade侧cached_trade示例时，--simulate返回包含innerInstructions的模拟结果。内部SPL转账可能是jsonParsed，原来的compiled route入口仍会拒绝它。专用入口需要**原始交易wire和对应完整simulateTransaction响应**，仅离线处理证据，不查询RPC或重新构建签名交易。
+
+```sh
+# Go
+go run ./examples/simulation_routes solparser/testdata/cached_tip_routes_20261002.json route-buy
+# Node
+npx tsx examples/simulation_routes.ts examples/fixtures/cached_tip_routes_20261002.json route-buy
+# Python
+PYTHONPATH=. python examples/simulation_routes.py examples/fixtures/cached_tip_routes_20261002.json route-buy
+```
+
+```ts
+import { analyzeSimulationRoutes } from "sol-parser-sdk";
+const route = analyzeSimulationRoutes(wire, simulationResponse);
+```
+
+```python
+from sol_parser import analyze_simulation_routes
+route = analyze_simulation_routes(wire, simulation_response)
+```
+
+SPL普通／checked／明确fee转账，以及首次ATA的getAccountDataSize／createAccount／initializeImmutableOwner／initializeAccount3的parsed表示被还原为分析证据；raw/compiled CPI原样保留位置和stack height。其它parsed指令明确报错。金额使用最小单位amount字段，不用uiAmount浮点值。缺失Token-2022手续费的净到账保持未知；失败交易实际成交字段为空。tip不会被当成WSOL充值。含ALT的V0需要原有compiled route入口与显式loadedAddresses；此入口不查询lookup table。调用方必须提供与wire对应的可信模拟响应。
+
+保存快照与模拟仅用于复现，不是实时状态。Go parser 已补齐 AnalyzeSimulationRoutes，接受 wire、完整模拟响应的 []byte 和可选 graduatedPools；安装和使用不依赖 Rust。
+
+```go
+route, err := solparser.AnalyzeSimulationRoutes(wire, simulationResponseJSON, nil)
+if err != nil { return err }
+// route.Legs 的 ActualOutputAmount == nil 表示净到账未知，不能当作零。
+```
+
+当前银行模拟复现：`examples/fixtures/simulation_routes_live_20261002.json`。包括因旧保护价格触发滑点错误的买入和成功卖出；失败时只保留意图，actual amount为空。Go可以用相同文件路径运行上述示例。保存wire用replaceRecentBlockhash重新模拟并不等于当前状态重新报价。
+
+首次 ATA 模拟：`examples/fixtures/simulation_ata_20261002.json`，含 classic SPL、Token-2022 股票和带建账户的单池／三跳卖出。setup指令用于mint推断，不计入成交转账；getAccountDataSize仅支持空列表或immutableOwner扩展，其它扩展明确报错。compiled route入口现在也要求meta.err显式存在，缺失状态不再默认为成功。
+
+
+2026-10-03: Prefunded ATA creation is also supported: System transfer, allocate and assign CPI are reconstructed and validated. getAccountDataSize accepts empty/immutableOwner extension lists only; unknown parsed instructions remain errors. Wire and compiled-route indexes, duplicate CPI groups and token-balance indexes are validated before event reconstruction. No RPC is used by the parser. Mainnet prefunded-ATA evidence is covered by the review10 fixture tests.
+
+
+#### 第二批审查证据（2026-10-03）
+
+`fixtures/batch2_cpmm_simulations_20261003.json` 含独立买入/卖出的真实主网模拟响应与原 wire，两个模拟均成功，三语言解析结果一致。买入实际输入 1000000、输出 13486034；卖出实际输入 1000000，但响应未明确 Token-2022 转账费，净到账保持未知。不要用快照报价填充实际成交字段。根目录第二批十轮审查证据同时保留触发滑点保护的延迟快照与历史三跳重放。
+
+
+### CPMM LP 模拟中的铸造／销毁 CPI（2026-10-06）
+
+三语言支持 parsed SPL／Token-2022 的 mintTo、burn、mintToChecked、burnChecked，校验精确 u64 金额、u8 decimals、多签账户与原始指令位置。它们保留为供分析的指令，不计入转账或 swap 成交；LP 顶层操作仍可能出现在 unknown_invocations，不意味着已新增 LP 事件 API。首次 ATA、资金准备 swap、LP 操作可在同笔模拟中解析。未知 Token-2022 净到账仍为 null。
+
+真实主网模拟样例：examples/fixtures/cpmm_lp_simulations_20261006.json，包含 LP 存入与取出。在各语言仓库运行：
+
+```sh
+# Go
+go run ./examples/simulation_routes examples/fixtures/cpmm_lp_simulations_20261006.json
+# Node
+npx tsx examples/simulation_routes.ts examples/fixtures/cpmm_lp_simulations_20261006.json
+# Python
+PYTHONPATH=. python examples/simulation_routes.py examples/fixtures/cpmm_lp_simulations_20261006.json
+```
+
+该样例包含 sigVerify=false 的资金准备前缀，仅作执行验证，不可广播。新交易的完整原始响应可由 Rust CPMM_SIMULATION_DIR 保存后，用相同示例解析。
+
+
+## Pump upgrade (October 2026)
+
+Compact Pump v3 and PumpSwap v2 trades use their new 17-account layouts. New typed events cover `PumpFunPostCompleteBuy`, `PumpFunComplete`, `PumpFunSweepBondingCurveFee` and `PumpSwapSweepPoolFee`, with program-scoped log and CPI parsing. Historical SOL CompleteEvent payloads remain supported. Curve/pool retained fees and synthetic counters are exposed; optional historical tails default to zero.
+
+For a synthetic completing buy, retain TradeEvent **and** PostCompleteBuyEvent and aggregate execution amounts within the same invocation. CompleteEvent is the completion notification. For `multi_hop_swap`, retain each venue's trade events; different venues are not merged into one fill. The multi-hop intent decoder exposes the fixed user accounts, input/minimum limits and 5 roles per hop; these limits are not actual executed amounts. Streamer forwards the typed events and account fields through its parser bridge (its re-exported `parser_sdk` also provides the intent decoder).
+
+Reference: [pump-public-docs](https://github.com/pump-fun/pump-public-docs/tree/8cda1fa30ea658b20909d8aedf002047119388d2). Validation uses offline official IDL fixtures; no live trade is sent by the tests.

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sol-parser-sdk-python"
-version = "0.5.9"
+version = "0.5.11"
 description = "Solana DEX program log parsing (pure Python, API aligned with sol-parser-sdk)"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -16,6 +16,7 @@ shredstream = [
     "solders>=0.21.0",
 ]
 dev = [
+    "cryptography>=44.0", # Independent Ed25519 verification in signed wire regressions.
     "pytest>=8.0",
     "pytest-asyncio>=0.21",
     "requests>=2.31",

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.11}/sol_parser/__init__.py

@@ -148,6 +148,9 @@ from .event_types import (
     # Meteora DAMM v2 events
     MeteoraDammV2SwapEvent,
     MeteoraDammV2CreatePositionEvent,
+    MeteoraDammV2ClaimPositionFeeEvent,
+    MeteoraDammV2ClaimRewardEvent,
+    MeteoraDlmmClaimRewardEvent,
     MeteoraDammV2ClosePositionEvent,
     MeteoraDammV2AddLiquidityEvent,
     MeteoraDammV2RemoveLiquidityEvent,
@@ -155,6 +158,11 @@ from .event_types import (
     MeteoraDammV2DynamicFeeParameters,
     MeteoraDammV2UpdateDelegatePermissionEvent,
     MeteoraDammV2WithdrawDeadLiquidityRewardEvent,
+    MeteoraDammV2WithdrawIneligibleRewardEvent,
+    MeteoraDammV2UpdateRewardFunderEvent,
+    MeteoraDammV2UpdateRewardDurationEvent,
+    MeteoraDammV2InitializeRewardEvent,
+    MeteoraDammV2FundRewardEvent,
     MeteoraDammV2CreateConfigEvent,
     MeteoraDammV2CreateDynamicConfigEvent,
     MeteoraDbcCurveCompleteEvent,
@@ -433,6 +441,9 @@ __all__ = [
     "MeteoraPoolsPoolCreatedEvent",
     "MeteoraDammV2SwapEvent",
     "MeteoraDammV2CreatePositionEvent",
+    "MeteoraDammV2ClaimPositionFeeEvent",
+    "MeteoraDammV2ClaimRewardEvent",
+    "MeteoraDlmmClaimRewardEvent",
     "MeteoraDammV2ClosePositionEvent",
     "MeteoraDammV2AddLiquidityEvent",
     "MeteoraDammV2RemoveLiquidityEvent",
@@ -440,6 +451,11 @@ __all__ = [
     "MeteoraDammV2DynamicFeeParameters",
     "MeteoraDammV2UpdateDelegatePermissionEvent",
     "MeteoraDammV2WithdrawDeadLiquidityRewardEvent",
+    "MeteoraDammV2WithdrawIneligibleRewardEvent",
+    "MeteoraDammV2UpdateRewardFunderEvent",
+    "MeteoraDammV2UpdateRewardDurationEvent",
+    "MeteoraDammV2InitializeRewardEvent",
+    "MeteoraDammV2FundRewardEvent",
     "MeteoraDammV2CreateConfigEvent",
     "MeteoraDammV2CreateDynamicConfigEvent",
     "MeteoraDbcCurveCompleteEvent",
@@ -490,3 +506,8 @@ __all__ += ["LaunchLabPoolCreateEvent", "StonkFunPoolCreateEvent", "LaunchLabTra
 
 from .grpc_client import DexEventQueue, GrpcStreamStatus
 __all__ += ["DexEventQueue", "GrpcStreamStatus"]
+
+from .pump_upgrade import decode_pump_multi_hop_intent
+
+from .pump_upgrade import PumpFunPostCompleteBuyEvent, PumpFunSweepBondingCurveFeeEvent, PumpFunCompleteEvent, PumpSwapSweepPoolFeeEvent
+__all__ += ['decode_pump_multi_hop_intent','PumpFunPostCompleteBuyEvent','PumpFunSweepBondingCurveFeeEvent','PumpFunCompleteEvent','PumpSwapSweepPoolFeeEvent']

{sol_parser_sdk_python-0.5.9 → sol_parser_sdk_python-0.5.11}/sol_parser/account_dispatcher.py

@@ -110,6 +110,119 @@ def fill_accounts_with_owned_keys(
             return
         filler(get)
 
+    def fill_clmm_liquidity(remove=False):
+        position_index = 2 if remove else 4
+        allowed = (bytes([58,127,188,62,79,82,196,96]), bytes([160,38,208,111,104,91,44,1])) if remove else (bytes([133,29,89,223,69,238,176,10]), bytes([46,156,243,118,13,205,251,178]))
+        selected = None
+        for invocation in invokes.get(base58.b58decode(RAYDIUM_CLMM_PROGRAM_ID), []):
+            raw = get_instruction_data(meta_pb, transaction_pb, invocation)
+            if not raw or raw[:8] not in allowed:
+                continue
+            get = get_instruction_account_getter(meta_pb, transaction_pb, static_keys, w, r, invocation)
+            if get is None or not raydium.clmm_position_matches(data.position_nft_mint, get(position_index)):
+                continue
+            data.personal_position = get(position_index)
+            if selected is not None and any(selected(i) != get(i) for i in range(18)):
+                return
+            selected = get
+        if selected is not None:
+            (raydium.fill_clmm_decrease_liquidity_accounts if remove else raydium.fill_clmm_increase_liquidity_accounts)(data, selected)
+
+    def fill_pump_trade():
+        if not data.mint or data.mint == "11111111111111111111111111111111":
+            return
+        layouts = {
+            bytes([102,6,61,18,1,218,235,234]): (2,6,True,16),
+            bytes([56,252,116,8,158,223,205,95]): (2,6,True,16),
+            bytes([51,230,133,164,1,127,131,173]): (2,6,False,14),
+            bytes([184,23,238,97,103,197,211,61]): (1,13,True,27),
+            bytes([194,171,28,70,104,77,91,47]): (1,13,True,27),
+            bytes([93,246,130,60,231,233,64,178]): (1,13,False,26),
+            bytes([7,5,29,196,245,23,101,80]): (1,8,True,17),
+            bytes([225,247,80,30,213,179,132,136]): (1,8,True,17),
+            bytes([28,146,222,119,38,196,105,213]): (1,8,False,17),
+        }
+        selected = None
+        for invocation in invokes.get(base58.b58decode(PUMPFUN_PROGRAM_ID), []):
+            raw = get_instruction_data(meta_pb, transaction_pb, invocation)
+            layout = layouts.get(raw[:8]) if raw else None
+            if layout is None:
+                continue
+            mint_index, user_index, buy, minimum = layout
+            oi, ii = invocation
+            instruction = (transaction_pb.message.instructions[oi] if ii < 0 else
+                           next(g for g in meta_pb.inner_instructions if g.index == oi).instructions[ii])
+            if buy != data.is_buy or len(instruction.accounts) < minimum:
+                continue
+            get = get_instruction_account_getter(meta_pb, transaction_pb, static_keys, w, r, invocation)
+            if get is None or get(mint_index) != data.mint:
+                continue
+            if data.user and data.user != "11111111111111111111111111111111" and get(user_index) != data.user:
+                continue
+            if selected is not None:
+                return
+            selected = get
+        if selected is not None:
+            pumpfun.fill_trade_accounts(data, selected)
+
+    def fill_swap(buy):
+        # Match the event's own pool, user and direction, not the largest invoke.
+        if not data.pool or data.pool == "11111111111111111111111111111111":
+            return
+        selected = None
+        legacy = (bytes([102, 6, 61, 18, 1, 218, 235, 234]),
+                  bytes([198, 46, 21, 82, 180, 217, 232, 112])) if buy else (bytes([51, 230, 133, 164, 1, 127, 131, 173]),)
+        compact = (bytes([184, 23, 238, 97, 103, 197, 211, 61]),
+                   bytes([194, 171, 28, 70, 104, 77, 91, 47])) if buy else (bytes([93, 246, 130, 60, 231, 233, 64, 178]),)
+        for invocation in invokes.get(base58.b58decode(PUMPSWAP_PROGRAM_ID), []):
+            raw = get_instruction_data(meta_pb, transaction_pb, invocation)
+            boost = buy and raw is not None and raw[:8] == bytes([105, 68, 6, 175, 0, 7, 35, 162])
+            if raw is None or (not boost and raw[:8] not in legacy + compact):
+                continue
+            oi, ii = invocation
+            instruction = (transaction_pb.message.instructions[oi] if ii < 0 else
+                           next(g for g in meta_pb.inner_instructions if g.index == oi).instructions[ii])
+            minimum = 13 if boost else (17 if raw[:8] in compact else (23 if buy else 21))
+            if len(instruction.accounts) < minimum:
+                continue
+            get = get_instruction_account_getter(meta_pb, transaction_pb, static_keys, w, r, invocation)
+            if get is None or get(0) != data.pool:
+                continue
+            if data.user and data.user != "11111111111111111111111111111111" and get(7 if boost else 1) != data.user:
+                continue
+            if selected is not None:
+                return  # Invocation positions are unavailable; ambiguous context stays blank.
+            selected = (get, boost)
+        if selected is not None:
+            get, boost = selected
+            filler = pumpswap.fill_boost_buy_accounts if boost else (pumpswap.fill_buy_accounts if buy else pumpswap.fill_sell_accounts)
+            filler(data, get)
+
+    def fill_create(v2_only=False):
+        selected = None
+        for ix in invokes.get(base58.b58decode(PUMPFUN_PROGRAM_ID), []):
+            raw = get_instruction_data(meta_pb, transaction_pb, ix)
+            if raw is None:
+                continue
+            v2 = raw[:8] == bytes([214,144,76,236,95,139,49,180])
+            legacy = raw[:8] == bytes([24,30,200,40,5,28,7,119])
+            if not v2 and (v2_only or not legacy):
+                continue
+            get = get_instruction_account_getter(meta_pb, transaction_pb, static_keys, w, r, ix)
+            oi, ii = ix
+            instruction = (transaction_pb.message.instructions[oi] if ii < 0 else
+                           next(g for g in meta_pb.inner_instructions if g.index == oi).instructions[ii])
+            if len(instruction.accounts) < (16 if v2 else 14) or get is None:
+                continue
+            if data.mint and data.mint != "11111111111111111111111111111111" and get(0) != data.mint:
+                continue
+            if selected is not None:
+                return  # Multiple matching creates: do not guess.
+            selected = (get, v2)
+        if selected:
+            get, v2 = selected
+            (pumpfun.fill_create_v2_accounts if v2 else pumpfun.fill_create_accounts)(data, get)
+
     et = event.type
     data = event.data
 
@@ -119,17 +232,17 @@ def fill_accounts_with_owned_keys(
         EventType.PUMP_FUN_SELL,
         EventType.PUMP_FUN_BUY_EXACT_SOL_IN,
     ):
-        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_trade_accounts(data, g))
+        fill_pump_trade()
     elif et == EventType.PUMP_FUN_CREATE:
-        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_create_accounts(data, g))
+        fill_create()
     elif et == EventType.PUMP_FUN_CREATE_V2:
-        run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_create_v2_accounts(data, g))
+        fill_create(True)
     elif et == EventType.PUMP_FUN_MIGRATE:
         run(PUMPFUN_PROGRAM_ID, lambda g: pumpfun.fill_migrate_accounts(data, g))
     elif et == EventType.PUMP_SWAP_BUY:
-        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_buy_accounts(data, g))
+        fill_swap(True)
     elif et == EventType.PUMP_SWAP_SELL:
-        run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_sell_accounts(data, g))
+        fill_swap(False)
     elif et == EventType.PUMP_SWAP_TRADE:
         run(PUMPSWAP_PROGRAM_ID, lambda g: pumpswap.fill_trade_accounts(data, g))
     elif et == EventType.PUMP_SWAP_CREATE_POOL:
@@ -149,9 +262,9 @@ def fill_accounts_with_owned_keys(
     elif et == EventType.RAYDIUM_CLMM_CLOSE_POSITION:
         run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_close_position_accounts(data, g))
     elif et == EventType.RAYDIUM_CLMM_INCREASE_LIQUIDITY:
-        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_increase_liquidity_accounts(data, g))
+        fill_clmm_liquidity()
     elif et == EventType.RAYDIUM_CLMM_DECREASE_LIQUIDITY:
-        run(RAYDIUM_CLMM_PROGRAM_ID, lambda g: raydium.fill_clmm_decrease_liquidity_accounts(data, g))
+        fill_clmm_liquidity(True)
     elif et == EventType.RAYDIUM_CPMM_SWAP:
         run(RAYDIUM_CPMM_PROGRAM_ID, lambda g: raydium.fill_cpmm_swap_accounts(data, g))
     elif et == EventType.RAYDIUM_CPMM_DEPOSIT: