pinpet-sdk 2.0.1 → 2.0.3

package/dist/index.d copy.ts

@@ -22,8 +22,6 @@ export interface PinPetSdkOptions {
   fee_recipient?: string;
   base_fee_recipient?: string;
   params_account?: string;
-  debug_log_path?: string;
-  debugLogPath?: string;
 }
 
 // ========================= 订单和交易相关类型 =========================
@@ -258,8 +256,7 @@ export declare class PinPetSdk {
   baseFeeRecipient: PublicKey;
   paramsAccount: PublicKey;
   spinFastApiUrl: string;
-  debugLogPath: string | null;
-  
+
   // 常量
   readonly MAX_ORDERS_COUNT: number;
   readonly FIND_MAX_ORDERS_COUNT: number;

package/dist/index.d.ts

@@ -22,7 +22,6 @@ export interface PinPetSdkOptions {
   feeRecipient?: string;
   baseFeeRecipient?: string;
   paramsAccount?: string;
-  debugLogPath?: string;
 }
 
 // ========================= 订单和交易相关类型 =========================
@@ -257,8 +256,7 @@ export declare class PinPetSdk {
   baseFeeRecipient: PublicKey;
   paramsAccount: PublicKey;
   pinPetFastApiUrl: string;
-  debugLogPath: string | null;
-  
+
   // 常量
   readonly MAX_ORDERS_COUNT: number;
   readonly FIND_MAX_ORDERS_COUNT: number;

package/dist/pinpet-sdk.cjs.js

@@ -15632,17 +15632,7 @@ const { Buffer: Buffer$5 } = require$$3__default["default"];
 const { MAX_CANDIDATE_INDICES: MAX_CANDIDATE_INDICES$2 } = utils$2;
 
 // 环境检测和条件加载
-const IS_NODE$1 = typeof process !== 'undefined' && process.versions && process.versions.node;
-
-let fs$2, path$2;
-if (IS_NODE$1) {
-  try {
-    fs$2 = require('fs');
-    path$2 = require('path');
-  } catch (e) {
-    console.warn('File system modules not available in trading module');
-  }
-}
+typeof process !== 'undefined' && process.versions && process.versions.node;
 
 /**
  * Trading Module
@@ -16442,30 +16432,6 @@ class TradingModule$1 {
     };
   }
 
-
-
-  // ========== Debug File Management Methods ==========
-
-  /**
-   * 安全地写入调试日志
-   * Safely write debug log
-   * @private
-   * @param {string} fileName - 文件名
-   * @param {string} content - 内容
-   */
-  _writeDebugLog(fileName, content) {
-    if (!IS_NODE$1 || !this.sdk.debugLogPath || typeof this.sdk.debugLogPath !== 'string' || !fs$2 || !path$2) {
-      return; // 浏览器环境或文件系统不可用时直接返回
-    }
-    
-    try {
-      const fullPath = path$2.join(this.sdk.debugLogPath, fileName);
-      fs$2.appendFileSync(fullPath, content);
-    } catch (error) {
-      console.warn(`Warning: Failed to write debug log to ${fileName}:`, error.message);
-    }
-  }
-
   // ========== PDA Calculation Methods ==========
 
   /**
@@ -29526,11 +29492,11 @@ var populate$1 = function (dst, src) {
 
 var CombinedStream = combined_stream;
 var util$1 = require$$1__default$1["default"];
-var path$1 = require$$1__default["default"];
+var path = require$$1__default["default"];
 var http$2 = require$$3__default$1["default"];
 var https$2 = require$$4__default["default"];
 var parseUrl$2 = require$$0__default$5["default"].parse;
-var fs$1 = require$$0__default$1["default"];
+var fs = require$$0__default$1["default"];
 var Stream = require$$0__default$4["default"].Stream;
 var crypto$2 = require$$8__default["default"];
 var mime = mimeTypes;
@@ -29657,7 +29623,7 @@ FormData$2.prototype._lengthRetriever = function (value, callback) {
       // not that fast snoopy
     } else {
       // still need to fetch file size from fs
-      fs$1.stat(value.path, function (err, stat) {
+      fs.stat(value.path, function (err, stat) {
         if (err) {
           callback(err);
           return;
@@ -29744,17 +29710,17 @@ FormData$2.prototype._getContentDisposition = function (value, options) { // esl
 
   if (typeof options.filepath === 'string') {
     // custom filepath for relative paths
-    filename = path$1.normalize(options.filepath).replace(/\\/g, '/');
+    filename = path.normalize(options.filepath).replace(/\\/g, '/');
   } else if (options.filename || (value && (value.name || value.path))) {
     /*
      * custom filename take precedence
      * formidable and the browser add a name property
      * fs- and request- streams have path property
      */
-    filename = path$1.basename(options.filename || (value && (value.name || value.path)));
+    filename = path.basename(options.filename || (value && (value.name || value.path)));
   } else if (value && value.readable && hasOwn(value, 'httpVersion')) {
     // or try http response
-    filename = path$1.basename(value.client._httpMessage.path || '');
+    filename = path.basename(value.client._httpMessage.path || '');
   }
 
   if (filename) {
@@ -48811,6 +48777,154 @@ class ToolsModule$1 {
       }
     };
   }
+
+  /**
+   * Validate cooldown PDA approval_token_amount matches user's current token balance
+   *
+   * Use Cases:
+   * - Before trading, verify if the cooldown PDA is in sync with user's token balance
+   * - Check if user needs to call approveTrade after receiving tokens
+   * - Validate cooldown state for security checks
+   *
+   * @param {Object} params - Parameters
+   * @param {PublicKey|string} params.mint - Token mint address
+   * @param {Keypair|Object} params.wallet - User wallet (can be Keypair or object with publicKey)
+   * @param {anchor.BN|number|string} [params.tokenBalance] - Optional: user's current token balance, if not provided will fetch from chain
+   * @returns {Promise<Object>} Validation result with detailed info
+   *
+   * @example
+   * // Auto-fetch token balance from chain
+   * const result = await sdk.tools.validateCooldown({
+   *   mint: 'xxxxx',
+   *   wallet: userKeypair
+   * });
+   *
+   * // Provide token balance manually
+   * const result = await sdk.tools.validateCooldown({
+   *   mint: 'xxxxx',
+   *   wallet: userKeypair,
+   *   tokenBalance: new anchor.BN('1000000')
+   * });
+   *
+   * console.log(result.isValid); // true/false
+   * console.log(result.cooldownInfo.approvalTokenAmount);
+   * console.log(result.tokenBalance);
+   */
+  async validateCooldown(params) {
+    const { mint, wallet, tokenBalance } = params;
+
+    // Validate parameters
+    if (!mint) {
+      throw new Error('mint parameter is required');
+    }
+    if (!wallet) {
+      throw new Error('wallet parameter is required');
+    }
+
+    // Convert mint to PublicKey
+    const mintPubkey = typeof mint === 'string' ? new PublicKey$2(mint) : mint;
+    const walletPubkey = wallet.publicKey || wallet;
+
+    // Calculate user token account
+    const userTokenAccount = await getAssociatedTokenAddress(
+      mintPubkey,
+      walletPubkey
+    );
+
+    // Calculate trade cooldown PDA
+    const [cooldown] = PublicKey$2.findProgramAddressSync(
+      [
+        Buffer.from('trade_cooldown'),
+        mintPubkey.toBuffer(),
+        walletPubkey.toBuffer()
+      ],
+      this.sdk.programId
+    );
+
+    // Get cooldown account data
+    const cooldownAccountInfo = await this.sdk.connection.getAccountInfo(cooldown);
+    if (!cooldownAccountInfo) {
+      // Cooldown PDA does not exist, return status without throwing error
+      return {
+        isValid: false,
+        exists: false,
+        reason: 'COOLDOWN_NOT_EXISTS',
+        message: 'Cooldown PDA does not exist. User has never traded this token or needs to call approveTrade first.',
+        cooldownInfo: null,
+        tokenBalance: null,
+        accounts: {
+          mintAccount: mintPubkey,
+          userTokenAccount: userTokenAccount,
+          cooldown: cooldown,
+          wallet: walletPubkey,
+        }
+      };
+    }
+
+    const accountsCoder = new anchor$1.BorshAccountsCoder(this.sdk.program.idl);
+    let cooldownAccountData;
+    try {
+      cooldownAccountData = accountsCoder.decode('TradeCooldown', cooldownAccountInfo.data);
+    } catch (e1) {
+      try {
+        cooldownAccountData = accountsCoder.decode('tradeCooldown', cooldownAccountInfo.data);
+      } catch (e2) {
+        throw new Error(`Cannot decode cooldown account: ${e1.message}`);
+      }
+    }
+
+    // Get user's current token balance
+    let currentTokenBalance;
+    if (tokenBalance !== undefined && tokenBalance !== null) {
+      // Use provided token balance
+      if (anchor$1.BN.isBN(tokenBalance)) {
+        currentTokenBalance = tokenBalance;
+      } else {
+        currentTokenBalance = new anchor$1.BN(tokenBalance.toString());
+      }
+    } else {
+      // Fetch token balance from chain
+      const userTokenAccountInfo = await this.sdk.connection.getAccountInfo(userTokenAccount);
+      if (!userTokenAccountInfo) {
+        throw new Error(`User token account does not exist for mint: ${mint} and wallet: ${walletPubkey.toString()}`);
+      }
+
+      try {
+        // Fetch SPL token account balance
+        const tokenAccountInfo = await this.sdk.connection.getTokenAccountBalance(userTokenAccount);
+        currentTokenBalance = new anchor$1.BN(tokenAccountInfo.value.amount);
+      } catch (e) {
+        throw new Error(`Cannot fetch token balance: ${e.message}`);
+      }
+    }
+
+    // Compare approval_token_amount with current token balance
+    // Valid if approval_token_amount >= current token balance
+    const approvalTokenAmount = new anchor$1.BN(cooldownAccountData.approvalTokenAmount.toString());
+    const isValid = approvalTokenAmount.gte(currentTokenBalance);
+
+    // Return result
+    return {
+      isValid,
+      exists: true,
+      reason: isValid ? 'VALID' : 'AMOUNT_MISMATCH',
+      message: isValid
+        ? 'Cooldown validation passed. approval_token_amount >= token_balance'
+        : 'Cooldown validation failed. approval_token_amount < token_balance. User needs to call approveTrade.',
+      cooldownInfo: {
+        approvalTokenAmount: cooldownAccountData.approvalTokenAmount,
+        lastTradeTime: cooldownAccountData.lastTradeTime,
+        bump: cooldownAccountData.bump,
+      },
+      tokenBalance: currentTokenBalance,
+      accounts: {
+        mintAccount: mintPubkey,
+        userTokenAccount: userTokenAccount,
+        cooldown: cooldown,
+        wallet: walletPubkey,
+      }
+    };
+  }
 }
 
 var tools = ToolsModule$1;
@@ -52876,22 +52990,13 @@ const { PublicKey: PublicKey$1 } = require$$0__default["default"];
 const { Buffer: Buffer$1 } = require$$3__default["default"];
 
 // 环境检测和条件加载
-const IS_NODE = typeof process !== 'undefined' && process.versions && process.versions.node;
+typeof process !== 'undefined' && process.versions && process.versions.node;
 
 // 确保全局可用（兼容现有代码）
 if (typeof commonjsGlobal !== 'undefined' && !commonjsGlobal.Buffer) {
   commonjsGlobal.Buffer = Buffer$1;
 }
 
-let fs, path;
-if (IS_NODE) {
-  try {
-    fs = require('fs');
-    path = require('path'); 
-  } catch (e) {
-    console.warn('File system modules not available');
-  }
-}
 const TradingModule = trading;
 const TokenModule = token;
 const ParamModule = param;
@@ -52949,13 +53054,6 @@ class PinPetSdk$1 {
     // 在流动性不足时, 建议实际使用流动性的比例, 分每 (1000=100%)
     this.SUGGEST_LIQ_RATIO = 975; // 97.5% (1000=100%)
 
-    // 只在 Node.js 环境中启用调试日志
-    this.debugLogPath = IS_NODE && fs ? (this.options.debugLogPath || null) : null;
-    
-    // 初始化调试文件
-    this._initDebugFiles();
-
-
     // Initialize Anchor program
     this.program = this._initProgram(this.options);
     
@@ -53053,52 +53151,6 @@ class PinPetSdk$1 {
     return new anchor.Program(spinpetIdl$1, this.programId);
   }
 
-
-  // ========== Debug File Management Methods ==========
-
-  /**
-   * 初始化调试文件，删除旧文件
-   * Initialize debug files, delete old files
-   * @private
-   */
-  _initDebugFiles() {
-    if (!this.debugLogPath || !IS_NODE || !fs || !path) {
-      return; // 浏览器环境或文件系统不可用
-    }
-
-    try {
-      const files = ['orderPda.txt', 'orderOpen.txt'];
-      files.forEach(file => {
-        const filePath = path.join(this.debugLogPath, file);
-        if (fs.existsSync(filePath)) {
-          fs.unlinkSync(filePath);
-        }
-      });
-    } catch (error) {
-      console.warn('Warning: Failed to initialize debug files:', error.message);
-    }
-  }
-
-  /**
-   * 安全地写入调试日志
-   * Safely write debug log
-   * @private
-   * @param {string} fileName - 文件名
-   * @param {string} content - 内容
-   */
-  _writeDebugLog(fileName, content) {
-    if (!this.debugLogPath || !IS_NODE || !fs || !path) {
-      return; // 静默失败，不报错
-    }
-
-    try {
-      const filePath = path.join(this.debugLogPath, fileName);
-      fs.appendFileSync(filePath, content);
-    } catch (error) {
-      console.warn(`Warning: Failed to write debug log to ${fileName}:`, error.message);
-    }
-  }
-
   // ========== Unified Data Interface Routing Method ==========
 
   /**