solana-priority-fee 1.0.0 → 1.1.0

package/fee.js

@@ -0,0 +1,36 @@
+const { Connection, PublicKey } = require('@solana/web3.js');
+const { SolanaFeeEstimator } = require('solana-priority-fee');
+
+const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=af5cb288-41c0-4728-a606-fee9e27909ea');
+
+// Hot DeFi accounts
+const HOT_ACCOUNTS = [
+  new PublicKey('675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8'), // Raydium
+  new PublicKey('JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4'),  // Jupiter
+  new PublicKey('whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc'),  // Orca
+];
+
+// Convert to SOL (assuming 200k compute units)
+function toSol(microlamports) {
+  return (microlamports * 200000) / 1_000_000 / 1_000_000_000;
+}
+
+async function main() {
+  console.log('Solana Priority Fees\n');
+
+  const estimator = new SolanaFeeEstimator(connection);
+  const fees = await estimator.getAllFees(HOT_ACCOUNTS);
+
+  console.log('┌──────────┬─────────────────┐');
+  console.log('│ Level    │ Fee (SOL)       │');
+  console.log('├──────────┼─────────────────┤');
+  console.log(`│ Economy  │ ${toSol(fees.economy).toFixed(9)} │`);
+  console.log(`│ Medium   │ ${toSol(fees.medium).toFixed(9)} │`);
+  console.log(`│ Fast     │ ${toSol(fees.fast).toFixed(9)} │`);
+  console.log(`│ Urgent   │ ${toSol(fees.urgent).toFixed(9)} │`);
+  console.log('└──────────┴─────────────────┘');
+
+  console.log(`\nBased on ${fees.raw.samples} recent transactions`);
+}
+
+main().catch(console.error);

package/index.js

@@ -1,22 +1,20 @@
-const { Connection } = require('@solana/web3.js');
+const { Connection, PublicKey } = require('@solana/web3.js');
 
 /**
- * SolanaFeeEstimator - Priority fee estimation with caching and monitoring
+ * SolanaFeeEstimator - Priority fee + Jito tip estimation
  */
 class SolanaFeeEstimator {
   constructor(connection, options = {}) {
     this.connection = connection;
     
-    // Configuration
     this.config = {
-      cacheMs: options.cacheMs ?? 5000,           // Cache duration
-      sampleSize: options.sampleSize ?? 150,       // Recent slots to analyze
-      minFee: options.minFee ?? 1000,              // Minimum fee (microlamports)
-      maxFee: options.maxFee ?? 10_000_000,        // Maximum fee cap
+      cacheMs: options.cacheMs ?? 5000,
+      minFee: options.minFee ?? 1000,
+      maxFee: options.maxFee ?? 10_000_000,
+      jitoEndpoint: options.jitoEndpoint ?? 'https://bundles.jito.wtf/api/v1/bundles/tip_floor',
       ...options
     };
     
-    // Percentiles for each level
     this.levels = {
       economy: 0.25,
       medium: 0.50,
@@ -24,22 +22,21 @@ class SolanaFeeEstimator {
       urgent: 0.95
     };
     
-    // Cache
     this.cache = {
       global: null,
       accounts: new Map(),
-      lastUpdate: 0
+      jito: null,
+      lastUpdate: 0,
+      jitoLastUpdate: 0
     };
     
-    // Stats tracking
     this.stats = {
       requests: 0,
       cacheHits: 0,
-      estimates: [],  // { level, fee, timestamp }
-      confirmed: [],  // { level, fee, landed, timestamp }
+      estimates: [],
+      confirmed: [],
     };
     
-    // WebSocket subscription
     this.subscription = null;
     this.realtimeFees = [];
   }
@@ -56,7 +53,6 @@ class SolanaFeeEstimator {
     
     this.stats.requests++;
     
-    // Check cache
     const cacheKey = accountKeys.length > 0 
       ? accountKeys.sort().join(',') 
       : 'global';
@@ -66,13 +62,11 @@ class SolanaFeeEstimator {
       return this._calculateFee(this._getCachedFees(cacheKey), level);
     }
     
-    // Fetch fresh data
     const fees = await this._fetchFees(accountKeys);
     this._updateCache(cacheKey, fees);
     
     const estimate = this._calculateFee(fees, level);
     
-    // Track estimate
     this.stats.estimates.push({
       level,
       fee: estimate,
@@ -102,6 +96,122 @@ class SolanaFeeEstimator {
     };
   }
 
+  /**
+   * Get Jito tip recommendations (the real cost for fast landing)
+   */
+  async getJitoTips() {
+    const now = Date.now();
+    
+    // Check cache
+    if (this.cache.jito && (now - this.cache.jitoLastUpdate) < this.config.cacheMs) {
+      return this.cache.jito;
+    }
+    
+    try {
+      const response = await fetch(this.config.jitoEndpoint);
+      const data = await response.json();
+      
+      // Jito returns tips in lamports
+      const tips = {
+        landed_tips_25th_percentile: data[0]?.landed_tips_25th_percentile ?? 0,
+        landed_tips_50th_percentile: data[0]?.landed_tips_50th_percentile ?? 0,
+        landed_tips_75th_percentile: data[0]?.landed_tips_75th_percentile ?? 0,
+        landed_tips_95th_percentile: data[0]?.landed_tips_95th_percentile ?? 0,
+        landed_tips_99th_percentile: data[0]?.landed_tips_99th_percentile ?? 0,
+      };
+      
+      const result = {
+        // In SOL
+        economy: tips.landed_tips_25th_percentile / 1_000_000_000,
+        medium: tips.landed_tips_50th_percentile / 1_000_000_000,
+        fast: tips.landed_tips_75th_percentile / 1_000_000_000,
+        urgent: tips.landed_tips_95th_percentile / 1_000_000_000,
+        max: tips.landed_tips_99th_percentile / 1_000_000_000,
+        // Raw lamports
+        raw: tips
+      };
+      
+      this.cache.jito = result;
+      this.cache.jitoLastUpdate = now;
+      
+      return result;
+    } catch (error) {
+      console.error('Failed to fetch Jito tips:', error.message);
+      // Return defaults if API fails
+      return {
+        economy: 0.0001,
+        medium: 0.001,
+        fast: 0.01,
+        urgent: 0.05,
+        max: 0.1,
+        raw: null,
+        error: error.message
+      };
+    }
+  }
+
+  /**
+   * Get total landing cost (priority fee + Jito tip)
+   */
+  async getTotalLandingCost(options = {}) {
+    const {
+      level = 'medium',
+      accountKeys = [],
+      computeUnits = 200000
+    } = options;
+    
+    const [priorityFees, jitoTips] = await Promise.all([
+      this.getAllFees(accountKeys),
+      this.getJitoTips()
+    ]);
+    
+    // Convert priority fee to SOL
+    const priorityFeeSol = (priorityFees[level] * computeUnits) / 1_000_000 / 1_000_000_000;
+    const jitoTipSol = jitoTips[level];
+    
+    return {
+      priorityFee: priorityFeeSol,
+      jitoTip: jitoTipSol,
+      total: priorityFeeSol + jitoTipSol,
+      breakdown: {
+        priorityFee: `${priorityFeeSol.toFixed(9)} SOL`,
+        jitoTip: `${jitoTipSol.toFixed(9)} SOL`,
+        total: `${(priorityFeeSol + jitoTipSol).toFixed(9)} SOL`
+      }
+    };
+  }
+
+  /**
+   * Get all costs for all levels
+   */
+  async getAllCosts(accountKeys = [], computeUnits = 200000) {
+    const [priorityFees, jitoTips] = await Promise.all([
+      this.getAllFees(accountKeys),
+      this.getJitoTips()
+    ]);
+    
+    const levels = ['economy', 'medium', 'fast', 'urgent'];
+    const result = {};
+    
+    for (const level of levels) {
+      const priorityFeeSol = (priorityFees[level] * computeUnits) / 1_000_000 / 1_000_000_000;
+      const jitoTipSol = jitoTips[level];
+      
+      result[level] = {
+        priorityFee: priorityFeeSol,
+        jitoTip: jitoTipSol,
+        total: priorityFeeSol + jitoTipSol
+      };
+    }
+    
+    result.raw = {
+      priorityFees: priorityFees.raw,
+      jitoTips: jitoTips.raw
+    };
+    
+    return result;
+  }
+
   /**
    * Start real-time monitoring via WebSocket
    */
@@ -111,7 +221,6 @@ class SolanaFeeEstimator {
       return;
     }
     
-    // Subscribe to slot changes
     this.subscription = this.connection.onSlotChange(async (slotInfo) => {
       try {
         const fees = await this._fetchFees([]);
@@ -127,7 +236,6 @@ class SolanaFeeEstimator {
         
         this.realtimeFees.push(allFees);
         
-        // Keep last 100 samples
         if (this.realtimeFees.length > 100) {
           this.realtimeFees.shift();
         }
@@ -163,7 +271,6 @@ class SolanaFeeEstimator {
       timestamp: Date.now()
     });
     
-    // Keep last 1000 results
     if (this.stats.confirmed.length > 1000) {
       this.stats.confirmed.shift();
     }
@@ -288,7 +395,6 @@ class SolanaFeeEstimator {
     } else {
       this.cache.accounts.set(key, { fees, timestamp: now });
       
-      // Limit account cache size
       if (this.cache.accounts.size > 100) {
         const oldest = [...this.cache.accounts.entries()]
           .sort((a, b) => a[1].timestamp - b[1].timestamp)[0];
@@ -306,6 +412,15 @@ async function getPriorityFee(connection, level = 'medium', accountKeys = []) {
   return estimator.getFee({ level, accountKeys });
 }
 
+/**
+ * Get Jito tips quickly
+ */
+async function getJitoTip(level = 'medium') {
+  const estimator = new SolanaFeeEstimator(null);
+  const tips = await estimator.getJitoTips();
+  return tips[level];
+}
+
 /**
  * Create compute budget instruction with estimated fee
  */
@@ -322,5 +437,6 @@ async function createPriorityFeeInstruction(connection, level = 'medium', accoun
 module.exports = {
   SolanaFeeEstimator,
   getPriorityFee,
+  getJitoTip,
   createPriorityFeeInstruction
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-priority-fee",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Priority fee estimation for Solana with caching, monitoring, and success tracking",
   "main": "src/index.js",
   "scripts": {
@@ -16,6 +16,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@solana/web3.js": "^1.98.4"
+    "@solana/web3.js": "^1.98.4",
+    "solana-priority-fee": "^1.0.0"
   }
 }