four-flap-meme-sdk 1.4.89 → 1.4.91

package/dist/sol/dex/jup/recurring.js

@@ -1,320 +0,0 @@
-/**
- * Jupiter Recurring API (定投/定期订单)
- * @module sol/dex/jup/recurring
- *
- * Recurring API 提供定投/DCA (Dollar Cost Averaging) 功能
- * 用户可以创建定期自动执行的订单
- */
-import { jupGet, jupPost } from './client.js';
-// ============================================================================
-// Create Order - 创建定投订单
-// ============================================================================
-/**
- * 创建定投订单（时间模式）
- *
- * 按固定时间间隔自动执行的定投订单。
- *
- * @param params 创建订单参数
- * @param config Jupiter 配置
- * @returns 创建订单响应
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * // 创建定投：每天用 1 SOL 买入 USDC，共10天
- * const result = await Sol.createRecurringOrder({
- *   user: wallet.publicKey.toBase58(),
- *   inputMint: 'So11111111111111111111111111111111111111112',  // SOL
- *   outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
- *   params: {
- *     time: {
- *       inAmount: 1_000_000_000,  // 1 SOL
- *       numberOfOrders: 10,       // 10次
- *       interval: 86400,          // 每天 (86400秒)
- *     }
- *   }
- * })
- *
- * // 签名并执行
- * const tx = VersionedTransaction.deserialize(
- *   Buffer.from(result.transaction, 'base64')
- * )
- * tx.sign([wallet])
- *
- * await Sol.executeRecurringOrder({
- *   requestId: result.requestId,
- *   signedTransaction: Buffer.from(tx.serialize()).toString('base64'),
- * })
- * ```
- */
-export async function createRecurringOrder(params, config) {
-    return jupPost('/recurring/v1/createOrder', params, config);
-}
-/**
- * 创建简单定投订单（时间模式）
- *
- * @param user 用户地址
- * @param inputMint 输入代币 Mint
- * @param outputMint 输出代币 Mint
- * @param inAmount 每次投入数量 (最小单位)
- * @param numberOfOrders 订单次数
- * @param intervalSeconds 间隔时间 (秒)
- * @param options 可选参数
- * @param config Jupiter 配置
- * @returns 创建订单响应
- *
- * @example
- * ```typescript
- * // 每天定投 1 SOL 买 USDC，共30天
- * const result = await Sol.createSimpleRecurringOrder(
- *   wallet.publicKey.toBase58(),
- *   'So11111111111111111111111111111111111111112',  // SOL
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
- *   1_000_000_000,  // 1 SOL
- *   30,             // 30次
- *   86400,          // 每天
- * )
- * ```
- */
-export async function createSimpleRecurringOrder(user, inputMint, outputMint, inAmount, numberOfOrders, intervalSeconds, options, config) {
-    return createRecurringOrder({
-        user,
-        inputMint,
-        outputMint,
-        params: {
-            time: {
-                inAmount,
-                numberOfOrders,
-                interval: intervalSeconds,
-                maxPrice: options?.maxPrice,
-                minPrice: options?.minPrice,
-                startAt: options?.startAt,
-            }
-        }
-    }, config);
-}
-// ============================================================================
-// 便捷的时间间隔常量
-// ============================================================================
-/** 预设时间间隔 (秒) */
-export const RECURRING_INTERVALS = {
-    /** 每分钟 */
-    MINUTE: 60,
-    /** 每小时 */
-    HOUR: 3600,
-    /** 每天 */
-    DAY: 86400,
-    /** 每周 */
-    WEEK: 604800,
-    /** 每月 (30天) */
-    MONTH: 2592000,
-};
-/**
- * 创建每日定投
- */
-export async function createDailyRecurring(user, inputMint, outputMint, inAmount, days, config) {
-    return createSimpleRecurringOrder(user, inputMint, outputMint, inAmount, days, RECURRING_INTERVALS.DAY, undefined, config);
-}
-/**
- * 创建每周定投
- */
-export async function createWeeklyRecurring(user, inputMint, outputMint, inAmount, weeks, config) {
-    return createSimpleRecurringOrder(user, inputMint, outputMint, inAmount, weeks, RECURRING_INTERVALS.WEEK, undefined, config);
-}
-// ============================================================================
-// Cancel Order - 取消订单
-// ============================================================================
-/**
- * 取消定投订单
- *
- * @param params 取消参数
- * @param config Jupiter 配置
- * @returns 取消订单响应
- *
- * @example
- * ```typescript
- * const result = await Sol.cancelRecurringOrder({
- *   user: wallet.publicKey.toBase58(),
- *   order: 'orderAccountAddress',
- *   recurringType: 'time',
- * })
- *
- * // 签名并执行
- * const tx = VersionedTransaction.deserialize(
- *   Buffer.from(result.transaction, 'base64')
- * )
- * tx.sign([wallet])
- *
- * await Sol.executeRecurringOrder({
- *   requestId: result.requestId,
- *   signedTransaction: Buffer.from(tx.serialize()).toString('base64'),
- * })
- * ```
- */
-export async function cancelRecurringOrder(params, config) {
-    return jupPost('/recurring/v1/cancelOrder', params, config);
-}
-/**
- * 快捷取消时间模式定投订单
- *
- * @param user 用户地址
- * @param order 订单账户地址
- * @param config Jupiter 配置
- * @returns 取消订单响应
- */
-export async function cancelTimeRecurringOrder(user, order, config) {
-    return cancelRecurringOrder({
-        user,
-        order,
-        recurringType: 'time',
-    }, config);
-}
-// ============================================================================
-// Execute - 执行交易
-// ============================================================================
-/**
- * 执行已签名的定投订单交易
- *
- * @param params 执行参数
- * @param config Jupiter 配置
- * @returns 执行结果
- */
-export async function executeRecurringOrder(params, config) {
-    return jupPost('/recurring/v1/execute', params, config);
-}
-// ============================================================================
-// Get Orders - 获取订单
-// ============================================================================
-/**
- * 获取用户的定投订单
- *
- * @param params 查询参数
- * @param config Jupiter 配置
- * @returns 订单列表响应（含分页）
- *
- * @example
- * ```typescript
- * const response = await Sol.getRecurringOrders({
- *   user: wallet.publicKey.toBase58(),
- *   recurringType: 'time',
- *   orderStatus: 'active',
- *   page: 1,
- * })
- *
- * console.log(`共 ${response.totalPages} 页`)
- * response.time?.forEach(order => {
- *   console.log(`订单: ${order.orderKey}`)
- *   console.log(`  每周期: ${order.inAmountPerCycle}`)
- *   console.log(`  已用: ${order.inUsed}`)
- *   console.log(`  已收: ${order.outReceived}`)
- *   console.log(`  交易数: ${order.trades.length}`)
- * })
- * ```
- */
-export async function getRecurringOrders(params, config) {
-    const queryParams = {
-        user: params.user,
-        recurringType: params.recurringType,
-        orderStatus: params.orderStatus,
-    };
-    if (params.page)
-        queryParams.page = params.page;
-    if (params.mint)
-        queryParams.mint = params.mint;
-    if (params.includeFailedTx !== undefined) {
-        queryParams.includeFailedTx = params.includeFailedTx;
-    }
-    return jupGet('/recurring/v1/getRecurringOrders', queryParams, config);
-}
-/**
- * 获取用户的活跃时间模式定投订单
- *
- * @param user 用户地址
- * @param page 页码
- * @param config Jupiter 配置
- * @returns 订单列表响应
- */
-export async function getActiveTimeRecurringOrders(user, page = 1, config) {
-    return getRecurringOrders({
-        user,
-        recurringType: 'time',
-        orderStatus: 'active',
-        page,
-    }, config);
-}
-/**
- * 获取用户的历史时间模式定投订单
- *
- * @param user 用户地址
- * @param page 页码
- * @param config Jupiter 配置
- * @returns 订单列表响应
- */
-export async function getHistoryTimeRecurringOrders(user, page = 1, config) {
-    return getRecurringOrders({
-        user,
-        recurringType: 'time',
-        orderStatus: 'history',
-        page,
-    }, config);
-}
-/**
- * 获取所有活跃时间模式定投订单（自动分页）
- *
- * @param user 用户地址
- * @param config Jupiter 配置
- * @returns 所有活跃订单
- */
-export async function getAllActiveTimeRecurringOrders(user, config) {
-    const allOrders = [];
-    let page = 1;
-    while (true) {
-        const response = await getActiveTimeRecurringOrders(user, page, config);
-        if (response.time) {
-            allOrders.push(...response.time);
-        }
-        if (page >= response.totalPages)
-            break;
-        page++;
-    }
-    return allOrders;
-}
-// ============================================================================
-// 便捷方法
-// ============================================================================
-/**
- * 计算定投总投入
- *
- * @param inAmount 每次投入数量
- * @param numberOfOrders 订单次数
- * @returns 总投入数量
- */
-export function calculateTotalInvestment(inAmount, numberOfOrders) {
-    return inAmount * numberOfOrders;
-}
-/**
- * 计算定投周期
- *
- * @param intervalSeconds 间隔时间 (秒)
- * @param numberOfOrders 订单次数
- * @returns 总持续时间 (秒)
- */
-export function calculateTotalDuration(intervalSeconds, numberOfOrders) {
-    return intervalSeconds * (numberOfOrders - 1);
-}
-/**
- * 估算定投结束时间
- *
- * @param intervalSeconds 间隔时间 (秒)
- * @param numberOfOrders 订单次数
- * @param startAt 开始时间 (Unix 时间戳，默认为当前时间)
- * @returns 结束时间 (Date)
- */
-export function estimateEndDate(intervalSeconds, numberOfOrders, startAt) {
-    const start = startAt || Math.floor(Date.now() / 1000);
-    const duration = calculateTotalDuration(intervalSeconds, numberOfOrders);
-    return new Date((start + duration) * 1000);
-}

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

@@ -1,282 +0,0 @@
-/**
- * Jupiter Send API V1
- * @module sol/dex/jup/send
- *
- * Send API 提供代币发送邀请链接功能
- * 允许创建邀请链接让他人领取代币
- */
-import type { JupiterConfig } from './types.js';
-/** 创建发送请求参数 */
-export interface CraftSendParams {
-    /**
-     * 邀请签名者公钥（从邀请码哈希生成）
-     * 注意：邀请码需要在客户端生成，请安全保管
-     */
-    inviteSigner: string;
-    /** 发送者公钥地址 */
-    sender: string;
-    /** 发送金额（原子单位，如 1 USDC = 1000000） */
-    amount: string;
-    /** 代币 Mint 地址（默认 WSOL） */
-    mint?: string;
-}
-/** 创建发送响应 */
-export interface CraftSendResponse {
-    /** Base64 编码的未签名交易 */
-    tx: string;
-    /** 邀请过期时间 (Unix 时间戳) */
-    expiry: string;
-    /** 总费用 (lamports) */
-    totalFeeLamports: string;
-}
-/** 撤回请求参数 */
-export interface CraftClawbackParams {
-    /**
-     * 邀请 PDA 地址
-     * 通过 "invite" 和邀请签名者公钥派生
-     */
-    invitePDA: string;
-    /** 发送者公钥地址（将接收撤回的资金） */
-    sender: string;
-}
-/** 撤回响应 */
-export interface CraftClawbackResponse {
-    /** Base64 编码的未签名交易 */
-    tx: string;
-}
-/** 邀请信息 */
-export interface SendInvite {
-    /** 邀请签名者公钥 */
-    invite_signer: string;
-    /** 邀请 PDA 地址 */
-    invite_pda: string;
-    /** 发送者地址 */
-    sender: string;
-    /** 过期时间 */
-    expiry: string;
-    /** 金额 */
-    amount: string;
-    /** 创建交易签名 */
-    creation_tx: string;
-    /** 删除交易签名 */
-    deletion_tx: string;
-    /** 接收者地址 */
-    receiver: string;
-    /** 操作类型 */
-    action: string;
-    /** 创建时间 */
-    creation_time: string;
-    /** 删除时间 */
-    deletion_time: string;
-    /** 代币 Mint */
-    mint: string;
-    /** 确认数 */
-    confirmed: number;
-}
-/** 邀请列表响应 */
-export interface InviteListResponse {
-    /** 邀请列表 */
-    invites: SendInvite[];
-    /** 是否有更多数据 */
-    hasMoreData: boolean;
-}
-/**
- * 创建发送邀请交易
- *
- * 创建一个邀请链接，让他人可以领取指定数量的代币。
- *
- * @param params 创建参数
- * @param config Jupiter 配置
- * @returns 创建响应
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- * import { Keypair } from '@solana/web3.js'
- * import crypto from 'crypto'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * // 生成邀请码（客户端生成，安全保管）
- * const inviteCode = crypto.randomBytes(32).toString('hex')
- * const inviteHash = crypto.createHash('sha256').update(inviteCode).digest()
- * const inviteKeypair = Keypair.fromSeed(inviteHash)
- *
- * // 创建发送邀请
- * const result = await Sol.craftSend({
- *   inviteSigner: inviteKeypair.publicKey.toBase58(),
- *   sender: wallet.publicKey.toBase58(),
- *   amount: '1000000', // 1 USDC
- *   mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
- * })
- *
- * console.log(`过期时间: ${new Date(parseInt(result.expiry) * 1000)}`)
- * console.log(`费用: ${result.totalFeeLamports} lamports`)
- *
- * // 签名交易
- * const tx = VersionedTransaction.deserialize(Buffer.from(result.tx, 'base64'))
- * tx.sign([wallet, inviteKeypair])
- *
- * // 发送交易...
- * // 保存 inviteCode 分享给接收者
- * ```
- */
-export declare function craftSend(params: CraftSendParams, config?: JupiterConfig): Promise<CraftSendResponse>;
-/**
- * 创建 SOL 发送邀请
- *
- * @param inviteSigner 邀请签名者公钥
- * @param sender 发送者地址
- * @param amountLamports SOL 数量 (lamports)
- * @param config Jupiter 配置
- * @returns 创建响应
- */
-export declare function craftSendSol(inviteSigner: string, sender: string, amountLamports: string | number, config?: JupiterConfig): Promise<CraftSendResponse>;
-/**
- * 创建 USDC 发送邀请
- *
- * @param inviteSigner 邀请签名者公钥
- * @param sender 发送者地址
- * @param amountUsdc USDC 数量（原子单位，6位小数）
- * @param config Jupiter 配置
- * @returns 创建响应
- */
-export declare function craftSendUsdc(inviteSigner: string, sender: string, amountUsdc: string | number, config?: JupiterConfig): Promise<CraftSendResponse>;
-/**
- * 撤回/取消邀请
- *
- * 撤回未领取的邀请，资金返还给发送者。
- *
- * @param params 撤回参数
- * @param config Jupiter 配置
- * @returns 撤回响应
- *
- * @example
- * ```typescript
- * // 撤回邀请
- * const result = await Sol.craftClawback({
- *   invitePDA: 'invitePDAAddress...',
- *   sender: wallet.publicKey.toBase58(),
- * })
- *
- * // 签名并发送交易
- * const tx = VersionedTransaction.deserialize(Buffer.from(result.tx, 'base64'))
- * tx.sign([wallet])
- * // 发送交易...
- * ```
- */
-export declare function craftClawback(params: CraftClawbackParams, config?: JupiterConfig): Promise<CraftClawbackResponse>;
-/**
- * 获取待处理的邀请
- *
- * 获取发送者创建的尚未被领取或撤回的邀请。
- *
- * @param address 发送者地址
- * @param page 页码（默认 1）
- * @param config Jupiter 配置
- * @returns 邀请列表响应
- *
- * @example
- * ```typescript
- * const pending = await Sol.getPendingInvites(
- *   wallet.publicKey.toBase58(),
- *   1,
- * )
- *
- * console.log(`待处理邀请: ${pending.invites.length}`)
- * pending.invites.forEach(invite => {
- *   console.log(`金额: ${invite.amount}`)
- *   console.log(`过期: ${new Date(parseInt(invite.expiry) * 1000)}`)
- * })
- * ```
- */
-export declare function getPendingInvites(address: string, page?: number, config?: JupiterConfig): Promise<InviteListResponse>;
-/**
- * 获取所有待处理邀请（自动分页）
- *
- * @param address 发送者地址
- * @param config Jupiter 配置
- * @returns 所有待处理邀请
- */
-export declare function getAllPendingInvites(address: string, config?: JupiterConfig): Promise<SendInvite[]>;
-/**
- * 获取邀请历史
- *
- * 获取地址相关的所有邀请历史（作为发送者或接收者）。
- *
- * @param address 地址（发送者或接收者）
- * @param page 页码（默认 1）
- * @param config Jupiter 配置
- * @returns 邀请列表响应
- *
- * @example
- * ```typescript
- * const history = await Sol.getInviteHistory(
- *   wallet.publicKey.toBase58(),
- *   1,
- * )
- *
- * console.log(`邀请历史: ${history.invites.length}`)
- * history.invites.forEach(invite => {
- *   console.log(`${invite.action}: ${invite.amount}`)
- *   console.log(`  发送者: ${invite.sender}`)
- *   console.log(`  接收者: ${invite.receiver}`)
- * })
- * ```
- */
-export declare function getInviteHistory(address: string, page?: number, config?: JupiterConfig): Promise<InviteListResponse>;
-/**
- * 获取所有邀请历史（自动分页）
- *
- * @param address 地址
- * @param config Jupiter 配置
- * @returns 所有邀请历史
- */
-export declare function getAllInviteHistory(address: string, config?: JupiterConfig): Promise<SendInvite[]>;
-/**
- * 获取待处理邀请总金额
- *
- * @param address 发送者地址
- * @param config Jupiter 配置
- * @returns 总金额（按 mint 分组）
- */
-export declare function getPendingInvitesTotal(address: string, config?: JupiterConfig): Promise<Map<string, bigint>>;
-/**
- * 获取即将过期的邀请
- *
- * @param address 发送者地址
- * @param withinHours 在多少小时内过期（默认 24）
- * @param config Jupiter 配置
- * @returns 即将过期的邀请
- */
-export declare function getExpiringInvites(address: string, withinHours?: number, config?: JupiterConfig): Promise<SendInvite[]>;
-/**
- * 检查邀请是否已过期
- *
- * @param invite 邀请信息
- * @returns 是否已过期
- */
-export declare function isInviteExpired(invite: SendInvite): boolean;
-/**
- * 获取邀请剩余时间（秒）
- *
- * @param invite 邀请信息
- * @returns 剩余秒数（已过期返回 0）
- */
-export declare function getInviteTimeRemaining(invite: SendInvite): number;
-/**
- * 筛选发送的邀请
- *
- * @param invites 邀请列表
- * @param sender 发送者地址
- * @returns 发送的邀请
- */
-export declare function filterSentInvites(invites: SendInvite[], sender: string): SendInvite[];
-/**
- * 筛选接收的邀请
- *
- * @param invites 邀请列表
- * @param receiver 接收者地址
- * @returns 接收的邀请
- */
-export declare function filterReceivedInvites(invites: SendInvite[], receiver: string): SendInvite[];