@k256/sdk 0.1.7 → 0.2.1

package/src/ws/decoder.ts

@@ -8,6 +8,7 @@
  */
 
 import { base58Encode } from '../utils/base58';
+import type { BlockMiniStats, TrendDirection } from '../types';
 import { MessageType, type DecodedMessage, type PoolUpdateMessage, type FeeMarketMessage } from './types';
 
 /**
@@ -116,11 +117,33 @@ export function decodeMessage(data: ArrayBuffer): DecodedMessage | null {
         offset += 92;
       }
 
+      // Decode recent_blocks (Vec<BlockMiniStats>) — v3
+      // Guard: need at least 8 bytes for count + 1 byte for trend after
+      const recentBlocksCount = offset + 8 <= payload.byteLength
+        ? Number(payloadView.getBigUint64(offset, true))
+        : 0;
+      offset += 8;
+      const recentBlocks: BlockMiniStats[] = [];
+      for (let i = 0; i < recentBlocksCount && offset + 32 <= payload.byteLength; 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 });
+      }
+
+      // Decode trend (u8) — v3
+      const trendByte = offset < payload.byteLength ? payloadView.getUint8(offset) : 2;
+      offset += 1;
+      const trend: TrendDirection = trendByte === 0 ? 'rising' : trendByte === 1 ? 'falling' : 'stable';
+
       return {
         type: 'fee_market',
         data: {
           slot, timestampMs, recommended, state, isStale,
           blockUtilizationPct, blocksInWindow, accounts,
+          recentBlocks, trend,
         },
       } as FeeMarketMessage;
     }
@@ -180,6 +203,35 @@ export function decodeMessage(data: ArrayBuffer): DecodedMessage | null {
       };
     }
 
+    case MessageType.BlockStats: {
+      // BlockStats (0x0F) — v3
+      // Layout: slot(u64) + cu_consumed(u64) + execution_cu(u64) + cu_limit(u64) + cu_remaining(u64)
+      //       + utilization_pct(f32) + tx_count(u32) + avg_cu_per_tx(u32) + avg_cu_price(u64)
+      //       + min_cu_price(u64) + max_cu_price(u64) + timestamp_ms(u64)
+      let offset = 0; // payload already has type byte stripped
+      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;
   }

package/src/ws/index.ts

@@ -45,6 +45,7 @@ export type {
   DecodedMessage,
   PoolUpdateMessage,
   FeeMarketMessage,
+  BlockStatsMessage,
   BlockhashMessage,
   QuoteMessage,
   HeartbeatMessage,

package/src/ws/types.ts

@@ -5,6 +5,8 @@
  * See: https://github.com/k256-xyz for protocol documentation
  */
 
+import type { BlockMiniStats, TrendDirection, BlockStats } from '../types';
+
 /**
  * WebSocket message type constants
  * 
@@ -40,6 +42,8 @@ export const MessageType = {
   Heartbeat: 0x0d,
   /** Batched pool updates for high throughput */
   PoolUpdateBatch: 0x0e,
+  /** Block-level statistics (v3) */
+  BlockStats: 0x0f,
   /** Error message (UTF-8 string) */
   Error: 0xff,
 } as const;
@@ -105,9 +109,22 @@ export interface FeeMarketMessage {
       /** 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)
+ */
+export interface BlockStatsMessage {
+  type: 'block_stats';
+  data: BlockStats;
+  receivedAt: number;
+}
+
 /**
  * Decoded blockhash from binary message
  */
@@ -223,6 +240,7 @@ export interface PongMessage {
 export type DecodedMessage =
   | PoolUpdateMessage
   | FeeMarketMessage
+  | BlockStatsMessage
   | BlockhashMessage
   | QuoteMessage
   | HeartbeatMessage