@k256/sdk 0.1.0

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"names":["NetworkState"],"mappings":";AAsIO,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  /** Whether pool is valid for trading */\n  isValid: boolean;\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"]}

package/dist/utils/index.cjs

@@ -0,0 +1,70 @@
+'use strict';
+
+// src/utils/base58.ts
+var BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Encode(bytes) {
+  const digits = [0];
+  for (let i = 0; i < bytes.length; i++) {
+    let carry = bytes[i];
+    for (let j = 0; j < digits.length; j++) {
+      carry += digits[j] << 8;
+      digits[j] = carry % 58;
+      carry = carry / 58 | 0;
+    }
+    while (carry > 0) {
+      digits.push(carry % 58);
+      carry = carry / 58 | 0;
+    }
+  }
+  let leadingZeros = "";
+  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {
+    leadingZeros += "1";
+  }
+  return leadingZeros + digits.reverse().map((d) => BASE58_ALPHABET[d]).join("");
+}
+function base58Decode(str) {
+  const bytes = [0];
+  for (let i = 0; i < str.length; i++) {
+    const char = str[i];
+    const value = BASE58_ALPHABET.indexOf(char);
+    if (value === -1) {
+      throw new Error(`Invalid Base58 character: ${char}`);
+    }
+    let carry = value;
+    for (let j = 0; j < bytes.length; j++) {
+      carry += bytes[j] * 58;
+      bytes[j] = carry & 255;
+      carry >>= 8;
+    }
+    while (carry > 0) {
+      bytes.push(carry & 255);
+      carry >>= 8;
+    }
+  }
+  for (let i = 0; i < str.length && str[i] === "1"; i++) {
+    bytes.push(0);
+  }
+  return new Uint8Array(bytes.reverse());
+}
+function isValidPubkey(address) {
+  if (address.length < 32 || address.length > 44) {
+    return false;
+  }
+  for (const char of address) {
+    if (!BASE58_ALPHABET.includes(char)) {
+      return false;
+    }
+  }
+  try {
+    const bytes = base58Decode(address);
+    return bytes.length === 32;
+  } catch {
+    return false;
+  }
+}
+
+exports.base58Decode = base58Decode;
+exports.base58Encode = base58Encode;
+exports.isValidPubkey = isValidPubkey;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/base58.ts"],"names":[],"mappings":";;;AAMA,IAAM,eAAA,GAAkB,4DAAA;AAejB,SAAS,aAAa,KAAA,EAA2B;AACtD,EAAA,MAAM,MAAA,GAAS,CAAC,CAAC,CAAA;AAEjB,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,IAAI,KAAA,GAAQ,MAAM,CAAC,CAAA;AACnB,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,QAAQ,CAAA,EAAA,EAAK;AACtC,MAAA,KAAA,IAAS,MAAA,CAAO,CAAC,CAAA,IAAK,CAAA;AACtB,MAAA,MAAA,CAAO,CAAC,IAAI,KAAA,GAAQ,EAAA;AACpB,MAAA,KAAA,GAAS,QAAQ,EAAA,GAAM,CAAA;AAAA,IACzB;AACA,IAAA,OAAO,QAAQ,CAAA,EAAG;AAChB,MAAA,MAAA,CAAO,IAAA,CAAK,QAAQ,EAAE,CAAA;AACtB,MAAA,KAAA,GAAS,QAAQ,EAAA,GAAM,CAAA;AAAA,IACzB;AAAA,EACF;AAGA,EAAA,IAAI,YAAA,GAAe,EAAA;AACnB,EAAA,KAAA,IAAS,CAAA,GAAI,GAAG,CAAA,GAAI,KAAA,CAAM,UAAU,KAAA,CAAM,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,EAAA,EAAK;AACvD,IAAA,YAAA,IAAgB,GAAA;AAAA,EAClB;AAEA,EAAA,OAAO,YAAA,GAAe,MAAA,CAAO,OAAA,EAAQ,CAAE,GAAA,CAAI,CAAA,CAAA,KAAK,eAAA,CAAgB,CAAC,CAAC,CAAA,CAAE,IAAA,CAAK,EAAE,CAAA;AAC7E;AAeO,SAAS,aAAa,GAAA,EAAyB;AACpD,EAAA,MAAM,KAAA,GAAQ,CAAC,CAAC,CAAA;AAEhB,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,MAAM,IAAA,GAAO,IAAI,CAAC,CAAA;AAClB,IAAA,MAAM,KAAA,GAAQ,eAAA,CAAgB,OAAA,CAAQ,IAAI,CAAA;AAE1C,IAAA,IAAI,UAAU,EAAA,EAAI;AAChB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,0BAAA,EAA6B,IAAI,CAAA,CAAE,CAAA;AAAA,IACrD;AAEA,IAAA,IAAI,KAAA,GAAQ,KAAA;AACZ,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,MAAA,KAAA,IAAS,KAAA,CAAM,CAAC,CAAA,GAAI,EAAA;AACpB,MAAA,KAAA,CAAM,CAAC,IAAI,KAAA,GAAQ,GAAA;AACnB,MAAA,KAAA,KAAU,CAAA;AAAA,IACZ;AACA,IAAA,OAAO,QAAQ,CAAA,EAAG;AAChB,MAAA,KAAA,CAAM,IAAA,CAAK,QAAQ,GAAI,CAAA;AACvB,MAAA,KAAA,KAAU,CAAA;AAAA,IACZ;AAAA,EACF;AAGA,EAAA,KAAA,IAAS,CAAA,GAAI,GAAG,CAAA,GAAI,GAAA,CAAI,UAAU,GAAA,CAAI,CAAC,CAAA,KAAM,GAAA,EAAK,CAAA,EAAA,EAAK;AACrD,IAAA,KAAA,CAAM,KAAK,CAAC,CAAA;AAAA,EACd;AAEA,EAAA,OAAO,IAAI,UAAA,CAAW,KAAA,CAAM,OAAA,EAAS,CAAA;AACvC;AAcO,SAAS,cAAc,OAAA,EAA0B;AAEtD,EAAA,IAAI,OAAA,CAAQ,MAAA,GAAS,EAAA,IAAM,OAAA,CAAQ,SAAS,EAAA,EAAI;AAC9C,IAAA,OAAO,KAAA;AAAA,EACT;AAGA,EAAA,KAAA,MAAW,QAAQ,OAAA,EAAS;AAC1B,IAAA,IAAI,CAAC,eAAA,CAAgB,QAAA,CAAS,IAAI,CAAA,EAAG;AACnC,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAGA,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQ,aAAa,OAAO,CAAA;AAClC,IAAA,OAAO,MAAM,MAAA,KAAW,EAAA;AAAA,EAC1B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF","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"]}

package/dist/utils/index.d.cts

@@ -0,0 +1,48 @@
+/**
+ * Base58 encoding utilities for Solana addresses
+ *
+ * Solana uses Base58 encoding (Bitcoin-style) for public keys and signatures.
+ */
+/**
+ * Encode bytes to Base58 string (Solana address format)
+ *
+ * @param bytes - Uint8Array to encode
+ * @returns Base58 encoded string
+ *
+ * @example
+ * ```typescript
+ * const pubkey = new Uint8Array([1, 2, 3, ...]);
+ * const address = base58Encode(pubkey);
+ * // "EPjFWdd5..."
+ * ```
+ */
+declare function base58Encode(bytes: Uint8Array): string;
+/**
+ * Decode Base58 string to bytes
+ *
+ * @param str - Base58 encoded string
+ * @returns Uint8Array of decoded bytes
+ * @throws Error if string contains invalid characters
+ *
+ * @example
+ * ```typescript
+ * const bytes = base58Decode("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+ * // Uint8Array(32) [...]
+ * ```
+ */
+declare function base58Decode(str: string): Uint8Array;
+/**
+ * Check if a string is a valid Solana public key (Base58, 32-44 chars)
+ *
+ * @param address - String to validate
+ * @returns true if valid Solana pubkey format
+ *
+ * @example
+ * ```typescript
+ * isValidPubkey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v") // true
+ * isValidPubkey("invalid") // false
+ * ```
+ */
+declare function isValidPubkey(address: string): boolean;
+
+export { base58Decode, base58Encode, isValidPubkey };

package/dist/utils/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Base58 encoding utilities for Solana addresses
+ *
+ * Solana uses Base58 encoding (Bitcoin-style) for public keys and signatures.
+ */
+/**
+ * Encode bytes to Base58 string (Solana address format)
+ *
+ * @param bytes - Uint8Array to encode
+ * @returns Base58 encoded string
+ *
+ * @example
+ * ```typescript
+ * const pubkey = new Uint8Array([1, 2, 3, ...]);
+ * const address = base58Encode(pubkey);
+ * // "EPjFWdd5..."
+ * ```
+ */
+declare function base58Encode(bytes: Uint8Array): string;
+/**
+ * Decode Base58 string to bytes
+ *
+ * @param str - Base58 encoded string
+ * @returns Uint8Array of decoded bytes
+ * @throws Error if string contains invalid characters
+ *
+ * @example
+ * ```typescript
+ * const bytes = base58Decode("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+ * // Uint8Array(32) [...]
+ * ```
+ */
+declare function base58Decode(str: string): Uint8Array;
+/**
+ * Check if a string is a valid Solana public key (Base58, 32-44 chars)
+ *
+ * @param address - String to validate
+ * @returns true if valid Solana pubkey format
+ *
+ * @example
+ * ```typescript
+ * isValidPubkey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v") // true
+ * isValidPubkey("invalid") // false
+ * ```
+ */
+declare function isValidPubkey(address: string): boolean;
+
+export { base58Decode, base58Encode, isValidPubkey };

package/dist/utils/index.js

@@ -0,0 +1,66 @@
+// src/utils/base58.ts
+var BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Encode(bytes) {
+  const digits = [0];
+  for (let i = 0; i < bytes.length; i++) {
+    let carry = bytes[i];
+    for (let j = 0; j < digits.length; j++) {
+      carry += digits[j] << 8;
+      digits[j] = carry % 58;
+      carry = carry / 58 | 0;
+    }
+    while (carry > 0) {
+      digits.push(carry % 58);
+      carry = carry / 58 | 0;
+    }
+  }
+  let leadingZeros = "";
+  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {
+    leadingZeros += "1";
+  }
+  return leadingZeros + digits.reverse().map((d) => BASE58_ALPHABET[d]).join("");
+}
+function base58Decode(str) {
+  const bytes = [0];
+  for (let i = 0; i < str.length; i++) {
+    const char = str[i];
+    const value = BASE58_ALPHABET.indexOf(char);
+    if (value === -1) {
+      throw new Error(`Invalid Base58 character: ${char}`);
+    }
+    let carry = value;
+    for (let j = 0; j < bytes.length; j++) {
+      carry += bytes[j] * 58;
+      bytes[j] = carry & 255;
+      carry >>= 8;
+    }
+    while (carry > 0) {
+      bytes.push(carry & 255);
+      carry >>= 8;
+    }
+  }
+  for (let i = 0; i < str.length && str[i] === "1"; i++) {
+    bytes.push(0);
+  }
+  return new Uint8Array(bytes.reverse());
+}
+function isValidPubkey(address) {
+  if (address.length < 32 || address.length > 44) {
+    return false;
+  }
+  for (const char of address) {
+    if (!BASE58_ALPHABET.includes(char)) {
+      return false;
+    }
+  }
+  try {
+    const bytes = base58Decode(address);
+    return bytes.length === 32;
+  } catch {
+    return false;
+  }
+}
+
+export { base58Decode, base58Encode, isValidPubkey };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +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"]}