@k256/sdk 0.1.6 → 0.2.0

package/dist/types/index.d.ts

@@ -100,24 +100,93 @@ interface RoutePlanStep {
     percent: number;
 }
 /**
- * Priority fee estimates
+ * Mini block statistics (compact form used in FeeMarket.recentBlocks)
  */
-interface PriorityFees {
+interface BlockMiniStats {
+    slot: number;
+    cuConsumed: number;
+    txCount: number;
+    utilizationPct: number;
+    avgCuPrice: number;
+}
+/**
+ * Direction of the fee trend
+ */
+type TrendDirection = 'rising' | 'falling' | 'stable';
+/**
+ * Full block-level statistics (standalone message 0x0F)
+ */
+interface BlockStats {
+    slot: number;
+    cuConsumed: number;
+    executionCu: number;
+    cuLimit: number;
+    cuRemaining: number;
+    utilizationPct: number;
+    txCount: number;
+    avgCuPerTx: number;
+    avgCuPrice: number;
+    minCuPrice: number;
+    maxCuPrice: number;
+    timestampMs: number;
+}
+/**
+ * Per-writable-account fee data
+ *
+ * Solana's scheduler limits each writable account to 12M CU per block.
+ * Fee pricing is per-account: the fee you pay should be
+ * max(p75(account) for account in your writable accounts).
+ */
+interface AccountFee {
+    /** Account public key (Base58) */
+    pubkey: string;
+    /** Total transactions touching this account in the window */
+    totalTxs: number;
+    /** Number of slots where this account was active */
+    activeSlots: number;
+    /** Total CU consumed by transactions touching this account */
+    cuConsumed: number;
+    /** Account utilization percentage (0-100) of 12M CU limit */
+    utilizationPct: number;
+    /** 25th percentile fee in microlamports/CU */
+    p25: number;
+    /** 50th percentile fee in microlamports/CU */
+    p50: number;
+    /** 75th percentile fee in microlamports/CU */
+    p75: number;
+    /** 90th percentile fee in microlamports/CU */
+    p90: number;
+    /** Minimum non-zero fee observed */
+    minNonzeroPrice: number;
+}
+/**
+ * Fee market update (per-writable-account model)
+ *
+ * Replaces the old flat PriorityFees struct. Now provides per-account
+ * fee data so clients can price transactions based on the specific
+ * writable accounts they touch.
+ */
+interface FeeMarket {
     /** Current slot */
     slot: number;
     /** Timestamp in milliseconds */
     timestampMs: number;
-    /** Recommended fee in microlamports */
+    /** Recommended fee in microlamports/CU (max p75 across hottest accounts) */
     recommended: number;
-    /** Network state (0=low, 1=normal, 2=high, 3=congested) */
+    /** Network state (0=low, 1=normal, 2=high, 3=extreme) */
     state: NetworkState;
     /** Whether data is stale */
     isStale: boolean;
-    /** Swap fee percentiles */
-    swapP50: number;
-    swapP75: number;
-    swapP90: number;
-    swapP99: number;
+    /** Block utilization percentage (0-100) */
+    blockUtilizationPct: number;
+    /** Number of blocks in the observation window */
+    blocksInWindow: number;
+    /** Per-account fee data */
+    accounts: AccountFee[];
+    /** Recent block mini-stats (v3) */
+    recentBlocks: BlockMiniStats[];
+    /** Fee trend direction (v3) */
+    trend: TrendDirection;
 }
 /**
  * Network congestion state
@@ -197,4 +266,4 @@ interface SubscribeQuoteRequest {
     refreshIntervalMs?: number;
 }
 
-export { type Blockhash, type Heartbeat, NetworkState, type OrderLevel, type Pool, type PoolUpdate, type PriorityFees, type Quote, type RoutePlanStep, type SubscribeQuoteRequest, type SubscribeRequest, type Token };
+export { type AccountFee, type BlockMiniStats, type BlockStats, type Blockhash, type FeeMarket, type Heartbeat, NetworkState, type OrderLevel, type Pool, type PoolUpdate, type Quote, type RoutePlanStep, type SubscribeQuoteRequest, type SubscribeRequest, type Token, type TrendDirection };

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"names":["NetworkState"],"mappings":";AAoIO,IAAK,YAAA,qBAAAA,aAAAA,KAAL;AACL,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,SAAM,CAAA,CAAA,GAAN,KAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,YAAS,CAAA,CAAA,GAAT,QAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,UAAO,CAAA,CAAA,GAAP,MAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,eAAY,CAAA,CAAA,GAAZ,WAAA;AAJU,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\n * Shared type definitions for K256 SDK\n * \n * These types are used across WebSocket and REST API modules.\n * \n * @module @k256/sdk/types\n */\n\n/**\n * Pool state from DEX\n */\nexport interface Pool {\n  /** Pool address (Base58) */\n  address: string;\n  /** Protocol/DEX name */\n  protocol: string;\n  /** Token mints in the pool (Base58) */\n  tokenMints: string[];\n  /** Token balances (as strings for precision) */\n  tokenBalances: string[];\n  /** Token decimals */\n  tokenDecimals: number[];\n}\n\n/**\n * Real-time pool state update\n */\nexport interface PoolUpdate extends Pool {\n  /** Global sequence number (monotonically increasing) */\n  sequence: number;\n  /** Solana slot when updated */\n  slot: number;\n  /** Write version within slot */\n  writeVersion: number;\n  /** Best bid price/size (orderbook pools only) */\n  bestBid?: OrderLevel;\n  /** Best ask price/size (orderbook pools only) */\n  bestAsk?: OrderLevel;\n}\n\n/**\n * Order book level (bid or ask)\n */\nexport interface OrderLevel {\n  /** Price in base units (as string for precision) */\n  price: string;\n  /** Size in base units (as string for precision) */\n  size: string;\n}\n\n/**\n * Token metadata\n */\nexport interface Token {\n  /** Token mint address (Base58) */\n  mint: string;\n  /** Token symbol (e.g., \"SOL\", \"USDC\") */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Decimal places */\n  decimals: number;\n  /** Logo URL (optional) */\n  logoUri?: string;\n  /** Coingecko ID (optional) */\n  coingeckoId?: string;\n}\n\n/**\n * Swap quote from aggregator\n */\nexport interface Quote {\n  /** Input token mint (Base58) */\n  inputMint: string;\n  /** Output token mint (Base58) */\n  outputMint: string;\n  /** Input amount (as string for precision) */\n  inAmount: string;\n  /** Output amount (as string for precision) */\n  outAmount: string;\n  /** Price impact in basis points */\n  priceImpactBps: number;\n  /** Slippage in basis points */\n  slippageBps: number;\n  /** Route plan (DEXes used) */\n  routePlan: RoutePlanStep[];\n  /** Context slot */\n  contextSlot: number;\n  /** Algorithm used for routing */\n  algorithm: string;\n}\n\n/**\n * Step in a swap route\n */\nexport interface RoutePlanStep {\n  /** DEX/protocol name */\n  protocol: string;\n  /** Pool address (Base58) */\n  poolAddress: string;\n  /** Input mint for this step */\n  inputMint: string;\n  /** Output mint for this step */\n  outputMint: string;\n  /** Percentage of input for this step (0-100) */\n  percent: number;\n}\n\n/**\n * Priority fee estimates\n */\nexport interface PriorityFees {\n  /** Current slot */\n  slot: number;\n  /** Timestamp in milliseconds */\n  timestampMs: number;\n  /** Recommended fee in microlamports */\n  recommended: number;\n  /** Network state (0=low, 1=normal, 2=high, 3=congested) */\n  state: NetworkState;\n  /** Whether data is stale */\n  isStale: boolean;\n  /** Swap fee percentiles */\n  swapP50: number;\n  swapP75: number;\n  swapP90: number;\n  swapP99: number;\n}\n\n/**\n * Network congestion state\n */\nexport enum NetworkState {\n  Low = 0,\n  Normal = 1,\n  High = 2,\n  Congested = 3,\n}\n\n/**\n * Recent blockhash for transactions\n */\nexport interface Blockhash {\n  /** Slot of blockhash */\n  slot: number;\n  /** Timestamp in milliseconds */\n  timestampMs: number;\n  /** Recent blockhash (Base58) */\n  blockhash: string;\n  /** Block height */\n  blockHeight: number;\n  /** Last valid block height for transactions */\n  lastValidBlockHeight: number;\n  /** Whether data is stale */\n  isStale: boolean;\n}\n\n/**\n * WebSocket connection heartbeat\n */\nexport interface Heartbeat {\n  /** Server timestamp in milliseconds */\n  timestampMs: number;\n  /** Connection uptime in seconds */\n  uptimeSecs: number;\n  /** Total messages sent */\n  messagesSent: number;\n  /** Pool updates sent */\n  poolUpdatesSent: number;\n  /** Messages dropped (slow client) */\n  messagesDropped: number;\n  /** Whether pool updates are enabled */\n  poolUpdatesEnabled: boolean;\n  /** Subscribed channels */\n  subscribedChannels: string[];\n  /** Server sequence number */\n  serverSequence: number;\n}\n\n/**\n * Subscribe request for WebSocket\n */\nexport interface SubscribeRequest {\n  /** Channels to subscribe to */\n  channels: ('pools' | 'priority_fees' | 'blockhash')[];\n  /** Response format (default: binary) */\n  format?: 'binary' | 'json';\n  /** Filter by protocol names */\n  protocols?: string[];\n  /** Filter by pool addresses (Base58) */\n  pools?: string[];\n  /** Filter by token pairs [[mintA, mintB], ...] */\n  tokenPairs?: [string, string][];\n}\n\n/**\n * Quote subscription request\n */\nexport interface SubscribeQuoteRequest {\n  /** Input token mint (Base58) */\n  inputMint: string;\n  /** Output token mint (Base58) */\n  outputMint: string;\n  /** Amount in base units */\n  amount: number;\n  /** Slippage tolerance in basis points */\n  slippageBps?: number;\n  /** Refresh interval in milliseconds */\n  refreshIntervalMs?: number;\n}\n"]}
+{"version":3,"sources":["../../src/types/index.ts"],"names":["NetworkState"],"mappings":";AA6MO,IAAK,YAAA,qBAAAA,aAAAA,KAAL;AACL,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,SAAM,CAAA,CAAA,GAAN,KAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,YAAS,CAAA,CAAA,GAAT,QAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,UAAO,CAAA,CAAA,GAAP,MAAA;AACA,EAAAA,aAAAA,CAAAA,aAAAA,CAAA,eAAY,CAAA,CAAA,GAAZ,WAAA;AAJU,EAAA,OAAAA,aAAAA;AAAA,CAAA,EAAA,YAAA,IAAA,EAAA","file":"index.js","sourcesContent":["/**\n * Shared type definitions for K256 SDK\n *\n * These types are used across WebSocket and REST API modules.\n *\n * @module @k256/sdk/types\n */\n\n/**\n * Pool state from DEX\n */\nexport interface Pool {\n  /** Pool address (Base58) */\n  address: string;\n  /** Protocol/DEX name */\n  protocol: string;\n  /** Token mints in the pool (Base58) */\n  tokenMints: string[];\n  /** Token balances (as strings for precision) */\n  tokenBalances: string[];\n  /** Token decimals */\n  tokenDecimals: number[];\n}\n\n/**\n * Real-time pool state update\n */\nexport interface PoolUpdate extends Pool {\n  /** Global sequence number (monotonically increasing) */\n  sequence: number;\n  /** Solana slot when updated */\n  slot: number;\n  /** Write version within slot */\n  writeVersion: number;\n  /** Best bid price/size (orderbook pools only) */\n  bestBid?: OrderLevel;\n  /** Best ask price/size (orderbook pools only) */\n  bestAsk?: OrderLevel;\n}\n\n/**\n * Order book level (bid or ask)\n */\nexport interface OrderLevel {\n  /** Price in base units (as string for precision) */\n  price: string;\n  /** Size in base units (as string for precision) */\n  size: string;\n}\n\n/**\n * Token metadata\n */\nexport interface Token {\n  /** Token mint address (Base58) */\n  mint: string;\n  /** Token symbol (e.g., \"SOL\", \"USDC\") */\n  symbol: string;\n  /** Token name */\n  name: string;\n  /** Decimal places */\n  decimals: number;\n  /** Logo URL (optional) */\n  logoUri?: string;\n  /** Coingecko ID (optional) */\n  coingeckoId?: string;\n}\n\n/**\n * Swap quote from aggregator\n */\nexport interface Quote {\n  /** Input token mint (Base58) */\n  inputMint: string;\n  /** Output token mint (Base58) */\n  outputMint: string;\n  /** Input amount (as string for precision) */\n  inAmount: string;\n  /** Output amount (as string for precision) */\n  outAmount: string;\n  /** Price impact in basis points */\n  priceImpactBps: number;\n  /** Slippage in basis points */\n  slippageBps: number;\n  /** Route plan (DEXes used) */\n  routePlan: RoutePlanStep[];\n  /** Context slot */\n  contextSlot: number;\n  /** Algorithm used for routing */\n  algorithm: string;\n}\n\n/**\n * Step in a swap route\n */\nexport interface RoutePlanStep {\n  /** DEX/protocol name */\n  protocol: string;\n  /** Pool address (Base58) */\n  poolAddress: string;\n  /** Input mint for this step */\n  inputMint: string;\n  /** Output mint for this step */\n  outputMint: string;\n  /** Percentage of input for this step (0-100) */\n  percent: number;\n}\n\n/**\n * Mini block statistics (compact form used in FeeMarket.recentBlocks)\n */\nexport interface BlockMiniStats {\n  slot: number\n  cuConsumed: number\n  txCount: number\n  utilizationPct: number\n  avgCuPrice: number\n}\n\n/**\n * Direction of the fee trend\n */\nexport type TrendDirection = 'rising' | 'falling' | 'stable'\n\n/**\n * Full block-level statistics (standalone message 0x0F)\n */\nexport interface BlockStats {\n  slot: number\n  cuConsumed: number\n  executionCu: number\n  cuLimit: number\n  cuRemaining: number\n  utilizationPct: number\n  txCount: number\n  avgCuPerTx: number\n  avgCuPrice: number\n  minCuPrice: number\n  maxCuPrice: number\n  timestampMs: number\n}\n\n/**\n * Per-writable-account fee data\n *\n * Solana's scheduler limits each writable account to 12M CU per block.\n * Fee pricing is per-account: the fee you pay should be\n * max(p75(account) for account in your writable accounts).\n */\nexport interface AccountFee {\n  /** Account public key (Base58) */\n  pubkey: string;\n  /** Total transactions touching this account in the window */\n  totalTxs: number;\n  /** Number of slots where this account was active */\n  activeSlots: number;\n  /** Total CU consumed by transactions touching this account */\n  cuConsumed: number;\n  /** Account utilization percentage (0-100) of 12M CU limit */\n  utilizationPct: number;\n  /** 25th percentile fee in microlamports/CU */\n  p25: number;\n  /** 50th percentile fee in microlamports/CU */\n  p50: number;\n  /** 75th percentile fee in microlamports/CU */\n  p75: number;\n  /** 90th percentile fee in microlamports/CU */\n  p90: number;\n  /** Minimum non-zero fee observed */\n  minNonzeroPrice: number;\n}\n\n/**\n * Fee market update (per-writable-account model)\n *\n * Replaces the old flat PriorityFees struct. Now provides per-account\n * fee data so clients can price transactions based on the specific\n * writable accounts they touch.\n */\nexport interface FeeMarket {\n  /** Current slot */\n  slot: number;\n  /** Timestamp in milliseconds */\n  timestampMs: number;\n  /** Recommended fee in microlamports/CU (max p75 across hottest accounts) */\n  recommended: number;\n  /** Network state (0=low, 1=normal, 2=high, 3=extreme) */\n  state: NetworkState;\n  /** Whether data is stale */\n  isStale: boolean;\n  /** Block utilization percentage (0-100) */\n  blockUtilizationPct: number;\n  /** Number of blocks in the observation window */\n  blocksInWindow: number;\n  /** Per-account fee data */\n  accounts: AccountFee[];\n  /** Recent block mini-stats (v3) */\n  recentBlocks: BlockMiniStats[];\n  /** Fee trend direction (v3) */\n  trend: TrendDirection;\n}\n\n/**\n * Network congestion state\n */\nexport enum NetworkState {\n  Low = 0,\n  Normal = 1,\n  High = 2,\n  Congested = 3,\n}\n\n/**\n * Recent blockhash for transactions\n */\nexport interface Blockhash {\n  /** Slot of blockhash */\n  slot: number;\n  /** Timestamp in milliseconds */\n  timestampMs: number;\n  /** Recent blockhash (Base58) */\n  blockhash: string;\n  /** Block height */\n  blockHeight: number;\n  /** Last valid block height for transactions */\n  lastValidBlockHeight: number;\n  /** Whether data is stale */\n  isStale: boolean;\n}\n\n/**\n * WebSocket connection heartbeat\n */\nexport interface Heartbeat {\n  /** Server timestamp in milliseconds */\n  timestampMs: number;\n  /** Connection uptime in seconds */\n  uptimeSecs: number;\n  /** Total messages sent */\n  messagesSent: number;\n  /** Pool updates sent */\n  poolUpdatesSent: number;\n  /** Messages dropped (slow client) */\n  messagesDropped: number;\n  /** Whether pool updates are enabled */\n  poolUpdatesEnabled: boolean;\n  /** Subscribed channels */\n  subscribedChannels: string[];\n  /** Server sequence number */\n  serverSequence: number;\n}\n\n/**\n * Subscribe request for WebSocket\n */\nexport interface SubscribeRequest {\n  /** Channels to subscribe to */\n  channels: ('pools' | 'priority_fees' | 'blockhash')[];\n  /** Response format (default: binary) */\n  format?: 'binary' | 'json';\n  /** Filter by protocol names */\n  protocols?: string[];\n  /** Filter by pool addresses (Base58) */\n  pools?: string[];\n  /** Filter by token pairs [[mintA, mintB], ...] */\n  tokenPairs?: [string, string][];\n}\n\n/**\n * Quote subscription request\n */\nexport interface SubscribeQuoteRequest {\n  /** Input token mint (Base58) */\n  inputMint: string;\n  /** Output token mint (Base58) */\n  outputMint: string;\n  /** Amount in base units */\n  amount: number;\n  /** Slippage tolerance in basis points */\n  slippageBps?: number;\n  /** Refresh interval in milliseconds */\n  refreshIntervalMs?: number;\n}\n"]}

package/dist/utils/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;
+  }
+  for (let i = startIdx; i < bytes.length; i++) {
+    result[leadingZeros + i - startIdx] = bytes[i];
   }
-  return new Uint8Array(bytes.reverse());
+  return result;
 }
 function isValidPubkey(address) {
   if (address.length < 32 || address.length > 44) {

package/dist/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/base58.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Base58 encoding utilities for Solana addresses\n * \n * Solana uses Base58 encoding (Bitcoin-style) for public keys and signatures.\n */\n\nconst BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n\n/**\n * Encode bytes to Base58 string (Solana address format)\n * \n * @param bytes - Uint8Array to encode\n * @returns Base58 encoded string\n * \n * @example\n * ```typescript\n * const pubkey = new Uint8Array([1, 2, 3, ...]);\n * const address = base58Encode(pubkey);\n * // \"EPjFWdd5...\"\n * ```\n */\nexport function base58Encode(bytes: Uint8Array): string {\n  const digits = [0];\n  \n  for (let i = 0; i < bytes.length; i++) {\n    let carry = bytes[i];\n    for (let j = 0; j < digits.length; j++) {\n      carry += digits[j] << 8;\n      digits[j] = carry % 58;\n      carry = (carry / 58) | 0;\n    }\n    while (carry > 0) {\n      digits.push(carry % 58);\n      carry = (carry / 58) | 0;\n    }\n  }\n\n  // Leading zeros\n  let leadingZeros = '';\n  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {\n    leadingZeros += '1';\n  }\n\n  return leadingZeros + digits.reverse().map(d => BASE58_ALPHABET[d]).join('');\n}\n\n/**\n * Decode Base58 string to bytes\n * \n * @param str - Base58 encoded string\n * @returns Uint8Array of decoded bytes\n * @throws Error if string contains invalid characters\n * \n * @example\n * ```typescript\n * const bytes = base58Decode(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\");\n * // Uint8Array(32) [...]\n * ```\n */\nexport function base58Decode(str: string): Uint8Array {\n  const bytes = [0];\n  \n  for (let i = 0; i < str.length; i++) {\n    const char = str[i];\n    const value = BASE58_ALPHABET.indexOf(char);\n    \n    if (value === -1) {\n      throw new Error(`Invalid Base58 character: ${char}`);\n    }\n    \n    let carry = value;\n    for (let j = 0; j < bytes.length; j++) {\n      carry += bytes[j] * 58;\n      bytes[j] = carry & 0xff;\n      carry >>= 8;\n    }\n    while (carry > 0) {\n      bytes.push(carry & 0xff);\n      carry >>= 8;\n    }\n  }\n\n  // Leading '1's are leading zeros\n  for (let i = 0; i < str.length && str[i] === '1'; i++) {\n    bytes.push(0);\n  }\n\n  return new Uint8Array(bytes.reverse());\n}\n\n/**\n * Check if a string is a valid Solana public key (Base58, 32-44 chars)\n * \n * @param address - String to validate\n * @returns true if valid Solana pubkey format\n * \n * @example\n * ```typescript\n * isValidPubkey(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\") // true\n * isValidPubkey(\"invalid\") // false\n * ```\n */\nexport function isValidPubkey(address: string): boolean {\n  // Solana pubkeys are 32-44 characters in Base58\n  if (address.length < 32 || address.length > 44) {\n    return false;\n  }\n\n  // Check all characters are valid Base58\n  for (const char of address) {\n    if (!BASE58_ALPHABET.includes(char)) {\n      return false;\n    }\n  }\n\n  // Try to decode and verify length\n  try {\n    const bytes = base58Decode(address);\n    return bytes.length === 32;\n  } catch {\n    return false;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/base58.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Base58 encoding utilities for Solana addresses\n * \n * Solana uses Base58 encoding (Bitcoin-style) for public keys and signatures.\n */\n\nconst BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n\n/**\n * Encode bytes to Base58 string (Solana address format)\n * \n * @param bytes - Uint8Array to encode\n * @returns Base58 encoded string\n * \n * @example\n * ```typescript\n * const pubkey = new Uint8Array([1, 2, 3, ...]);\n * const address = base58Encode(pubkey);\n * // \"EPjFWdd5...\"\n * ```\n */\nexport function base58Encode(bytes: Uint8Array): string {\n  const digits = [0];\n  \n  for (let i = 0; i < bytes.length; i++) {\n    let carry = bytes[i];\n    for (let j = 0; j < digits.length; j++) {\n      carry += digits[j] << 8;\n      digits[j] = carry % 58;\n      carry = (carry / 58) | 0;\n    }\n    while (carry > 0) {\n      digits.push(carry % 58);\n      carry = (carry / 58) | 0;\n    }\n  }\n\n  // Leading zeros\n  let leadingZeros = '';\n  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {\n    leadingZeros += '1';\n  }\n\n  return leadingZeros + digits.reverse().map(d => BASE58_ALPHABET[d]).join('');\n}\n\n/**\n * Decode Base58 string to bytes\n * \n * @param str - Base58 encoded string\n * @returns Uint8Array of decoded bytes\n * @throws Error if string contains invalid characters\n * \n * @example\n * ```typescript\n * const bytes = base58Decode(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\");\n * // Uint8Array(32) [...]\n * ```\n */\nexport function base58Decode(str: string): Uint8Array {\n  if (str.length === 0) {\n    return new Uint8Array(0);\n  }\n\n  // Count leading '1's (they represent leading zero bytes)\n  let leadingZeros = 0;\n  for (let i = 0; i < str.length && str[i] === '1'; i++) {\n    leadingZeros++;\n  }\n\n  // Process remaining characters through base conversion\n  const bytes = [0];\n  for (let i = leadingZeros; i < str.length; i++) {\n    const char = str[i];\n    const value = BASE58_ALPHABET.indexOf(char);\n    \n    if (value === -1) {\n      throw new Error(`Invalid Base58 character: ${char}`);\n    }\n    \n    let carry = value;\n    for (let j = 0; j < bytes.length; j++) {\n      carry += bytes[j] * 58;\n      bytes[j] = carry & 0xff;\n      carry >>= 8;\n    }\n    while (carry > 0) {\n      bytes.push(carry & 0xff);\n      carry >>= 8;\n    }\n  }\n\n  // Build result: leading zeros + converted bytes (reversed)\n  bytes.reverse();\n  \n  // Handle case where input was all '1's (all leading zeros, no data to convert)\n  // In this case, bytes is just [0] from initialization, which we should ignore\n  if (leadingZeros > 0 && bytes.length === 1 && bytes[0] === 0) {\n    // Input was all '1's, return that many zero bytes\n    return new Uint8Array(leadingZeros);\n  }\n  \n  // Remove leading zero from conversion if present (artifact of starting with [0])\n  const startIdx = bytes.length > 1 && bytes[0] === 0 ? 1 : 0;\n  \n  const result = new Uint8Array(leadingZeros + bytes.length - startIdx);\n  // Fill leading zeros\n  for (let i = 0; i < leadingZeros; i++) {\n    result[i] = 0;\n  }\n  // Copy converted bytes\n  for (let i = startIdx; i < bytes.length; i++) {\n    result[leadingZeros + i - startIdx] = bytes[i];\n  }\n  \n  return result;\n}\n\n/**\n * Check if a string is a valid Solana public key (Base58, 32-44 chars)\n * \n * @param address - String to validate\n * @returns true if valid Solana pubkey format\n * \n * @example\n * ```typescript\n * isValidPubkey(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\") // true\n * isValidPubkey(\"invalid\") // false\n * ```\n */\nexport function isValidPubkey(address: string): boolean {\n  // Solana pubkeys are 32-44 characters in Base58\n  if (address.length < 32 || address.length > 44) {\n    return false;\n  }\n\n  // Check all characters are valid Base58\n  for (const char of address) {\n    if (!BASE58_ALPHABET.includes(char)) {\n      return false;\n    }\n  }\n\n  // Try to decode and verify length\n  try {\n    const bytes = base58Decode(address);\n    return bytes.length === 32;\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/utils/index.js

@@ -21,8 +21,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) {
@@ -39,10 +46,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;
+  }
+  for (let i = startIdx; i < bytes.length; i++) {
+    result[leadingZeros + i - startIdx] = bytes[i];
   }
-  return new Uint8Array(bytes.reverse());
+  return result;
 }
 function isValidPubkey(address) {
   if (address.length < 32 || address.length > 44) {

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/base58.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Base58 encoding utilities for Solana addresses\n * \n * Solana uses Base58 encoding (Bitcoin-style) for public keys and signatures.\n */\n\nconst BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n\n/**\n * Encode bytes to Base58 string (Solana address format)\n * \n * @param bytes - Uint8Array to encode\n * @returns Base58 encoded string\n * \n * @example\n * ```typescript\n * const pubkey = new Uint8Array([1, 2, 3, ...]);\n * const address = base58Encode(pubkey);\n * // \"EPjFWdd5...\"\n * ```\n */\nexport function base58Encode(bytes: Uint8Array): string {\n  const digits = [0];\n  \n  for (let i = 0; i < bytes.length; i++) {\n    let carry = bytes[i];\n    for (let j = 0; j < digits.length; j++) {\n      carry += digits[j] << 8;\n      digits[j] = carry % 58;\n      carry = (carry / 58) | 0;\n    }\n    while (carry > 0) {\n      digits.push(carry % 58);\n      carry = (carry / 58) | 0;\n    }\n  }\n\n  // Leading zeros\n  let leadingZeros = '';\n  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {\n    leadingZeros += '1';\n  }\n\n  return leadingZeros + digits.reverse().map(d => BASE58_ALPHABET[d]).join('');\n}\n\n/**\n * Decode Base58 string to bytes\n * \n * @param str - Base58 encoded string\n * @returns Uint8Array of decoded bytes\n * @throws Error if string contains invalid characters\n * \n * @example\n * ```typescript\n * const bytes = base58Decode(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\");\n * // Uint8Array(32) [...]\n * ```\n */\nexport function base58Decode(str: string): Uint8Array {\n  const bytes = [0];\n  \n  for (let i = 0; i < str.length; i++) {\n    const char = str[i];\n    const value = BASE58_ALPHABET.indexOf(char);\n    \n    if (value === -1) {\n      throw new Error(`Invalid Base58 character: ${char}`);\n    }\n    \n    let carry = value;\n    for (let j = 0; j < bytes.length; j++) {\n      carry += bytes[j] * 58;\n      bytes[j] = carry & 0xff;\n      carry >>= 8;\n    }\n    while (carry > 0) {\n      bytes.push(carry & 0xff);\n      carry >>= 8;\n    }\n  }\n\n  // Leading '1's are leading zeros\n  for (let i = 0; i < str.length && str[i] === '1'; i++) {\n    bytes.push(0);\n  }\n\n  return new Uint8Array(bytes.reverse());\n}\n\n/**\n * Check if a string is a valid Solana public key (Base58, 32-44 chars)\n * \n * @param address - String to validate\n * @returns true if valid Solana pubkey format\n * \n * @example\n * ```typescript\n * isValidPubkey(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\") // true\n * isValidPubkey(\"invalid\") // false\n * ```\n */\nexport function isValidPubkey(address: string): boolean {\n  // Solana pubkeys are 32-44 characters in Base58\n  if (address.length < 32 || address.length > 44) {\n    return false;\n  }\n\n  // Check all characters are valid Base58\n  for (const char of address) {\n    if (!BASE58_ALPHABET.includes(char)) {\n      return false;\n    }\n  }\n\n  // Try to decode and verify length\n  try {\n    const bytes = base58Decode(address);\n    return bytes.length === 32;\n  } catch {\n    return false;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/base58.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Base58 encoding utilities for Solana addresses\n * \n * Solana uses Base58 encoding (Bitcoin-style) for public keys and signatures.\n */\n\nconst BASE58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n\n/**\n * Encode bytes to Base58 string (Solana address format)\n * \n * @param bytes - Uint8Array to encode\n * @returns Base58 encoded string\n * \n * @example\n * ```typescript\n * const pubkey = new Uint8Array([1, 2, 3, ...]);\n * const address = base58Encode(pubkey);\n * // \"EPjFWdd5...\"\n * ```\n */\nexport function base58Encode(bytes: Uint8Array): string {\n  const digits = [0];\n  \n  for (let i = 0; i < bytes.length; i++) {\n    let carry = bytes[i];\n    for (let j = 0; j < digits.length; j++) {\n      carry += digits[j] << 8;\n      digits[j] = carry % 58;\n      carry = (carry / 58) | 0;\n    }\n    while (carry > 0) {\n      digits.push(carry % 58);\n      carry = (carry / 58) | 0;\n    }\n  }\n\n  // Leading zeros\n  let leadingZeros = '';\n  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {\n    leadingZeros += '1';\n  }\n\n  return leadingZeros + digits.reverse().map(d => BASE58_ALPHABET[d]).join('');\n}\n\n/**\n * Decode Base58 string to bytes\n * \n * @param str - Base58 encoded string\n * @returns Uint8Array of decoded bytes\n * @throws Error if string contains invalid characters\n * \n * @example\n * ```typescript\n * const bytes = base58Decode(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\");\n * // Uint8Array(32) [...]\n * ```\n */\nexport function base58Decode(str: string): Uint8Array {\n  if (str.length === 0) {\n    return new Uint8Array(0);\n  }\n\n  // Count leading '1's (they represent leading zero bytes)\n  let leadingZeros = 0;\n  for (let i = 0; i < str.length && str[i] === '1'; i++) {\n    leadingZeros++;\n  }\n\n  // Process remaining characters through base conversion\n  const bytes = [0];\n  for (let i = leadingZeros; i < str.length; i++) {\n    const char = str[i];\n    const value = BASE58_ALPHABET.indexOf(char);\n    \n    if (value === -1) {\n      throw new Error(`Invalid Base58 character: ${char}`);\n    }\n    \n    let carry = value;\n    for (let j = 0; j < bytes.length; j++) {\n      carry += bytes[j] * 58;\n      bytes[j] = carry & 0xff;\n      carry >>= 8;\n    }\n    while (carry > 0) {\n      bytes.push(carry & 0xff);\n      carry >>= 8;\n    }\n  }\n\n  // Build result: leading zeros + converted bytes (reversed)\n  bytes.reverse();\n  \n  // Handle case where input was all '1's (all leading zeros, no data to convert)\n  // In this case, bytes is just [0] from initialization, which we should ignore\n  if (leadingZeros > 0 && bytes.length === 1 && bytes[0] === 0) {\n    // Input was all '1's, return that many zero bytes\n    return new Uint8Array(leadingZeros);\n  }\n  \n  // Remove leading zero from conversion if present (artifact of starting with [0])\n  const startIdx = bytes.length > 1 && bytes[0] === 0 ? 1 : 0;\n  \n  const result = new Uint8Array(leadingZeros + bytes.length - startIdx);\n  // Fill leading zeros\n  for (let i = 0; i < leadingZeros; i++) {\n    result[i] = 0;\n  }\n  // Copy converted bytes\n  for (let i = startIdx; i < bytes.length; i++) {\n    result[leadingZeros + i - startIdx] = bytes[i];\n  }\n  \n  return result;\n}\n\n/**\n * Check if a string is a valid Solana public key (Base58, 32-44 chars)\n * \n * @param address - String to validate\n * @returns true if valid Solana pubkey format\n * \n * @example\n * ```typescript\n * isValidPubkey(\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\") // true\n * isValidPubkey(\"invalid\") // false\n * ```\n */\nexport function isValidPubkey(address: string): boolean {\n  // Solana pubkeys are 32-44 characters in Base58\n  if (address.length < 32 || address.length > 44) {\n    return false;\n  }\n\n  // Check all characters are valid Base58\n  for (const char of address) {\n    if (!BASE58_ALPHABET.includes(char)) {\n      return false;\n    }\n  }\n\n  // Try to decode and verify length\n  try {\n    const bytes = base58Decode(address);\n    return bytes.length === 32;\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/ws/index.cjs

@@ -53,6 +53,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
 };
@@ -93,55 +95,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
         }
       };
     }
@@ -186,6 +208,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;
   }
@@ -267,19 +334,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) {
@@ -350,25 +405,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;
   }
 }
 
@@ -670,8 +707,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);