@k256/sdk 0.1.6 → 0.2.0

package/README.md

@@ -25,7 +25,7 @@ const client = new K256WebSocketClient({
   
   // Message callbacks
   onPoolUpdate: (update) => console.log('Pool:', update.data.poolAddress),
-  onPriorityFees: (fees) => console.log('Fees:', fees.data.recommended),
+  onFeeMarket: (fees) => console.log('Fees:', fees.data.recommended),
   onBlockhash: (bh) => console.log('Blockhash:', bh.data.blockhash),
   
   // Connection callbacks
@@ -67,7 +67,7 @@ client.disconnect();
 | Type | Description |
 |------|-------------|
 | `pool_update` | DEX pool state change |
-| `priority_fees` | Fee estimates (~400ms updates) |
+| `fee_market` | Per-writable-account fee market (~400ms updates) |
 | `blockhash` | Latest blockhash (~400ms updates) |
 | `quote` | Streaming quote update |
 | `subscribed` | Subscription confirmed |

package/dist/index.cjs

@@ -23,8 +23,15 @@ function base58Encode(bytes) {
   return leadingZeros + digits.reverse().map((d) => BASE58_ALPHABET[d]).join("");
 }
 function base58Decode(str) {
+  if (str.length === 0) {
+    return new Uint8Array(0);
+  }
+  let leadingZeros = 0;
+  for (let i = 0; i < str.length && str[i] === "1"; i++) {
+    leadingZeros++;
+  }
   const bytes = [0];
-  for (let i = 0; i < str.length; i++) {
+  for (let i = leadingZeros; i < str.length; i++) {
     const char = str[i];
     const value = BASE58_ALPHABET.indexOf(char);
     if (value === -1) {
@@ -41,10 +48,19 @@ function base58Decode(str) {
       carry >>= 8;
     }
   }
-  for (let i = 0; i < str.length && str[i] === "1"; i++) {
-    bytes.push(0);
+  bytes.reverse();
+  if (leadingZeros > 0 && bytes.length === 1 && bytes[0] === 0) {
+    return new Uint8Array(leadingZeros);
+  }
+  const startIdx = bytes.length > 1 && bytes[0] === 0 ? 1 : 0;
+  const result = new Uint8Array(leadingZeros + bytes.length - startIdx);
+  for (let i = 0; i < leadingZeros; i++) {
+    result[i] = 0;
   }
-  return new Uint8Array(bytes.reverse());
+  for (let i = startIdx; i < bytes.length; i++) {
+    result[leadingZeros + i - startIdx] = bytes[i];
+  }
+  return result;
 }
 function isValidPubkey(address) {
   if (address.length < 32 || address.length > 44) {
@@ -93,6 +109,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
 };
@@ -133,55 +151,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
         }
       };
     }
@@ -226,6 +264,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;
   }
@@ -307,19 +390,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) {
@@ -390,25 +461,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;
   }
 }
 
@@ -710,8 +763,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);