sol-parser-sdk 0.5.16 → 0.5.18

package/NATIVE_DAMM_FACTORY_EVIDENCE_20261004.json

@@ -1,55 +0,0 @@
-{
-  "baseline": {
-    "trade": "5.0.6",
-    "parser": "0.7.7"
-  },
-  "scope": "DAMM cached exact-in factory and route parsing",
-  "broadcasts": 0,
-  "tests": {
-    "trade_node": 3054,
-    "trade_python": 3135,
-    "parser_node": 210,
-    "parser_node_skipped": 8,
-    "parser_python": 196,
-    "go": "test/vet/race passed"
-  },
-  "simulations": [
-    {
-      "fixture": "cached_damm_v2_wsol_buy_20261004.json",
-      "wire_sha256": "1d76f287e2ef99de37984648b48fa78673c986bfd0275deb2f6923e462cd1f78",
-      "error": {
-        "InstructionError": [
-          2,
-          {
-            "Custom": 1
-          }
-        ]
-      },
-      "slot": 453089743
-    },
-    {
-      "fixture": "cached_damm_v2_sol_buy_20261004.json",
-      "wire_sha256": "258381dd8fe9ddc8b4a2240db2f8993be3c099851f3124db85d054425a16fcae",
-      "error": null,
-      "slot": 453089744
-    },
-    {
-      "fixture": "cached_damm_v2_funded_wsol_buy_20261004.json",
-      "wire_sha256": "0c797787f9dc745eadb1ff2c49869a6ad94cfee9f5d571e4f057e956ac35bc2a",
-      "error": null,
-      "slot": 453090844
-    }
-  ],
-  "unverified": [
-    "real sell",
-    "USDC/stock matrix",
-    "automatic quote and DAMM multi-hop",
-    "overall parity"
-  ],
-  "artifact_sha256": {
-    "/tmp/native-damm-npm/sol-trade-sdk-0.1.6.tgz": "6b3aea55fabfe05268b9b42f38baed7721f1c5c139e8d9ab02295beb6edefd4a",
-    "/tmp/native-damm-parser-npm/sol-parser-sdk-0.5.15.tgz": "ea02d4ab390355b5deaac96e167b891e8a6d0d81d19281aa7707d409d86978fa",
-    "/tmp/native-damm-wheels/sol_trade_sdk-0.1.6-py3-none-any.whl": "2ebe7251396d5f5d71018648afb700781f369f62a1287b6ba913d0b411e3b1d2",
-    "/tmp/native-damm-parser-wheels/sol_parser_sdk_python-0.5.8-py3-none-any.whl": "1d4924070b0944f3437e877e08dd09b2c9c0f509dc0d482cccf0c993a3ffa95d"
-  }
-}

package/NATIVE_MIGRATION.md

@@ -1,38 +0,0 @@
-# 本轮 API 迁移（实施中，尚未发布）
-
-基线：Rust sol-parser-sdk 0.7.7。完整功能对照仍在审核，本文件描述已修改的公开行为。
-
-## 元数据精度
-
-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 自动关联仍在实现。
-
-示例见 `examples/GRPC_CACHE.md`；PublicNode 接入读取 GRPC_URL/GRPC_TOKEN，不打印凭据。
-
-
-## DAMM route 解析（2026-10-04）
-
-新增 legacy swap/swap2 route；mode 0/1 exact-in，mode 2 第一个金额为期望输出、第二个为最大输入，其它 mode unknown。失败保留意图、实际成交未知；Token-2022 缺净到账证据不填零。历史模拟 expected 新增 DAMM leg，调用方不可依赖旧的空 legs。

package/NATIVE_PUMPFUN_NATIVE_DEBIT_ALIGNMENT_20261004.md

@@ -1,18 +0,0 @@
-# PumpFun 原生 SOL 成交量归属（2026-10-04）
-
-三语言 parser 对 WSOL-sentinel PumpFun V2 统一报告钱包作为 native 支付/收款账户，不再误报指令中的 WSOL ATA 为实际结算账户。mint 仍按 Solana 的 WSOL sentinel 表示该资产；外层 WSOL 转换动作单独保留。
-
-买入实际输入来自成功调用内的直属 System transfer：曲线本金、protocol fee、buyback fee、creator fee。必须观察到曲线收款；收款人不属于该指令明确账户、付款调用深度缺失或有嵌套歧义、总额溢出时返回未知。不会拿 specified amount 补实际金额。交易手续费、ATA rent、外层 WSOL 转出及临时账户关闭不会重复计入 swap。
-
-真实旧/新买入模拟均得到实际 SOL 输入 10000。新 funded WSOL 模拟可同时看到外层 10000 WSOL 转出、临时账户关闭和 PumpFun 10000 SOL 支付；这不是两次用户支付。卖出直接修改 lamports 的实际净输出仍未归属，Token-2022 净到账缺少费用证据仍为未知。失败交易始终不报告实际成交量。
-
-新 fixtures/pumpfun_settlement_mainnet_simulations_20261004.json 保留实际 mainnet 模拟 wire/response 和三语言相同解析预期。并补缺失 pool 支付、缺失深度、陌生收款人、嵌套及溢出负向回归。
-
-本轮从 Yellowstone gRPC 捕获 5 组当前交易线索，冷核对 canonical ATA 均无可卖余额。还检查了事件中的非 ATA source：该买入源账户在核验时已不再是有效 initialized 账户；另一买入账户余额为零。未构建余额不足的卖出并当作成功。对应 trade examples/fixtures/pumpfun_sell_discovery_unverified_20261004.json 保存尝试记录。卖出真实模拟仍未验收。
-
-前一份 settlement 记录中“当前 V2 实际 SOL 输入未知”的状态已被本轮买入 CPI 证据补齐；legacy 指令和卖出输出不能据此宣称已验收。
-
-整体 Rust 公共 API/字段、gRPC fork/恢复、新数组及 SWQOS 验证仍按计划继续。没有广播、发布或创建 Actions。
-
-
-后续账户级 gRPC 发现有余额的钱包，8 个钱包共 16 次独立 SOL/WSOL 卖出模拟成功。新 funded_sell corpus 三语言验证卖出 source debit 100000000，原生收款账户为钱包，net output 仍保留未知；WSOL minimum 7542 和实际 SOL 残余 397 有交易 SDK 独立账户余额证据。先前无可用余额的尝试仍作为历史记录保存。

package/NATIVE_PUMPFUN_NATIVE_DEBIT_EVIDENCE_20261004.json

@@ -1,57 +0,0 @@
-{
-  "date": "2026-10-04",
-  "overall_alignment_complete": false,
-  "native_debit_rules": {
-    "scope": "PumpFun V2 WSOL-sentinel buy",
-    "input_account": "wallet",
-    "recipients": [
-      "curve",
-      "fee recipient",
-      "buyback recipient",
-      "creator vault"
-    ],
-    "requires": "direct pool payment, known payment recipients and immediate stack depth",
-    "on_ambiguity": "unknown",
-    "fee_rent_wrap_excluded": true,
-    "source": "successful execution System CPI, not specified amount"
-  },
-  "actual_buy_input_lamports": 10000,
-  "actual_output": "Token-2022 net output remains unknown without fee evidence",
-  "corpora": [
-    "pumpfun_current_mainnet_simulations_20261004.json",
-    "pumpfun_settlement_mainnet_simulations_20261004.json"
-  ],
-  "verification": {
-    "full_node_before_final_added_samples": 221,
-    "node_skipped": 8,
-    "full_python_before_final_added_samples": 207,
-    "final_node_simulation_tests": 57,
-    "final_python_simulation_tests": 59,
-    "go_test_vet_and_race": "passed",
-    "node_typecheck_build": "passed",
-    "installed_npm_public_api": "native debit verified",
-    "installed_python_wheel": "native debit verified"
-  },
-  "sell_attempt": {
-    "grpc_events": 5,
-    "canonical_atas": "no usable balance at cold validation",
-    "non_ata_buy_source": "no valid initialized account at later cold validation",
-    "other_buy_source": "zero balance",
-    "simulations_performed": 0,
-    "accepted_as_success": false
-  },
-  "broadcasts": 0,
-  "sell_verified_followup": {
-    "account_grpc_candidates": 9,
-    "successful_simulations": 16,
-    "selected_factory_wire_match": [
-      "go",
-      "nodejs",
-      "python"
-    ],
-    "actual_source_debit": "100000000",
-    "actual_minimum_wsol_credit": "7542",
-    "actual_native_residual": "397",
-    "parser_actual_output": "unknown; direct lamport changes not attributed"
-  }
-}

package/NATIVE_PUMPFUN_SETTLEMENT_ALIGNMENT_20261004.md

@@ -1,11 +0,0 @@
-# PumpFun 交易形态解析对齐（2026-10-04）
-
-三语言 transaction route 增加 PumpFun 旧版 buy/sell/exact-SOL-in 与 V2 exact-quote-in、buy exact-out、sell exact-in 的指令意图识别。V2 从账户提取 curve、钱包、base/quote mint 和账户；失败交易保留意图。
-
-真实 mainnet V2 模拟 corpus：测试 fixtures/pumpfun_current_mainnet_simulations_20261004.json（三语言 fixtures 位置按既有规范）。三语言复放验证单个 PumpFun leg，实际 SOL 输入及 Token-2022 净输出缺证据仍为未知，不以 specified amount 或零代替。该 corpus 的旧 funded WSOL 案例实际走钱包 SOL；不能宣称 WSOL 支付成功。
-
-trade-sdk 现已另存专用 WSOL 结算模拟：原 ATA 实际扣减 10000，V1 wire 1238 字节。parser 对 System CPI 实际 SOL debit 的逐调用归属及所有旧版账户净余额行为仍需补全。仅识别 route intent 不代表所有归一化事件字段已完全对齐 Rust 0.7.7。
-
-实时仍使用 Yellowstone gRPC；本次 RPC 仅为显式冷准备和模拟，无发送。整体公开 API/字段矩阵、生命周期恢复、fork、动态数组等其余验收继续保留未完成状态。
-
-验证摘要见 [机器可读记录](NATIVE_PUMPFUN_SETTLEMENT_EVIDENCE_20261004.json)：六仓全量测试通过；最终新增回归单独通过；Go 两仓全量 race/vet、Node 类型/构建/示例类型、独立 npm/wheel 安装后的公共入口 wire 对照通过。跳过的在线测试不计为验收。

package/NATIVE_PUMPFUN_SETTLEMENT_EVIDENCE_20261004.json

@@ -1,70 +0,0 @@
-{
-  "date": "2026-10-04",
-  "overall_alignment_complete": false,
-  "broadcasts": 0,
-  "hot_path_rpc_calls": 0,
-  "rust_baseline": {
-    "trade": "5.0.6",
-    "parser": "0.7.7"
-  },
-  "current_pumpfun_fee_oracle": {
-    "package": "@pump-fun/pump-sdk",
-    "version": "2.0.0",
-    "vectors_per_language": 240,
-    "runtime_dependency": false
-  },
-  "simulations": {
-    "direct_sol": {
-      "wire_bytes": 1044,
-      "err": null,
-      "evidence": "examples/fixtures/pumpfun_direct_sol_simulations_20261004.json"
-    },
-    "funded_wsol": {
-      "wire_bytes": 1238,
-      "wire_sha256": "76b18c71a930080a4c937483ed1ab670e7ade2188cfef6cf1d00ec8a1538adfd",
-      "err": null,
-      "actual_wsol_debit": "10000",
-      "verified_asset_payment": true,
-      "evidence": "examples/fixtures/pumpfun_settled_funded_wsol_evidence_20261004.json",
-      "cross_language_wire_match": [
-        "go",
-        "nodejs",
-        "python"
-      ]
-    }
-  },
-  "verification": {
-    "full_suites_before_final_added_regressions": {
-      "trade_nodejs": 3326,
-      "parser_nodejs": 213,
-      "parser_nodejs_skipped": 8,
-      "trade_python": 3406,
-      "parser_python": 199,
-      "go_trade": "go test ./... passed",
-      "go_parser": "go test ./... passed"
-    },
-    "final_targeted": {
-      "trade_nodejs": 8,
-      "trade_python": 12,
-      "parser_nodejs_simulation": 47,
-      "parser_python_simulation": 49,
-      "go_parser_failed_intent_and_mainnet_corpus": "passed"
-    },
-    "go_vet": "both passed",
-    "go_race": "both full suites passed",
-    "node_trade_types_and_build": "passed",
-    "node_trade_example_types": "passed",
-    "node_parser_types": "passed",
-    "installed_wheel_verified_wire": "passed",
-    "installed_npm_public_api_verified_wire": "passed",
-    "six_repo_diff_check": "passed"
-  },
-  "not_verified": [
-    "current PumpFun funded sell simulation",
-    "native-quote PumpFun multi-hop settlement (explicitly rejected)",
-    "non-native USDC/stock PumpFun mainnet simulations",
-    "legacy low-level builder current-chain compatibility",
-    "SWQOS online V1 broadcast compatibility",
-    "full Rust public API/field alignment matrix and remaining lifecycle acceptance"
-  ]
-}