@hashgraphonline/standards-sdk 0.1.189 → 0.1.191

package/dist/es/standards-sdk.es136.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es136.js","sources":["../../src/utils/key-type-detector.ts"],"sourcesContent":["import { PrivateKey } from '@hashgraph/sdk';\n\n/**\n * Enumeration of supported key types\n */\nexport enum KeyType {\n  ED25519 = 'ed25519',\n  ECDSA = 'ecdsa',\n  UNKNOWN = 'unknown',\n}\n\n/**\n * Result of key type detection\n */\nexport interface KeyInfo {\n  /** Detected key type (ED25519, ECDSA, or UNKNOWN) */\n  type: KeyType;\n  /** Format of the provided key */\n  format: 'hex' | 'der' | 'pem' | 'raw';\n  /** Whether the key is a private key */\n  isPrivateKey: boolean;\n  /** Raw bytes of the key (if available) */\n  rawBytes?: Uint8Array;\n  /** Confidence level of the detection */\n  confidence: 'certain' | 'uncertain';\n  /** Warning message for uncertain detections */\n  warning?: string;\n}\n\n/**\n * Legacy interface for backward compatibility\n */\nexport interface KeyDetectionResult {\n  /** Detected key type */\n  detectedType: 'ed25519' | 'ecdsa';\n  /** Parsed private key */\n  privateKey: PrivateKey;\n  /** Optional warning for ambiguous keys */\n  warning?: string;\n}\n\n/**\n * Utility class for detecting cryptographic key types used in Hedera\n *\n * This class provides methods to determine whether a key is ED25519 or ECDSA\n * based on various input formats (hex, DER, PEM) and detection strategies.\n *\n * For ambiguous 32-byte raw keys, it uses heuristics and signature testing\n * to make a best-effort determination. When confidence is 'uncertain',\n * consider using the Hedera mirror node to confirm the key type if you have\n * the associated account ID.\n *\n * @example\n * // Detect key type from a hex string\n * const keyInfo = KeyTypeDetector.detect('0x' + privateKey.toStringRaw());\n * if (keyInfo.confidence === 'uncertain') {\n *   console.warn(keyInfo.warning);\n *   // Consider checking mirror node if account ID is available\n * }\n */\nexport class KeyTypeDetector {\n  private static readonly ED25519_PUBLIC_KEY_LENGTH = 32;\n  private static readonly ED25519_EXPANDED_PRIVATE_KEY_LENGTH = 64;\n\n  private static readonly ED25519_PUBLIC_KEY_PREFIX = Buffer.from([\n    0x30, 0x2a, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x03, 0x21, 0x00,\n  ]);\n  private static readonly ED25519_PRIVATE_KEY_PREFIX = Buffer.from([\n    0x30, 0x2e, 0x02, 0x01, 0x00, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70,\n    0x04, 0x22, 0x04, 0x20,\n  ]);\n\n  private static readonly ECDSA_SECP256K1_PUBLIC_KEY_PREFIX = Buffer.from([\n    0x30, 0x56, 0x30, 0x10, 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x02,\n    0x01, 0x06, 0x05, 0x2b, 0x81, 0x04, 0x00, 0x0a, 0x03, 0x42, 0x00,\n  ]);\n  private static readonly ECDSA_SECP256K1_PRIVATE_KEY_PREFIX = Buffer.from([\n    0x30, 0x74, 0x02, 0x01, 0x01, 0x04, 0x20,\n  ]);\n  private static readonly ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_SHORT =\n    Buffer.from([\n      0x30, 0x30, 0x02, 0x01, 0x00, 0x30, 0x07, 0x06, 0x05, 0x2b, 0x81, 0x04,\n      0x00, 0x0a, 0x04, 0x22, 0x04, 0x20,\n    ]);\n\n  private static readonly ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_LONG = Buffer.from(\n    [0x30, 0x77, 0x02, 0x01, 0x01, 0x04, 0x20],\n  );\n\n  /**\n   * Detects private key type from various input formats without throwing errors\n   *\n   * This detector is designed for private keys only. It uses various heuristics to determine\n   * the key type for ambiguous 32-byte keys, including byte patterns and statistical analysis.\n   *\n   * For ambiguous cases (where confidence is 'uncertain'), if you have the associated account ID,\n   * you can use the Hedera mirror node to confirm the key type.\n   *\n   * @param keyInput - The key to detect, can be a string (hex, base64, PEM), Buffer, or Uint8Array\n   * @returns KeyInfo object containing the detected key type and metadata\n   *\n   * @example\n   * // Detect from hex string\n   * const info1 = KeyTypeDetector.detect('0x7f96cea0c0d9d5bfb3ab8a42cf0cea44d57f62f2e068f8e5a3251914a9252b04');\n   *\n   * // Detect from DER-encoded string\n   * const info2 = KeyTypeDetector.detect(privateKey.toStringDer());\n   *\n   * // Detect from PEM format\n   * const info3 = KeyTypeDetector.detect(`-----BEGIN PRIVATE KEY-----\n   * MC4CAQAwBQYDK2VwBCIEIGRchBsQGQduAAGBQ7GAkKCKkmQ3EGCARwHsHiRqTNR9\n   * -----END PRIVATE KEY-----`);\n   */\n  static detect(keyInput: string | Uint8Array | Buffer): KeyInfo {\n    try {\n      let keyBytes: Uint8Array;\n      let originalFormat: 'hex' | 'der' | 'pem' | 'raw' = 'raw';\n\n      if (typeof keyInput === 'string') {\n        let trimmed = keyInput.trim();\n\n        if (trimmed.includes('-----BEGIN')) {\n          return this.detectFromPem(trimmed);\n        }\n\n        if (trimmed.toLowerCase().startsWith('0x')) {\n          trimmed = trimmed.substring(2);\n        }\n\n        if (this.isValidHex(trimmed)) {\n          keyBytes = this.hexToBytes(trimmed);\n          originalFormat = 'hex';\n        } else if (this.isBase64(trimmed)) {\n          keyBytes = Buffer.from(trimmed, 'base64');\n          originalFormat = 'der';\n        } else {\n          return {\n            type: KeyType.UNKNOWN,\n            format: 'raw',\n            isPrivateKey: false,\n            confidence: 'certain',\n          };\n        }\n      } else if (keyInput instanceof Buffer) {\n        keyBytes = new Uint8Array(keyInput);\n      } else {\n        keyBytes = keyInput as Uint8Array;\n      }\n\n      return this.detectFromBytes(keyBytes, originalFormat);\n    } catch (error) {\n      return {\n        type: KeyType.UNKNOWN,\n        format: 'raw',\n        isPrivateKey: false,\n        confidence: 'certain',\n      };\n    }\n  }\n\n  /**\n   * Detect key type from raw bytes\n   *\n   * @param bytes - The raw bytes of the key\n   * @param format - The original format of the key\n   * @returns KeyInfo object with detection results\n   * @private\n   */\n  private static detectFromBytes(\n    bytes: Uint8Array,\n    format: 'hex' | 'der' | 'pem' | 'raw',\n  ): KeyInfo {\n    if (this.hasPrefix(bytes, this.ED25519_PUBLIC_KEY_PREFIX)) {\n      const keyStart = this.ED25519_PUBLIC_KEY_PREFIX.length;\n      return {\n        type: KeyType.ED25519,\n        format: 'der',\n        isPrivateKey: false,\n        rawBytes: bytes.slice(keyStart),\n        confidence: 'certain',\n      };\n    }\n\n    if (this.hasPrefix(bytes, this.ED25519_PRIVATE_KEY_PREFIX)) {\n      const keyStart = this.ED25519_PRIVATE_KEY_PREFIX.length;\n      if (bytes.length >= keyStart + 32) {\n        return {\n          type: KeyType.ED25519,\n          format: 'der',\n          isPrivateKey: true,\n          rawBytes: bytes.slice(keyStart, keyStart + 32),\n          confidence: 'certain',\n        };\n      }\n    }\n\n    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PUBLIC_KEY_PREFIX)) {\n      const keyStart = this.ECDSA_SECP256K1_PUBLIC_KEY_PREFIX.length;\n      return {\n        type: KeyType.ECDSA,\n        format: 'der',\n        isPrivateKey: false,\n        rawBytes: bytes.slice(keyStart),\n        confidence: 'certain',\n      };\n    }\n\n    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_SHORT)) {\n      const keyStart = this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_SHORT.length;\n      return {\n        type: KeyType.ECDSA,\n        format: 'der',\n        isPrivateKey: true,\n        rawBytes: bytes.slice(keyStart),\n        confidence: 'certain',\n      };\n    }\n\n    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX)) {\n      const keyStart = this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX.length;\n      return {\n        type: KeyType.ECDSA,\n        format: 'der',\n        isPrivateKey: true,\n        rawBytes: bytes.slice(keyStart, keyStart + 32),\n        confidence: 'certain',\n      };\n    }\n\n    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_LONG)) {\n      const keyStart = this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_LONG.length;\n      return {\n        type: KeyType.ECDSA,\n        format: 'der',\n        isPrivateKey: true,\n        rawBytes: bytes.slice(keyStart, keyStart + 32),\n        confidence: 'certain',\n      };\n    }\n\n    if (bytes.length > 36 && this.containsECDSAPrivateKeyPattern(bytes)) {\n      return {\n        type: KeyType.ECDSA,\n        format: 'der',\n        isPrivateKey: true,\n        rawBytes: this.extractECDSAPrivateKey(bytes),\n        confidence: 'certain',\n      };\n    }\n\n    switch (bytes.length) {\n      case this.ED25519_PUBLIC_KEY_LENGTH:\n        if (format === 'hex') {\n          const hexStr = Array.from(bytes)\n            .map(b => b.toString(16).padStart(2, '0'))\n            .join('');\n\n          const privateResult = this.tryCreateKey(hexStr);\n          if (privateResult.type !== KeyType.UNKNOWN) {\n            return privateResult;\n          }\n        }\n\n        return {\n          type: KeyType.UNKNOWN,\n          format: format,\n          isPrivateKey: false,\n          rawBytes: bytes,\n          confidence: 'certain',\n        };\n\n      case this.ED25519_EXPANDED_PRIVATE_KEY_LENGTH:\n        return {\n          type: KeyType.ED25519,\n          format: format,\n          isPrivateKey: true,\n          rawBytes: bytes,\n          confidence: 'certain',\n        };\n    }\n\n    return {\n      type: KeyType.UNKNOWN,\n      format: format,\n      isPrivateKey: false,\n      rawBytes: bytes,\n      confidence: 'certain',\n    };\n  }\n\n  /**\n   * Detect key type from PEM format\n   *\n   * @param pem - The PEM-encoded key string\n   * @returns KeyInfo object with detection results\n   * @private\n   */\n  private static detectFromPem(pem: string): KeyInfo {\n    const trimmedPem = pem.trim();\n    const isPrivateKey = trimmedPem.includes('PRIVATE KEY');\n\n    const pemTypes = {\n      EC_PRIVATE: /-----BEGIN EC PRIVATE KEY-----/,\n      EC_PUBLIC: /-----BEGIN EC PUBLIC KEY-----/,\n      PRIVATE: /-----BEGIN PRIVATE KEY-----/,\n      PUBLIC: /-----BEGIN PUBLIC KEY-----/,\n    };\n\n    let isECKey = false;\n    for (const [type, regex] of Object.entries(pemTypes)) {\n      if (regex.test(trimmedPem) && type.includes('EC')) {\n        isECKey = true;\n        break;\n      }\n    }\n\n    const beginMarkerIndex = trimmedPem.indexOf('-----BEGIN ');\n    if (beginMarkerIndex === -1) {\n      return {\n        type: KeyType.UNKNOWN,\n        format: 'pem',\n        isPrivateKey,\n        confidence: 'certain',\n      };\n    }\n\n    const beginLineEndIndex = trimmedPem.indexOf('\\n', beginMarkerIndex);\n    if (beginLineEndIndex === -1) {\n      return {\n        type: KeyType.UNKNOWN,\n        format: 'pem',\n        isPrivateKey,\n        confidence: 'certain',\n      };\n    }\n\n    const endMarkerIndex = trimmedPem.lastIndexOf('-----END ');\n    if (endMarkerIndex === -1 || endMarkerIndex <= beginLineEndIndex) {\n      return {\n        type: KeyType.UNKNOWN,\n        format: 'pem',\n        isPrivateKey,\n        confidence: 'certain',\n      };\n    }\n\n    const base64Content = trimmedPem\n      .slice(beginLineEndIndex + 1, endMarkerIndex)\n      .replace(/\\s/g, '');\n    if (!base64Content) {\n      return {\n        type: KeyType.UNKNOWN,\n        format: 'pem',\n        isPrivateKey,\n        confidence: 'certain',\n      };\n    }\n\n    try {\n      const derBytes = Buffer.from(base64Content, 'base64');\n      const result = this.detectFromBytes(new Uint8Array(derBytes), 'der');\n\n      if (result.type === KeyType.UNKNOWN && isECKey) {\n        return {\n          type: KeyType.ECDSA,\n          format: 'pem',\n          isPrivateKey,\n          rawBytes: derBytes,\n          confidence: 'certain',\n        };\n      }\n\n      return {\n        ...result,\n        format: 'pem',\n      };\n    } catch {\n      return {\n        type: KeyType.UNKNOWN,\n        format: 'pem',\n        isPrivateKey,\n        confidence: 'certain',\n      };\n    }\n  }\n\n  /**\n   * Try to create a key using Hedera SDK to validate the type\n   *\n   * @param keyInput - The key input string or bytes\n   * @returns KeyInfo object with detection results\n   * @private\n   */\n  private static tryCreateKey(keyInput: string | Uint8Array): KeyInfo {\n    try {\n      if (typeof keyInput === 'string') {\n        let keyStr = keyInput.trim();\n        if (keyStr.toLowerCase().startsWith('0x')) {\n          keyStr = keyStr.substring(2);\n        }\n\n        if (this.isValidHex(keyStr) && keyStr.length === 64) {\n          const keyBytes = this.hexToBytes(keyStr);\n\n          const signatureResult = this.detectBySignature(keyStr);\n          if (signatureResult.type !== KeyType.UNKNOWN) {\n            return {\n              type: signatureResult.type,\n              format: 'hex',\n              isPrivateKey: true,\n              rawBytes: keyBytes,\n              confidence: signatureResult.confidence,\n              warning: signatureResult.warning,\n            };\n          }\n\n          return {\n            type: KeyType.UNKNOWN,\n            format: 'hex',\n            isPrivateKey: false,\n            rawBytes: keyBytes,\n            confidence: 'certain',\n          };\n        }\n      }\n    } catch {}\n\n    return {\n      type: KeyType.UNKNOWN,\n      format: 'hex',\n      isPrivateKey: false,\n      rawBytes: new Uint8Array(),\n      confidence: 'certain',\n    };\n  }\n\n  /**\n   * Detect key type by attempting to sign a message with both algorithms\n   *\n   * For ambiguous cases where both algorithms can use the key, this method\n   * uses heuristics to make a best-effort determination. For production use\n   * with ambiguous keys, consider using the Hedera mirror node to confirm\n   * the key type if you have the associated account ID.\n   *\n   * @param hexKey - The hex string representation of the key\n   * @returns Object containing type, confidence level, and optional warning\n   * @private\n   */\n  private static detectBySignature(hexKey: string): {\n    type: KeyType;\n    confidence: 'certain' | 'uncertain';\n    warning?: string;\n  } {\n    const keyBigInt = BigInt('0x' + hexKey);\n    const secp256k1Order = BigInt(\n      '0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141',\n    );\n\n    if (keyBigInt === 0n) {\n      return {\n        type: KeyType.ED25519,\n        confidence: 'certain',\n      };\n    }\n\n    if (keyBigInt >= secp256k1Order) {\n      return {\n        type: KeyType.ED25519,\n        confidence: 'certain',\n      };\n    }\n\n    let ed25519CanSign = false;\n    let ecdsaCanSign = false;\n\n    try {\n      const ed25519Key = PrivateKey.fromStringED25519(hexKey);\n      const testMessage = new Uint8Array([1, 2, 3, 4, 5]);\n      const signature = ed25519Key.sign(testMessage);\n      if (ed25519Key.publicKey.verify(testMessage, signature)) {\n        ed25519CanSign = true;\n      }\n    } catch {}\n\n    try {\n      const ecdsaKey = PrivateKey.fromStringECDSA(hexKey);\n      const testMessage = new Uint8Array([1, 2, 3, 4, 5]);\n      const signature = ecdsaKey.sign(testMessage);\n      if (ecdsaKey.publicKey.verify(testMessage, signature)) {\n        ecdsaCanSign = true;\n      }\n    } catch {}\n\n    if (ed25519CanSign && ecdsaCanSign) {\n      const keyBytes = this.hexToBytes(hexKey);\n\n      if (keyBytes[0] === 0xa8 && keyBytes[1] === 0x01) {\n        return {\n          type: KeyType.ED25519,\n          confidence: 'uncertain',\n          warning:\n            'Detection based on byte pattern heuristic. Both ED25519 and ECDSA accept this key.',\n        };\n      }\n\n      let highBytes = 0;\n      for (const byte of keyBytes) {\n        if (byte >= 0x80) highBytes++;\n      }\n\n      const highByteRatio = highBytes / keyBytes.length;\n      if (highByteRatio >= 0.4 && highByteRatio <= 0.6) {\n        return {\n          type: KeyType.ECDSA,\n          confidence: 'uncertain',\n          warning:\n            'Detection based on entropy heuristic. Both ED25519 and ECDSA accept this key.',\n        };\n      }\n\n      return {\n        type: KeyType.ECDSA,\n        confidence: 'uncertain',\n        warning:\n          'Detection based on entropy heuristic. Both ED25519 and ECDSA accept this key. Defaulting to ECDSA.',\n      };\n    }\n\n    if (ed25519CanSign && !ecdsaCanSign) {\n      return {\n        type: KeyType.ED25519,\n        confidence: 'certain',\n      };\n    }\n\n    if (ecdsaCanSign && !ed25519CanSign) {\n      return {\n        type: KeyType.ECDSA,\n        confidence: 'certain',\n      };\n    }\n\n    return {\n      type: KeyType.UNKNOWN,\n      confidence: 'certain',\n    };\n  }\n\n  /**\n   * Check if a string is valid hexadecimal with even length\n   *\n   * @param str - The string to check\n   * @returns True if the string is valid hex with even length\n   * @private\n   */\n  private static isValidHex(str: string): boolean {\n    return /^[0-9a-fA-F]+$/.test(str) && str.length % 2 === 0;\n  }\n\n  /**\n   * Check if a string is valid base64\n   *\n   * @param str - The string to check\n   * @returns True if the string is valid base64\n   * @private\n   */\n  private static isBase64(str: string): boolean {\n    try {\n      return Buffer.from(str, 'base64').toString('base64') === str;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Convert a hex string to bytes\n   *\n   * @param hex - The hex string to convert\n   * @returns Uint8Array of bytes\n   * @private\n   */\n  private static hexToBytes(hex: string): Uint8Array {\n    const bytes = new Uint8Array(hex.length / 2);\n    for (let i = 0; i < hex.length; i += 2) {\n      bytes[i / 2] = parseInt(hex.substr(i, 2), 16);\n    }\n    return bytes;\n  }\n\n  /**\n   * Check if bytes start with a specific prefix\n   *\n   * @param bytes - The bytes to check\n   * @param prefix - The prefix to look for\n   * @returns True if bytes start with the prefix\n   * @private\n   */\n  private static hasPrefix(bytes: Uint8Array, prefix: Buffer): boolean {\n    if (bytes.length < prefix.length) return false;\n    for (let i = 0; i < prefix.length; i++) {\n      if (bytes[i] !== prefix[i]) return false;\n    }\n    return true;\n  }\n\n  /**\n   * Check if bytes contain an ECDSA private key pattern\n   *\n   * @param bytes - The bytes to check\n   * @returns True if ECDSA private key pattern is found\n   * @private\n   */\n  private static containsECDSAPrivateKeyPattern(bytes: Uint8Array): boolean {\n    for (let i = 0; i < bytes.length - 7; i++) {\n      if (\n        bytes[i] === 0x30 &&\n        bytes[i + 1] === 0x74 &&\n        bytes[i + 2] === 0x02 &&\n        bytes[i + 3] === 0x01 &&\n        bytes[i + 4] === 0x01 &&\n        bytes[i + 5] === 0x04 &&\n        bytes[i + 6] === 0x20\n      ) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Extract ECDSA private key from DER structure\n   *\n   * @param bytes - The DER encoded bytes\n   * @returns The extracted private key bytes\n   * @private\n   */\n  private static extractECDSAPrivateKey(bytes: Uint8Array): Uint8Array {\n    for (let i = 0; i < bytes.length - 32; i++) {\n      if (bytes[i] === 0x04 && bytes[i + 1] === 0x20) {\n        return bytes.slice(i + 2, i + 34);\n      }\n    }\n    return bytes;\n  }\n}\n\n/**\n * Detects the key type from a private key string and returns the parsed PrivateKey\n *\n * This function leverages the KeyTypeDetector class to determine whether a key is\n * ED25519 or ECDSA. It handles parsing the key and provides appropriate warnings\n * for uncertain detections.\n *\n * Note: For ambiguous keys, if you have the associated account ID, consider using\n * the Hedera mirror node to confirm the key type for production use.\n *\n * @param privateKeyString The private key string to detect type from\n * @returns The detected key type, parsed PrivateKey, and optional warning\n * @throws Error if the private key cannot be parsed\n */\nexport function detectKeyTypeFromString(\n  privateKeyString: string,\n): KeyDetectionResult {\n  const keyInfo = KeyTypeDetector.detect(privateKeyString);\n\n  if (keyInfo.type !== KeyType.UNKNOWN) {\n    try {\n      const privateKey =\n        keyInfo.type === KeyType.ECDSA\n          ? PrivateKey.fromStringECDSA(privateKeyString)\n          : PrivateKey.fromStringED25519(privateKeyString);\n\n      const result: KeyDetectionResult = {\n        detectedType: keyInfo.type as 'ed25519' | 'ecdsa',\n        privateKey,\n      };\n\n      if (keyInfo.confidence === 'uncertain') {\n        result.warning =\n          `Key type detection is uncertain. If you have the associated account ID, ` +\n          `consider using the Hedera mirror node to confirm the key type.`;\n      }\n\n      return result;\n    } catch (error) {}\n  }\n\n  try {\n    const privateKey = PrivateKey.fromStringECDSA(privateKeyString);\n    return {\n      detectedType: 'ecdsa',\n      privateKey,\n      warning: `Using ECDSA as default. If you have the associated account ID, consider using the Hedera mirror node to confirm the key type.`,\n    };\n  } catch (ecdsaError) {\n    try {\n      const privateKey = PrivateKey.fromStringED25519(privateKeyString);\n      return {\n        detectedType: 'ed25519',\n        privateKey,\n        warning: `Using ED25519 as fallback. If you have the associated account ID, consider using the Hedera mirror node to confirm the key type.`,\n      };\n    } catch (ed25519Error) {\n      throw new Error(\n        `Failed to parse private key as either ECDSA or ED25519: ${ecdsaError}`,\n      );\n    }\n  }\n}\n"],"names":["KeyType"],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es136.js","sources":["../../src/hcs-25/collectors/acp.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { readString } from '../signals';\nimport { Hcs25CollectorHttpError, isTimeoutError, requestJson } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\n/**\n * Marketplace-native performance metrics consumed by the `acp` scoring\n * adapter (stored under `metadata.metrics` with top-level fallbacks).\n */\nexport interface Hcs25AcpMetrics {\n  successRate?: number;\n  successfulJobCount?: number;\n  totalJobCount?: number;\n  volume?: number;\n  revenue?: number;\n  rating?: number;\n}\n\n/**\n * Options for the ACP/Virtuals signal adapter.\n */\nexport interface Hcs25AcpSignalAdapterOptions {\n  /**\n   * Marketplace endpoint: a URL template supporting `{address}` /\n   * `{nativeId}` placeholders, or a function returning the URL (null =\n   * not listed in the marketplace).\n   */\n  endpoint: string | ((subject: Hcs25Subject) => string | null);\n  /**\n   * Maps the marketplace response JSON to normalized metrics. Default reads\n   * the metric keys from the payload root, `.metrics`, or `.agent`.\n   */\n  mapResponse?: (data: unknown) => Hcs25AcpMetrics | null;\n  timeoutMs?: number;\n  includeRegistries?: readonly string[];\n  excludeRegistries?: readonly string[];\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\nconst DEFAULT_INCLUDED_REGISTRIES: readonly string[] = ['virtuals-protocol'];\n\nconst METRIC_KEYS = [\n  'successRate',\n  'successfulJobCount',\n  'totalJobCount',\n  'volume',\n  'revenue',\n  'rating',\n] as const;\n\nfunction pickMetrics(record: unknown): Hcs25AcpMetrics | null {\n  if (typeof record !== 'object' || record === null) {\n    return null;\n  }\n  const source = record as Record<string, unknown>;\n  const metrics: Hcs25AcpMetrics = {};\n  let found = false;\n  for (const key of METRIC_KEYS) {\n    const value = source[key];\n    if (typeof value === 'number' && Number.isFinite(value)) {\n      metrics[key] = value;\n      found = true;\n    }\n  }\n  return found ? metrics : null;\n}\n\nfunction defaultMapResponse(data: unknown): Hcs25AcpMetrics | null {\n  if (typeof data !== 'object' || data === null) {\n    return null;\n  }\n  const root = data as Record<string, unknown>;\n  return (\n    pickMetrics(root.metrics) ?? pickMetrics(root.agent) ?? pickMetrics(root)\n  );\n}\n\nfunction resolveAgentAddress(subject: Hcs25Subject): string | null {\n  const metadata = subject.metadata ?? {};\n  for (const key of ['nativeId', 'address', 'uid']) {\n    const value = readString(metadata, key);\n    if (value) {\n      return value;\n    }\n  }\n  return null;\n}\n\n/**\n * Creates the `acp` signal adapter: fetches marketplace-native recent\n * performance metrics for ACP/Virtuals-style agents and stores them under\n * `metadata.metrics` (with `successRate`/`successfulJobCount` top-level\n * fallbacks per the signal catalog).\n */\nexport function createAcpSignalAdapter(\n  options: Hcs25AcpSignalAdapterOptions,\n): Hcs25SignalAdapter {\n  const mapResponse = options.mapResponse ?? defaultMapResponse;\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const now = context.now.toISOString();\n    const address = resolveAgentAddress(subject) ?? subject.id;\n    const url =\n      typeof options.endpoint === 'function'\n        ? options.endpoint(subject)\n        : options.endpoint\n            .replace('{address}', encodeURIComponent(address))\n            .replace('{nativeId}', encodeURIComponent(address));\n\n    if (!url) {\n      return [{ signalId: 'acp.metrics', status: 'missing' }];\n    }\n\n    try {\n      const data = await requestJson(url, {\n        fetch: context.fetch,\n        timeoutMs: context.timeoutMs,\n        signal: context.signal,\n      });\n      const metrics = mapResponse(data);\n      if (!metrics) {\n        return [{ signalId: 'acp.metrics', status: 'missing' }];\n      }\n\n      const metricsValues: Record<string, Hcs25JsonValue> = {};\n      for (const key of METRIC_KEYS) {\n        const value = metrics[key];\n        if (value !== undefined) {\n          metricsValues[key] = value;\n        }\n      }\n      const rootValues: Record<string, Hcs25JsonValue> = {};\n      if (metrics.successRate !== undefined) {\n        rootValues.successRate = metrics.successRate;\n      }\n      if (metrics.successfulJobCount !== undefined) {\n        rootValues.successfulJobCount = metrics.successfulJobCount;\n      }\n\n      return [\n        {\n          signalId: 'acp.metrics',\n          status: 'ok',\n          value: metrics.successRate ?? null,\n          fields: [\n            { scope: 'metrics', values: metricsValues },\n            { scope: 'root', values: rootValues },\n          ],\n          provenance: {\n            source: 'acp',\n            sourceUrl: url,\n            subjectId: address,\n            fetchedAt: now,\n          },\n        },\n      ];\n    } catch (error) {\n      if (error instanceof Hcs25CollectorHttpError && error.status === 404) {\n        return [{ signalId: 'acp.metrics', status: 'missing' }];\n      }\n      return [\n        {\n          signalId: 'acp.metrics',\n          status: isTimeoutError(error) ? 'timeout' : 'error',\n        },\n      ];\n    }\n  };\n\n  return {\n    id: 'acp',\n    produces: ['acp.metrics'],\n    timeoutMs: options.timeoutMs,\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    excludeRegistries: options.excludeRegistries,\n    appliesTo: options.appliesTo,\n    collect,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/es/standards-sdk.es137.js

@@ -1,16 +1,255 @@
-function getTopicId(inscription) {
-  if (!inscription || typeof inscription !== "object") return void 0;
-  const obj = inscription;
-  const direct = obj.topicId || obj.topic_id;
-  if (typeof direct === "string" && direct.trim()) return direct;
-  const rec = obj;
-  const t1 = rec["topicId"];
-  if (typeof t1 === "string" && t1.trim()) return t1;
-  const t2 = rec["topic_id"];
-  if (typeof t2 === "string" && t2.trim()) return t2;
-  return void 0;
+import { readSubjectAdditional, readString } from "./standards-sdk.es201.js";
+import "./standards-sdk.es184.js";
+import "./standards-sdk.es198.js";
+import "./standards-sdk.es199.js";
+import "./standards-sdk.es200.js";
+import "./standards-sdk.es183.js";
+import { parseTimestampMs } from "./standards-sdk.es123.js";
+import { requestJson, Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
+const AGENTVERSE_API_BASE = "https://agentverse.ai";
+const INSIGHTS_SOURCES = ["agentverse:insights:v1"];
+const AGENTVERSE_ADDRESS_REGEX = /^agent1[qpzry9x8gf2tvdw0s3jn54khce6mua7l]{59}$/i;
+const DEFAULT_INCLUDED_REGISTRIES = ["agentverse", "uagent"];
+function resolveAgentAddress(subject) {
+  const additional = readSubjectAdditional(subject);
+  const metadata = subject.metadata ?? {};
+  for (const value of [
+    readString(additional, "agentverseInsightsAddress"),
+    subject.id,
+    readString(metadata, "nativeId"),
+    readString(metadata, "uid"),
+    readString(metadata, "address")
+  ]) {
+    if (value && AGENTVERSE_ADDRESS_REGEX.test(value.trim())) {
+      return value.trim();
+    }
+  }
+  const uaidFull = readString(metadata, "uaidFull");
+  if (uaidFull) {
+    const nativeId = uaidFull.match(/(?:^|;)nativeId=([^;]+)(?:;|$)/i)?.[1]?.trim();
+    if (nativeId && AGENTVERSE_ADDRESS_REGEX.test(nativeId)) {
+      return nativeId;
+    }
+    const uid = uaidFull.match(/(?:^|;)uid=([^;]+)(?:;|$)/i)?.[1]?.trim();
+    if (uid && AGENTVERSE_ADDRESS_REGEX.test(uid)) {
+      return uid;
+    }
+  }
+  return null;
+}
+function num(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function createAgentverseInsightsSignalAdapter(options = {}) {
+  const baseUrl = options.baseUrl ?? AGENTVERSE_API_BASE;
+  const fetchAgentStatus = options.fetchAgentStatus ?? true;
+  const collect = async (subject, context) => {
+    const now = context.now.toISOString();
+    const address = resolveAgentAddress(subject);
+    if (!address) {
+      return [
+        {
+          signalId: "agentverse.insights",
+          status: "missing",
+          fields: [
+            {
+              scope: "additional",
+              values: {
+                agentverseInsightsStatus: "missing",
+                agentverseInsightsUpdatedAt: now
+              }
+            }
+          ]
+        }
+      ];
+    }
+    if (!context.force) {
+      const additional = readSubjectAdditional(subject);
+      const storedStatus = readString(additional, "agentverseInsightsStatus");
+      const storedUpdatedMs = parseTimestampMs(
+        additional.agentverseInsightsUpdatedAt
+      );
+      if (storedStatus && storedUpdatedMs !== null) {
+        const ttl = storedStatus === "ok" ? options.ttlMs ?? 6 * 60 * 60 * 1e3 : options.failureTtlMs ?? 60 * 60 * 1e3;
+        if (context.now.getTime() - storedUpdatedMs < ttl) {
+          return [
+            {
+              signalId: "agentverse.insights",
+              status: storedStatus === "ok" ? "ok" : "missing",
+              provenance: {
+                source: "agentverse",
+                subjectId: address,
+                fetchedAt: new Date(storedUpdatedMs).toISOString()
+              }
+            }
+          ];
+        }
+      }
+    }
+    const results = [];
+    const sources = [];
+    const contractParam = options.contract ?? readString(readSubjectAdditional(subject), "agentverseInsightsContract");
+    const contractsToTry = contractParam === "mainnet" || contractParam === "testnet" ? [contractParam] : ["mainnet", "testnet"];
+    let insightsResult = { status: "missing" };
+    for (const contract of contractsToTry) {
+      const insightsUrl = `${baseUrl}/v1/search/analytics/insights/${encodeURIComponent(address)}?contract=${contract}`;
+      try {
+        const data = await requestJson(
+          insightsUrl,
+          {
+            fetch: context.fetch,
+            timeoutMs: context.timeoutMs,
+            signal: context.signal
+          }
+        );
+        const hasAnySignal = num(data.rating) !== null || num(data.readme_quality_score) !== null || num(data.readme_uniqueness_score) !== null || num(data.interactions_score) !== null || num(data.avg_response_time) !== null || (num(data.asi1_total_interactions) ?? 0) > 0 || (num(data.asi1_recent_interactions) ?? 0) > 0 || (num(data.verifier_total_interactions) ?? 0) > 0 || (num(data.verifier_recent_interactions) ?? 0) > 0;
+        if (!hasAnySignal) {
+          continue;
+        }
+        insightsResult = { data, contract, url: insightsUrl };
+        break;
+      } catch (error) {
+        if (error instanceof Hcs25CollectorHttpError && (error.status === 404 || error.status === 422)) {
+          continue;
+        }
+        insightsResult = {
+          status: isTimeoutError(error) ? "timeout" : "upstream-error"
+        };
+        break;
+      }
+    }
+    if ("data" in insightsResult) {
+      const { data, contract, url } = insightsResult;
+      sources.push("insights");
+      results.push({
+        signalId: "agentverse.insights",
+        status: "ok",
+        value: num(data.rating),
+        fields: [
+          {
+            scope: "additional",
+            values: {
+              agentverseInsightsUpdatedAt: now,
+              agentverseInsightsStatus: "ok",
+              agentverseInsightsAddress: address,
+              agentverseInsightsContract: contract,
+              agentverseInsightsSources: [...INSIGHTS_SOURCES],
+              agentverseInsightsRating: num(data.rating),
+              agentverseInsightsReadmeQualityScore: num(
+                data.readme_quality_score
+              ),
+              agentverseInsightsReadmeUniquenessScore: num(
+                data.readme_uniqueness_score
+              ),
+              agentverseInsightsInteractionsScore: num(data.interactions_score),
+              agentverseInsightsAvgResponseTime: num(data.avg_response_time),
+              agentverseInsightsAsi1TotalInteractions: num(data.asi1_total_interactions) ?? 0,
+              agentverseInsightsAsi1TotalSuccessInteractions: num(data.asi1_total_success_interactions) ?? 0,
+              agentverseInsightsAsi1RecentInteractions: num(data.asi1_recent_interactions) ?? 0,
+              agentverseInsightsAsi1RecentSuccessInteractions: num(data.asi1_recent_success_interactions) ?? 0,
+              agentverseInsightsVerifierTotalInteractions: num(data.verifier_total_interactions) ?? 0,
+              agentverseInsightsVerifierTotalSuccessInteractions: num(data.verifier_total_success_interactions) ?? 0,
+              agentverseInsightsVerifierRecentInteractions: num(data.verifier_recent_interactions) ?? 0,
+              agentverseInsightsVerifierRecentSuccessInteractions: num(data.verifier_recent_success_interactions) ?? 0
+            }
+          }
+        ],
+        provenance: {
+          source: "agentverse",
+          sourceUrl: url,
+          subjectId: address,
+          fetchedAt: now
+        }
+      });
+    } else {
+      const stored = insightsResult.status === "missing" ? "missing" : "upstream-error";
+      results.push({
+        signalId: "agentverse.insights",
+        status: insightsResult.status === "timeout" ? "timeout" : stored === "missing" ? "missing" : "error",
+        fields: [
+          {
+            scope: "additional",
+            values: {
+              agentverseInsightsUpdatedAt: now,
+              agentverseInsightsStatus: stored,
+              agentverseInsightsAddress: address,
+              agentverseInsightsSources: [...INSIGHTS_SOURCES]
+            }
+          }
+        ],
+        provenance: {
+          source: "agentverse",
+          subjectId: address,
+          fetchedAt: now
+        }
+      });
+    }
+    if (fetchAgentStatus) {
+      const agentUrl = `${baseUrl}/v1/search/agents/${encodeURIComponent(address)}${contractParam ? `?contract=${contractParam}` : ""}`;
+      try {
+        const agent = await requestJson(agentUrl, {
+          fetch: context.fetch,
+          timeoutMs: context.timeoutMs,
+          signal: context.signal
+        });
+        sources.push("search-agent");
+        results.push({
+          signalId: "agentverse.agent_status",
+          status: "ok",
+          value: agent.status ?? null,
+          fields: [
+            {
+              scope: "metrics",
+              values: {
+                isOnline: agent.status === "active",
+                lastActiveAt: agent.last_updated ?? null
+              }
+            }
+          ],
+          provenance: {
+            source: "agentverse",
+            sourceUrl: agentUrl,
+            subjectId: address,
+            fetchedAt: now
+          }
+        });
+      } catch {
+        results.push({
+          signalId: "agentverse.agent_status",
+          status: "missing"
+        });
+      }
+    }
+    if (sources.length > 0) {
+      results.push({
+        signalId: "agentverse.sources",
+        status: "ok",
+        value: sources,
+        fields: [
+          {
+            scope: "additional",
+            values: { agentverseInsightsSources: sources }
+          }
+        ]
+      });
+    }
+    return results;
+  };
+  return {
+    id: "agentverse-insights",
+    produces: [
+      "agentverse.insights",
+      "agentverse.agent_status",
+      "agentverse.sources"
+    ],
+    timeoutMs: options.timeoutMs,
+    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
+    excludeRegistries: options.excludeRegistries,
+    appliesTo: options.appliesTo,
+    collect
+  };
 }
 export {
-  getTopicId
+  createAgentverseInsightsSignalAdapter
 };
 //# sourceMappingURL=standards-sdk.es137.js.map

package/dist/es/standards-sdk.es137.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es137.js","sources":["../../src/utils/topic-id-utils.ts"],"sourcesContent":["/**\n * Utility functions for safely handling topic ID properties that may use different naming conventions\n */\n\n/**\n * Safely extracts topic ID from an inscription result object that may have either `topicId` or `topic_id`\n * @param inscription - The inscription result object\n * @returns The topic ID string or undefined if not found\n */\ntype TopicIdCarrier =\n  | { topicId?: string; topic_id?: string }\n  | Record<string, unknown>\n  | null\n  | undefined;\n\nexport function getTopicId(inscription: unknown): string | undefined {\n  if (!inscription || typeof inscription !== 'object') return undefined;\n  const obj = inscription as TopicIdCarrier;\n  const direct =\n    (obj as { topicId?: string }).topicId ||\n    (obj as { topic_id?: string }).topic_id;\n  if (typeof direct === 'string' && direct.trim()) return direct;\n  const rec = obj as Record<string, unknown>;\n  const t1 = rec['topicId'];\n  if (typeof t1 === 'string' && t1.trim()) return t1;\n  const t2 = rec['topic_id'];\n  if (typeof t2 === 'string' && t2.trim()) return t2;\n  return undefined;\n}\n"],"names":[],"mappings":"AAeO,SAAS,WAAW,aAA0C;AACnE,MAAI,CAAC,eAAe,OAAO,gBAAgB,SAAU,QAAO;AAC5D,QAAM,MAAM;AACZ,QAAM,SACH,IAA6B,WAC7B,IAA8B;AACjC,MAAI,OAAO,WAAW,YAAY,OAAO,KAAA,EAAQ,QAAO;AACxD,QAAM,MAAM;AACZ,QAAM,KAAK,IAAI,SAAS;AACxB,MAAI,OAAO,OAAO,YAAY,GAAG,KAAA,EAAQ,QAAO;AAChD,QAAM,KAAK,IAAI,UAAU;AACzB,MAAI,OAAO,OAAO,YAAY,GAAG,KAAA,EAAQ,QAAO;AAChD,SAAO;AACT;"}
+{"version":3,"file":"standards-sdk.es137.js","sources":["../../src/hcs-25/collectors/agentverse.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { readString, readSubjectAdditional } from '../signals';\nimport { parseTimestampMs } from './freshness';\nimport { Hcs25CollectorHttpError, isTimeoutError, requestJson } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\n\nconst AGENTVERSE_API_BASE = 'https://agentverse.ai';\nconst INSIGHTS_SOURCES = ['agentverse:insights:v1'];\nconst AGENTVERSE_ADDRESS_REGEX =\n  /^agent1[qpzry9x8gf2tvdw0s3jn54khce6mua7l]{59}$/i;\n\n/**\n * Options for the AgentVerse insights signal adapter.\n */\nexport interface Hcs25AgentverseSignalAdapterOptions {\n  /** AgentVerse API base URL. Default `https://agentverse.ai`. */\n  baseUrl?: string;\n  /**\n   * Almanac contract network query hint. When omitted, production behavior\n   * applies: `mainnet` is tried first and `testnet` is probed on\n   * missing/empty payloads.\n   */\n  contract?: 'mainnet' | 'testnet';\n  /**\n   * Also fetch `GET /v1/search/agents/{address}` and store its operational\n   * status as `metrics.isOnline` / `metrics.lastActiveAt`. Default true.\n   */\n  fetchAgentStatus?: boolean;\n  /** Refresh interval for stored `ok` state in ms. Default 6 hours. */\n  ttlMs?: number;\n  /** Refresh interval after a failure state in ms. Default 1 hour. */\n  failureTtlMs?: number;\n  timeoutMs?: number;\n  includeRegistries?: readonly string[];\n  excludeRegistries?: readonly string[];\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\nconst DEFAULT_INCLUDED_REGISTRIES: readonly string[] = ['agentverse', 'uagent'];\n\ninterface AgentverseInsightsResponse {\n  address?: string;\n  rating?: number | null;\n  contract?: string;\n  readme_quality_score?: number | null;\n  readme_uniqueness_score?: number | null;\n  interactions_score?: number | null;\n  avg_response_time?: number | null;\n  recent_uptime?: number | null;\n  asi1_total_interactions?: number | null;\n  asi1_total_success_interactions?: number | null;\n  asi1_recent_interactions?: number | null;\n  asi1_recent_success_interactions?: number | null;\n  verifier_total_interactions?: number | null;\n  verifier_total_success_interactions?: number | null;\n  verifier_recent_interactions?: number | null;\n  verifier_recent_success_interactions?: number | null;\n}\n\ninterface AgentverseAgentResponse {\n  status?: string;\n  last_updated?: string;\n}\n\nfunction resolveAgentAddress(subject: Hcs25Subject): string | null {\n  const additional = readSubjectAdditional(subject);\n  const metadata = subject.metadata ?? {};\n  for (const value of [\n    readString(additional, 'agentverseInsightsAddress'),\n    subject.id,\n    readString(metadata, 'nativeId'),\n    readString(metadata, 'uid'),\n    readString(metadata, 'address'),\n  ]) {\n    if (value && AGENTVERSE_ADDRESS_REGEX.test(value.trim())) {\n      return value.trim();\n    }\n  }\n  const uaidFull = readString(metadata, 'uaidFull');\n  if (uaidFull) {\n    const nativeId = uaidFull\n      .match(/(?:^|;)nativeId=([^;]+)(?:;|$)/i)?.[1]\n      ?.trim();\n    if (nativeId && AGENTVERSE_ADDRESS_REGEX.test(nativeId)) {\n      return nativeId;\n    }\n    const uid = uaidFull.match(/(?:^|;)uid=([^;]+)(?:;|$)/i)?.[1]?.trim();\n    if (uid && AGENTVERSE_ADDRESS_REGEX.test(uid)) {\n      return uid;\n    }\n  }\n  return null;\n}\n\nfunction num(value: number | null | undefined): number | null {\n  return typeof value === 'number' && Number.isFinite(value) ? value : null;\n}\n\n/**\n * Creates the `agentverse-insights` signal adapter: fetches the AgentVerse\n * insights endpoint for the subject's agent address and stores the\n * `agentverseInsights*` field family (rating, quality proxies, interaction\n * and verifier counters) under `metadata.additional`. Optionally also reads\n * the agent record for online status.\n */\nexport function createAgentverseInsightsSignalAdapter(\n  options: Hcs25AgentverseSignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const baseUrl = options.baseUrl ?? AGENTVERSE_API_BASE;\n  const fetchAgentStatus = options.fetchAgentStatus ?? true;\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const now = context.now.toISOString();\n    const address = resolveAgentAddress(subject);\n    if (!address) {\n      return [\n        {\n          signalId: 'agentverse.insights',\n          status: 'missing',\n          fields: [\n            {\n              scope: 'additional',\n              values: {\n                agentverseInsightsStatus: 'missing',\n                agentverseInsightsUpdatedAt: now,\n              },\n            },\n          ],\n        },\n      ];\n    }\n\n    // Freshness gate (production TTL/failure-TTL semantics).\n    if (!context.force) {\n      const additional = readSubjectAdditional(subject);\n      const storedStatus = readString(additional, 'agentverseInsightsStatus');\n      const storedUpdatedMs = parseTimestampMs(\n        (additional as Record<string, Hcs25JsonValue>)\n          .agentverseInsightsUpdatedAt,\n      );\n      if (storedStatus && storedUpdatedMs !== null) {\n        const ttl =\n          storedStatus === 'ok'\n            ? (options.ttlMs ?? 6 * 60 * 60 * 1000)\n            : (options.failureTtlMs ?? 60 * 60 * 1000);\n        if (context.now.getTime() - storedUpdatedMs < ttl) {\n          return [\n            {\n              signalId: 'agentverse.insights',\n              status: storedStatus === 'ok' ? 'ok' : 'missing',\n              provenance: {\n                source: 'agentverse',\n                subjectId: address,\n                fetchedAt: new Date(storedUpdatedMs).toISOString(),\n              },\n            },\n          ];\n        }\n      }\n    }\n\n    const results: Hcs25SignalAdapterResult[] = [];\n    const sources: string[] = [];\n\n    const contractParam =\n      options.contract ??\n      readString(readSubjectAdditional(subject), 'agentverseInsightsContract');\n    // Production behavior: mainnet first, then testnet on 404/422 or an\n    // all-empty payload; non-missing HTTP failures are upstream-error.\n    const contractsToTry: Array<'mainnet' | 'testnet'> =\n      contractParam === 'mainnet' || contractParam === 'testnet'\n        ? [contractParam]\n        : ['mainnet', 'testnet'];\n\n    let insightsResult:\n      | {\n          data: AgentverseInsightsResponse;\n          contract: 'mainnet' | 'testnet';\n          url: string;\n        }\n      | { status: 'missing' | 'upstream-error' }\n      | { status: 'timeout' | 'error' } = { status: 'missing' };\n\n    for (const contract of contractsToTry) {\n      const insightsUrl = `${baseUrl}/v1/search/analytics/insights/${encodeURIComponent(address)}?contract=${contract}`;\n      try {\n        const data = await requestJson<AgentverseInsightsResponse>(\n          insightsUrl,\n          {\n            fetch: context.fetch,\n            timeoutMs: context.timeoutMs,\n            signal: context.signal,\n          },\n        );\n        const hasAnySignal =\n          num(data.rating) !== null ||\n          num(data.readme_quality_score) !== null ||\n          num(data.readme_uniqueness_score) !== null ||\n          num(data.interactions_score) !== null ||\n          num(data.avg_response_time) !== null ||\n          (num(data.asi1_total_interactions) ?? 0) > 0 ||\n          (num(data.asi1_recent_interactions) ?? 0) > 0 ||\n          (num(data.verifier_total_interactions) ?? 0) > 0 ||\n          (num(data.verifier_recent_interactions) ?? 0) > 0;\n        if (!hasAnySignal) {\n          continue;\n        }\n        insightsResult = { data, contract, url: insightsUrl };\n        break;\n      } catch (error) {\n        if (\n          error instanceof Hcs25CollectorHttpError &&\n          (error.status === 404 || error.status === 422)\n        ) {\n          continue;\n        }\n        insightsResult = {\n          status: isTimeoutError(error) ? 'timeout' : 'upstream-error',\n        };\n        break;\n      }\n    }\n\n    if ('data' in insightsResult) {\n      const { data, contract, url } = insightsResult;\n      sources.push('insights');\n      results.push({\n        signalId: 'agentverse.insights',\n        status: 'ok',\n        value: num(data.rating),\n        fields: [\n          {\n            scope: 'additional',\n            values: {\n              agentverseInsightsUpdatedAt: now,\n              agentverseInsightsStatus: 'ok',\n              agentverseInsightsAddress: address,\n              agentverseInsightsContract: contract,\n              agentverseInsightsSources: [...INSIGHTS_SOURCES],\n              agentverseInsightsRating: num(data.rating),\n              agentverseInsightsReadmeQualityScore: num(\n                data.readme_quality_score,\n              ),\n              agentverseInsightsReadmeUniquenessScore: num(\n                data.readme_uniqueness_score,\n              ),\n              agentverseInsightsInteractionsScore: num(data.interactions_score),\n              agentverseInsightsAvgResponseTime: num(data.avg_response_time),\n              agentverseInsightsAsi1TotalInteractions:\n                num(data.asi1_total_interactions) ?? 0,\n              agentverseInsightsAsi1TotalSuccessInteractions:\n                num(data.asi1_total_success_interactions) ?? 0,\n              agentverseInsightsAsi1RecentInteractions:\n                num(data.asi1_recent_interactions) ?? 0,\n              agentverseInsightsAsi1RecentSuccessInteractions:\n                num(data.asi1_recent_success_interactions) ?? 0,\n              agentverseInsightsVerifierTotalInteractions:\n                num(data.verifier_total_interactions) ?? 0,\n              agentverseInsightsVerifierTotalSuccessInteractions:\n                num(data.verifier_total_success_interactions) ?? 0,\n              agentverseInsightsVerifierRecentInteractions:\n                num(data.verifier_recent_interactions) ?? 0,\n              agentverseInsightsVerifierRecentSuccessInteractions:\n                num(data.verifier_recent_success_interactions) ?? 0,\n            },\n          },\n        ],\n        provenance: {\n          source: 'agentverse',\n          sourceUrl: url,\n          subjectId: address,\n          fetchedAt: now,\n        },\n      });\n    } else {\n      const stored =\n        insightsResult.status === 'missing' ? 'missing' : 'upstream-error';\n      results.push({\n        signalId: 'agentverse.insights',\n        status:\n          insightsResult.status === 'timeout'\n            ? 'timeout'\n            : stored === 'missing'\n              ? 'missing'\n              : 'error',\n        fields: [\n          {\n            scope: 'additional',\n            values: {\n              agentverseInsightsUpdatedAt: now,\n              agentverseInsightsStatus: stored,\n              agentverseInsightsAddress: address,\n              agentverseInsightsSources: [...INSIGHTS_SOURCES],\n            },\n          },\n        ],\n        provenance: {\n          source: 'agentverse',\n          subjectId: address,\n          fetchedAt: now,\n        },\n      });\n    }\n\n    if (fetchAgentStatus) {\n      const agentUrl = `${baseUrl}/v1/search/agents/${encodeURIComponent(address)}${contractParam ? `?contract=${contractParam}` : ''}`;\n      try {\n        const agent = await requestJson<AgentverseAgentResponse>(agentUrl, {\n          fetch: context.fetch,\n          timeoutMs: context.timeoutMs,\n          signal: context.signal,\n        });\n        sources.push('search-agent');\n        results.push({\n          signalId: 'agentverse.agent_status',\n          status: 'ok',\n          value: agent.status ?? null,\n          fields: [\n            {\n              scope: 'metrics',\n              values: {\n                isOnline: agent.status === 'active',\n                lastActiveAt: agent.last_updated ?? null,\n              },\n            },\n          ],\n          provenance: {\n            source: 'agentverse',\n            sourceUrl: agentUrl,\n            subjectId: address,\n            fetchedAt: now,\n          },\n        });\n      } catch {\n        results.push({\n          signalId: 'agentverse.agent_status',\n          status: 'missing',\n        });\n      }\n    }\n\n    if (sources.length > 0) {\n      results.push({\n        signalId: 'agentverse.sources',\n        status: 'ok',\n        value: sources,\n        fields: [\n          {\n            scope: 'additional',\n            values: { agentverseInsightsSources: sources },\n          },\n        ],\n      });\n    }\n\n    return results;\n  };\n\n  return {\n    id: 'agentverse-insights',\n    produces: [\n      'agentverse.insights',\n      'agentverse.agent_status',\n      'agentverse.sources',\n    ],\n    timeoutMs: options.timeoutMs,\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    excludeRegistries: options.excludeRegistries,\n    appliesTo: options.appliesTo,\n    collect,\n  };\n}\n"],"names":[],"mappings":"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"}