sol-parser-sdk 0.5.9

package/dist/grpc/types.d.ts

@@ -0,0 +1,195 @@
+import type { SubscribeRequestFilterAccountsFilter } from "@triton-one/yellowstone-grpc";
+import type { DexEvent } from "../core/dex_event.js";
+/** gRPC 订阅顺序模式 */
+export type OrderMode = "Unordered" | "Ordered" | "StreamingOrdered" | "MicroBatch";
+/** 与 Rust `grpc::types::Protocol` 一致 */
+export type Protocol = "PumpFun" | "PumpSwap" | "PumpFees" | "RaydiumLaunchlab" | "RaydiumCpmm" | "RaydiumClmm" | "RaydiumAmmV4" | "OrcaWhirlpool" | "MeteoraPools" | "MeteoraDammV2" | "MeteoraDlmm" | "MeteoraDbc";
+export type SlotStatus = "Processed" | "Confirmed" | "Finalized" | "FirstShredReceived" | "Completed" | "CreatedBank" | "Dead";
+export interface SubscribeUpdateAccountInfo {
+    pubkey: Uint8Array;
+    lamports: string | bigint;
+    owner: Uint8Array;
+    executable: boolean;
+    rentEpoch: string | bigint;
+    data: Uint8Array;
+    writeVersion: string | bigint;
+    txnSignature?: Uint8Array;
+}
+export interface SubscribeUpdateAccount {
+    slot: string | bigint;
+    isStartup: boolean;
+    account?: SubscribeUpdateAccountInfo;
+}
+export interface SubscribeUpdateSlot {
+    slot: string | bigint;
+    parent?: string | bigint;
+    status: SlotStatus;
+    deadError?: string;
+}
+export interface SubscribeUpdateTransactionInfo {
+    signature: Uint8Array;
+    isVote: boolean;
+    /** 原始 proto Transaction 对象 */
+    transactionRaw?: unknown;
+    /** 原始 proto TransactionStatusMeta 对象（含 logMessages） */
+    metaRaw?: {
+        logMessages?: string[];
+        logMessagesNone?: boolean;
+        err?: unknown;
+        preBalances?: string[];
+        postBalances?: string[];
+        [key: string]: unknown;
+    };
+    index: string | bigint;
+}
+export interface SubscribeUpdateTransaction {
+    slot: string | bigint;
+    transaction?: SubscribeUpdateTransactionInfo;
+}
+export interface SubscribeUpdateBlock {
+    slot: string | bigint;
+    blockhash: string;
+    parentSlot: string | bigint;
+    parentBlockhash: string;
+    executedTransactionCount: string | bigint;
+}
+export interface SubscribeUpdateBlockMeta {
+    slot: string | bigint;
+    blockhash: string;
+    parentSlot: string | bigint;
+    parentBlockhash: string;
+    executedTransactionCount: string | bigint;
+}
+export interface SubscribeUpdatePing {
+}
+export interface SubscribeUpdatePong {
+    id: number;
+}
+export interface SubscribeUpdate {
+    filters: string[];
+    account?: SubscribeUpdateAccount;
+    slot?: SubscribeUpdateSlot;
+    transaction?: SubscribeUpdateTransaction;
+    block?: SubscribeUpdateBlock;
+    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;
+    connection_timeout_ms: number;
+    request_timeout_ms: number;
+    enable_tls: boolean;
+    max_retries: number;
+    retry_delay_ms: number;
+    max_concurrent_streams: number;
+    keep_alive_interval_ms: number;
+    keep_alive_timeout_ms: number;
+    buffer_size: number;
+    order_mode: OrderMode;
+    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" | "RaydiumLaunchlabTrade" | "RaydiumLaunchlabPoolCreate" | "RaydiumLaunchlabMigrateAmm" | "PumpFunTrade" | "PumpFunBuy" | "PumpFunSell" | "PumpFunBuyExactSolIn" | "PumpFunCreate" | "PumpFunCreateV2" | "PumpFunComplete" | "PumpFunMigrate" | "PumpFeesCreateFeeSharingConfig" | "PumpFeesInitializeFeeConfig" | "PumpFeesResetFeeSharingConfig" | "PumpFeesRevokeFeeSharingAuthority" | "PumpFeesTransferFeeSharingAuthority" | "PumpFeesUpdateAdmin" | "PumpFeesUpdateFeeConfig" | "PumpFeesUpdateFeeShares" | "PumpFeesUpsertFeeTiers" | "PumpFunMigrateBondingCurveCreator" | "PumpSwapTrade" | "PumpSwapBuy" | "PumpSwapSell" | "PumpSwapCreatePool" | "PumpSwapLiquidityAdded" | "PumpSwapLiquidityRemoved" | "RaydiumCpmmSwap" | "RaydiumCpmmDeposit" | "RaydiumCpmmWithdraw" | "RaydiumCpmmInitialize" | "RaydiumClmmSwap" | "RaydiumClmmCreatePool" | "RaydiumClmmOpenPosition" | "RaydiumClmmClosePosition" | "RaydiumClmmIncreaseLiquidity" | "RaydiumClmmDecreaseLiquidity" | "RaydiumClmmLiquidityChange" | "RaydiumClmmConfigChange" | "RaydiumClmmCreatePersonalPosition" | "RaydiumClmmLiquidityCalculate" | "RaydiumClmmOpenLimitOrder" | "RaydiumClmmIncreaseLimitOrder" | "RaydiumClmmDecreaseLimitOrder" | "RaydiumClmmSettleLimitOrder" | "RaydiumClmmUpdateRewardInfos" | "RaydiumClmmOpenPositionWithTokenExtNft" | "RaydiumClmmCollectFee" | "RaydiumAmmV4Swap" | "RaydiumAmmV4Deposit" | "RaydiumAmmV4Withdraw" | "RaydiumAmmV4Initialize2" | "RaydiumAmmV4WithdrawPnl" | "OrcaWhirlpoolSwap" | "OrcaWhirlpoolLiquidityIncreased" | "OrcaWhirlpoolLiquidityDecreased" | "OrcaWhirlpoolPoolInitialized" | "MeteoraPoolsSwap" | "MeteoraPoolsAddLiquidity" | "MeteoraPoolsRemoveLiquidity" | "MeteoraPoolsBootstrapLiquidity" | "MeteoraPoolsPoolCreated" | "MeteoraPoolsSetPoolFees" | "MeteoraDammV2Swap" | "MeteoraDammV2AddLiquidity" | "MeteoraDammV2RemoveLiquidity" | "MeteoraDammV2InitializePool" | "MeteoraDammV2CreatePosition" | "MeteoraDammV2ClosePosition" | "MeteoraDbcSwap" | "MeteoraDbcInitializePool" | "MeteoraDbcCurveComplete" | "MeteoraDlmmSwap" | "MeteoraDlmmAddLiquidity" | "MeteoraDlmmRemoveLiquidity" | "MeteoraDlmmInitializePool" | "MeteoraDlmmInitializeBinArray" | "MeteoraDlmmCreatePosition" | "MeteoraDlmmClosePosition" | "MeteoraDlmmClaimFee" | "TokenAccount" | "TokenInfo" | "NonceAccount" | "AccountPumpFunGlobal" | "AccountPumpFunBondingCurve" | "AccountPumpFunFeeConfig" | "AccountPumpFunSharingConfig" | "AccountPumpFunGlobalVolumeAccumulator" | "AccountPumpFunUserVolumeAccumulator" | "AccountPumpSwapGlobalConfig" | "AccountPumpSwapPool" | "AccountRaydiumClmmAmmConfig" | "AccountRaydiumClmmPoolState" | "AccountRaydiumClmmTickArrayState" | "AccountRaydiumCpmmAmmConfig" | "AccountRaydiumCpmmPoolState" | "AccountOrcaWhirlpool" | "AccountOrcaPosition" | "AccountOrcaTickArray" | "AccountOrcaFeeTier" | "AccountOrcaWhirlpoolsConfig";
+/** 与 Rust `grpc::EventType`（由 `StreamingEventType` 导出）一致 */
+export type StreamingEventType = EventType;
+/** 所有事件类型列表 */
+export declare const ALL_EVENT_TYPES: EventType[];
+export declare function eventTypeFromDexEvent(event: DexEvent): EventType | null;
+export declare function eventTypeFilterShouldIncludeDexEvent(filter: EventTypeFilter, event: DexEvent): boolean;
+export declare function eventTypeFilterNormalizeDexEvent(filter: EventTypeFilter, event: DexEvent): DexEvent;
+export interface EventTypeFilter {
+    include_only?: EventType[];
+    exclude_types?: EventType[];
+    shouldInclude(eventType: EventType): boolean;
+}
+export declare function eventTypeFilterIncludeOnly(types: EventType[]): EventTypeFilter;
+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 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraDammV2(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Meteora DBC 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraDbc(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Meteora Pools 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraPools(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Meteora DLMM 相关类型 */
+export declare function eventTypeFilterIncludesMeteoraDlmm(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Raydium CLMM 相关类型 */
+export declare function eventTypeFilterIncludesRaydiumClmm(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Raydium CPMM 相关类型 */
+export declare function eventTypeFilterIncludesRaydiumCpmm(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Raydium AMM V4 相关类型 */
+export declare function eventTypeFilterIncludesRaydiumAmmV4(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Orca Whirlpool 相关类型 */
+export declare function eventTypeFilterIncludesOrcaWhirlpool(filter: EventTypeFilter): boolean;
+/** 过滤器是否包含 Raydium LaunchLab 相关类型（与 Rust `includes_raydium_launchlab` 集合一致） */
+export declare function eventTypeFilterIncludesRaydiumLaunchlab(filter: EventTypeFilter): boolean;
+/**
+ * `parseInstructionUnified` 前置白名单：仅当 `include_only` 与下列指令相关类型有交集时才解析指令。
+ * 若白名单中不含下列任一类型，则整条指令解析入口返回 null。
+ */
+export declare function eventTypeFilterAllowsInstructionParsing(includeOnly: EventType[]): boolean;