four-flap-meme-sdk 1.5.4 → 1.5.6

package/dist/sol/dex/blockrazor/index.js

@@ -0,0 +1,23 @@
+/**
+ * BlockRazor Solana Service
+ * @module sol/dex/blockrazor
+ *
+ * BlockRazor 提供 Solana 服务：
+ * - 高性能交易落地 (Transaction Landing)
+ * - 三明治攻击缓解模式 (Sandwich Mitigation)
+ * - Revert 保护
+ * - Geyser Stream (gRPC 实时数据流)
+ *
+ * @see https://blockrazor.gitbook.io/blockrazor/solana/send-transaction
+ * @see https://blockrazor.gitbook.io/blockrazor/solana/geyser-stream
+ */
+// 类型导出
+export * from './types.js';
+// 常量导出
+export * from './constants.js';
+// 客户端管理
+export { setBlockRazorConfig, getBlockRazorConfig, getBlockRazorEndpoint, getRandomBlockRazorTipAccount, validateSendParams, } from './client.js';
+// Send Transaction
+export { blockRazorSendTransaction, blockRazorSendTransactionV2, blockRazorHealth, blockRazorHealthV2, blockRazorFastSend, blockRazorSafeSend, blockRazorSendWithRevertProtection, startBlockRazorKeepAlive, } from './send.js';
+// Geyser Stream
+export { GEYSER_PROTO_DEFINITION, getGeyserEndpoint, buildGeyserSubscribeRequest, createAccountSubscribeConfig, createTransactionSubscribeConfig, createBlockSubscribeConfig, createGeyserSubscription, subscribeGeyserAccounts, subscribeGeyserTransactions, subscribeGeyserBlocks, } from './geyser.js';

package/dist/sol/dex/blockrazor/send.d.ts

@@ -0,0 +1,135 @@
+/**
+ * BlockRazor 交易发送服务
+ * @module sol/dex/blockrazor/send
+ *
+ * @see https://blockrazor.gitbook.io/blockrazor/solana/send-transaction
+ */
+import type { BlockRazorConfig, BlockRazorMode, BlockRazorSendParams, BlockRazorSendResponse, BlockRazorHealthResponse } from './types.js';
+/**
+ * 发送交易 (V1 - HTTP JSON)
+ *
+ * @param params 发送参数
+ * @param config BlockRazor 配置
+ * @returns 发送响应
+ *
+ * @example
+ * ```typescript
+ * import { Sol } from 'four-flap-meme-sdk'
+ *
+ * Sol.setBlockRazorConfig({ apiKey: 'your-auth-token' })
+ *
+ * // 快速模式发送
+ * const result = await Sol.blockRazorSendTransaction({
+ *   transaction: base64SignedTx,
+ *   mode: 'fast',
+ * })
+ *
+ * console.log(`签名: ${result.signature}`)
+ *
+ * // 三明治缓解模式
+ * const result2 = await Sol.blockRazorSendTransaction({
+ *   transaction: base64SignedTx,
+ *   mode: 'sandwichMitigation',
+ *   safeWindow: 5,
+ * })
+ * ```
+ */
+export declare function blockRazorSendTransaction(params: BlockRazorSendParams, config?: BlockRazorConfig): Promise<BlockRazorSendResponse>;
+/**
+ * 发送交易 V2 (更快的 HTTP Plain Text)
+ *
+ * V2 优势：
+ * - 绕过 CORS Preflight (节省 50-100ms)
+ * - 使用 Plain Text 而非 JSON
+ * - Base64 编码更快
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param options 可选参数
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ *
+ * @example
+ * ```typescript
+ * // 快速发送
+ * const signature = await Sol.blockRazorSendTransactionV2(base64Tx)
+ *
+ * // 带参数发送
+ * const signature = await Sol.blockRazorSendTransactionV2(
+ *   base64Tx,
+ *   {
+ *     mode: 'sandwichMitigation',
+ *     safeWindow: 5,
+ *     revertProtection: true,
+ *   },
+ * )
+ * ```
+ */
+export declare function blockRazorSendTransactionV2(transaction: string, options?: {
+    mode?: BlockRazorMode;
+    safeWindow?: number;
+    revertProtection?: boolean;
+}, config?: BlockRazorConfig): Promise<string>;
+/**
+ * 健康检查 (V1)
+ *
+ * 用于保持连接活跃。
+ *
+ * @param config BlockRazor 配置
+ * @returns 健康状态
+ */
+export declare function blockRazorHealth(config?: BlockRazorConfig): Promise<BlockRazorHealthResponse>;
+/**
+ * 健康检查 V2
+ *
+ * @param config BlockRazor 配置
+ * @returns 是否健康
+ */
+export declare function blockRazorHealthV2(config?: BlockRazorConfig): Promise<boolean>;
+/**
+ * 快速发送交易
+ *
+ * 使用 V2 + fast 模式发送。
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ */
+export declare function blockRazorFastSend(transaction: string, config?: BlockRazorConfig): Promise<string>;
+/**
+ * 安全发送交易（三明治缓解）
+ *
+ * 使用 V2 + sandwichMitigation 模式发送。
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param safeWindow 安全窗口（默认 5）
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ */
+export declare function blockRazorSafeSend(transaction: string, safeWindow?: number, config?: BlockRazorConfig): Promise<string>;
+/**
+ * 发送交易带 Revert 保护
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ */
+export declare function blockRazorSendWithRevertProtection(transaction: string, config?: BlockRazorConfig): Promise<string>;
+/**
+ * 启动 Keep-Alive 定时器
+ *
+ * 定期发送健康检查以保持连接活跃。
+ *
+ * @param intervalMs 间隔时间（毫秒，默认 30000）
+ * @param config BlockRazor 配置
+ * @returns 定时器 ID（用于停止）
+ *
+ * @example
+ * ```typescript
+ * // 启动 keep-alive
+ * const timerId = Sol.startBlockRazorKeepAlive(30000)
+ *
+ * // 停止
+ * clearInterval(timerId)
+ * ```
+ */
+export declare function startBlockRazorKeepAlive(intervalMs?: number, config?: BlockRazorConfig): ReturnType<typeof setInterval>;

package/dist/sol/dex/blockrazor/send.js

@@ -0,0 +1,254 @@
+/**
+ * BlockRazor 交易发送服务
+ * @module sol/dex/blockrazor/send
+ *
+ * @see https://blockrazor.gitbook.io/blockrazor/solana/send-transaction
+ */
+import { BLOCKRAZOR_DEFAULT_TIMEOUT } from './constants.js';
+import { getBlockRazorConfig, getBlockRazorEndpoint } from './client.js';
+// ============================================================================
+// Send Transaction V1 (HTTP JSON)
+// ============================================================================
+/**
+ * 发送交易 (V1 - HTTP JSON)
+ *
+ * @param params 发送参数
+ * @param config BlockRazor 配置
+ * @returns 发送响应
+ *
+ * @example
+ * ```typescript
+ * import { Sol } from 'four-flap-meme-sdk'
+ *
+ * Sol.setBlockRazorConfig({ apiKey: 'your-auth-token' })
+ *
+ * // 快速模式发送
+ * const result = await Sol.blockRazorSendTransaction({
+ *   transaction: base64SignedTx,
+ *   mode: 'fast',
+ * })
+ *
+ * console.log(`签名: ${result.signature}`)
+ *
+ * // 三明治缓解模式
+ * const result2 = await Sol.blockRazorSendTransaction({
+ *   transaction: base64SignedTx,
+ *   mode: 'sandwichMitigation',
+ *   safeWindow: 5,
+ * })
+ * ```
+ */
+export async function blockRazorSendTransaction(params, config) {
+    const cfg = getBlockRazorConfig(config);
+    const endpoint = getBlockRazorEndpoint(cfg);
+    const timeout = cfg.timeout || BLOCKRAZOR_DEFAULT_TIMEOUT;
+    const url = `${endpoint}/sendTransaction`;
+    const body = {
+        transaction: params.transaction,
+        mode: params.mode || 'fast',
+    };
+    if (params.safeWindow !== undefined) {
+        body.safeWindow = params.safeWindow;
+    }
+    if (params.revertProtection !== undefined) {
+        body.revertProtection = params.revertProtection;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'apikey': cfg.apiKey,
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        const data = await response.json();
+        if (data.error) {
+            throw new Error(`BlockRazor error: ${data.error}`);
+        }
+        return data;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+// ============================================================================
+// Send Transaction V2 (HTTP Plain Text - Faster)
+// ============================================================================
+/**
+ * 发送交易 V2 (更快的 HTTP Plain Text)
+ *
+ * V2 优势：
+ * - 绕过 CORS Preflight (节省 50-100ms)
+ * - 使用 Plain Text 而非 JSON
+ * - Base64 编码更快
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param options 可选参数
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ *
+ * @example
+ * ```typescript
+ * // 快速发送
+ * const signature = await Sol.blockRazorSendTransactionV2(base64Tx)
+ *
+ * // 带参数发送
+ * const signature = await Sol.blockRazorSendTransactionV2(
+ *   base64Tx,
+ *   {
+ *     mode: 'sandwichMitigation',
+ *     safeWindow: 5,
+ *     revertProtection: true,
+ *   },
+ * )
+ * ```
+ */
+export async function blockRazorSendTransactionV2(transaction, options, config) {
+    const cfg = getBlockRazorConfig(config);
+    const endpoint = getBlockRazorEndpoint(cfg);
+    const timeout = cfg.timeout || BLOCKRAZOR_DEFAULT_TIMEOUT;
+    // 构建 URL 参数
+    const params = new URLSearchParams();
+    params.append('auth', cfg.apiKey);
+    if (options?.mode) {
+        params.append('mode', options.mode);
+    }
+    if (options?.safeWindow !== undefined) {
+        params.append('safeWindow', options.safeWindow.toString());
+    }
+    if (options?.revertProtection !== undefined) {
+        params.append('revertProtection', options.revertProtection.toString());
+    }
+    const url = `${endpoint}/v2/sendTransaction?${params.toString()}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'text/plain',
+            },
+            body: transaction,
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`BlockRazor V2 error (${response.status}): ${errorText}`);
+        }
+        // V2 响应直接返回签名
+        return await response.text();
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+// ============================================================================
+// Health Check
+// ============================================================================
+/**
+ * 健康检查 (V1)
+ *
+ * 用于保持连接活跃。
+ *
+ * @param config BlockRazor 配置
+ * @returns 健康状态
+ */
+export async function blockRazorHealth(config) {
+    const cfg = getBlockRazorConfig(config);
+    const endpoint = getBlockRazorEndpoint(cfg);
+    const response = await fetch(`${endpoint}/health`, {
+        method: 'GET',
+        headers: {
+            'apikey': cfg.apiKey,
+        },
+    });
+    return await response.json();
+}
+/**
+ * 健康检查 V2
+ *
+ * @param config BlockRazor 配置
+ * @returns 是否健康
+ */
+export async function blockRazorHealthV2(config) {
+    const cfg = getBlockRazorConfig(config);
+    const endpoint = getBlockRazorEndpoint(cfg);
+    const params = new URLSearchParams();
+    params.append('auth', cfg.apiKey);
+    const response = await fetch(`${endpoint}/v2/health?${params.toString()}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'text/plain',
+        },
+        body: '',
+    });
+    return response.ok;
+}
+// ============================================================================
+// 便捷方法
+// ============================================================================
+/**
+ * 快速发送交易
+ *
+ * 使用 V2 + fast 模式发送。
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ */
+export async function blockRazorFastSend(transaction, config) {
+    return blockRazorSendTransactionV2(transaction, { mode: 'fast' }, config);
+}
+/**
+ * 安全发送交易（三明治缓解）
+ *
+ * 使用 V2 + sandwichMitigation 模式发送。
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param safeWindow 安全窗口（默认 5）
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ */
+export async function blockRazorSafeSend(transaction, safeWindow = 5, config) {
+    return blockRazorSendTransactionV2(transaction, { mode: 'sandwichMitigation', safeWindow }, config);
+}
+/**
+ * 发送交易带 Revert 保护
+ *
+ * @param transaction Base64 编码的已签名交易
+ * @param config BlockRazor 配置
+ * @returns 交易签名
+ */
+export async function blockRazorSendWithRevertProtection(transaction, config) {
+    return blockRazorSendTransactionV2(transaction, { mode: 'fast', revertProtection: true }, config);
+}
+/**
+ * 启动 Keep-Alive 定时器
+ *
+ * 定期发送健康检查以保持连接活跃。
+ *
+ * @param intervalMs 间隔时间（毫秒，默认 30000）
+ * @param config BlockRazor 配置
+ * @returns 定时器 ID（用于停止）
+ *
+ * @example
+ * ```typescript
+ * // 启动 keep-alive
+ * const timerId = Sol.startBlockRazorKeepAlive(30000)
+ *
+ * // 停止
+ * clearInterval(timerId)
+ * ```
+ */
+export function startBlockRazorKeepAlive(intervalMs = 30000, config) {
+    // 立即执行一次
+    blockRazorHealthV2(config).catch(console.error);
+    // 定时执行
+    return setInterval(() => {
+        blockRazorHealthV2(config).catch(console.error);
+    }, intervalMs);
+}

package/dist/sol/dex/blockrazor/types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * BlockRazor 类型定义
+ * @module sol/dex/blockrazor/types
+ */
+/** 区域类型 */
+export type BlockRazorRegion = 'frankfurt' | 'newyork' | 'tokyo' | 'amsterdam';
+/** 发送模式 */
+export type BlockRazorMode = 'fast' | 'sandwichMitigation';
+/** BlockRazor 配置 */
+export interface BlockRazorConfig {
+    /** API Key (auth token) */
+    apiKey: string;
+    /** 区域（默认: frankfurt） */
+    region?: BlockRazorRegion;
+    /** 自定义端点 URL */
+    endpoint?: string;
+    /** 请求超时 (ms，默认: 10000) */
+    timeout?: number;
+}
+/** 发送交易参数 */
+export interface BlockRazorSendParams {
+    /** Base64 编码的已签名交易 */
+    transaction: string;
+    /**
+     * 发送模式
+     * - fast: 最快落地模式（默认）
+     * - sandwichMitigation: 三明治攻击缓解模式
+     */
+    mode?: BlockRazorMode;
+    /**
+     * 安全窗口（仅 sandwichMitigation 模式生效）
+     * 范围: 3-13，默认: 3
+     * 值越大防护效果越好，但可能影响落地率
+     */
+    safeWindow?: number;
+    /**
+     * Revert 保护
+     * 设为 true 时交易不会在链上失败，但会影响落地速度
+     */
+    revertProtection?: boolean;
+}
+/** 发送交易响应 */
+export interface BlockRazorSendResponse {
+    /** 交易签名 */
+    signature: string;
+    /** 错误信息（如有） */
+    error?: string;
+}
+/** 健康检查响应 */
+export interface BlockRazorHealthResponse {
+    /** 状态 */
+    status: string;
+}
+/** Commitment 级别 */
+export type GeyserCommitment = 'PROCESSED' | 'CONFIRMED' | 'FINALIZED';
+/** Geyser Stream 区域 */
+export type GeyserRegion = 'tokyo' | 'frankfurt' | 'newyork' | 'amsterdam';
+/** Geyser 过滤器 */
+export interface GeyserFilter {
+    /** memcmp 过滤器 */
+    memcmp?: {
+        offset: number;
+        bytes: string;
+    };
+    /** dataSize 过滤器 */
+    dataSize?: number;
+}
+/** 账户订阅参数 */
+export interface GeyserAccountParams {
+    /** 过滤器 Key */
+    filterKey: string;
+    /** 拥有者地址列表 */
+    owners?: string[];
+    /** 特定账户地址列表 */
+    accounts?: string[];
+    /** 额外过滤器（如 memcmp, datasize） */
+    filters?: GeyserFilter[];
+    /** 是否只包含有交易签名的更新 */
+    nonemptyTxnSignature?: boolean;
+}
+/** 区块订阅参数 */
+export interface GeyserBlockParams {
+    /** 过滤器 Key */
+    filterKey: string;
+    /** 包含涉及这些账户的区块（空表示全部） */
+    accountInclude?: string[];
+    /** 是否包含交易 */
+    includeTransactions?: boolean;
+    /** 是否包含账户更新 */
+    includeAccounts?: boolean;
+    /** 是否包含条目 */
+    includeEntries?: boolean;
+}
+/** 交易订阅参数 */
+export interface GeyserTransactionParams {
+    /** 过滤器 Key */
+    filterKey: string;
+    /** 是否只包含投票交易 */
+    vote?: boolean;
+    /** 是否只包含失败交易 */
+    failed?: boolean;
+    /** 包含涉及这些账户的交易 */
+    accountInclude?: string[];
+    /** 排除涉及这些账户的交易 */
+    accountExclude?: string[];
+    /** 交易必须涉及这些账户 */
+    accountRequired?: string[];
+    /** 特定交易签名 */
+    signature?: string | null;
+}
+/** Geyser 订阅配置 */
+export interface GeyserSubscribeConfig {
+    /** Commitment 级别 */
+    commitment?: GeyserCommitment;
+    /** 是否订阅账户 */
+    subscribeAccounts?: boolean;
+    /** 账户订阅参数 */
+    accountParams?: GeyserAccountParams;
+    /** 是否订阅区块 */
+    subscribeBlocks?: boolean;
+    /** 区块订阅参数 */
+    blockParams?: GeyserBlockParams;
+    /** 是否订阅交易 */
+    subscribeTransactions?: boolean;
+    /** 交易订阅参数 */
+    transactionParams?: GeyserTransactionParams;
+}
+/** 账户更新 */
+export interface GeyserAccountUpdate {
+    slot: string;
+    account: {
+        pubkey: Uint8Array;
+        owner: Uint8Array;
+        lamports: string;
+        data: Uint8Array;
+        executable: boolean;
+        rentEpoch: string;
+    };
+}
+/** 区块更新 */
+export interface GeyserBlockUpdate {
+    slot: string;
+    blockhash: string;
+    transactions: unknown[];
+    parentSlot: string;
+    blockTime?: string;
+}
+/** 交易更新 */
+export interface GeyserTransactionUpdate {
+    slot: string;
+    transaction: {
+        signature: Uint8Array;
+        isVote: boolean;
+        transaction: unknown;
+        meta: unknown;
+    };
+}
+/** Geyser 更新 */
+export interface GeyserUpdate {
+    update_oneof: 'account' | 'block' | 'transaction' | 'ping' | 'pong';
+    account?: GeyserAccountUpdate;
+    block?: GeyserBlockUpdate;
+    transaction?: GeyserTransactionUpdate;
+}
+/** Geyser 客户端配置 */
+export interface GeyserClientConfig {
+    /** gRPC 服务地址 */
+    host: string;
+    /** 认证 Token */
+    token: string;
+}
+/** Geyser Stream 事件处理器 */
+export interface GeyserEventHandlers {
+    /** 账户更新回调 */
+    onAccount?: (update: GeyserAccountUpdate, raw: Uint8Array) => void;
+    /** 区块更新回调 */
+    onBlock?: (update: GeyserBlockUpdate) => void;
+    /** 交易更新回调 */
+    onTransaction?: (update: GeyserTransactionUpdate, raw: Uint8Array) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+    /** 流结束回调 */
+    onEnd?: () => void;
+}
+/** Geyser 订阅流控制 */
+export interface GeyserStreamControl {
+    /** 关闭流 */
+    close: () => void;
+    /** 发送数据 */
+    write: (data: unknown) => void;
+}

package/dist/sol/dex/blockrazor/types.js

@@ -0,0 +1,5 @@
+/**
+ * BlockRazor 类型定义
+ * @module sol/dex/blockrazor/types
+ */
+export {};

package/dist/sol/dex/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DEX 模块导出
+ * @module sol/dex
+ */
+export * from './pump/index.js';
+export * from './raydium/index.js';
+export * from './orca/index.js';
+export * from './meteora/index.js';
+export * from './jup/index.js';
+export * from './blockrazor/index.js';

package/dist/sol/dex/index.js

@@ -0,0 +1,16 @@
+/**
+ * DEX 模块导出
+ * @module sol/dex
+ */
+// Pump.fun
+export * from './pump/index.js';
+// Raydium
+export * from './raydium/index.js';
+// Orca
+export * from './orca/index.js';
+// Meteora
+export * from './meteora/index.js';
+// Jupiter
+export * from './jup/index.js';
+// BlockRazor
+export * from './blockrazor/index.js';

package/dist/sol/dex/jup/client.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Jupiter API 客户端
+ * @module sol/dex/jup/client
+ */
+import type { JupiterConfig } from './types.js';
+/** Jupiter API 基础 URL */
+export declare const JUP_API_BASE_URL = "https://api.jup.ag";
+/** 默认超时时间 (ms) */
+export declare const DEFAULT_TIMEOUT = 30000;
+/**
+ * 设置默认 Jupiter 配置
+ */
+export declare function setJupiterConfig(config: JupiterConfig): void;
+/**
+ * 获取 Jupiter 配置
+ */
+export declare function getJupiterConfig(config?: JupiterConfig): JupiterConfig;
+/**
+ * 获取基础 URL
+ */
+export declare function getBaseUrl(config?: JupiterConfig): string;
+/**
+ * 构建请求头
+ */
+export declare function buildHeaders(config?: JupiterConfig): Record<string, string>;
+/**
+ * 发送 GET 请求
+ */
+export declare function jupGet<T>(path: string, params?: Record<string, string | number | boolean | undefined>, config?: JupiterConfig): Promise<T>;
+/**
+ * 发送 POST 请求
+ */
+export declare function jupPost<T>(path: string, body: Record<string, unknown>, config?: JupiterConfig): Promise<T>;