fema-pf-calc 1.0.5 → 1.0.7

package/README.md

@@ -62,12 +62,12 @@ That is all a developer needs to do. No RPC key, no math, no guessing.
 
 ```ts
 const result = await estimateFee({
-  speed: "fast",            // "slow" | "medium" | "fast"
-  strategy: "balanced",     // "cheap" | "balanced" | "aggressive"
-  protocol: "jupiter",      // see supported protocols below
+  speed: "fast",              // "slow" | "medium" | "fast"
+  strategy: "balanced",       // "cheap" | "balanced" | "aggressive"
+  protocol: "jupiter",        // see supported protocols below
   transaction: myTransaction, // pass your actual tx for automatic protocol detection
-  maxFee: 500_000,          // optional cap in microLamports
-  includeStats: true,       // include full distribution in response
+  maxFee: 500_000,            // optional cap in microLamports
+  includeStats: true,         // include full distribution in response
 });
 ```
 
@@ -138,11 +138,11 @@ const { fee } = await estimateFee({
 
 ```ts
 {
-  fee: 253637,              // microLamports per CU — pass directly to setComputeUnitPrice
-  congestion: "high",       // "low" | "medium" | "high"
-  percentileUsed: 75,       // which percentile was used
-  sampleSize: 1203,         // number of transactions analyzed
-  programFiltered: true,    // true = fee is based on your protocol's txs specifically
+  fee: 253637,           // microLamports per CU — pass directly to setComputeUnitPrice
+  congestion: "high",    // "low" | "medium" | "high"
+  percentileUsed: 75,    // which percentile was used
+  sampleSize: 1203,      // number of transactions analyzed
+  programFiltered: true, // true = fee is based on your protocol's txs specifically
 
   // only included when includeStats: true
   stats: {
@@ -169,44 +169,44 @@ The `fee` value is in **microLamports per compute unit** — the exact unit that
 
 ```ts
 init({
-  cluster: "mainnet-beta",      // "mainnet-beta" | "devnet" (default: "mainnet-beta")
-  rpcUrl: "https://your-rpc.com", // optional — bring your own RPC to override the default
-  cacheDurationMs: 7000,        // how long to cache results in ms (default: 7000)
+  cluster: "mainnet-beta", // "mainnet-beta" | "devnet" (default: "mainnet-beta")
+  cacheDurationMs: 7000,   // how long to cache results in ms (default: 7000)
 });
 ```
 
-You can also override the RPC via environment variables:
+---
 
-```env
-# Optional: use your own RPC provider (overrides the built-in default)
-SOLANA_RPC_URL=https://your-custom-rpc.com
+## Sample Code
 
-# Or use your own Helius API key
-HELIUS_API_KEY=your-api-key-here
+```ts
+import express from "express";
+import { init, estimateFee } from "fema-pf-calc";
+import { ComputeBudgetProgram } from "@solana/web3.js";
 
-# Network: mainnet-beta (default) or devnet
-SOLANA_CLUSTER=mainnet-beta
+const app = express();
 
-# How long to cache fee data in milliseconds (default: 7000)
-CACHE_DURATION_MS=7000
-```
+init({ cluster: "mainnet-beta" }); // no RPC setup needed
 
----
+app.get("/fee", async (req, res) => {
+  try {
+    const { fee } = await estimateFee({ speed: "fast", strategy: "balanced" });
 
-## Project Structure
+    const priorityIx = ComputeBudgetProgram.setComputeUnitPrice({
+      microLamports: fee,
+    });
 
-```
-src/
-├── index.ts              # SDK entry point — estimateFee() and init()
-├── types.ts              # TypeScript types and interfaces
-├── config.ts             # Configuration and RPC resolution
-├── protocols.ts          # Known protocol registry (Jupiter, Raydium, etc.)
-├── engine/
-│   └── feeCalculator.ts  # Percentile math, strategy modifiers, outlier filtering
-└── services/
-    ├── solana.ts         # RPC data fetching and block scanning
-    ├── cache.ts          # In-memory TTL cache
-    └── database.ts       # In-memory snapshot store and fallback
+    res.json({ fee, priorityIx });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.listen(8000, () => {
+  console.log("Server is running on port http://localhost:8000");
+});
+
+export default app;
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fema-pf-calc",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Intelligent Solana priority fee estimation engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",