sol-parser-sdk-nodejs 0.3.0 → 0.4.4

package/dist/grpc/rpc_to_grpc.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convert_rpc_to_grpc = void 0;
+exports.convertRpcToGrpc = convertRpcToGrpc;
+/**
+ * 将 `@solana/web3.js` 的 `VersionedTransactionResponse` 转为 Yellowstone `Transaction` + `TransactionStatusMeta`，
+ * 与 Rust `rpc_parser::convert_rpc_to_grpc` 字段取舍一致（token balances / rewards 置空，err 置空等）。
+ */
+const bs58_1 = __importDefault(require("bs58"));
+const rpc_invoke_map_js_1 = require("../core/rpc_invoke_map.js");
+function toYCompiled(ix) {
+    const accounts = "accountKeyIndexes" in ix ? ix.accountKeyIndexes : ix.accounts;
+    return {
+        programIdIndex: ix.programIdIndex,
+        accounts: Uint8Array.from(accounts),
+        data: (0, rpc_invoke_map_js_1.decodeIxData)(ix.data),
+    };
+}
+function toYInnerInstruction(ix) {
+    const stackHeight = ix.stackHeight;
+    return {
+        programIdIndex: ix.programIdIndex,
+        accounts: Uint8Array.from(ix.accounts),
+        data: (0, rpc_invoke_map_js_1.decodeIxData)(ix.data),
+        ...(stackHeight !== undefined ? { stackHeight } : {}),
+    };
+}
+function legacyMessageToYellowstone(msg) {
+    return {
+        header: {
+            numRequiredSignatures: msg.header.numRequiredSignatures,
+            numReadonlySignedAccounts: msg.header.numReadonlySignedAccounts,
+            numReadonlyUnsignedAccounts: msg.header.numReadonlyUnsignedAccounts,
+        },
+        accountKeys: msg.accountKeys.map((k) => new Uint8Array(k.toBytes())),
+        recentBlockhash: new Uint8Array(bs58_1.default.decode(msg.recentBlockhash)),
+        instructions: msg.compiledInstructions.map(toYCompiled),
+        versioned: false,
+        addressTableLookups: [],
+    };
+}
+function v0MessageToYellowstone(msg) {
+    const lookups = msg.addressTableLookups.map((l) => ({
+        accountKey: new Uint8Array(l.accountKey.toBytes()),
+        writableIndexes: l.writableIndexes instanceof Uint8Array ? l.writableIndexes : Uint8Array.from(l.writableIndexes),
+        readonlyIndexes: l.readonlyIndexes instanceof Uint8Array ? l.readonlyIndexes : Uint8Array.from(l.readonlyIndexes),
+    }));
+    return {
+        header: {
+            numRequiredSignatures: msg.header.numRequiredSignatures,
+            numReadonlySignedAccounts: msg.header.numReadonlySignedAccounts,
+            numReadonlyUnsignedAccounts: msg.header.numReadonlyUnsignedAccounts,
+        },
+        accountKeys: msg.staticAccountKeys.map((k) => new Uint8Array(k.toBytes())),
+        recentBlockhash: new Uint8Array(bs58_1.default.decode(msg.recentBlockhash)),
+        instructions: msg.compiledInstructions.map(toYCompiled),
+        versioned: true,
+        addressTableLookups: lookups,
+    };
+}
+function metaToYellowstone(meta) {
+    const innerGroups = meta.innerInstructions;
+    const innerInstructions = [];
+    if (innerGroups) {
+        for (const g of innerGroups) {
+            innerInstructions.push({
+                index: g.index,
+                instructions: g.instructions.map(toYInnerInstruction),
+            });
+        }
+    }
+    const loaded = meta.loadedAddresses;
+    const loadedWritable = loaded?.writable.map((k) => new Uint8Array(k.toBytes())) ?? [];
+    const loadedReadonly = loaded?.readonly.map((k) => new Uint8Array(k.toBytes())) ?? [];
+    const logs = meta.logMessages ?? [];
+    return {
+        err: undefined,
+        fee: String(meta.fee),
+        preBalances: meta.preBalances.map(String),
+        postBalances: meta.postBalances.map(String),
+        innerInstructions,
+        innerInstructionsNone: innerGroups == null,
+        logMessages: [...logs],
+        logMessagesNone: logs.length === 0,
+        preTokenBalances: [],
+        postTokenBalances: [],
+        rewards: [],
+        loadedWritableAddresses: loadedWritable,
+        loadedReadonlyAddresses: loadedReadonly,
+        returnData: undefined,
+        returnDataNone: true,
+        computeUnitsConsumed: meta.computeUnitsConsumed !== undefined ? String(meta.computeUnitsConsumed) : undefined,
+    };
+}
+/**
+ * 与 Rust `convert_rpc_to_grpc` 对齐：输入为 RPC `getTransaction` 的 **非 jsonParsed**、已编译 message 的响应。
+ */
+function convertRpcToGrpc(tx) {
+    const msg = tx.transaction?.message;
+    if (!msg || !(0, rpc_invoke_map_js_1.isCompiledVersionedMessage)(msg)) {
+        return {
+            ok: false,
+            error: {
+                kind: "ConversionError",
+                message: "交易 message 非编译形态（例如 jsonParsed）。请使用默认编码的 getTransaction 响应后再转换。",
+            },
+        };
+    }
+    const meta = tx.meta;
+    if (meta == null) {
+        return {
+            ok: false,
+            error: { kind: "MissingField", field: "meta" },
+        };
+    }
+    const yMsg = msg.version === "legacy" ? legacyMessageToYellowstone(msg) : v0MessageToYellowstone(msg);
+    const transaction = {
+        signatures: tx.transaction.signatures.map((s) => new Uint8Array(bs58_1.default.decode(s))),
+        message: yMsg,
+    };
+    return { ok: true, meta: metaToYellowstone(meta), transaction };
+}
+/** Rust 蛇形命名 */
+exports.convert_rpc_to_grpc = convertRpcToGrpc;

package/dist/grpc/subscribe_builder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Yellowstone `SubscribeRequest` 构造（与 Rust `grpc/subscribe_builder` 对齐）。
+ */
+import type { SubscribeRequest } from "@triton-one/yellowstone-grpc";
+import { CommitmentLevel } from "@triton-one/yellowstone-grpc";
+import type { AccountFilter, TransactionFilter } from "./types.js";
+export declare function buildSubscribeRequest(txFilters: TransactionFilter[], accFilters: AccountFilter[]): SubscribeRequest;
+export declare function buildSubscribeRequestWithCommitment(txFilters: TransactionFilter[], accFilters: AccountFilter[], commitment: CommitmentLevel): SubscribeRequest;
+export declare function buildSubscribeTransactionFiltersNamed(namedTxFilters: readonly {
+    name: string;
+    filter: TransactionFilter;
+}[], accFilters: AccountFilter[], commitment: CommitmentLevel): SubscribeRequest;
+export { CommitmentLevel };

package/dist/grpc/subscribe_builder.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommitmentLevel = void 0;
+exports.buildSubscribeRequest = buildSubscribeRequest;
+exports.buildSubscribeRequestWithCommitment = buildSubscribeRequestWithCommitment;
+exports.buildSubscribeTransactionFiltersNamed = buildSubscribeTransactionFiltersNamed;
+const yellowstone_grpc_1 = require("@triton-one/yellowstone-grpc");
+Object.defineProperty(exports, "CommitmentLevel", { enumerable: true, get: function () { return yellowstone_grpc_1.CommitmentLevel; } });
+function txFilterToProto(f) {
+    return {
+        vote: false,
+        failed: false,
+        signature: undefined,
+        accountInclude: f.account_include,
+        accountExclude: f.account_exclude,
+        accountRequired: f.account_required,
+    };
+}
+function accFilterToProto(f) {
+    return {
+        account: f.account,
+        owner: f.owner,
+        filters: f.filters,
+        nonemptyTxnSignature: undefined,
+    };
+}
+function finalize(transactions, accounts, commitment) {
+    return {
+        slots: {},
+        accounts,
+        transactions,
+        transactionsStatus: {},
+        blocks: {},
+        blocksMeta: {},
+        entry: {},
+        commitment,
+        accountsDataSlice: [],
+        ping: undefined,
+        fromSlot: undefined,
+    };
+}
+function buildSubscribeRequest(txFilters, accFilters) {
+    return buildSubscribeRequestWithCommitment(txFilters, accFilters, yellowstone_grpc_1.CommitmentLevel.PROCESSED);
+}
+function buildSubscribeRequestWithCommitment(txFilters, accFilters, commitment) {
+    const transactions = {};
+    txFilters.forEach((f, i) => {
+        transactions[`tx_${i}`] = txFilterToProto(f);
+    });
+    const accounts = {};
+    accFilters.forEach((f, i) => {
+        accounts[`acc_${i}`] = accFilterToProto(f);
+    });
+    return finalize(transactions, accounts, commitment);
+}
+function buildSubscribeTransactionFiltersNamed(namedTxFilters, accFilters, commitment) {
+    const transactions = {};
+    for (const { name, filter } of namedTxFilters) {
+        transactions[name] = txFilterToProto(filter);
+    }
+    const accounts = {};
+    accFilters.forEach((f, i) => {
+        accounts[`acc_${i}`] = accFilterToProto(f);
+    });
+    return finalize(transactions, accounts, commitment);
+}

package/dist/grpc/transaction_meta.d.ts

@@ -0,0 +1,29 @@
+import type { TokenBalance, Transaction, TransactionStatusMeta } from "@triton-one/yellowstone-grpc/dist/grpc/solana-storage.js";
+/** 32 字节公钥 → Base58（无效长度返回 `null`） */
+export declare function pubkeyBytesToBs58(bytes: Uint8Array): string | null;
+/**
+ * 消息静态 `accountKeys` + meta 中 `loadedWritableAddresses` / `loadedReadonlyAddresses`，
+ * 顺序与 `preBalances` / `postBalances` 对齐。
+ */
+export declare function collectAccountKeysBs58(tx: Transaction, meta: TransactionStatusMeta): string[] | null;
+/** 每个账户索引的 lamports 变化（post − pre） */
+export declare function lamportBalanceDeltas(meta: TransactionStatusMeta): bigint[];
+/**
+ * 启发式原生 SOL：对 `watchedBs58` 中出现的账户，若 lamports 净减少 ≥ `minOutflowLamports`，
+ * 再与其它索引配对，要求对方 delta ≥ `minOutflowLamports/2`。
+ */
+export declare function heuristicSolCounterpartiesForWatchedKeys(accountKeysBs58: string[], lamportDeltas: bigint[], watchedBs58: Set<string>, minOutflowLamports: bigint): [string, string][];
+/** `TokenBalance.uiTokenAmount.amount` → 原始整数；解析失败为 `0n` */
+export declare function tokenBalanceRawAmount(t: TokenBalance): bigint;
+/**
+ * SPL：当 `watchOwnerBs58` 在某 mint 上余额净减少 ≥ `minWatchDecreaseRaw` 时，
+ * 找同 mint 下余额增加的其它 owner，返回 `(watch_owner, counterparty_owner)`。
+ */
+export declare function splTokenCounterpartyByOwner(meta: TransactionStatusMeta, watchOwnerBs58: string, minWatchDecreaseRaw: bigint): [string, string][];
+/**
+ * 汇总监控地址在一笔交易中的转出对手方（原生 SOL 启发式 + SPL token balance 启发式）。
+ * 若账户 key 与 balance 数组长度不一致则返回 `null`。
+ */
+export declare function collectWatchTransferCounterpartyPairs(tx: Transaction, meta: TransactionStatusMeta, watchedBs58: string[], minNativeOutflowLamports: bigint, splMinWatchDecreaseRaw: bigint): [string, string][] | null;
+/** Yellowstone 交易签名原始字节（64）→ Base58 签名字符串；长度非 64 返回 `null` */
+export declare function tryYellowstoneSignature(sig: Uint8Array): string | null;

package/dist/grpc/transaction_meta.js

@@ -0,0 +1,208 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pubkeyBytesToBs58 = pubkeyBytesToBs58;
+exports.collectAccountKeysBs58 = collectAccountKeysBs58;
+exports.lamportBalanceDeltas = lamportBalanceDeltas;
+exports.heuristicSolCounterpartiesForWatchedKeys = heuristicSolCounterpartiesForWatchedKeys;
+exports.tokenBalanceRawAmount = tokenBalanceRawAmount;
+exports.splTokenCounterpartyByOwner = splTokenCounterpartyByOwner;
+exports.collectWatchTransferCounterpartyPairs = collectWatchTransferCounterpartyPairs;
+exports.tryYellowstoneSignature = tryYellowstoneSignature;
+/**
+ * Yellowstone `Transaction` / `TransactionStatusMeta` 通用工具（与 Rust `grpc/transaction_meta` 对齐）。
+ * 不依赖 DEX 日志解析，用于 mentions 订阅后的 SOL/SPL 转账启发式分析等。
+ */
+const bs58_1 = __importDefault(require("bs58"));
+const web3_js_1 = require("@solana/web3.js");
+/** 32 字节公钥 → Base58（无效长度返回 `null`） */
+function pubkeyBytesToBs58(bytes) {
+    if (bytes.length !== 32)
+        return null;
+    try {
+        return new web3_js_1.PublicKey(bytes).toBase58();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 消息静态 `accountKeys` + meta 中 `loadedWritableAddresses` / `loadedReadonlyAddresses`，
+ * 顺序与 `preBalances` / `postBalances` 对齐。
+ */
+function collectAccountKeysBs58(tx, meta) {
+    const msg = tx.message;
+    if (!msg)
+        return null;
+    const keys = [];
+    for (const b of msg.accountKeys) {
+        const s = pubkeyBytesToBs58(b);
+        if (!s)
+            continue;
+        keys.push(s);
+    }
+    for (const b of meta.loadedWritableAddresses) {
+        const s = pubkeyBytesToBs58(b);
+        if (!s)
+            continue;
+        keys.push(s);
+    }
+    for (const b of meta.loadedReadonlyAddresses) {
+        const s = pubkeyBytesToBs58(b);
+        if (!s)
+            continue;
+        keys.push(s);
+    }
+    return keys;
+}
+/** 每个账户索引的 lamports 变化（post − pre） */
+function lamportBalanceDeltas(meta) {
+    const n = Math.min(meta.preBalances.length, meta.postBalances.length);
+    const out = [];
+    for (let i = 0; i < n; i++) {
+        out.push(BigInt(meta.postBalances[i] ?? "0") - BigInt(meta.preBalances[i] ?? "0"));
+    }
+    return out;
+}
+/**
+ * 启发式原生 SOL：对 `watchedBs58` 中出现的账户，若 lamports 净减少 ≥ `minOutflowLamports`，
+ * 再与其它索引配对，要求对方 delta ≥ `minOutflowLamports/2`。
+ */
+function heuristicSolCounterpartiesForWatchedKeys(accountKeysBs58, lamportDeltas, watchedBs58, minOutflowLamports) {
+    const minL = minOutflowLamports;
+    const half = minL / 2n;
+    const pairs = [];
+    for (let i = 0; i < accountKeysBs58.length; i++) {
+        const key = accountKeysBs58[i];
+        if (!watchedBs58.has(key))
+            continue;
+        const d = lamportDeltas[i] ?? 0n;
+        if (d >= -minL)
+            continue;
+        for (let j = 0; j < lamportDeltas.length; j++) {
+            if (i === j)
+                continue;
+            const dj = lamportDeltas[j] ?? 0n;
+            if (dj <= half)
+                continue;
+            pairs.push([key, accountKeysBs58[j]]);
+        }
+    }
+    return pairs;
+}
+/** `TokenBalance.uiTokenAmount.amount` → 原始整数；解析失败为 `0n` */
+function tokenBalanceRawAmount(t) {
+    const a = t.uiTokenAmount?.amount;
+    if (a === undefined || a === "")
+        return 0n;
+    try {
+        return BigInt(a);
+    }
+    catch {
+        return 0n;
+    }
+}
+function mapKey(mint, owner) {
+    return `${mint}\0${owner}`;
+}
+function parseMapKey(k) {
+    const i = k.indexOf("\0");
+    if (i <= 0)
+        return null;
+    return { mint: k.slice(0, i), owner: k.slice(i + 1) };
+}
+/**
+ * SPL：当 `watchOwnerBs58` 在某 mint 上余额净减少 ≥ `minWatchDecreaseRaw` 时，
+ * 找同 mint 下余额增加的其它 owner，返回 `(watch_owner, counterparty_owner)`。
+ */
+function splTokenCounterpartyByOwner(meta, watchOwnerBs58, minWatchDecreaseRaw) {
+    const pre = meta.preTokenBalances ?? [];
+    const post = meta.postTokenBalances ?? [];
+    const preM = new Map();
+    for (const b of pre) {
+        if (!b.owner)
+            continue;
+        const k = mapKey(b.mint, b.owner);
+        preM.set(k, (preM.get(k) ?? 0n) + tokenBalanceRawAmount(b));
+    }
+    const postM = new Map();
+    for (const b of post) {
+        if (!b.owner)
+            continue;
+        const k = mapKey(b.mint, b.owner);
+        postM.set(k, (postM.get(k) ?? 0n) + tokenBalanceRawAmount(b));
+    }
+    const mints = new Set();
+    for (const k of preM.keys()) {
+        const p = parseMapKey(k);
+        if (p && p.owner === watchOwnerBs58)
+            mints.add(p.mint);
+    }
+    for (const k of postM.keys()) {
+        const p = parseMapKey(k);
+        if (p && p.owner === watchOwnerBs58)
+            mints.add(p.mint);
+    }
+    const out = [];
+    const minL = minWatchDecreaseRaw > 0n ? minWatchDecreaseRaw : 1n;
+    for (const mint of mints) {
+        const wPre = preM.get(mapKey(mint, watchOwnerBs58)) ?? 0n;
+        const wPost = postM.get(mapKey(mint, watchOwnerBs58)) ?? 0n;
+        const lost = wPre > wPost ? wPre - wPost : 0n;
+        if (lost < minL)
+            continue;
+        for (const [k, po] of postM) {
+            const parsed = parseMapKey(k);
+            if (!parsed || parsed.mint !== mint || parsed.owner === watchOwnerBs58)
+                continue;
+            const pr = preM.get(k) ?? 0n;
+            if (po > pr) {
+                out.push([watchOwnerBs58, parsed.owner]);
+            }
+        }
+    }
+    out.sort((a, b) => a[1].localeCompare(b[1]));
+    const dedup = [];
+    for (const p of out) {
+        const prev = dedup[dedup.length - 1];
+        if (prev && prev[0] === p[0] && prev[1] === p[1])
+            continue;
+        dedup.push(p);
+    }
+    return dedup;
+}
+/**
+ * 汇总监控地址在一笔交易中的转出对手方（原生 SOL 启发式 + SPL token balance 启发式）。
+ * 若账户 key 与 balance 数组长度不一致则返回 `null`。
+ */
+function collectWatchTransferCounterpartyPairs(tx, meta, watchedBs58, minNativeOutflowLamports, splMinWatchDecreaseRaw) {
+    const keys = collectAccountKeysBs58(tx, meta);
+    if (!keys)
+        return null;
+    const n = keys.length;
+    if (meta.preBalances.length !== n || meta.postBalances.length !== n)
+        return null;
+    const deltas = lamportBalanceDeltas(meta);
+    const watchedH = new Set(watchedBs58);
+    const pairs = heuristicSolCounterpartiesForWatchedKeys(keys, deltas, watchedH, minNativeOutflowLamports);
+    for (const w of watchedBs58) {
+        pairs.push(...splTokenCounterpartyByOwner(meta, w, splMinWatchDecreaseRaw));
+    }
+    pairs.sort((a, b) => a[1].localeCompare(b[1]));
+    const dedup = [];
+    for (const p of pairs) {
+        const prev = dedup[dedup.length - 1];
+        if (prev && prev[0] === p[0] && prev[1] === p[1])
+            continue;
+        dedup.push(p);
+    }
+    return dedup;
+}
+/** Yellowstone 交易签名原始字节（64）→ Base58 签名字符串；长度非 64 返回 `null` */
+function tryYellowstoneSignature(sig) {
+    if (sig.length !== 64)
+        return null;
+    return bs58_1.default.encode(sig);
+}

package/dist/grpc/types.d.ts

@@ -1,5 +1,8 @@
+import type { SubscribeRequestFilterAccountsFilter } from "@triton-one/yellowstone-grpc";
 /** gRPC 订阅顺序模式 */
 export type OrderMode = "Unordered" | "Ordered" | "StreamingOrdered" | "MicroBatch";
+/** 与 Rust `grpc::types::Protocol` 一致 */
+export type Protocol = "PumpFun" | "PumpSwap" | "Bonk" | "RaydiumCpmm" | "RaydiumClmm" | "RaydiumAmmV4" | "MeteoraDammV2";
 export type SlotStatus = "Processed" | "Confirmed" | "Finalized" | "FirstShredReceived" | "Completed" | "CreatedBank" | "Dead";
 export interface SubscribeUpdateAccountInfo {
     pubkey: Uint8Array;
@@ -70,11 +73,18 @@ export interface SubscribeUpdate {
     blockMeta?: SubscribeUpdateBlockMeta;
     ping?: SubscribeUpdatePing;
     pong?: SubscribeUpdatePong;
+    /** Yellowstone SubscribeUpdate.created_at, Unix timestamp in microseconds. */
+    createdAtUs?: number;
 }
 export interface SubscribeCallbacks {
     onUpdate?: (update: SubscribeUpdate) => void;
     onError?: (err: Error) => void;
     onEnd?: () => void;
+    /**
+     * 是否在流断开后自动重连（指数退避，与 Rust `subscribe_dex_events` 一致）。
+     * 默认 `true`。为 `false` 时保持单次连接的旧行为。
+     */
+    autoReconnect?: boolean;
 }
 export interface ClientConfig {
     enable_metrics: boolean;
@@ -91,15 +101,56 @@ export interface ClientConfig {
     order_timeout_ms: number;
     micro_batch_us: number;
 }
+/** 与 Rust `grpc::config` 中 `StreamingConfig` 别名（即 `ClientConfig`）一致 */
+export type StreamingConfig = ClientConfig;
 export declare function defaultClientConfig(): ClientConfig;
+/** 与 Rust `ClientConfig::low_latency` 一致 */
+export declare function lowLatencyClientConfig(): ClientConfig;
+/** 与 Rust `ClientConfig::high_throughput` 一致 */
+export declare function highThroughputClientConfig(): ClientConfig;
 export interface TransactionFilter {
     account_include: string[];
     account_exclude: string[];
     account_required: string[];
 }
 export declare function newTransactionFilter(): TransactionFilter;
+/** 与 Rust `TransactionFilter::from_program_ids` 一致 */
+export declare function transactionFilterFromProgramIds(programIds: string[]): TransactionFilter;
+/** 与 Rust `grpc::AccountFilter` 一致（Yellowstone 账户订阅） */
+export interface AccountFilter {
+    account: string[];
+    owner: string[];
+    filters: SubscribeRequestFilterAccountsFilter[];
+}
+/** 与 Rust `grpc::types::AccountFilterMemcmp` / `AccountFilterData` 一致（文档与扩展用） */
+export interface AccountFilterMemcmp {
+    offset: number;
+    bytes: Uint8Array;
+}
+export interface AccountFilterData {
+    memcmp?: AccountFilterMemcmp;
+    datasize?: number;
+}
+export declare function newAccountFilter(): AccountFilter;
+/** 与 Rust `grpc::types::SlotFilter` 一致 */
+export interface SlotFilter {
+    min_slot?: number;
+    max_slot?: number;
+}
+export declare function newSlotFilter(): SlotFilter;
+export declare function slotFilterMinSlot(filter: SlotFilter, slot: number): SlotFilter;
+export declare function slotFilterMaxSlot(filter: SlotFilter, slot: number): SlotFilter;
+/** 与 Rust `AccountFilter::from_program_owners` 一致 */
+export declare function accountFilterFromProgramOwners(programIds: string[]): AccountFilter;
+/**
+ * 构造 memcmp 账户过滤器（与 Rust `account_filter_memcmp` 一致）。
+ * ATA 常在 offset 0 放 mint；PumpSwap 池子等常在 offset 32。
+ */
+export declare function accountFilterMemcmp(offset: number, bytes: Uint8Array): SubscribeRequestFilterAccountsFilter;
 /** 事件类型过滤标签 */
-export type EventType = "BlockMeta" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumClmmSwap" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmClosePosition" | "RaydiumClmmCollectFee" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4WithdrawPnl" | "RaydiumAmmV4Initialize2" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2ClosePosition" | "MeteoraDammV2InitializePool" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "BonkTrade" | "BonkPoolCreate" | "BonkMigrateAmm" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool";
+export type EventType = "BlockMeta" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpFeesCreateFeeSharingConfig" | "PumpFeesInitializeFeeConfig" | "PumpFeesResetFeeSharingConfig" | "PumpFeesRevokeFeeSharingAuthority" | "PumpFeesTransferFeeSharingAuthority" | "PumpFeesUpdateAdmin" | "PumpFeesUpdateFeeConfig" | "PumpFeesUpdateFeeShares" | "PumpFeesUpsertFeeTiers" | "PumpFunMigrateBondingCurveCreator" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumClmmSwap" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmClosePosition" | "RaydiumClmmCollectFee" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4WithdrawPnl" | "RaydiumAmmV4Initialize2" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2RemoveAllLiquidity" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2InitializePool" | "MeteoraDammV2ClosePosition" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "BonkTrade" | "BonkPoolCreate" | "BonkMigrateAmm" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpFunGlobal" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool";
+/** 与 Rust `grpc::EventType`（由 `StreamingEventType` 导出）一致 */
+export type StreamingEventType = EventType;
 /** 所有事件类型列表 */
 export declare const ALL_EVENT_TYPES: EventType[];
 export interface EventTypeFilter {
@@ -111,6 +162,8 @@ export declare function eventTypeFilterIncludeOnly(types: EventType[]): EventTyp
 export declare function eventTypeFilterExclude(types: EventType[]): EventTypeFilter;
 /** 过滤器是否包含 PumpFun 相关类型 */
 export declare function eventTypeFilterIncludesPumpfun(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Pump Fees (`pfeeUx...`) 相关类型 */
+export declare function eventTypeFilterIncludesPumpFees(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 PumpSwap 相关类型 */
 export declare function eventTypeFilterIncludesPumpswap(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 Meteora DAMM V2 相关类型 */
@@ -123,8 +176,10 @@ export declare function eventTypeFilterIncludesRaydiumCpmm(filter: EventTypeFilt
 export declare function eventTypeFilterIncludesRaydiumAmmV4(filter: EventTypeFilter): boolean;
 /** 过滤器是否包含 Orca Whirlpool 相关类型 */
 export declare function eventTypeFilterIncludesOrcaWhirlpool(filter: EventTypeFilter): boolean;
-/** 过滤器是否包含 Bonk Launchpad 相关类型 */
+/** 过滤器是否包含 Bonk Launchpad 相关类型（与 Rust `includes_raydium_launchpad` / Bonk 集合一致） */
 export declare function eventTypeFilterIncludesBonk(filter: EventTypeFilter): boolean;
+/** 与 Rust `EventTypeFilter::includes_raydium_launchpad` 同名语义 */
+export declare function eventTypeFilterIncludesRaydiumLaunchpad(filter: EventTypeFilter): boolean;
 /**
  * `parseInstructionUnified` 前置白名单：仅当 `include_only` 与下列指令相关类型有交集时才解析指令。
  * 若白名单中不含下列任一类型，则整条指令解析入口返回 null。