sol-parser-sdk-nodejs 0.4.0 → 0.4.4

package/README.md

@@ -16,6 +16,12 @@
     <a href="https://discord.gg/vuazbGkqQE">Discord</a>
 </p>
 
+> ☕ **Support This Project**
+>
+> This SDK is completely free and open source. However, maintaining and continuously updating it requires significant AI computing resources and token consumption. If this SDK helps with your development, consider making a monthly SOL donation — any amount is appreciated and helps keep this project alive!
+>
+> **Donation Wallet:** `6oW7AXz1yRb57pYSxysuXnMs2aR1ha5rzGzReZ1MjPV8`
+
 ---
 
 ## Other language SDKs

package/README_CN.md

@@ -16,6 +16,12 @@
     <a href="https://discord.gg/vuazbGkqQE">Discord</a>
 </p>
 
+> ☕ **支持本项目**
+>
+> 本 SDK 完全免费且开源。但维护和持续更新需要消耗大量 AI 算力与 Token。如果这个 SDK 对您的开发有帮助，欢迎每月捐赠任意数量的 SOL，您的支持将帮助这个项目持续运行！
+>
+> **捐赠钱包：** `6oW7AXz1yRb57pYSxysuXnMs2aR1ha5rzGzReZ1MjPV8`
+
 ---
 
 ## 其他语言 SDK

package/dist/accounts/mod.d.ts

@@ -5,6 +5,7 @@ import type { EventTypeFilter } from "../grpc/types.js";
 export type { AccountData } from "./types.js";
 export { parseNonceAccount, isNonceAccount } from "./nonce.js";
 export { parseTokenAccount } from "./token.js";
+export { parsePumpfunGlobal, parsePumpfunAccount, isPumpfunGlobalAccount, } from "./pumpfun.js";
 export { parsePumpswapGlobalConfig, parsePumpswapPool, parsePumpswapAccount, isGlobalConfigAccount, isPoolAccount, } from "./pumpswap.js";
 export { hasDiscriminator } from "./utils.js";
 export { userWalletPubkeyForOnchainAccount } from "./wallet_resolve.js";

package/dist/accounts/mod.js

@@ -1,16 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rpcResolveUserWalletPubkey = exports.userWalletPubkeyForOnchainAccount = exports.hasDiscriminator = exports.isPoolAccount = exports.isGlobalConfigAccount = exports.parsePumpswapAccount = exports.parsePumpswapPool = exports.parsePumpswapGlobalConfig = exports.parseTokenAccount = exports.isNonceAccount = exports.parseNonceAccount = void 0;
+exports.rpcResolveUserWalletPubkey = exports.userWalletPubkeyForOnchainAccount = exports.hasDiscriminator = exports.isPoolAccount = exports.isGlobalConfigAccount = exports.parsePumpswapAccount = exports.parsePumpswapPool = exports.parsePumpswapGlobalConfig = exports.isPumpfunGlobalAccount = exports.parsePumpfunAccount = exports.parsePumpfunGlobal = exports.parseTokenAccount = exports.isNonceAccount = exports.parseNonceAccount = void 0;
 exports.parseAccountUnified = parseAccountUnified;
 const program_ids_js_1 = require("../instr/program_ids.js");
 const nonce_js_1 = require("./nonce.js");
 const token_js_1 = require("./token.js");
 const pumpswap_js_1 = require("./pumpswap.js");
+const pumpfun_js_1 = require("./pumpfun.js");
 var nonce_js_2 = require("./nonce.js");
 Object.defineProperty(exports, "parseNonceAccount", { enumerable: true, get: function () { return nonce_js_2.parseNonceAccount; } });
 Object.defineProperty(exports, "isNonceAccount", { enumerable: true, get: function () { return nonce_js_2.isNonceAccount; } });
 var token_js_2 = require("./token.js");
 Object.defineProperty(exports, "parseTokenAccount", { enumerable: true, get: function () { return token_js_2.parseTokenAccount; } });
+var pumpfun_js_2 = require("./pumpfun.js");
+Object.defineProperty(exports, "parsePumpfunGlobal", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunGlobal; } });
+Object.defineProperty(exports, "parsePumpfunAccount", { enumerable: true, get: function () { return pumpfun_js_2.parsePumpfunAccount; } });
+Object.defineProperty(exports, "isPumpfunGlobalAccount", { enumerable: true, get: function () { return pumpfun_js_2.isPumpfunGlobalAccount; } });
 var pumpswap_js_2 = require("./pumpswap.js");
 Object.defineProperty(exports, "parsePumpswapGlobalConfig", { enumerable: true, get: function () { return pumpswap_js_2.parsePumpswapGlobalConfig; } });
 Object.defineProperty(exports, "parsePumpswapPool", { enumerable: true, get: function () { return pumpswap_js_2.parsePumpswapPool; } });
@@ -26,6 +31,7 @@ Object.defineProperty(exports, "rpcResolveUserWalletPubkey", { enumerable: true,
 const ACCOUNT_EVENT_TYPES = [
     "TokenAccount",
     "NonceAccount",
+    "AccountPumpFunGlobal",
     "AccountPumpSwapGlobalConfig",
     "AccountPumpSwapPool",
 ];
@@ -46,6 +52,13 @@ function parseAccountUnified(account, metadata, eventTypeFilter) {
                 return ev;
         }
     }
+    if (account.owner === program_ids_js_1.PUMPFUN_PROGRAM_ID && eventTypeFilter) {
+        if (eventTypeFilter.shouldInclude("AccountPumpFunGlobal")) {
+            const ev = (0, pumpfun_js_1.parsePumpfunAccount)(account, metadata);
+            if (ev)
+                return ev;
+        }
+    }
     if ((0, nonce_js_1.isNonceAccount)(account.data)) {
         if (eventTypeFilter && !eventTypeFilter.shouldInclude("NonceAccount"))
             return null;

package/dist/accounts/pumpfun.d.ts

@@ -0,0 +1,6 @@
+import type { EventMetadata } from "../core/metadata.js";
+import type { DexEvent } from "../core/dex_event.js";
+import type { AccountData } from "./types.js";
+export declare function isPumpfunGlobalAccount(data: Uint8Array): boolean;
+export declare function parsePumpfunGlobal(account: AccountData, metadata: EventMetadata): DexEvent | null;
+export declare function parsePumpfunAccount(account: AccountData, metadata: EventMetadata): DexEvent | null;

package/dist/accounts/pumpfun.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPumpfunGlobalAccount = isPumpfunGlobalAccount;
+exports.parsePumpfunGlobal = parsePumpfunGlobal;
+exports.parsePumpfunAccount = parsePumpfunAccount;
+const utils_js_1 = require("./utils.js");
+const binary_js_1 = require("../util/binary.js");
+const program_ids_js_1 = require("../instr/program_ids.js");
+const GLOBAL_DISC = Uint8Array.from([167, 232, 232, 177, 200, 108, 114, 127]);
+const GLOBAL_BODY = 1021;
+function isPumpfunGlobalAccount(data) {
+    return (0, utils_js_1.hasDiscriminator)(data, GLOBAL_DISC);
+}
+function readPubkeyArray(data, offset, len) {
+    const value = [];
+    let o = offset;
+    for (let i = 0; i < len; i++) {
+        const pubkey = (0, binary_js_1.readPubkey)(data, o);
+        if (pubkey === null)
+            return null;
+        value.push(pubkey);
+        o += 32;
+    }
+    return { value, next: o };
+}
+function parsePumpfunGlobal(account, metadata) {
+    if (account.data.length < 8 + GLOBAL_BODY)
+        return null;
+    if (!isPumpfunGlobalAccount(account.data))
+        return null;
+    const d = account.data.subarray(8);
+    let o = 0;
+    const initializedByte = (0, binary_js_1.readU8)(d, o);
+    if (initializedByte === null)
+        return null;
+    const initialized = initializedByte !== 0;
+    o += 1;
+    const authority = (0, binary_js_1.readPubkey)(d, o);
+    if (authority === null)
+        return null;
+    o += 32;
+    const fee_recipient = (0, binary_js_1.readPubkey)(d, o);
+    if (fee_recipient === null)
+        return null;
+    o += 32;
+    const initial_virtual_token_reserves = (0, binary_js_1.readU64LE)(d, o);
+    if (initial_virtual_token_reserves === null)
+        return null;
+    o += 8;
+    const initial_virtual_sol_reserves = (0, binary_js_1.readU64LE)(d, o);
+    if (initial_virtual_sol_reserves === null)
+        return null;
+    o += 8;
+    const initial_real_token_reserves = (0, binary_js_1.readU64LE)(d, o);
+    if (initial_real_token_reserves === null)
+        return null;
+    o += 8;
+    const token_total_supply = (0, binary_js_1.readU64LE)(d, o);
+    if (token_total_supply === null)
+        return null;
+    o += 8;
+    const fee_basis_points = (0, binary_js_1.readU64LE)(d, o);
+    if (fee_basis_points === null)
+        return null;
+    o += 8;
+    const withdraw_authority = (0, binary_js_1.readPubkey)(d, o);
+    if (withdraw_authority === null)
+        return null;
+    o += 32;
+    const enableMigrateByte = (0, binary_js_1.readU8)(d, o);
+    if (enableMigrateByte === null)
+        return null;
+    const enable_migrate = enableMigrateByte !== 0;
+    o += 1;
+    const pool_migration_fee = (0, binary_js_1.readU64LE)(d, o);
+    if (pool_migration_fee === null)
+        return null;
+    o += 8;
+    const creator_fee_basis_points = (0, binary_js_1.readU64LE)(d, o);
+    if (creator_fee_basis_points === null)
+        return null;
+    o += 8;
+    const feeRecipients = readPubkeyArray(d, o, 8);
+    if (feeRecipients === null)
+        return null;
+    const fee_recipients = feeRecipients.value;
+    o = feeRecipients.next;
+    const set_creator_authority = (0, binary_js_1.readPubkey)(d, o);
+    if (set_creator_authority === null)
+        return null;
+    o += 32;
+    const admin_set_creator_authority = (0, binary_js_1.readPubkey)(d, o);
+    if (admin_set_creator_authority === null)
+        return null;
+    o += 32;
+    const createV2EnabledByte = (0, binary_js_1.readU8)(d, o);
+    if (createV2EnabledByte === null)
+        return null;
+    const create_v2_enabled = createV2EnabledByte !== 0;
+    o += 1;
+    const whitelist_pda = (0, binary_js_1.readPubkey)(d, o);
+    if (whitelist_pda === null)
+        return null;
+    o += 32;
+    const reserved_fee_recipient = (0, binary_js_1.readPubkey)(d, o);
+    if (reserved_fee_recipient === null)
+        return null;
+    o += 32;
+    const mayhemModeEnabledByte = (0, binary_js_1.readU8)(d, o);
+    if (mayhemModeEnabledByte === null)
+        return null;
+    const mayhem_mode_enabled = mayhemModeEnabledByte !== 0;
+    o += 1;
+    const reservedFeeRecipients = readPubkeyArray(d, o, 7);
+    if (reservedFeeRecipients === null)
+        return null;
+    const reserved_fee_recipients = reservedFeeRecipients.value;
+    o = reservedFeeRecipients.next;
+    const cashbackEnabledByte = (0, binary_js_1.readU8)(d, o);
+    if (cashbackEnabledByte === null)
+        return null;
+    o += 1;
+    const buybackFeeRecipients = readPubkeyArray(d, o, 8);
+    if (buybackFeeRecipients === null)
+        return null;
+    const global = {
+        initialized,
+        authority,
+        fee_recipient,
+        initial_virtual_token_reserves,
+        initial_virtual_sol_reserves,
+        initial_real_token_reserves,
+        token_total_supply,
+        fee_basis_points,
+        withdraw_authority,
+        enable_migrate,
+        pool_migration_fee,
+        creator_fee_basis_points,
+        fee_recipients,
+        set_creator_authority,
+        admin_set_creator_authority,
+        create_v2_enabled,
+        whitelist_pda,
+        reserved_fee_recipient,
+        mayhem_mode_enabled,
+        reserved_fee_recipients,
+    };
+    const ev = { metadata, pubkey: account.pubkey, global };
+    return { PumpFunGlobalAccount: ev };
+}
+function parsePumpfunAccount(account, metadata) {
+    if (account.owner !== program_ids_js_1.PUMPFUN_PROGRAM_ID)
+        return null;
+    if (isPumpfunGlobalAccount(account.data))
+        return parsePumpfunGlobal(account, metadata);
+    return null;
+}

package/dist/accounts/rust_aliases.d.ts

@@ -4,6 +4,7 @@
 export { parseAccountUnified as parse_account_unified } from "./mod.js";
 export { parseNonceAccount as parse_nonce_account } from "./nonce.js";
 export { parseTokenAccount as parse_token_account } from "./token.js";
+export { parsePumpfunGlobal as parse_pumpfun_global } from "./pumpfun.js";
 export { parsePumpswapGlobalConfig as parse_pumpswap_global_config, parsePumpswapPool as parse_pumpswap_pool, } from "./pumpswap.js";
 export { rpcResolveUserWalletPubkey as rpc_resolve_user_wallet_pubkey } from "./rpc_wallet.js";
 export { userWalletPubkeyForOnchainAccount as user_wallet_pubkey_for_onchain_account } from "./wallet_resolve.js";

package/dist/accounts/rust_aliases.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.user_wallet_pubkey_for_onchain_account = exports.rpc_resolve_user_wallet_pubkey = exports.parse_pumpswap_pool = exports.parse_pumpswap_global_config = exports.parse_token_account = exports.parse_nonce_account = exports.parse_account_unified = void 0;
+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 = void 0;
 /**
  * Rust `accounts` 模块蛇形命名别名（与 `parse_nonce_account` 等对应）。
  */
@@ -10,6 +10,8 @@ var nonce_js_1 = require("./nonce.js");
 Object.defineProperty(exports, "parse_nonce_account", { enumerable: true, get: function () { return nonce_js_1.parseNonceAccount; } });
 var token_js_1 = require("./token.js");
 Object.defineProperty(exports, "parse_token_account", { enumerable: true, get: function () { return token_js_1.parseTokenAccount; } });
+var pumpfun_js_1 = require("./pumpfun.js");
+Object.defineProperty(exports, "parse_pumpfun_global", { enumerable: true, get: function () { return pumpfun_js_1.parsePumpfunGlobal; } });
 var pumpswap_js_1 = require("./pumpswap.js");
 Object.defineProperty(exports, "parse_pumpswap_global_config", { enumerable: true, get: function () { return pumpswap_js_1.parsePumpswapGlobalConfig; } });
 Object.defineProperty(exports, "parse_pumpswap_pool", { enumerable: true, get: function () { return pumpswap_js_1.parsePumpswapPool; } });

package/dist/core/account_fill_pumpfun.js

@@ -8,6 +8,23 @@ const dex_event_js_1 = require("./dex_event.js");
 const Z = () => (0, dex_event_js_1.defaultPubkey)();
 function fillPumpfunTradeAccounts(e, get) {
     const zero = Z();
+    const isV2 = e.ix_name === "buy_v2" ||
+        e.ix_name === "sell_v2" ||
+        e.ix_name === "buy_exact_quote_in_v2";
+    if (isV2) {
+        if (!e.user || e.user === zero)
+            e.user = get(13);
+        if (!e.bonding_curve || e.bonding_curve === zero)
+            e.bonding_curve = get(10);
+        if (!e.associated_bonding_curve || e.associated_bonding_curve === zero) {
+            e.associated_bonding_curve = get(11);
+        }
+        if (!e.creator_vault || e.creator_vault === zero)
+            e.creator_vault = get(16);
+        if (!e.token_program || e.token_program === zero)
+            e.token_program = get(3);
+        return;
+    }
     if (!e.user || e.user === zero)
         e.user = get(6);
     if (!e.bonding_curve || e.bonding_curve === zero)

package/dist/core/dex_event.d.ts

@@ -14,6 +14,26 @@ export type DexEvent = {
     PumpFunBuyExactSolIn: PumpFunTradeEvent;
 } | {
     PumpFunMigrate: PumpFunMigrateEvent;
+} | {
+    PumpFeesCreateFeeSharingConfig: PumpFeesCreateFeeSharingConfigEvent;
+} | {
+    PumpFeesInitializeFeeConfig: PumpFeesInitializeFeeConfigEvent;
+} | {
+    PumpFeesResetFeeSharingConfig: PumpFeesResetFeeSharingConfigEvent;
+} | {
+    PumpFeesRevokeFeeSharingAuthority: PumpFeesRevokeFeeSharingAuthorityEvent;
+} | {
+    PumpFeesTransferFeeSharingAuthority: PumpFeesTransferFeeSharingAuthorityEvent;
+} | {
+    PumpFeesUpdateAdmin: PumpFeesUpdateAdminEvent;
+} | {
+    PumpFeesUpdateFeeConfig: PumpFeesUpdateFeeConfigEvent;
+} | {
+    PumpFeesUpdateFeeShares: PumpFeesUpdateFeeSharesEvent;
+} | {
+    PumpFeesUpsertFeeTiers: PumpFeesUpsertFeeTiersEvent;
+} | {
+    PumpFunMigrateBondingCurveCreator: PumpFunMigrateBondingCurveCreatorEvent;
 } | {
     PumpSwapTrade: PumpSwapTradeEvent;
 } | {
@@ -122,6 +142,8 @@ export type DexEvent = {
     TokenAccount: TokenAccountEvent;
 } | {
     NonceAccount: NonceAccountEvent;
+} | {
+    PumpFunGlobalAccount: PumpFunGlobalAccountEvent;
 } | {
     PumpSwapGlobalConfigAccount: PumpSwapGlobalConfigAccountEvent;
 } | {
@@ -162,6 +184,7 @@ export interface PumpFunCreateV2TokenEvent extends PumpFunCreateTokenEvent {
     mayhem_token_vault: string;
     event_authority: string;
     program: string;
+    observed_fee_recipient: string;
 }
 export interface PumpFunTradeEvent {
     metadata: EventMetadata;
@@ -209,6 +232,103 @@ export interface PumpFunMigrateEvent {
     timestamp: bigint;
     pool: string;
 }
+export interface PumpFeesShareholder {
+    address: string;
+    share_bps: number;
+}
+export type PumpFeesConfigStatus = "Paused" | "Active";
+export interface PumpFeesFees {
+    lp_fee_bps: bigint;
+    protocol_fee_bps: bigint;
+    creator_fee_bps: bigint;
+}
+export interface PumpFeesFeeTier {
+    market_cap_lamports_threshold: bigint;
+    fees: PumpFeesFees;
+}
+export interface PumpFeesCreateFeeSharingConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    bonding_curve: string;
+    pool?: string;
+    sharing_config: string;
+    admin: string;
+    initial_shareholders: PumpFeesShareholder[];
+    status: PumpFeesConfigStatus;
+}
+export interface PumpFeesInitializeFeeConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    admin: string;
+    fee_config: string;
+}
+export interface PumpFeesResetFeeSharingConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    old_admin: string;
+    old_shareholders: PumpFeesShareholder[];
+    new_admin: string;
+    new_shareholders: PumpFeesShareholder[];
+}
+export interface PumpFeesRevokeFeeSharingAuthorityEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    admin: string;
+}
+export interface PumpFeesTransferFeeSharingAuthorityEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    old_admin: string;
+    new_admin: string;
+}
+export interface PumpFeesUpdateAdminEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    old_admin: string;
+    new_admin: string;
+}
+export interface PumpFeesUpdateFeeConfigEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    admin: string;
+    fee_config: string;
+    fee_tiers: PumpFeesFeeTier[];
+    flat_fees: PumpFeesFees;
+}
+export interface PumpFeesUpdateFeeSharesEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    sharing_config: string;
+    admin: string;
+    bonding_curve: string;
+    pump_creator_vault: string;
+    new_shareholders: PumpFeesShareholder[];
+}
+export interface PumpFeesUpsertFeeTiersEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    admin: string;
+    fee_config: string;
+    fee_tiers: PumpFeesFeeTier[];
+    offset: number;
+}
+export interface PumpFunMigrateBondingCurveCreatorEvent {
+    metadata: EventMetadata;
+    timestamp: bigint;
+    mint: string;
+    bonding_curve: string;
+    sharing_config: string;
+    old_creator: string;
+    new_creator: string;
+}
 /** 与 `PumpSwapTradeEvent`（IDL TradeEvent）对齐 */
 export interface PumpSwapTradeEvent {
     metadata: EventMetadata;
@@ -938,6 +1058,33 @@ export interface NonceAccountEvent {
     nonce: string;
     authority: string;
 }
+export interface PumpFunGlobal {
+    initialized: boolean;
+    authority: string;
+    fee_recipient: string;
+    initial_virtual_token_reserves: bigint;
+    initial_virtual_sol_reserves: bigint;
+    initial_real_token_reserves: bigint;
+    token_total_supply: bigint;
+    fee_basis_points: bigint;
+    withdraw_authority: string;
+    enable_migrate: boolean;
+    pool_migration_fee: bigint;
+    creator_fee_basis_points: bigint;
+    fee_recipients: string[];
+    set_creator_authority: string;
+    admin_set_creator_authority: string;
+    create_v2_enabled: boolean;
+    whitelist_pda: string;
+    reserved_fee_recipient: string;
+    mayhem_mode_enabled: boolean;
+    reserved_fee_recipients: string[];
+}
+export interface PumpFunGlobalAccountEvent {
+    metadata: EventMetadata;
+    pubkey: string;
+    global: PumpFunGlobal;
+}
 export interface PumpSwapGlobalConfig {
     admin: string;
     lp_fee_basis_points: bigint;

package/dist/core/pumpfun_fee_enrich.d.ts

@@ -0,0 +1,4 @@
+import type { DexEvent } from "./dex_event.js";
+export declare function enrichCreateV2ObservedFeeRecipient(events: DexEvent[]): void;
+export declare function enrichPumpfunTradesFromCreateInstructions(events: DexEvent[]): void;
+export declare function enrichPumpfunSameTxPostMerge(events: DexEvent[]): void;

package/dist/core/pumpfun_fee_enrich.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enrichCreateV2ObservedFeeRecipient = enrichCreateV2ObservedFeeRecipient;
+exports.enrichPumpfunTradesFromCreateInstructions = enrichPumpfunTradesFromCreateInstructions;
+exports.enrichPumpfunSameTxPostMerge = enrichPumpfunSameTxPostMerge;
+const dex_event_js_1 = require("./dex_event.js");
+function pumpfunTradeEvent(ev) {
+    if ("PumpFunTrade" in ev)
+        return ev.PumpFunTrade;
+    if ("PumpFunBuy" in ev)
+        return ev.PumpFunBuy;
+    if ("PumpFunSell" in ev)
+        return ev.PumpFunSell;
+    if ("PumpFunBuyExactSolIn" in ev)
+        return ev.PumpFunBuyExactSolIn;
+    return null;
+}
+function pumpfunCreateFlags(ev) {
+    let c = null;
+    if ("PumpFunCreate" in ev)
+        c = ev.PumpFunCreate;
+    if ("PumpFunCreateV2" in ev)
+        c = ev.PumpFunCreateV2;
+    if (!c || !c.mint || c.mint === (0, dex_event_js_1.defaultPubkey)())
+        return null;
+    return [c.mint, c.is_cashback_enabled, c.is_mayhem_mode];
+}
+function enrichCreateV2ObservedFeeRecipient(events) {
+    const zero = (0, dex_event_js_1.defaultPubkey)();
+    const mintToFee = new Map();
+    for (const ev of events) {
+        const t = pumpfunTradeEvent(ev);
+        if (!t || !t.mint || t.mint === zero || !t.fee_recipient || t.fee_recipient === zero) {
+            continue;
+        }
+        const buyLike = ("PumpFunTrade" in ev && t.is_buy) ||
+            "PumpFunBuy" in ev ||
+            "PumpFunBuyExactSolIn" in ev;
+        if (buyLike && !mintToFee.has(t.mint)) {
+            mintToFee.set(t.mint, t.fee_recipient);
+        }
+    }
+    if (mintToFee.size === 0)
+        return;
+    for (const ev of events) {
+        if (!("PumpFunCreateV2" in ev))
+            continue;
+        const c = ev.PumpFunCreateV2;
+        if (!c.observed_fee_recipient || c.observed_fee_recipient === zero) {
+            c.observed_fee_recipient = mintToFee.get(c.mint) ?? c.observed_fee_recipient;
+        }
+    }
+}
+function enrichPumpfunTradesFromCreateInstructions(events) {
+    const flags = new Map();
+    for (const ev of events) {
+        const f = pumpfunCreateFlags(ev);
+        if (f && !flags.has(f[0]))
+            flags.set(f[0], [f[1], f[2]]);
+    }
+    if (flags.size === 0)
+        return;
+    for (const ev of events) {
+        const t = pumpfunTradeEvent(ev);
+        if (!t || !t.mint || t.mint === (0, dex_event_js_1.defaultPubkey)())
+            continue;
+        const f = flags.get(t.mint);
+        if (!f)
+            continue;
+        const [cashbackEnabled, mayhemMode] = f;
+        t.is_cashback_coin ||= cashbackEnabled;
+        t.mayhem_mode ||= mayhemMode;
+        if (cashbackEnabled)
+            t.track_volume = true;
+    }
+}
+function enrichPumpfunSameTxPostMerge(events) {
+    enrichCreateV2ObservedFeeRecipient(events);
+    enrichPumpfunTradesFromCreateInstructions(events);
+}

package/dist/core/unified_parser.js

@@ -8,6 +8,7 @@ exports.parseTransactionEventsStreaming = parseTransactionEventsStreaming;
 exports.parseLogsStreaming = parseLogsStreaming;
 exports.parseTransactionWithStreamingListener = parseTransactionWithStreamingListener;
 exports.parseLog = parseLog;
+const pumpfun_fee_enrich_js_1 = require("./pumpfun_fee_enrich.js");
 const optimized_matcher_js_1 = require("../logs/optimized_matcher.js");
 const clock_js_1 = require("./clock.js");
 Object.defineProperty(exports, "nowUs", { enumerable: true, get: function () { return clock_js_1.nowUs; } });
@@ -22,6 +23,7 @@ function parseLogsOnly(logs, signature, slot, blockTimeUs, txIndex = 0) {
         if (e)
             out.push(e);
     }
+    (0, pumpfun_fee_enrich_js_1.enrichPumpfunSameTxPostMerge)(out);
     return out;
 }
 function parseTransactionWithListener(instructionData, accounts, logs, signature, slot, txIndex, blockTimeUs, programId, listener) {

package/dist/grpc/client.d.ts

@@ -2,14 +2,22 @@
  * Yellowstone gRPC 客户端实现 - 基于 @triton-one/yellowstone-grpc
  */
 import { CommitmentLevel } from "@triton-one/yellowstone-grpc";
-import { type ClientConfig, type TransactionFilter, type SubscribeCallbacks } from "./types.js";
+import type { DexEvent } from "../core/dex_event.js";
+import { type AccountFilter, type ClientConfig, type EventTypeFilter, type TransactionFilter, type SubscribeCallbacks } from "./types.js";
 export { SubscribeCallbacks };
+export interface DexEventSubscription extends AsyncIterable<DexEvent> {
+    id: string;
+    errors: AsyncIterable<Error>;
+    cancel(): void;
+    next(): Promise<IteratorResult<DexEvent>>;
+}
 /** Yellowstone gRPC 客户端包装器 */
 export declare class YellowstoneGrpc {
     private client;
     private config;
     private connected;
     private subscribers;
+    private dexSubscribers;
     constructor(endpoint: string, xToken: string, config?: ClientConfig);
     /** 连接到 gRPC 服务器 */
     connect(): Promise<void>;
@@ -28,14 +36,31 @@ export declare class YellowstoneGrpc {
      * 若不回复，公共节点或 LB 可能在超时后 RST_STREAM（HTTP/2 CANCEL）。
      */
     private subscribePingPongRequest;
+    private static toBytes;
+    private static toBigInt;
+    private static protobufNumber;
+    private static timestampToMicros;
+    private parseAccountEvent;
     private initialSubscribeRequest;
     /** 订阅交易 */
     subscribeTransactions(filter: TransactionFilter, callbacks: SubscribeCallbacks): Promise<{
         id: string;
         cancel: () => void;
     }>;
+    /**
+     * 订阅并直接产出 `DexEvent`。
+     *
+     * 交易更新走统一交易解析（外层/内层指令 + 日志 + 数据填充）；账户更新走 `parseAccountUnified`。
+     * 事件队列满时丢弃新事件，避免回调阻塞 gRPC 读循环，保持低延迟。
+     */
+    subscribeDexEvents(transactionFilters?: TransactionFilter[], accountFilters?: AccountFilter[], eventTypeFilter?: EventTypeFilter, options?: {
+        autoReconnect?: boolean;
+    }): Promise<DexEventSubscription>;
     /** 取消订阅 */
     unsubscribe(subId: string): void;
+    /** 动态更新当前 DEX 订阅过滤器（与 Rust update_subscription 语义对齐）。 */
+    updateSubscription(transactionFilters: TransactionFilter[], accountFilters: AccountFilter[]): Promise<void>;
+    update_subscription(transactionFilters: TransactionFilter[], accountFilters: AccountFilter[]): Promise<void>;
     /** 获取最新区块哈希 */
     getLatestBlockhash(commitment?: CommitmentLevel): Promise<{
         slot: number;