@k256/sdk 0.3.2 → 0.5.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { BlockStatsMessage, BlockhashMessage, CloseCode, CloseCodeValue, ConnectionState, DecodedMessage, ErrorMessage, FeeMarketMessage, HeartbeatMessage, K256ErrorCode, K256WebSocketClient, K256WebSocketClientConfig, K256WebSocketError, MessageType, MessageTypeValue, PongMessage, PoolUpdateMessage, QuoteMessage, QuoteSubscribedMessage, SubscribeOptions, SubscribeQuoteOptions, SubscribedMessage, decodeMessage, decodePoolUpdateBatch } from './ws/index.cjs';
+export { BlockStatsMessage, BlockhashMessage, CloseCode, CloseCodeValue, ConnectionState, DecodedMessage, ErrorMessage, FeeMarketMessage, HeartbeatMessage, K256ErrorCode, K256WebSocketClient, K256WebSocketClientConfig, K256WebSocketError, MessageType, MessageTypeValue, PongMessage, PoolUpdateMessage, PriceBatchMessage, PriceEntry, PriceSnapshotMessage, PriceUpdateMessage, QuoteMessage, QuoteSubscribedMessage, SubscribeOptions, SubscribePriceOptions, SubscribeQuoteOptions, SubscribedMessage, decodeMessage, decodePoolUpdateBatch, decodePriceEntries } from './ws/index.cjs';
 export { ALL_LEADER_CHANNELS, GossipDiffMessage, GossipPeer, GossipSnapshotMessage, IpChangeMessage, LeaderChannel, LeaderChannelValue, ConnectionState as LeaderConnectionState, LeaderDecodedMessage, LeaderErrorCode, LeaderErrorMessage, LeaderHeartbeatMessage, LeaderMessageTag, LeaderScheduleMessage, LeaderSubscribedMessage, LeaderWebSocketClient, LeaderWebSocketClientConfig, LeaderWebSocketError, MessageKind, MessageSchemaEntry, RoutingHealthMessage, SkipEventMessage, SlotUpdateMessage, decodeLeaderMessage } from './leader-ws/index.cjs';
 export { AccountFee, BlockMiniStats, BlockStats, Blockhash, FeeMarket, Heartbeat, NetworkState, OrderLevel, Pool, PoolUpdate, Quote, RoutePlanStep, SubscribeQuoteRequest, SubscribeRequest, Token, TrendDirection } from './types/index.cjs';
 export { base58Decode, base58Encode, isValidPubkey } from './utils/index.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { BlockStatsMessage, BlockhashMessage, CloseCode, CloseCodeValue, ConnectionState, DecodedMessage, ErrorMessage, FeeMarketMessage, HeartbeatMessage, K256ErrorCode, K256WebSocketClient, K256WebSocketClientConfig, K256WebSocketError, MessageType, MessageTypeValue, PongMessage, PoolUpdateMessage, QuoteMessage, QuoteSubscribedMessage, SubscribeOptions, SubscribeQuoteOptions, SubscribedMessage, decodeMessage, decodePoolUpdateBatch } from './ws/index.js';
+export { BlockStatsMessage, BlockhashMessage, CloseCode, CloseCodeValue, ConnectionState, DecodedMessage, ErrorMessage, FeeMarketMessage, HeartbeatMessage, K256ErrorCode, K256WebSocketClient, K256WebSocketClientConfig, K256WebSocketError, MessageType, MessageTypeValue, PongMessage, PoolUpdateMessage, PriceBatchMessage, PriceEntry, PriceSnapshotMessage, PriceUpdateMessage, QuoteMessage, QuoteSubscribedMessage, SubscribeOptions, SubscribePriceOptions, SubscribeQuoteOptions, SubscribedMessage, decodeMessage, decodePoolUpdateBatch, decodePriceEntries } from './ws/index.js';
 export { ALL_LEADER_CHANNELS, GossipDiffMessage, GossipPeer, GossipSnapshotMessage, IpChangeMessage, LeaderChannel, LeaderChannelValue, ConnectionState as LeaderConnectionState, LeaderDecodedMessage, LeaderErrorCode, LeaderErrorMessage, LeaderHeartbeatMessage, LeaderMessageTag, LeaderScheduleMessage, LeaderSubscribedMessage, LeaderWebSocketClient, LeaderWebSocketClientConfig, LeaderWebSocketError, MessageKind, MessageSchemaEntry, RoutingHealthMessage, SkipEventMessage, SlotUpdateMessage, decodeLeaderMessage } from './leader-ws/index.js';
 export { AccountFee, BlockMiniStats, BlockStats, Blockhash, FeeMarket, Heartbeat, NetworkState, OrderLevel, Pool, PoolUpdate, Quote, RoutePlanStep, SubscribeQuoteRequest, SubscribeRequest, Token, TrendDirection } from './types/index.js';
 export { base58Decode, base58Encode, isValidPubkey } from './utils/index.js';

package/dist/index.js

@@ -109,6 +109,16 @@ var MessageType = {
   PoolUpdateBatch: 14,
   /** Block-level statistics (v3) */
   BlockStats: 15,
+  /** Subscribe to price updates (JSON) - Client → Server */
+  SubscribePrice: 16,
+  /** Single price update (bincode 56B) - Server → Client */
+  PriceUpdate: 17,
+  /** Batched price updates (bincode [u16 count][entries...]) - Server → Client */
+  PriceBatch: 18,
+  /** Initial price snapshot (same binary format as PriceBatch) - Server → Client */
+  PriceSnapshot: 19,
+  /** Unsubscribe from prices (no payload) - Client → Server */
+  UnsubscribePrice: 20,
   /** Error message (UTF-8 string) */
   Error: 255
 };
@@ -307,10 +317,48 @@ function decodeMessage(data) {
         receivedAt: Date.now()
       };
     }
+    case MessageType.PriceUpdate: {
+      if (payload.byteLength < 56) return null;
+      const mintBytes = new Uint8Array(payload, 0, 32);
+      return {
+        type: "price_update",
+        data: {
+          mint: base58Encode(mintBytes),
+          usdPrice: Number(payloadView.getBigUint64(32, true)) / 1e12,
+          slot: Number(payloadView.getBigUint64(40, true)),
+          timestampMs: Number(payloadView.getBigUint64(48, true))
+        }
+      };
+    }
+    case MessageType.PriceBatch:
+    case MessageType.PriceSnapshot: {
+      if (payload.byteLength < 2) return null;
+      const entries = decodePriceEntries(payload);
+      const priceType = msgType === MessageType.PriceSnapshot ? "price_snapshot" : "price_batch";
+      return { type: priceType, data: entries };
+    }
     default:
       return null;
   }
 }
+function decodePriceEntries(payload) {
+  const view = new DataView(payload);
+  if (payload.byteLength < 2) return [];
+  const count = view.getUint16(0, true);
+  const entries = [];
+  let offset = 2;
+  for (let i = 0; i < count && offset + 56 <= payload.byteLength; i++) {
+    const mintBytes = new Uint8Array(payload, offset, 32);
+    entries.push({
+      mint: base58Encode(mintBytes),
+      usdPrice: Number(view.getBigUint64(offset + 32, true)) / 1e12,
+      slot: Number(view.getBigUint64(offset + 40, true)),
+      timestampMs: Number(view.getBigUint64(offset + 48, true))
+    });
+    offset += 56;
+  }
+  return entries;
+}
 function decodePoolUpdateBatch(payload) {
   const view = new DataView(payload);
   if (payload.byteLength < 2) return [];
@@ -533,6 +581,7 @@ var K256WebSocketClient = class {
   lastHeartbeatTime = 0;
   pendingSubscription = null;
   pendingQuoteSubscription = null;
+  pendingPriceSubscription = null;
   isIntentionallyClosed = false;
   /** Current connection state */
   get state() {
@@ -622,12 +671,33 @@ var K256WebSocketClient = class {
     const msg = JSON.stringify({ type: "unsubscribe_quote", topicId });
     this.ws?.send(msg);
   }
+  /**
+   * Subscribe to real-time price updates
+   * @param options - Token mints and threshold configuration
+   */
+  subscribePrices(options) {
+    this.pendingPriceSubscription = options;
+    if (!this.isConnected) {
+      return;
+    }
+    this.sendPriceSubscription(options);
+  }
+  /**
+   * Unsubscribe from price updates
+   */
+  unsubscribePrices() {
+    this.pendingPriceSubscription = null;
+    if (!this.isConnected) return;
+    const buf = new Uint8Array([MessageType.UnsubscribePrice]);
+    this.ws?.send(buf);
+  }
   /**
    * Unsubscribe from all channels
    */
   unsubscribe() {
     this.pendingSubscription = null;
     this.pendingQuoteSubscription = null;
+    this.pendingPriceSubscription = null;
     if (!this.isConnected) return;
     this.ws?.send(JSON.stringify({ type: "unsubscribe" }));
   }
@@ -678,6 +748,9 @@ var K256WebSocketClient = class {
           if (this.pendingQuoteSubscription) {
             this.sendQuoteSubscription(this.pendingQuoteSubscription);
           }
+          if (this.pendingPriceSubscription) {
+            this.sendPriceSubscription(this.pendingPriceSubscription);
+          }
           this.config.onConnect?.();
           resolve();
         };
@@ -777,6 +850,21 @@ var K256WebSocketClient = class {
         case "quote_subscribed":
           this.config.onQuoteSubscribed?.(decoded);
           break;
+        case "price_update":
+          this.config.onPriceUpdate?.(decoded);
+          break;
+        case "price_batch":
+          this.config.onPriceBatch?.(decoded);
+          for (const entry of decoded.data) {
+            this.config.onPriceUpdate?.({ type: "price_update", data: entry });
+          }
+          break;
+        case "price_snapshot":
+          this.config.onPriceSnapshot?.(decoded);
+          for (const entry of decoded.data) {
+            this.config.onPriceUpdate?.({ type: "price_update", data: entry });
+          }
+          break;
         case "heartbeat":
           this.lastHeartbeatTime = Date.now();
           this.resetHeartbeatTimeout();
@@ -837,6 +925,18 @@ var K256WebSocketClient = class {
     };
     this.ws?.send(JSON.stringify(msg));
   }
+  sendPriceSubscription(options) {
+    const json = JSON.stringify({
+      tokens: options.tokens,
+      thresholdBps: options.thresholdBps ?? 10
+    });
+    const encoder = new TextEncoder();
+    const jsonBytes = encoder.encode(json);
+    const buf = new Uint8Array(1 + jsonBytes.length);
+    buf[0] = MessageType.SubscribePrice;
+    buf.set(jsonBytes, 1);
+    this.ws?.send(buf);
+  }
   setState(state) {
     if (this._state !== state) {
       const prevState = this._state;
@@ -1007,6 +1107,11 @@ function readU16(view, o) {
   o.v += 2;
   return val;
 }
+function readF64(view, o) {
+  const val = view.getFloat64(o.v, true);
+  o.v += 8;
+  return val;
+}
 function readU8(view, o) {
   const val = view.getUint8(o.v);
   o.v += 1;
@@ -1065,12 +1170,16 @@ function readGossipPeer(view, data, o) {
     lastVote: readU64(view, o),
     rootSlot: readU64(view, o),
     wallclock: readU64(view, o),
-    // Geo/ASN enrichment from IPinfo Lite MMDB (server-side)
+    // Geo/ASN enrichment from MaxMind GeoLite2 (server-side)
     countryCode: readVecU8AsString(view, data, o),
     continentCode: readVecU8AsString(view, data, o),
     asn: readVecU8AsString(view, data, o),
     asName: readVecU8AsString(view, data, o),
-    asDomain: readVecU8AsString(view, data, o)
+    city: readVecU8AsString(view, data, o),
+    region: readVecU8AsString(view, data, o),
+    latitude: readF64(view, o),
+    longitude: readF64(view, o),
+    timezone: readVecU8AsString(view, data, o)
   };
 }
 function readGossipPeerVec(view, data, o) {
@@ -1486,6 +1595,6 @@ var NetworkState = /* @__PURE__ */ ((NetworkState2) => {
   return NetworkState2;
 })(NetworkState || {});
 
-export { ALL_LEADER_CHANNELS, CloseCode, K256WebSocketClient, K256WebSocketError, LeaderChannel, LeaderMessageTag, LeaderWebSocketClient, LeaderWebSocketError, MessageType, NetworkState, base58Decode, base58Encode, decodeLeaderMessage, decodeMessage, decodePoolUpdateBatch, isValidPubkey };
+export { ALL_LEADER_CHANNELS, CloseCode, K256WebSocketClient, K256WebSocketError, LeaderChannel, LeaderMessageTag, LeaderWebSocketClient, LeaderWebSocketError, MessageType, NetworkState, base58Decode, base58Encode, decodeLeaderMessage, decodeMessage, decodePoolUpdateBatch, decodePriceEntries, isValidPubkey };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map