@k256/sdk 0.1.6 → 0.2.0

package/dist/ws/index.d.ts

@@ -1,9 +1,12 @@
+import { BlockStats, BlockMiniStats, TrendDirection } from '../types/index.js';
+
 /**
  * WebSocket message types and interfaces
  *
  * Message type constants MUST match the K2 server values.
  * See: https://github.com/k256-xyz for protocol documentation
  */
+
 /**
  * WebSocket message type constants
  *
@@ -39,6 +42,8 @@ declare const MessageType: {
     readonly Heartbeat: 13;
     /** Batched pool updates for high throughput */
     readonly PoolUpdateBatch: 14;
+    /** Block-level statistics (v3) */
+    readonly BlockStats: 15;
     /** Error message (UTF-8 string) */
     readonly Error: 255;
 };
@@ -68,37 +73,59 @@ interface PoolUpdateMessage {
     };
 }
 /**
- * Decoded priority fees from binary message
+ * Decoded fee market from binary message (per-writable-account model)
  *
- * All fields from K2 PriorityFeesWire
+ * All fields from K2 FeeMarketWire
  */
-interface PriorityFeesMessage {
-    type: 'priority_fees';
+interface FeeMarketMessage {
+    type: 'fee_market';
     data: {
         slot: number;
         timestampMs: number;
-        /** Recommended priority fee in micro-lamports */
+        /** Recommended priority fee in microlamports/CU (max p75 across hottest accounts) */
         recommended: number;
         /** Fee state: 0=low, 1=normal, 2=high, 3=extreme */
         state: number;
         /** True if data is stale (no recent samples) */
         isStale: boolean;
-        swapP50: number;
-        swapP75: number;
-        swapP90: number;
-        swapP99: number;
-        /** Number of samples used for swap percentiles */
-        swapSamples: number;
-        landingP50Fee: number;
-        landingP75Fee: number;
-        landingP90Fee: number;
-        landingP99Fee: number;
-        top10Fee: number;
-        top25Fee: number;
-        spikeDetected: boolean;
-        spikeFee: number;
+        /** Block utilization percentage (0-100) */
+        blockUtilizationPct: number;
+        /** Number of blocks in the observation window */
+        blocksInWindow: number;
+        /** Per-writable-account fee data */
+        accounts: {
+            /** Account public key (Base58) */
+            pubkey: string;
+            /** Total transactions touching this account */
+            totalTxs: number;
+            /** Active slots for this account */
+            activeSlots: number;
+            /** Total CU consumed */
+            cuConsumed: number;
+            /** Utilization percentage (0-100) of 12M CU limit */
+            utilizationPct: number;
+            /** Fee percentiles in microlamports/CU */
+            p25: number;
+            p50: number;
+            p75: number;
+            p90: number;
+            /** Minimum non-zero fee observed */
+            minNonzeroPrice: number;
+        }[];
+        /** Recent block mini-stats (v3) */
+        recentBlocks: BlockMiniStats[];
+        /** Fee trend direction (v3) */
+        trend: TrendDirection;
     };
 }
+/**
+ * Decoded block stats from binary message (v3)
+ */
+interface BlockStatsMessage {
+    type: 'block_stats';
+    data: BlockStats;
+    receivedAt: number;
+}
 /**
  * Decoded blockhash from binary message
  */
@@ -204,7 +231,7 @@ interface PongMessage {
 /**
  * Union of all decoded message types
  */
-type DecodedMessage = PoolUpdateMessage | PriorityFeesMessage | BlockhashMessage | QuoteMessage | HeartbeatMessage | SubscribedMessage | QuoteSubscribedMessage | ErrorMessage | PongMessage;
+type DecodedMessage = PoolUpdateMessage | FeeMarketMessage | BlockStatsMessage | BlockhashMessage | QuoteMessage | HeartbeatMessage | SubscribedMessage | QuoteSubscribedMessage | ErrorMessage | PongMessage;
 
 /**
  * K256 WebSocket Client
@@ -342,10 +369,12 @@ interface K256WebSocketClientConfig {
     onPoolUpdate?: (update: PoolUpdateMessage) => void;
     /** Called on batched pool updates (for efficiency) */
     onPoolUpdateBatch?: (updates: PoolUpdateMessage[]) => void;
-    /** Called on priority fees update */
-    onPriorityFees?: (data: DecodedMessage & {
-        type: 'priority_fees';
+    /** Called on fee market update (per-writable-account fees) */
+    onFeeMarket?: (data: DecodedMessage & {
+        type: 'fee_market';
     }) => void;
+    /** Called on block stats update (v3) */
+    onBlockStats?: (message: BlockStatsMessage) => void;
     /** Called on blockhash update */
     onBlockhash?: (data: DecodedMessage & {
         type: 'blockhash';
@@ -512,4 +541,4 @@ declare function decodeMessage(data: ArrayBuffer): DecodedMessage | null;
  */
 declare function decodePoolUpdateBatch(payload: ArrayBuffer): PoolUpdateMessage[];
 
-export { type BlockhashMessage, CloseCode, type CloseCodeValue, type ConnectionState, type DecodedMessage, type ErrorMessage, type HeartbeatMessage, type K256ErrorCode, K256WebSocketClient, type K256WebSocketClientConfig, K256WebSocketError, MessageType, type MessageTypeValue, type PongMessage, type PoolUpdateMessage, type PriorityFeesMessage, type QuoteMessage, type QuoteSubscribedMessage, type SubscribeOptions, type SubscribeQuoteOptions, type SubscribedMessage, decodeMessage, decodePoolUpdateBatch };
+export { type BlockStatsMessage, type BlockhashMessage, CloseCode, type CloseCodeValue, type ConnectionState, type DecodedMessage, type ErrorMessage, type FeeMarketMessage, type HeartbeatMessage, type K256ErrorCode, K256WebSocketClient, type K256WebSocketClientConfig, K256WebSocketError, MessageType, type MessageTypeValue, type PongMessage, type PoolUpdateMessage, type QuoteMessage, type QuoteSubscribedMessage, type SubscribeOptions, type SubscribeQuoteOptions, type SubscribedMessage, decodeMessage, decodePoolUpdateBatch };

package/dist/ws/index.js

@@ -51,6 +51,8 @@ var MessageType = {
   Heartbeat: 13,
   /** Batched pool updates for high throughput */
   PoolUpdateBatch: 14,
+  /** Block-level statistics (v3) */
+  BlockStats: 15,
   /** Error message (UTF-8 string) */
   Error: 255
 };
@@ -91,55 +93,75 @@ function decodeMessage(data) {
       return { type: "error", data: { message: text } };
     }
     case MessageType.PriorityFees: {
-      if (payload.byteLength < 24) return null;
+      if (payload.byteLength < 42) return null;
       const slot = Number(payloadView.getBigUint64(0, true));
       const timestampMs = Number(payloadView.getBigUint64(8, true));
       const recommended = Number(payloadView.getBigUint64(16, true));
-      const state = payload.byteLength > 24 ? payloadView.getUint8(24) : 1;
-      const isStale = payload.byteLength > 25 ? payloadView.getUint8(25) !== 0 : false;
-      let swapP50 = 0, swapP75 = 0, swapP90 = 0, swapP99 = 0;
-      if (payload.byteLength >= 58) {
-        swapP50 = Number(payloadView.getBigUint64(26, true));
-        swapP75 = Number(payloadView.getBigUint64(34, true));
-        swapP90 = Number(payloadView.getBigUint64(42, true));
-        swapP99 = Number(payloadView.getBigUint64(50, true));
+      const state = payloadView.getUint8(24);
+      const isStale = payloadView.getUint8(25) !== 0;
+      const blockUtilizationPct = payloadView.getFloat32(26, true);
+      const blocksInWindow = payloadView.getUint32(30, true);
+      const accountCount = Number(payloadView.getBigUint64(34, true));
+      const accounts = [];
+      let offset = 42;
+      for (let i = 0; i < accountCount && offset + 92 <= payload.byteLength; i++) {
+        const pubkeyBytes = new Uint8Array(payload, offset, 32);
+        const pubkey = base58Encode(pubkeyBytes);
+        const totalTxs = payloadView.getUint32(offset + 32, true);
+        const activeSlots = payloadView.getUint32(offset + 36, true);
+        const cuConsumed = Number(payloadView.getBigUint64(offset + 40, true));
+        const utilizationPct = payloadView.getFloat32(offset + 48, true);
+        const p25 = Number(payloadView.getBigUint64(offset + 52, true));
+        const p50 = Number(payloadView.getBigUint64(offset + 60, true));
+        const p75 = Number(payloadView.getBigUint64(offset + 68, true));
+        const p90 = Number(payloadView.getBigUint64(offset + 76, true));
+        const minNonzeroPrice = Number(payloadView.getBigUint64(offset + 84, true));
+        accounts.push({
+          pubkey,
+          totalTxs,
+          activeSlots,
+          cuConsumed,
+          utilizationPct,
+          p25,
+          p50,
+          p75,
+          p90,
+          minNonzeroPrice
+        });
+        offset += 92;
       }
-      let swapSamples = 0;
-      let landingP50Fee = 0, landingP75Fee = 0, landingP90Fee = 0, landingP99Fee = 0;
-      let top10Fee = 0, top25Fee = 0;
-      let spikeDetected = false, spikeFee = 0;
-      if (payload.byteLength >= 119) {
-        swapSamples = payloadView.getUint32(58, true);
-        landingP50Fee = Number(payloadView.getBigUint64(62, true));
-        landingP75Fee = Number(payloadView.getBigUint64(70, true));
-        landingP90Fee = Number(payloadView.getBigUint64(78, true));
-        landingP99Fee = Number(payloadView.getBigUint64(86, true));
-        top10Fee = Number(payloadView.getBigUint64(94, true));
-        top25Fee = Number(payloadView.getBigUint64(102, true));
-        spikeDetected = payloadView.getUint8(110) !== 0;
-        spikeFee = Number(payloadView.getBigUint64(111, true));
+      const recentBlocksCount = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const recentBlocks = [];
+      for (let i = 0; i < recentBlocksCount; i++) {
+        const rbSlot = Number(payloadView.getBigUint64(offset, true));
+        offset += 8;
+        const rbCuConsumed = Number(payloadView.getBigUint64(offset, true));
+        offset += 8;
+        const rbTxCount = payloadView.getUint32(offset, true);
+        offset += 4;
+        const rbUtilizationPct = payloadView.getFloat32(offset, true);
+        offset += 4;
+        const rbAvgCuPrice = Number(payloadView.getBigUint64(offset, true));
+        offset += 8;
+        recentBlocks.push({ slot: rbSlot, cuConsumed: rbCuConsumed, txCount: rbTxCount, utilizationPct: rbUtilizationPct, avgCuPrice: rbAvgCuPrice });
       }
+      const trendByte = payloadView.getUint8(offset);
+      offset += 1;
+      const trend = trendByte === 0 ? "rising" : trendByte === 1 ? "falling" : "stable";
       return {
-        type: "priority_fees",
+        type: "fee_market",
         data: {
           slot,
           timestampMs,
           recommended,
           state,
           isStale,
-          swapP50,
-          swapP75,
-          swapP90,
-          swapP99,
-          swapSamples,
-          landingP50Fee,
-          landingP75Fee,
-          landingP90Fee,
-          landingP99Fee,
-          top10Fee,
-          top25Fee,
-          spikeDetected,
-          spikeFee
+          blockUtilizationPct,
+          blocksInWindow,
+          accounts,
+          recentBlocks,
+          trend
         }
       };
     }
@@ -184,6 +206,51 @@ function decodeMessage(data) {
         }
       };
     }
+    case MessageType.BlockStats: {
+      let offset = 0;
+      const slot = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const cuConsumed = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const executionCu = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const cuLimit = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const cuRemaining = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const utilizationPct = payloadView.getFloat32(offset, true);
+      offset += 4;
+      const txCount = payloadView.getUint32(offset, true);
+      offset += 4;
+      const avgCuPerTx = payloadView.getUint32(offset, true);
+      offset += 4;
+      const avgCuPrice = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const minCuPrice = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const maxCuPrice = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      const timestampMs = Number(payloadView.getBigUint64(offset, true));
+      offset += 8;
+      return {
+        type: "block_stats",
+        data: {
+          slot,
+          cuConsumed,
+          executionCu,
+          cuLimit,
+          cuRemaining,
+          utilizationPct,
+          txCount,
+          avgCuPerTx,
+          avgCuPrice,
+          minCuPrice,
+          maxCuPrice,
+          timestampMs
+        },
+        receivedAt: Date.now()
+      };
+    }
     default:
       return null;
   }
@@ -265,19 +332,7 @@ function decodePoolUpdate(payload, payloadView) {
       }
     };
   } catch {
-    return {
-      type: "pool_update",
-      data: {
-        sequence: 0,
-        slot: 0,
-        writeVersion: 0,
-        protocol: "unknown",
-        poolAddress: "",
-        tokenMints: [],
-        tokenBalances: [],
-        tokenDecimals: []
-      }
-    };
+    return null;
   }
 }
 function decodeQuote(payload, payloadView) {
@@ -348,25 +403,7 @@ function decodeQuote(payload, payloadView) {
       }
     };
   } catch {
-    return {
-      type: "quote",
-      data: {
-        topicId: "",
-        timestampMs: 0,
-        sequence: 0,
-        inputMint: "",
-        outputMint: "",
-        inAmount: "0",
-        outAmount: "0",
-        priceImpactBps: 0,
-        contextSlot: 0,
-        algorithm: "",
-        isImprovement: false,
-        isCached: false,
-        isStale: false,
-        routePlan: null
-      }
-    };
+    return null;
   }
 }
 
@@ -668,8 +705,11 @@ var K256WebSocketClient = class {
         case "pool_update":
           this.config.onPoolUpdate?.(decoded);
           break;
-        case "priority_fees":
-          this.config.onPriorityFees?.(decoded);
+        case "fee_market":
+          this.config.onFeeMarket?.(decoded);
+          break;
+        case "block_stats":
+          this.config.onBlockStats?.(decoded);
           break;
         case "blockhash":
           this.config.onBlockhash?.(decoded);