four-flap-meme-sdk 1.5.6 → 1.5.8

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

@@ -1,96 +0,0 @@
-/**
- * BlockRazor 客户端配置管理
- * @module sol/dex/blockrazor/client
- */
-import { BLOCKRAZOR_ENDPOINTS, BLOCKRAZOR_TIP_ACCOUNTS } from './constants.js';
-// ============================================================================
-// 客户端管理
-// ============================================================================
-let defaultConfig = null;
-/**
- * 设置默认 BlockRazor 配置
- *
- * @param config 配置
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setBlockRazorConfig({
- *   apiKey: 'your-auth-token',
- *   region: 'frankfurt',
- * })
- * ```
- */
-export function setBlockRazorConfig(config) {
-    defaultConfig = config;
-}
-/**
- * 获取 BlockRazor 配置
- *
- * @param config 可选配置（覆盖默认配置）
- * @returns 配置对象
- * @throws 未配置时抛出错误
- */
-export function getBlockRazorConfig(config) {
-    const cfg = config || defaultConfig;
-    if (!cfg) {
-        throw new Error('BlockRazor not configured. Call setBlockRazorConfig() first or pass config.');
-    }
-    return cfg;
-}
-/**
- * 获取端点 URL
- *
- * @param config 可选配置
- * @returns 端点 URL
- */
-export function getBlockRazorEndpoint(config) {
-    const cfg = getBlockRazorConfig(config);
-    if (cfg.endpoint) {
-        return cfg.endpoint;
-    }
-    const region = cfg.region || 'frankfurt';
-    switch (region) {
-        case 'frankfurt':
-            return BLOCKRAZOR_ENDPOINTS.FRANKFURT;
-        case 'newyork':
-            return BLOCKRAZOR_ENDPOINTS.NEW_YORK;
-        case 'tokyo':
-            return BLOCKRAZOR_ENDPOINTS.TOKYO;
-        case 'amsterdam':
-            return BLOCKRAZOR_ENDPOINTS.AMSTERDAM;
-        default:
-            return BLOCKRAZOR_ENDPOINTS.FRANKFURT;
-    }
-}
-/**
- * 获取随机 BlockRazor Tip 账户
- *
- * 避免因地址占用导致的性能下降，建议轮换 Tip 账户。
- *
- * @returns 随机 Tip 账户地址
- */
-export function getRandomBlockRazorTipAccount() {
-    const index = Math.floor(Math.random() * BLOCKRAZOR_TIP_ACCOUNTS.length);
-    return BLOCKRAZOR_TIP_ACCOUNTS[index];
-}
-/**
- * 验证发送交易参数
- *
- * @param params 发送参数
- * @throws 参数无效时抛出错误
- */
-export function validateSendParams(params) {
-    if (!params.transaction) {
-        throw new Error('transaction is required');
-    }
-    if (params.mode && !['fast', 'sandwichMitigation'].includes(params.mode)) {
-        throw new Error('mode must be "fast" or "sandwichMitigation"');
-    }
-    if (params.safeWindow !== undefined) {
-        if (params.safeWindow < 3 || params.safeWindow > 13) {
-            throw new Error('safeWindow must be between 3 and 13');
-        }
-    }
-}

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

@@ -1,34 +0,0 @@
-/**
- * BlockRazor 常量
- * @module sol/dex/blockrazor/constants
- */
-/** BlockRazor 区域端点 */
-export declare const BLOCKRAZOR_ENDPOINTS: {
-    /** 法兰克福 */
-    readonly FRANKFURT: "http://frankfurt.solana.blockrazor.xyz:443";
-    /** 纽约 */
-    readonly NEW_YORK: "http://newyork.solana.blockrazor.xyz:443";
-    /** 东京 */
-    readonly TOKYO: "http://tokyo.solana.blockrazor.xyz:443";
-    /** 阿姆斯特丹 */
-    readonly AMSTERDAM: "http://amsterdam.solana.blockrazor.xyz:443";
-};
-/** BlockRazor Tip 账户列表 */
-export declare const BLOCKRAZOR_TIP_ACCOUNTS: readonly ["Gywj98ophM7GmkDdaWs4isqZnDdFCW7B46TXmKfvyqSm", "FjmZZrFvhnqqb9ThCuMVnENaM3JGVuGWNyCAxRJcFpg9", "6No2i3aawzHsjtThw81iq1EXPJN6rh8eSJCLaYZfKDTG", "A9cWowVAiHe9pJfKAj3TJiN9VpbzMUq6E4kEvf5mUT22", "68Pwb4jS7eZATjDfhmTXgRJjCiZmw1L7Huy4HNpnxJ3o", "4ABhJh5rZPjv63RBJBuyWzBK3g9gWMUQdTZP2kiW31V9", "B2M4NG5eyZp5SBQrSdtemzk5TqVuaWGQnowGaCBt8GyM", "5jA59cXMKQqZAVdtopv8q3yyw9SYfiE3vUCbt7p8MfVf", "5YktoWygr1Bp9wiS1xtMtUki1PeYuuzuCF98tqwYxf61", "295Avbam4qGShBYK7E9H5Ldew4B3WyJGmgmXfiWdeeyV", "EDi4rSy2LZgKJX74mbLTFk4mxoTgT6F7HxxzG2HBAFyK", "BnGKHAC386n4Qmv9xtpBVbRaUTKixjBe3oagkPFKtoy6", "Dd7K2Fp7AtoN8xCghKDRmyqr5U169t48Tw5fEd3wT9mq", "AP6qExwrbRgBAVaehg4b5xHENX815sMabtBzUzVB4v8S"];
-/** 默认 Tip 金额 (lamports) */
-export declare const DEFAULT_TIP_AMOUNT = 1000000;
-/** 最小 Tip 金额 (lamports) */
-export declare const MIN_TIP_AMOUNT = 1000000;
-/** 默认请求超时 (ms) */
-export declare const BLOCKRAZOR_DEFAULT_TIMEOUT = 10000;
-/** Geyser Stream 端点 */
-export declare const GEYSER_STREAM_ENDPOINTS: {
-    /** 东京 */
-    readonly TOKYO: "geyserstream-tokyo.blockrazor.xyz:443";
-    /** 法兰克福 */
-    readonly FRANKFURT: "geyserstream-frankfurt.blockrazor.xyz:443";
-    /** 纽约 */
-    readonly NEW_YORK: "geyserstream-newyork.blockrazor.xyz:443";
-    /** 阿姆斯特丹 */
-    readonly AMSTERDAM: "geyserstream-amsterdam.blockrazor.xyz:443";
-};

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

@@ -1,55 +0,0 @@
-/**
- * BlockRazor 常量
- * @module sol/dex/blockrazor/constants
- */
-// ============================================================================
-// Send Transaction 端点
-// ============================================================================
-/** BlockRazor 区域端点 */
-export const BLOCKRAZOR_ENDPOINTS = {
-    /** 法兰克福 */
-    FRANKFURT: 'http://frankfurt.solana.blockrazor.xyz:443',
-    /** 纽约 */
-    NEW_YORK: 'http://newyork.solana.blockrazor.xyz:443',
-    /** 东京 */
-    TOKYO: 'http://tokyo.solana.blockrazor.xyz:443',
-    /** 阿姆斯特丹 */
-    AMSTERDAM: 'http://amsterdam.solana.blockrazor.xyz:443',
-};
-/** BlockRazor Tip 账户列表 */
-export const BLOCKRAZOR_TIP_ACCOUNTS = [
-    'Gywj98ophM7GmkDdaWs4isqZnDdFCW7B46TXmKfvyqSm',
-    'FjmZZrFvhnqqb9ThCuMVnENaM3JGVuGWNyCAxRJcFpg9',
-    '6No2i3aawzHsjtThw81iq1EXPJN6rh8eSJCLaYZfKDTG',
-    'A9cWowVAiHe9pJfKAj3TJiN9VpbzMUq6E4kEvf5mUT22',
-    '68Pwb4jS7eZATjDfhmTXgRJjCiZmw1L7Huy4HNpnxJ3o',
-    '4ABhJh5rZPjv63RBJBuyWzBK3g9gWMUQdTZP2kiW31V9',
-    'B2M4NG5eyZp5SBQrSdtemzk5TqVuaWGQnowGaCBt8GyM',
-    '5jA59cXMKQqZAVdtopv8q3yyw9SYfiE3vUCbt7p8MfVf',
-    '5YktoWygr1Bp9wiS1xtMtUki1PeYuuzuCF98tqwYxf61',
-    '295Avbam4qGShBYK7E9H5Ldew4B3WyJGmgmXfiWdeeyV',
-    'EDi4rSy2LZgKJX74mbLTFk4mxoTgT6F7HxxzG2HBAFyK',
-    'BnGKHAC386n4Qmv9xtpBVbRaUTKixjBe3oagkPFKtoy6',
-    'Dd7K2Fp7AtoN8xCghKDRmyqr5U169t48Tw5fEd3wT9mq',
-    'AP6qExwrbRgBAVaehg4b5xHENX815sMabtBzUzVB4v8S',
-];
-/** 默认 Tip 金额 (lamports) */
-export const DEFAULT_TIP_AMOUNT = 1000000;
-/** 最小 Tip 金额 (lamports) */
-export const MIN_TIP_AMOUNT = 1000000;
-/** 默认请求超时 (ms) */
-export const BLOCKRAZOR_DEFAULT_TIMEOUT = 10000;
-// ============================================================================
-// Geyser Stream 端点
-// ============================================================================
-/** Geyser Stream 端点 */
-export const GEYSER_STREAM_ENDPOINTS = {
-    /** 东京 */
-    TOKYO: 'geyserstream-tokyo.blockrazor.xyz:443',
-    /** 法兰克福 */
-    FRANKFURT: 'geyserstream-frankfurt.blockrazor.xyz:443',
-    /** 纽约 */
-    NEW_YORK: 'geyserstream-newyork.blockrazor.xyz:443',
-    /** 阿姆斯特丹 */
-    AMSTERDAM: 'geyserstream-amsterdam.blockrazor.xyz:443',
-};

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

@@ -1,128 +0,0 @@
-/**
- * BlockRazor Geyser Stream 服务
- * @module sol/dex/blockrazor/geyser
- *
- * Geyser Stream 是基于 Yellowstone gRPC 的高性能 Solana 数据流服务。
- *
- * @see https://blockrazor.gitbook.io/blockrazor/solana/geyser-stream
- */
-import type { GeyserRegion, GeyserSubscribeConfig, GeyserClientConfig, GeyserEventHandlers, GeyserStreamControl } from './types.js';
-/**
- * Geyser Proto 定义（内联）
- *
- * 用于动态加载 gRPC 服务
- */
-export declare const GEYSER_PROTO_DEFINITION = "\nsyntax = \"proto3\";\n\npackage geyser;\n\nservice Geyser {\n  rpc Subscribe(stream SubscribeRequest) returns (stream SubscribeUpdate);\n}\n\nmessage SubscribeRequest {\n  map<string, SubscribeRequestFilterAccounts> accounts = 1;\n  map<string, SubscribeRequestFilterSlots> slots = 2;\n  map<string, SubscribeRequestFilterTransactions> transactions = 3;\n  map<string, SubscribeRequestFilterBlocks> blocks = 4;\n  map<string, SubscribeRequestFilterBlocksMeta> blocks_meta = 5;\n  map<string, SubscribeRequestFilterEntry> entry = 6;\n  optional CommitmentLevel commitment = 7;\n  repeated SubscribeRequestAccountsDataSlice accounts_data_slice = 8;\n  optional SubscribeRequestPing ping = 9;\n}\n\nenum CommitmentLevel {\n  PROCESSED = 0;\n  CONFIRMED = 1;\n  FINALIZED = 2;\n}\n\nmessage SubscribeRequestFilterAccounts {\n  repeated string account = 1;\n  repeated string owner = 2;\n  repeated SubscribeRequestFilterAccountsFilter filters = 3;\n  optional bool nonempty_txn_signature = 4;\n}\n\nmessage SubscribeRequestFilterAccountsFilter {\n  oneof filter {\n    SubscribeRequestFilterAccountsFilterMemcmp memcmp = 1;\n    uint64 datasize = 2;\n    bool token_account_state = 3;\n    SubscribeRequestFilterAccountsFilterLamports lamports = 4;\n  }\n}\n\nmessage SubscribeRequestFilterAccountsFilterMemcmp {\n  uint64 offset = 1;\n  oneof data {\n    bytes bytes = 2;\n    string base58 = 3;\n    string base64 = 4;\n  }\n}\n\nmessage SubscribeRequestFilterAccountsFilterLamports {\n  oneof cmp {\n    uint64 eq = 1;\n    uint64 ne = 2;\n    uint64 lt = 3;\n    uint64 gt = 4;\n  }\n}\n\nmessage SubscribeRequestFilterSlots {\n  optional bool filter_by_commitment = 1;\n  optional bool interleave_global_updates = 2;\n}\n\nmessage SubscribeRequestFilterTransactions {\n  optional bool vote = 1;\n  optional bool failed = 2;\n  optional string signature = 3;\n  repeated string account_include = 4;\n  repeated string account_exclude = 5;\n  repeated string account_required = 6;\n}\n\nmessage SubscribeRequestFilterBlocks {\n  repeated string account_include = 1;\n  optional bool include_transactions = 2;\n  optional bool include_accounts = 3;\n  optional bool include_entries = 4;\n}\n\nmessage SubscribeRequestFilterBlocksMeta {}\n\nmessage SubscribeRequestFilterEntry {}\n\nmessage SubscribeRequestAccountsDataSlice {\n  uint64 offset = 1;\n  uint64 length = 2;\n}\n\nmessage SubscribeRequestPing {\n  int32 id = 1;\n}\n\nmessage SubscribeUpdate {\n  repeated string filters = 1;\n  oneof update_oneof {\n    SubscribeUpdateAccount account = 2;\n    SubscribeUpdateSlot slot = 3;\n    SubscribeUpdateTransaction transaction = 4;\n    SubscribeUpdateTransactionInfo transaction_info = 10;\n    SubscribeUpdateBlock block = 5;\n    SubscribeUpdatePing ping = 6;\n    SubscribeUpdatePong pong = 7;\n    SubscribeUpdateBlockMeta block_meta = 8;\n    SubscribeUpdateEntry entry = 9;\n  }\n  uint64 created_at = 11;\n}\n\nmessage SubscribeUpdateAccount {\n  SubscribeUpdateAccountInfo account = 1;\n  uint64 slot = 2;\n  optional bool is_startup = 3;\n}\n\nmessage SubscribeUpdateAccountInfo {\n  bytes pubkey = 1;\n  uint64 lamports = 2;\n  bytes owner = 3;\n  bool executable = 4;\n  uint64 rent_epoch = 5;\n  bytes data = 6;\n  uint64 write_version = 7;\n  optional bytes txn_signature = 8;\n}\n\nmessage SubscribeUpdateSlot {\n  uint64 slot = 1;\n  optional uint64 parent = 2;\n  CommitmentLevel status = 3;\n  optional int64 dead_error = 4;\n}\n\nmessage SubscribeUpdateTransaction {\n  SubscribeUpdateTransactionInfo transaction = 1;\n  uint64 slot = 2;\n}\n\nmessage SubscribeUpdateTransactionInfo {\n  bytes signature = 1;\n  bool is_vote = 2;\n  bytes transaction = 3;\n  bytes meta = 4;\n  optional uint64 index = 5;\n}\n\nmessage SubscribeUpdateBlock {\n  uint64 slot = 1;\n  string blockhash = 2;\n  SubscribeUpdateBlockRewards rewards = 3;\n  UnixTimestamp block_time = 4;\n  BlockHeight block_height = 5;\n  uint64 parent_slot = 6;\n  string parent_blockhash = 7;\n  uint64 executed_transaction_count = 8;\n  uint64 entries_count = 9;\n  repeated SubscribeUpdateTransactionInfo transactions = 10;\n  repeated SubscribeUpdateAccountInfo updated_account_count = 11;\n  repeated SubscribeUpdateEntry entries = 12;\n}\n\nmessage SubscribeUpdateBlockRewards {\n  bytes rewards = 1;\n}\n\nmessage UnixTimestamp {\n  int64 timestamp = 1;\n}\n\nmessage BlockHeight {\n  uint64 block_height = 1;\n}\n\nmessage SubscribeUpdatePing {}\n\nmessage SubscribeUpdatePong {\n  int32 id = 1;\n}\n\nmessage SubscribeUpdateBlockMeta {\n  uint64 slot = 1;\n  string blockhash = 2;\n  SubscribeUpdateBlockRewards rewards = 3;\n  UnixTimestamp block_time = 4;\n  BlockHeight block_height = 5;\n  uint64 parent_slot = 6;\n  string parent_blockhash = 7;\n  uint64 executed_transaction_count = 8;\n  uint64 entries_count = 9;\n}\n\nmessage SubscribeUpdateEntry {\n  uint64 slot = 1;\n  uint64 index = 2;\n  uint64 num_hashes = 3;\n  bytes hash = 4;\n  uint64 executed_transaction_count = 5;\n  optional uint64 starting_transaction_index = 6;\n}\n";
-/**
- * 获取 Geyser Stream 端点
- *
- * @param region 区域
- * @returns gRPC 端点地址
- */
-export declare function getGeyserEndpoint(region?: GeyserRegion): string;
-/**
- * 构建 Geyser 订阅请求
- *
- * @param config 订阅配置
- * @returns gRPC 请求对象
- */
-export declare function buildGeyserSubscribeRequest(config: GeyserSubscribeConfig): Record<string, unknown>;
-/**
- * 创建默认账户订阅配置
- *
- * @param owners 拥有者地址列表
- * @param accounts 特定账户地址列表
- * @returns 订阅配置
- */
-export declare function createAccountSubscribeConfig(owners?: string[], accounts?: string[]): GeyserSubscribeConfig;
-/**
- * 创建默认交易订阅配置
- *
- * @param accountInclude 包含涉及这些账户的交易
- * @param accountRequired 交易必须涉及这些账户
- * @returns 订阅配置
- */
-export declare function createTransactionSubscribeConfig(accountInclude?: string[], accountRequired?: string[]): GeyserSubscribeConfig;
-/**
- * 创建默认区块订阅配置
- *
- * @param accountInclude 包含涉及这些账户的区块
- * @param includeTransactions 是否包含交易
- * @returns 订阅配置
- */
-export declare function createBlockSubscribeConfig(accountInclude?: string[], includeTransactions?: boolean): GeyserSubscribeConfig;
-/**
- * 创建 Geyser 订阅（需要 @grpc/grpc-js 和 @grpc/proto-loader）
- *
- * 注意：此函数需要安装 gRPC 依赖：
- * ```bash
- * npm install @grpc/grpc-js @grpc/proto-loader
- * ```
- *
- * @param clientConfig 客户端配置
- * @param subscribeConfig 订阅配置
- * @param handlers 事件处理器
- * @returns 流控制对象
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- * import bs58 from 'bs58'
- *
- * const stream = await Sol.createGeyserSubscription(
- *   {
- *     host: Sol.getGeyserEndpoint('tokyo'),
- *     token: 'your-auth-token',
- *   },
- *   Sol.createTransactionSubscribeConfig(
- *     ['your-account-address'], // 监听涉及此账户的交易
- *   ),
- *   {
- *     onTransaction: (update, raw) => {
- *       console.log(`交易: ${bs58.encode(update.transaction.signature)}`)
- *     },
- *     onError: (err) => console.error('错误:', err),
- *     onEnd: () => console.log('流结束'),
- *   },
- * )
- *
- * // 关闭流
- * stream.close()
- * ```
- */
-export declare function createGeyserSubscription(clientConfig: GeyserClientConfig, subscribeConfig: GeyserSubscribeConfig, handlers: GeyserEventHandlers): Promise<GeyserStreamControl>;
-/**
- * 简化版：订阅账户更新
- *
- * @param token 认证 Token
- * @param accounts 账户地址列表
- * @param onUpdate 更新回调
- * @param region 区域（默认 tokyo）
- * @returns 流控制对象
- */
-export declare function subscribeGeyserAccounts(token: string, accounts: string[], onUpdate: (pubkey: string, lamports: string, slot: string) => void, region?: GeyserRegion): Promise<{
-    close: () => void;
-}>;
-/**
- * 简化版：订阅交易更新
- *
- * @param token 认证 Token
- * @param accountInclude 包含涉及这些账户的交易
- * @param onUpdate 更新回调
- * @param region 区域（默认 tokyo）
- * @returns 流控制对象
- */
-export declare function subscribeGeyserTransactions(token: string, accountInclude: string[], onUpdate: (signature: string, isVote: boolean, slot: string) => void, region?: GeyserRegion): Promise<{
-    close: () => void;
-}>;
-/**
- * 简化版：订阅区块更新
- *
- * @param token 认证 Token
- * @param onUpdate 更新回调
- * @param region 区域（默认 tokyo）
- * @returns 流控制对象
- */
-export declare function subscribeGeyserBlocks(token: string, onUpdate: (slot: string, blockhash: string, txCount: number) => void, region?: GeyserRegion): Promise<{
-    close: () => void;
-}>;