@hashgraphonline/standards-sdk 0.1.189 → 0.1.190

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es133.js","sources":["../../src/utils/transaction-parser.ts"],"sourcesContent":["import { proto } from '@hashgraph/proto';\nimport { Buffer } from 'buffer';\nimport { Hbar, HbarUnit, Long, Transaction, AccountId } from '@hashgraph/sdk';\nimport { ethers } from 'ethers';\nimport {\n  ParsedTransaction,\n  ValidationResult,\n  ParseOptions,\n  TransactionParsingError,\n  TokenCreationData,\n} from './transaction-parser-types';\nimport { resolveTransactionSummary } from './transaction-summary-registry';\nexport { TransactionParsingError } from './transaction-parser-types';\nimport { HTSParser } from './parsers/hts-parser';\nimport { HCSParser } from './parsers/hcs-parser';\nimport { FileParser } from './parsers/file-parser';\nimport { CryptoParser } from './parsers/crypto-parser';\nimport { SCSParser } from './parsers/scs-parser';\nimport { UtilParser } from './parsers/util-parser';\nimport { ScheduleParser } from './parsers/schedule-parser';\nimport { transactionParserRegistry } from './transaction-parser-registry';\nimport {\n  getHumanReadableTransactionType,\n  getTransactionTypeFromBody,\n} from './transaction-type-registries';\n\ninterface TransactionInternals {\n  _transactionBody?: proto.ITransactionBody;\n  _transactionMemo?: string;\n  _transactionValidStart?: {\n    toString(): string;\n  };\n  _transactionValidDuration?: {\n    toString(): string;\n  };\n  _hbarTransfers?: Array<{\n    accountId: AccountId;\n    amount: Hbar;\n  }>;\n  _tokenTransfers?: Array<{\n    tokenId: { toString(): string };\n    transfers: Array<{\n      accountId?: AccountId;\n      amount?: number | Long;\n    }>;\n  }>;\n  _tokenName?: string;\n  _tokenSymbol?: string;\n  _decimals?: number | Long;\n  _initialSupply?: number | Long;\n  _treasuryAccountId?: AccountId;\n  _adminKey?: any;\n  _kycKey?: any;\n  _freezeKey?: any;\n  _wipeKey?: any;\n  _supplyKey?: any;\n  _feeScheduleKey?: any;\n  _pauseKey?: any;\n  _metadataKey?: any;\n  _freezeDefault?: boolean;\n  _expirationTime?: any;\n  _autoRenewAccountId?: AccountId;\n  _autoRenewPeriod?: any;\n  _tokenMemo?: string;\n  _customFees?: any[];\n  _tokenType?: any;\n  _supplyType?: any;\n  _maxSupply?: number | Long;\n  _metadata?: Buffer;\n  _tokenAirdrops?: any[];\n}\n\n/**\n * Hedera Transaction Parser\n *\n * Supports parsing of both regular Transaction objects and scheduled transaction bytes\n * Provides comprehensive support for all major Hedera transaction types with fallback mechanisms\n */\nexport class TransactionParser {\n  /**\n   * Parse transaction bytes in any supported format (base64 or hex, regular or scheduled)\n   * This is the main entry point for transaction parsing with enhanced retry logic\n   *\n   * @param transactionBytes - Transaction bytes in base64 or hex format\n   * @param options - Parsing options and configuration\n   * @returns Promise resolving to ParsedTransaction\n   */\n  static async parseTransactionBytes(\n    transactionBytes: string,\n    options: ParseOptions = {},\n  ): Promise<ParsedTransaction> {\n    const {\n      enableFallback = true,\n      strictMode = false,\n      includeRaw = true,\n      maxRetries = 2,\n    } = options;\n\n    const validation = this.validateTransactionBytes(transactionBytes);\n    if (!validation.isValid && strictMode) {\n      throw new TransactionParsingError(\n        `Invalid transaction bytes format: ${validation.error}`,\n        'INVALID_FORMAT',\n        undefined,\n        transactionBytes,\n      );\n    }\n\n    let lastError: Error | undefined;\n    let retryCount = 0;\n\n    while (retryCount <= maxRetries) {\n      try {\n        const result = await this.parseTransaction(transactionBytes, options);\n\n        result.formatDetection = {\n          originalFormat: validation.format || 'base64',\n          wasConverted: validation.format === 'hex',\n          length: transactionBytes.length,\n        };\n\n        return result;\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n        retryCount++;\n\n        if (!enableFallback || retryCount > maxRetries) {\n          if (strictMode) {\n            throw new TransactionParsingError(\n              'Failed to parse transaction after all attempts',\n              'PARSING_FAILED',\n              lastError,\n              transactionBytes,\n            );\n          }\n          break;\n        }\n\n        try {\n          const result = this.parseScheduledTransaction(\n            transactionBytes,\n            options,\n          );\n\n          result.formatDetection = {\n            originalFormat: validation.format || 'base64',\n            wasConverted: false,\n            length: transactionBytes.length,\n          };\n\n          return result;\n        } catch (scheduledError) {}\n      }\n    }\n\n    const fallbackResult = this.createFallbackResult(\n      transactionBytes,\n      lastError,\n      undefined,\n    );\n    if (fallbackResult.details) {\n      fallbackResult.details.parseAttempts = Math.max(retryCount, 1);\n    }\n    return fallbackResult;\n  }\n\n  /**\n   * Parse a Transaction object directly using unified delegation approach\n   * This method delegates to specialized parsers for clean separation of concerns\n   *\n   * @param transaction - The Transaction object to parse\n   * @param originalBytes - The original transaction bytes (optional, for protobuf parsing)\n   * @param options - Parsing options\n   * @returns Parsed transaction data\n   */\n  static parseTransactionObject(\n    transaction: Transaction,\n    originalBytesOrOptions?: Uint8Array | ParseOptions,\n    options: ParseOptions = {},\n  ): ParsedTransaction {\n    let originalBytes: Uint8Array | undefined;\n    let actualOptions: ParseOptions;\n\n    if (\n      originalBytesOrOptions &&\n      !Buffer.isBuffer(originalBytesOrOptions) &&\n      !(originalBytesOrOptions instanceof Uint8Array)\n    ) {\n      actualOptions = originalBytesOrOptions as ParseOptions;\n      originalBytes = undefined;\n    } else {\n      originalBytes = originalBytesOrOptions as Uint8Array | undefined;\n      actualOptions = options;\n    }\n    try {\n      const metadata = this.extractTransactionMetadata(transaction);\n\n      const htsResult = HTSParser.parseFromTransactionObject(transaction);\n      const cryptoResult = CryptoParser.parseFromTransactionObject(transaction);\n      const hcsResult = HCSParser.parseFromTransactionObject(transaction);\n      const fileResult = FileParser.parseFromTransactionObject(transaction);\n      const scsResult = SCSParser.parseFromTransactionObject(transaction);\n      const scheduleResult =\n        ScheduleParser.parseFromTransactionObject(transaction);\n      const utilResult = UtilParser.parseFromTransactionObject(transaction);\n\n      const results = [\n        htsResult,\n        cryptoResult,\n        hcsResult,\n        fileResult,\n        scsResult,\n        scheduleResult,\n        utilResult,\n      ];\n      const primaryResult =\n        results.find(result => result.type && result.type !== 'UNKNOWN') || {};\n\n      let finalType = 'UNKNOWN';\n      let finalHumanReadableType = 'Unknown Transaction';\n      let parsedTokenCreation: TokenCreationData | undefined;\n      let protoParsingResult: any = {};\n\n      if (originalBytes || transaction.toBytes) {\n        try {\n          const bytesToParse = originalBytes || transaction.toBytes();\n          const decoded = proto.TransactionList.decode(bytesToParse);\n\n          if (decoded.transactionList && decoded.transactionList.length > 0) {\n            const tx = decoded.transactionList[0];\n\n            if (tx.bodyBytes && tx.bodyBytes.length > 0) {\n              const txBody = proto.TransactionBody.decode(tx.bodyBytes);\n              const typeResult = this.detectTransactionTypeFromBody(txBody);\n              finalType = typeResult.type;\n              finalHumanReadableType = typeResult.humanReadableType;\n\n              protoParsingResult = this.parseTransactionBodyDetails(\n                txBody,\n                finalType,\n              );\n              if (protoParsingResult.tokenCreation) {\n                parsedTokenCreation = protoParsingResult.tokenCreation;\n              }\n            } else if (\n              tx.signedTransactionBytes &&\n              tx.signedTransactionBytes.length > 0\n            ) {\n              const signedTx = proto.SignedTransaction.decode(\n                tx.signedTransactionBytes,\n              );\n              if (signedTx.bodyBytes) {\n                const txBody = proto.TransactionBody.decode(signedTx.bodyBytes);\n                const typeResult = this.detectTransactionTypeFromBody(txBody);\n                finalType = typeResult.type;\n                finalHumanReadableType = typeResult.humanReadableType;\n\n                protoParsingResult = this.parseTransactionBodyDetails(\n                  txBody,\n                  finalType,\n                );\n                if (protoParsingResult.tokenCreation) {\n                  parsedTokenCreation = protoParsingResult.tokenCreation;\n                }\n              }\n            }\n          }\n        } catch (protoError) {}\n      }\n\n      if (finalType === 'UNKNOWN' && primaryResult.type) {\n        finalType = primaryResult.type;\n        finalHumanReadableType =\n          primaryResult.humanReadableType || finalHumanReadableType;\n      }\n\n      const result: ParsedTransaction = {\n        type: finalType,\n        humanReadableType: finalHumanReadableType,\n        transfers: [],\n        tokenTransfers: [],\n        ...metadata,\n        ...primaryResult,\n        raw: actualOptions.includeRaw\n          ? ((transaction as unknown as TransactionInternals)\n              ._transactionBody as proto.SchedulableTransactionBody) ||\n            ({} as proto.SchedulableTransactionBody)\n          : undefined,\n      };\n\n      this.mergeProtoParsingResults(\n        result,\n        protoParsingResult,\n        htsResult,\n        transaction,\n        originalBytes,\n      );\n\n      result.transfers = cryptoResult.transfers || result.transfers || [];\n      result.tokenTransfers =\n        cryptoResult.tokenTransfers || result.tokenTransfers || [];\n\n      return result;\n    } catch (error) {\n      return {\n        type: 'UNKNOWN',\n        humanReadableType: 'Unknown Transaction',\n        transfers: [],\n        tokenTransfers: [],\n        raw: actualOptions.includeRaw\n          ? ({} as proto.SchedulableTransactionBody)\n          : undefined,\n        details: {\n          error: `Failed to parse Transaction object: ${error instanceof Error ? error.message : String(error)}`,\n        },\n      };\n    }\n  }\n\n  /**\n   * Parse a base64 encoded transaction body using registry pattern\n   * @param transactionBodyBase64 - The base64 encoded transaction body\n   * @returns The parsed transaction\n   */\n  static parseTransactionBody(\n    transactionBodyBase64: string,\n  ): ParsedTransaction {\n    try {\n      const buffer = ethers.decodeBase64(transactionBodyBase64);\n      const txBody = proto.SchedulableTransactionBody.decode(buffer);\n\n      const transactionType = this.getTransactionType(txBody);\n\n      const result: ParsedTransaction = {\n        type: transactionType,\n        humanReadableType: this.getHumanReadableType(transactionType),\n        transfers: [],\n        tokenTransfers: [],\n        raw: txBody,\n      };\n\n      if (txBody.memo) {\n        result.memo = txBody.memo;\n      }\n\n      if (txBody.transactionFee) {\n        const hbarAmount = Hbar.fromTinybars(\n          Long.fromValue(txBody.transactionFee),\n        );\n        result.transactionFee = hbarAmount.toString(HbarUnit.Hbar);\n      }\n\n      this.applySchedulableTransactionParsing(txBody, result);\n\n      return result;\n    } catch (error) {\n      return {\n        type: 'UNKNOWN',\n        humanReadableType: 'Unknown Transaction',\n        transfers: [],\n        tokenTransfers: [],\n        raw: undefined,\n        details: {\n          error: `Failed to parse transaction body: ${\n            error instanceof Error ? error.message : String(error)\n          }`,\n        },\n      };\n    }\n  }\n\n  /**\n   * Detect transaction type and human-readable type from transaction body protobuf\n   * Uses registry pattern to eliminate massive if-else chain\n   */\n  private static detectTransactionTypeFromBody(\n    txBody: proto.ITransactionBody,\n  ): {\n    type: string;\n    humanReadableType: string;\n  } {\n    return getTransactionTypeFromBody(txBody as proto.TransactionBody);\n  }\n\n  /**\n   * Parse details from a complete schedule response\n   * @param scheduleResponse - The schedule response to parse\n   * @returns The parsed transaction\n   */\n  static parseScheduleResponse(scheduleResponse: {\n    transaction_body: string;\n    memo?: string;\n  }): ParsedTransaction {\n    if (!scheduleResponse.transaction_body) {\n      return {\n        type: 'UNKNOWN',\n        humanReadableType: 'Unknown Transaction',\n        transfers: [],\n        tokenTransfers: [],\n        raw: undefined,\n        details: {\n          error: 'Schedule response missing transaction_body',\n        },\n      };\n    }\n\n    const parsed = this.parseTransactionBody(scheduleResponse.transaction_body);\n\n    if (scheduleResponse.memo) {\n      parsed.memo = scheduleResponse.memo;\n    }\n\n    return parsed;\n  }\n\n  /**\n   * Determine the transaction type using registry pattern\n   * @param txBody - The transaction body to determine the type of\n   * @returns The type of the transaction\n   */\n  private static getTransactionType(\n    txBody: proto.SchedulableTransactionBody,\n  ): string {\n    return getTransactionTypeFromBody(txBody as proto.TransactionBody).type;\n  }\n\n  /**\n   * Convert technical transaction type to human-readable format using registry pattern\n   * @param type - The technical transaction type\n   * @returns The human-readable transaction type\n   */\n  private static getHumanReadableType(type: string): string {\n    return getHumanReadableTransactionType(type);\n  }\n\n  /**\n   * Get a human-readable summary of the transaction\n   * @param parsedTx - The parsed transaction\n   * @returns The human-readable summary of the transaction\n   */\n  static getTransactionSummary(parsedTx: ParsedTransaction): string {\n    return resolveTransactionSummary(parsedTx);\n  }\n\n  /**\n   * Validate transaction bytes format and encoding\n   * Enhanced validation with better format detection\n   */\n  static validateTransactionBytes(transactionBytes: string): ValidationResult {\n    if (!transactionBytes || typeof transactionBytes !== 'string') {\n      return {\n        isValid: false,\n        error: 'Transaction bytes must be a non-empty string',\n      };\n    }\n\n    const format = this.detectTransactionFormat(transactionBytes);\n    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;\n    const hexRegex = /^0x[0-9a-fA-F]+$/;\n\n    let isValid = false;\n    let error: string | undefined;\n\n    if (format === 'hex') {\n      isValid = hexRegex.test(transactionBytes) && transactionBytes.length > 2;\n      if (!isValid) {\n        error = 'Invalid hex format';\n      }\n    } else {\n      isValid =\n        base64Regex.test(transactionBytes) && transactionBytes.length > 0;\n      if (!isValid) {\n        error = 'Invalid base64 format';\n      }\n    }\n\n    return {\n      isValid,\n      format,\n      error,\n      length: transactionBytes.length,\n    };\n  }\n\n  /**\n   * Detects the format of transaction bytes\n   * @param transactionBytes - The transaction bytes to analyze\n   * @returns The detected format ('base64' or 'hex')\n   */\n  static detectTransactionFormat(transactionBytes: string): 'base64' | 'hex' {\n    return transactionBytes.startsWith('0x') ? 'hex' : 'base64';\n  }\n\n  /**\n   * Decodes transaction bytes from string to Uint8Array\n   * @param transactionBytes - The transaction bytes string (base64 or hex)\n   * @returns Decoded Uint8Array\n   * @throws TransactionParsingError if decoding fails\n   */\n  static decodeTransactionBytes(transactionBytes: string): Uint8Array {\n    try {\n      const format = this.detectTransactionFormat(transactionBytes);\n\n      if (format === 'hex') {\n        const hexString = transactionBytes.slice(2);\n        return new Uint8Array(Buffer.from(hexString, 'hex'));\n      } else {\n        return new Uint8Array(Buffer.from(transactionBytes, 'base64'));\n      }\n    } catch (error) {\n      throw new TransactionParsingError(\n        'Failed to decode transaction bytes',\n        'DECODE_ERROR',\n        error instanceof Error ? error : undefined,\n        transactionBytes,\n      );\n    }\n  }\n\n  /**\n   * Check if transaction bytes represent a valid Hedera transaction\n   */\n  static async isValidHederaTransaction(\n    transactionBytes: string,\n  ): Promise<boolean> {\n    try {\n      if (!this.validateTransactionBytes(transactionBytes).isValid) {\n        return false;\n      }\n\n      const bytes = this.decodeTransactionBytes(transactionBytes);\n      Transaction.fromBytes(bytes);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Legacy alias for decodeTransactionBytes - keeping for backward compatibility\n   */\n  private static decodeBytesLegacy(transactionBytes: string): Uint8Array {\n    return this.decodeTransactionBytes(transactionBytes);\n  }\n\n  /**\n   * Parse transaction bytes into structured data using thin orchestration\n   * Delegates to specialized parsers for clean separation of concerns\n   */\n  private static async parseTransaction(\n    transactionBytes: string,\n    options: ParseOptions = {},\n  ): Promise<ParsedTransaction> {\n    try {\n      const bytes = this.decodeTransactionBytes(transactionBytes);\n      const transaction = Transaction.fromBytes(bytes);\n      const metadata = this.extractTransactionMetadataEnhanced(transaction);\n\n      const parserResults = this.runAllParsers(transaction);\n\n      const primaryResult =\n        parserResults.find(\n          result => result.type && result.type !== 'UNKNOWN',\n        ) || {};\n\n      const protoParsingResult = this.parseFromProtobuf(bytes);\n\n      const finalType =\n        protoParsingResult.type || primaryResult.type || 'UNKNOWN';\n      const finalHumanReadableType =\n        protoParsingResult.humanReadableType ||\n        primaryResult.humanReadableType ||\n        'Unknown Transaction';\n\n      const result: ParsedTransaction = {\n        type: finalType,\n        humanReadableType: finalHumanReadableType,\n        transfers: [],\n        tokenTransfers: [],\n        details: { ...metadata },\n        memo: typeof metadata.memo === 'string' ? metadata.memo : undefined,\n        transactionId:\n          typeof metadata.transactionId === 'string'\n            ? metadata.transactionId\n            : undefined,\n        nodeAccountIds: Array.isArray(metadata.nodeAccountIds)\n          ? metadata.nodeAccountIds\n          : [],\n        maxTransactionFee:\n          typeof metadata.maxTransactionFee === 'string'\n            ? metadata.maxTransactionFee\n            : undefined,\n        validStart:\n          typeof metadata.validStart === 'string'\n            ? metadata.validStart\n            : undefined,\n        validDuration:\n          typeof metadata.validDuration === 'string'\n            ? metadata.validDuration\n            : undefined,\n        raw: options.includeRaw\n          ? ({} as proto.SchedulableTransactionBody)\n          : undefined,\n      };\n\n      this.mergeAllResults(\n        result,\n        protoParsingResult,\n        primaryResult,\n        parserResults,\n      );\n\n      return result;\n    } catch (error) {\n      throw new TransactionParsingError(\n        'Failed to parse as regular transaction',\n        'REGULAR_PARSING_FAILED',\n        error instanceof Error ? error : undefined,\n        transactionBytes,\n      );\n    }\n  }\n\n  /**\n   * Parse scheduled transaction body\n   */\n  private static parseScheduledTransaction(\n    transactionBytes: string,\n    options: ParseOptions = {},\n  ): ParsedTransaction {\n    try {\n      const parsedTx = this.parseTransactionBody(transactionBytes);\n\n      const validation = this.validateTransactionBytes(transactionBytes);\n\n      const enhancedResult: ParsedTransaction = {\n        ...parsedTx,\n        details: {\n          ...(parsedTx.details || {}),\n          parseMethod: 'scheduled',\n          validation,\n          parseAttempts: parsedTx.details?.parseAttempts || 1,\n        },\n        formatDetection: {\n          originalFormat: validation.format || 'base64',\n          wasConverted: false,\n          length: transactionBytes.length,\n        },\n      };\n\n      return enhancedResult;\n    } catch (error) {\n      throw new TransactionParsingError(\n        'Failed to parse as scheduled transaction',\n        'SCHEDULED_PARSING_FAILED',\n        error instanceof Error ? error : undefined,\n        transactionBytes,\n      );\n    }\n  }\n\n  /**\n   * Extract metadata from Transaction object (legacy method - keeping for backward compatibility)\n   */\n  private static extractTransactionMetadata(\n    transaction: Transaction,\n  ): Partial<ParsedTransaction> {\n    return {\n      transactionId: transaction.transactionId?.toString(),\n      nodeAccountIds:\n        transaction.nodeAccountIds?.map(id => id.toString()) || [],\n      maxTransactionFee:\n        transaction.maxTransactionFee?.toTinybars().toString() || '0',\n      memo:\n        (transaction as unknown as TransactionInternals)._transactionMemo ||\n        undefined,\n      transfers: [],\n      tokenTransfers: [],\n    };\n  }\n\n  /**\n   * Extract enhanced metadata from Transaction object\n   */\n  private static extractTransactionMetadataEnhanced(\n    transaction: Transaction,\n  ): Record<string, string | string[] | undefined> {\n    return {\n      transactionId: transaction.transactionId?.toString(),\n      nodeAccountIds:\n        transaction.nodeAccountIds?.map(id => id.toString()) || [],\n      maxTransactionFee:\n        transaction.maxTransactionFee?.toTinybars().toString() || '0',\n      memo:\n        (transaction as unknown as TransactionInternals)._transactionMemo ||\n        undefined,\n      validStart: (\n        transaction as unknown as TransactionInternals\n      )._transactionValidStart?.toString(),\n      validDuration: (\n        transaction as unknown as TransactionInternals\n      )._transactionValidDuration?.toString(),\n    };\n  }\n\n  /**\n   * Run all available parsers on a transaction\n   */\n  private static runAllParsers(transaction: Transaction): any[] {\n    return [\n      HTSParser.parseFromTransactionObject(transaction),\n      CryptoParser.parseFromTransactionObject(transaction),\n      HCSParser.parseFromTransactionObject(transaction),\n      FileParser.parseFromTransactionObject(transaction),\n      SCSParser.parseFromTransactionObject(transaction),\n      ScheduleParser.parseFromTransactionObject(transaction),\n      UtilParser.parseFromTransactionObject(transaction),\n    ];\n  }\n\n  /**\n   * Parse transaction from protobuf bytes\n   */\n  private static parseFromProtobuf(\n    bytes: Uint8Array,\n  ): Partial<ParsedTransaction> {\n    const result: Partial<ParsedTransaction> = {};\n\n    try {\n      const decoded = proto.TransactionList.decode(bytes);\n      if (decoded.transactionList && decoded.transactionList.length > 0) {\n        const tx = decoded.transactionList[0];\n        let txBody: proto.TransactionBody | null = null;\n\n        if (tx.bodyBytes && tx.bodyBytes.length > 0) {\n          txBody = proto.TransactionBody.decode(tx.bodyBytes);\n        } else if (\n          tx.signedTransactionBytes &&\n          tx.signedTransactionBytes.length > 0\n        ) {\n          const signedTx = proto.SignedTransaction.decode(\n            tx.signedTransactionBytes,\n          );\n          if (signedTx.bodyBytes) {\n            txBody = proto.TransactionBody.decode(signedTx.bodyBytes);\n          }\n        }\n\n        if (txBody) {\n          const typeResult = this.detectTransactionTypeFromBody(txBody);\n          result.type = typeResult.type;\n          result.humanReadableType = typeResult.humanReadableType;\n\n          const details = this.parseTransactionBodyDetails(\n            txBody,\n            typeResult.type,\n          );\n          Object.assign(result, details);\n        }\n      }\n    } catch (error) {}\n\n    return result;\n  }\n\n  /**\n   * Intelligently merge all parsing results\n   */\n  private static mergeAllResults(\n    result: ParsedTransaction,\n    protoResult: Partial<ParsedTransaction>,\n    primaryResult: any,\n    parserResults: any[],\n  ): void {\n    const cryptoResult =\n      parserResults.find(r => r.transfers || r.tokenTransfers) || {};\n    result.transfers = cryptoResult.transfers || result.transfers || [];\n    result.tokenTransfers =\n      cryptoResult.tokenTransfers || result.tokenTransfers || [];\n\n    Object.keys(protoResult).forEach(key => {\n      if (\n        protoResult[key as keyof ParsedTransaction] !== undefined &&\n        key !== 'type' &&\n        key !== 'humanReadableType'\n      ) {\n        (result as any)[key] = protoResult[key as keyof ParsedTransaction];\n      }\n    });\n\n    Object.keys(primaryResult).forEach(key => {\n      if (\n        primaryResult[key] !== undefined &&\n        !(key in result) &&\n        key !== 'type' &&\n        key !== 'humanReadableType'\n      ) {\n        (result as any)[key] = primaryResult[key];\n      }\n    });\n  }\n\n  /**\n   * Apply schedulable transaction parsing using registry pattern\n   * Eliminates conditional logic in parseTransactionBody\n   */\n  private static applySchedulableTransactionParsing(\n    txBody: proto.SchedulableTransactionBody,\n    result: ParsedTransaction,\n  ): void {\n    if (txBody.cryptoTransfer) {\n      CryptoParser.parseCryptoTransfers(txBody.cryptoTransfer, result);\n    }\n\n    if (txBody.cryptoDelete) {\n      result.cryptoDelete = CryptoParser.parseCryptoDelete(txBody.cryptoDelete);\n    }\n\n    if (txBody.cryptoCreateAccount) {\n      result.cryptoCreateAccount = CryptoParser.parseCryptoCreateAccount(\n        txBody.cryptoCreateAccount,\n      );\n    }\n\n    if (txBody.cryptoUpdateAccount) {\n      result.cryptoUpdateAccount = CryptoParser.parseCryptoUpdateAccount(\n        txBody.cryptoUpdateAccount,\n      );\n    }\n\n    if (txBody.cryptoApproveAllowance) {\n      result.cryptoApproveAllowance = CryptoParser.parseCryptoApproveAllowance(\n        txBody.cryptoApproveAllowance,\n      );\n    }\n\n    if (txBody.cryptoDeleteAllowance) {\n      result.cryptoDeleteAllowance = CryptoParser.parseCryptoDeleteAllowance(\n        txBody.cryptoDeleteAllowance,\n      );\n    }\n\n    if (txBody.contractCall) {\n      result.contractCall = SCSParser.parseContractCall(txBody.contractCall);\n    }\n\n    if (txBody.contractCreateInstance) {\n      result.contractCreate = SCSParser.parseContractCreate(\n        txBody.contractCreateInstance,\n      );\n    }\n\n    if (txBody.contractUpdateInstance) {\n      result.contractUpdate = SCSParser.parseContractUpdate(\n        txBody.contractUpdateInstance,\n      );\n    }\n\n    if (txBody.contractDeleteInstance) {\n      result.contractDelete = SCSParser.parseContractDelete(\n        txBody.contractDeleteInstance,\n      );\n    }\n\n    if (txBody.tokenCreation) {\n      result.tokenCreation = HTSParser.parseTokenCreate(txBody.tokenCreation);\n    }\n\n    if (txBody.tokenMint) {\n      result.tokenMint = HTSParser.parseTokenMint(txBody.tokenMint);\n    }\n\n    if (txBody.tokenBurn) {\n      result.tokenBurn = HTSParser.parseTokenBurn(txBody.tokenBurn);\n    }\n\n    if (txBody.tokenUpdate) {\n      result.tokenUpdate = HTSParser.parseTokenUpdate(txBody.tokenUpdate);\n    }\n\n    if (txBody.tokenFeeScheduleUpdate) {\n      result.tokenFeeScheduleUpdate = HTSParser.parseTokenFeeScheduleUpdate(\n        txBody.tokenFeeScheduleUpdate,\n      );\n    }\n\n    if (txBody.tokenFreeze) {\n      result.tokenFreeze = HTSParser.parseTokenFreeze(txBody.tokenFreeze);\n    }\n\n    if (txBody.tokenUnfreeze) {\n      result.tokenUnfreeze = HTSParser.parseTokenUnfreeze(txBody.tokenUnfreeze);\n    }\n\n    if (txBody.tokenGrantKyc) {\n      result.tokenGrantKyc = HTSParser.parseTokenGrantKyc(txBody.tokenGrantKyc);\n    }\n\n    if (txBody.tokenRevokeKyc) {\n      result.tokenRevokeKyc = HTSParser.parseTokenRevokeKyc(\n        txBody.tokenRevokeKyc,\n      );\n    }\n\n    if (txBody.tokenPause) {\n      result.tokenPause = HTSParser.parseTokenPause(txBody.tokenPause);\n    }\n\n    if (txBody.tokenUnpause) {\n      result.tokenUnpause = HTSParser.parseTokenUnpause(txBody.tokenUnpause);\n    }\n\n    if (txBody.tokenWipe) {\n      result.tokenWipeAccount = HTSParser.parseTokenWipeAccount(\n        txBody.tokenWipe,\n      );\n    }\n\n    if (txBody.tokenDeletion) {\n      result.tokenDelete = HTSParser.parseTokenDelete(txBody.tokenDeletion);\n    }\n\n    if (txBody.tokenAssociate) {\n      result.tokenAssociate = HTSParser.parseTokenAssociate(\n        txBody.tokenAssociate,\n      );\n    }\n\n    if (txBody.tokenDissociate) {\n      result.tokenDissociate = HTSParser.parseTokenDissociate(\n        txBody.tokenDissociate,\n      );\n    }\n\n    if (txBody.tokenAirdrop) {\n      result.tokenAirdrop = HTSParser.parseTokenAirdropFromProto(\n        txBody.tokenAirdrop,\n      );\n    }\n\n    if (txBody.consensusCreateTopic) {\n      result.consensusCreateTopic = HCSParser.parseConsensusCreateTopic(\n        txBody.consensusCreateTopic,\n      );\n    }\n\n    if (txBody.consensusSubmitMessage) {\n      result.consensusSubmitMessage = HCSParser.parseConsensusSubmitMessage(\n        txBody.consensusSubmitMessage,\n      );\n    }\n\n    if (txBody.consensusUpdateTopic) {\n      result.consensusUpdateTopic = HCSParser.parseConsensusUpdateTopic(\n        txBody.consensusUpdateTopic,\n      );\n    }\n\n    if (txBody.consensusDeleteTopic) {\n      result.consensusDeleteTopic = HCSParser.parseConsensusDeleteTopic(\n        txBody.consensusDeleteTopic,\n      );\n    }\n\n    if (txBody.fileCreate) {\n      result.fileCreate = FileParser.parseFileCreate(txBody.fileCreate);\n    }\n\n    if (txBody.fileAppend) {\n      result.fileAppend = FileParser.parseFileAppend(txBody.fileAppend);\n    }\n\n    if (txBody.fileUpdate) {\n      result.fileUpdate = FileParser.parseFileUpdate(txBody.fileUpdate);\n    }\n\n    if (txBody.fileDelete) {\n      result.fileDelete = FileParser.parseFileDelete(txBody.fileDelete);\n    }\n\n    if (txBody.utilPrng) {\n      result.utilPrng = UtilParser.parseUtilPrng(txBody.utilPrng);\n    }\n  }\n\n  /**\n   * Parse transaction body details for all supported transaction types\n   * Uses a scalable registry pattern instead of if-else chains\n   */\n  private static parseTransactionBodyDetails(\n    txBody: proto.TransactionBody,\n    transactionType: string,\n  ): Partial<ParsedTransaction> {\n    const result: Partial<ParsedTransaction> = {};\n\n    const parserConfig = transactionParserRegistry[transactionType];\n    if (parserConfig) {\n      const bodyData = txBody[parserConfig.bodyField];\n      if (bodyData) {\n        const parserResult = parserConfig.parser(bodyData);\n\n        if (parserConfig.spreadResult) {\n          Object.assign(result, parserResult);\n        } else {\n          result[parserConfig.resultField] = parserResult;\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Merge protobuf parsing results with parser results using registry pattern\n   * Eliminates transactionFields array and forEach logic\n   */\n  private static mergeProtoParsingResults(\n    result: ParsedTransaction,\n    protoResult: Partial<ParsedTransaction>,\n    htsResult: any,\n    transaction: Transaction,\n    originalBytes?: Uint8Array,\n  ): void {\n    const fieldsToMerge = Object.values(transactionParserRegistry).map(\n      config => config.resultField as string,\n    );\n\n    for (const field of fieldsToMerge) {\n      const protoValue = protoResult[field as keyof ParsedTransaction];\n      const htsValue = htsResult[field];\n\n      if (protoValue !== undefined) {\n        (result as any)[field] = protoValue;\n      } else if (htsValue !== undefined) {\n        (result as any)[field] = htsValue;\n      } else {\n        this.handleSpecialFieldExtraction(result, field, transaction);\n      }\n    }\n  }\n\n  /**\n   * Handle special field extraction cases using registry pattern\n   */\n  private static handleSpecialFieldExtraction(\n    result: ParsedTransaction,\n    field: string,\n    transaction: Transaction,\n  ): void {\n    if (field === 'tokenCreation' && result.type === 'TOKENCREATE') {\n      const extracted =\n        HTSParser.extractTokenCreationFromTransaction(transaction);\n      if (extracted) {\n        (result as any)[field] = extracted;\n      }\n    } else if (field === 'tokenAirdrop' && result.type === 'TOKENAIRDROP') {\n      const extracted =\n        HTSParser.extractTokenAirdropFromTransaction(transaction);\n      if (extracted) {\n        (result as any)[field] = extracted;\n      }\n    }\n  }\n\n  /**\n   * Create fallback result when all parsing methods fail\n   */\n  private static createFallbackResult(\n    transactionBytes: string,\n    primaryError?: Error,\n    secondaryError?: Error,\n  ): ParsedTransaction {\n    const validation = this.validateTransactionBytes(transactionBytes);\n\n    return {\n      type: 'UNKNOWN',\n      humanReadableType: 'Unknown Transaction',\n      transfers: [],\n      tokenTransfers: [],\n      details: {\n        rawBytes:\n          transactionBytes.length > 100\n            ? transactionBytes.substring(0, 100) + '...'\n            : transactionBytes,\n        primaryError: primaryError?.message,\n        secondaryError: secondaryError?.message,\n        parseAttempts: secondaryError ? 2 : 1,\n        validation,\n      },\n      formatDetection: {\n        originalFormat: validation.format || 'base64',\n        wasConverted: false,\n        length: transactionBytes.length,\n      },\n      raw: {} as proto.SchedulableTransactionBody,\n    };\n  }\n}\n"],"names":["result"],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es133.js","sources":["../../src/hcs-25/collectors/x402.ts"],"sourcesContent":["import type { Hcs25JsonValue, Hcs25Subject } from '../types';\nimport { isJsonObject, readString } from '../signals';\nimport { parseTimestampMs } from './freshness';\nimport { Hcs25CollectorHttpError, isTimeoutError, requestJson } from './http';\nimport type {\n  Hcs25CollectContext,\n  Hcs25SignalAdapter,\n  Hcs25SignalAdapterResult,\n} from './types';\nimport {\n  fetchX402OnchainUsageState,\n  type Hcs25X402OnchainUsageOptions,\n  type Hcs25X402UsageStateParams,\n  type Hcs25X402UsageStateResult,\n  type Hcs25X402UsageSummary,\n} from './x402-onchain';\n\n/**\n * Pluggable usage-state fetcher (the on-chain scanner by default; inject a\n * stub in tests or a custom implementation for other networks).\n */\nexport type Hcs25X402UsageStateFetcher = (\n  params: Hcs25X402UsageStateParams,\n  options: Hcs25X402OnchainUsageOptions,\n) => Promise<Hcs25X402UsageStateResult>;\n\n/**\n * Options for the x402 usage signal adapter.\n */\nexport interface Hcs25X402SignalAdapterOptions\n  extends Hcs25X402OnchainUsageOptions {\n  /**\n   * Usage source:\n   * - `'onchain'` (default): scans ERC-20 `Transfer` events to/from\n   *   `metadata.payTo` on the `metadata.network` chain via viem.\n   * - a URL template with `{payTo}`/`{asset}`/`{network}` placeholders, or a\n   *   function returning a URL: queries an HTTP usage indexer instead.\n   */\n  source?: 'onchain' | string | ((subject: Hcs25Subject) => string | null);\n  /**\n   * Fully custom usage-state source (e.g. a hosted scanner or a test stub).\n   * Overrides `source` when provided.\n   */\n  fetchUsageState?: Hcs25X402UsageStateFetcher;\n  /**\n   * Refresh interval applied when the stored `x402UsageStatus` is `ok`.\n   * Default 6 hours. The scan is skipped (and the stored summary echoed)\n   * while fresh.\n   */\n  ttlMs?: number;\n  /**\n   * Refresh interval applied after non-`ok` states. Default 3 hours.\n   */\n  failureTtlMs?: number;\n  /** Per-adapter timeout in milliseconds. */\n  timeoutMs?: number;\n  appliesTo?: (subject: Hcs25Subject) => boolean;\n}\n\ninterface X402IndexerResponse {\n  volume7dUsd?: number;\n  volume24hUsd?: number;\n  inboundTrades7d?: number;\n  outboundTrades7d?: number;\n  cursor?: Hcs25JsonValue;\n  summary?: {\n    volume7dUsd?: number;\n    volume24hUsd?: number;\n    inboundTrades7d?: number;\n    outboundTrades7d?: number;\n  };\n}\n\nconst summaryValues = (\n  summary: Partial<Hcs25X402UsageSummary> | null,\n): Record<string, Hcs25JsonValue> => ({\n  x402UsageSummary: summary\n    ? {\n        volume7dUsd: summary.volume7dUsd ?? 0,\n        volume24hUsd: summary.volume24hUsd ?? 0,\n        inboundTrades7d: summary.inboundTrades7d ?? 0,\n        outboundTrades7d: summary.outboundTrades7d ?? 0,\n      }\n    : null,\n});\n\nfunction hasProtocol(subject: Hcs25Subject, wanted: string): boolean {\n  const normalized = wanted.toLowerCase();\n  const direct = subject.protocol?.toLowerCase();\n  if (direct === normalized) {\n    return true;\n  }\n  const metadataProtocol =\n    typeof subject.metadata?.protocol === 'string'\n      ? subject.metadata.protocol.toLowerCase()\n      : null;\n  if (metadataProtocol === normalized) {\n    return true;\n  }\n  const list = (subject as { protocols?: unknown }).protocols;\n  return (\n    Array.isArray(list) &&\n    list.some(\n      entry => typeof entry === 'string' && entry.toLowerCase() === normalized,\n    )\n  );\n}\n\nfunction hasX402Config(subject: Hcs25Subject): boolean {\n  const metadata = subject.metadata ?? {};\n  const configured =\n    readString(metadata, 'payTo') !== null &&\n    readString(metadata, 'asset') !== null &&\n    readString(metadata, 'network') !== null;\n  return configured || hasProtocol(subject, 'x402');\n}\n\nfunction readCursor(subject: Hcs25Subject): Hcs25JsonValue | undefined {\n  const raw = subject.metadata?.x402UsageCursor;\n  return raw === undefined ? undefined : raw;\n}\n\n/**\n * Creates the `x402` signal adapter: scans on-chain x402 payment activity\n * (USD volume + trade counts, chunked `Transfer` log scans resumable via\n * `x402UsageCursor`) or queries a configured HTTP usage indexer, and stores\n * the `x402Usage*` fields per the signal catalog. Fresh `ok` refreshes are\n * skipped per `ttlMs`/`failureTtlMs` unless `context.force` is set.\n */\nexport function createX402SignalAdapter(\n  options: Hcs25X402SignalAdapterOptions = {},\n): Hcs25SignalAdapter {\n  const source = options.source ?? 'onchain';\n  const ttlMs = options.ttlMs ?? 6 * 60 * 60 * 1000;\n  const failureTtlMs = options.failureTtlMs ?? 3 * 60 * 60 * 1000;\n\n  const fetchUsage: Hcs25X402UsageStateFetcher =\n    options.fetchUsageState ?? fetchX402OnchainUsageState;\n  const isHttpSource = typeof source === 'string' && source !== 'onchain';\n  const isUrlFn = typeof source === 'function';\n\n  const collect = async (\n    subject: Hcs25Subject,\n    context: Hcs25CollectContext,\n  ): Promise<Hcs25SignalAdapterResult[]> => {\n    const now = context.now.toISOString();\n    const metadata = subject.metadata ?? {};\n    const payTo = readString(metadata, 'payTo');\n    const asset = readString(metadata, 'asset');\n    const network = readString(metadata, 'network');\n    const cursor = readCursor(subject);\n\n    // Freshness gate: skip the scan while stored fields are still fresh and\n    // echo the stored summary so provenance keeps the original fetchedAt.\n    if (!context.force) {\n      const storedStatus = readString(metadata, 'x402UsageStatus');\n      const storedUpdatedMs = parseTimestampMs(metadata.x402UsageUpdatedAt);\n      if (storedStatus && storedUpdatedMs !== null) {\n        const ttl = storedStatus === 'ok' ? ttlMs : failureTtlMs;\n        if (context.now.getTime() - storedUpdatedMs < ttl) {\n          const storedSummary = isJsonObject(metadata.x402UsageSummary)\n            ? (metadata.x402UsageSummary as Record<string, Hcs25JsonValue>)\n            : null;\n          return [\n            {\n              signalId: 'x402.usage',\n              status: storedStatus === 'ok' ? 'ok' : 'missing',\n              value:\n                storedSummary && typeof storedSummary.volume7dUsd === 'number'\n                  ? storedSummary.volume7dUsd\n                  : null,\n              provenance: {\n                source: 'x402',\n                subjectId: payTo ?? subject.id,\n                fetchedAt: metadata.x402UsageUpdatedAt as string,\n              },\n            },\n          ];\n        }\n      }\n    }\n\n    if (!options.fetchUsageState && (isHttpSource || isUrlFn)) {\n      const resolved = isUrlFn\n        ? (source as (s: Hcs25Subject) => string | null)(subject)\n        : (source as string)\n            .replace('{payTo}', encodeURIComponent(payTo ?? ''))\n            .replace('{asset}', encodeURIComponent(asset ?? ''))\n            .replace('{network}', encodeURIComponent(network ?? ''));\n      const url = typeof resolved === 'string' ? resolved : null;\n\n      if (!url) {\n        return [{ signalId: 'x402.usage', status: 'missing' }];\n      }\n      const urlWithCursor =\n        cursor && isJsonObject(cursor) && typeof cursor.cursor === 'string'\n          ? `${url}${url.includes('?') ? '&' : '?'}cursor=${encodeURIComponent(cursor.cursor)}`\n          : url;\n      try {\n        const data = await requestJson<X402IndexerResponse>(urlWithCursor, {\n          fetch: context.fetch,\n          timeoutMs: context.timeoutMs,\n          signal: context.signal,\n        });\n        const summary = data.summary ?? data;\n        const values: Record<string, Hcs25JsonValue> = {\n          x402UsageStatus: 'ok',\n          x402UsageUpdatedAt: now,\n          x402UsageSource: 'indexer',\n          ...summaryValues(summary),\n        };\n        const nextCursor = data.cursor ?? cursor;\n        if (nextCursor !== undefined) {\n          values.x402UsageCursor = nextCursor;\n        }\n        return [\n          {\n            signalId: 'x402.usage',\n            status: 'ok',\n            value: summary.volume7dUsd ?? null,\n            fields: [{ scope: 'root', values }],\n            provenance: {\n              source: 'x402',\n              sourceUrl: url,\n              subjectId: payTo ?? subject.id,\n              fetchedAt: now,\n            },\n          },\n        ];\n      } catch (error) {\n        const missing =\n          error instanceof Hcs25CollectorHttpError && error.status === 404;\n        const status = missing\n          ? 'missing'\n          : isTimeoutError(error)\n            ? 'timeout'\n            : 'error';\n        return [\n          {\n            signalId: 'x402.usage',\n            status,\n            fields: [\n              {\n                scope: 'root',\n                values: {\n                  x402UsageStatus: missing ? 'missing' : 'error',\n                  x402UsageUpdatedAt: now,\n                  x402UsageSource: 'indexer',\n                },\n              },\n            ],\n          },\n        ];\n      }\n    }\n\n    // On-chain scan (default, matching the production implementation).\n    if (!payTo || !asset || !network) {\n      return [\n        {\n          signalId: 'x402.usage',\n          status: 'missing',\n          fields: [\n            {\n              scope: 'root',\n              values: {\n                x402UsageStatus: 'missing',\n                x402UsageUpdatedAt: now,\n                x402UsageSource: 'onchain',\n                x402UsageSummary: null,\n              },\n            },\n          ],\n        },\n      ];\n    }\n\n    try {\n      const { summary, cursor: nextCursor } = await fetchUsage(\n        { network, asset, payTo, cursor },\n        {\n          days: options.days,\n          ttlMs: options.ttlMs,\n          maxRetries: options.maxRetries,\n          chunkSizeBlocks: options.chunkSizeBlocks,\n          rpcUrls: options.rpcUrls,\n        },\n      );\n      const values: Record<string, Hcs25JsonValue> = {\n        x402UsageStatus: summary ? 'ok' : 'missing',\n        x402UsageUpdatedAt: now,\n        x402UsageSource: 'onchain',\n        ...summaryValues(summary),\n      };\n      if (nextCursor !== null) {\n        values.x402UsageCursor = nextCursor as unknown as Hcs25JsonValue;\n      } else if (cursor !== undefined) {\n        values.x402UsageCursor = cursor;\n      }\n      return [\n        {\n          signalId: 'x402.usage',\n          status: summary ? 'ok' : 'missing',\n          value: summary?.volume7dUsd ?? null,\n          fields: [{ scope: 'root', values }],\n          provenance: {\n            source: 'x402',\n            subjectId: payTo,\n            fetchedAt: now,\n            params: { network, asset, source: 'onchain' },\n          },\n        },\n      ];\n    } catch (error) {\n      return [\n        {\n          signalId: 'x402.usage',\n          status: isTimeoutError(error) ? 'timeout' : 'error',\n          fields: [\n            {\n              scope: 'root',\n              values: {\n                x402UsageStatus: 'error',\n                x402UsageUpdatedAt: now,\n                x402UsageSource: 'onchain',\n                x402UsageSummary: null,\n                ...(cursor !== undefined ? { x402UsageCursor: cursor } : {}),\n              },\n            },\n          ],\n        },\n      ];\n    }\n  };\n\n  return {\n    id: 'x402',\n    produces: ['x402.usage'],\n    timeoutMs: options.timeoutMs,\n    // On-chain scans need network+asset+payTo; HTTP/custom sources only\n    // need a payTo (or the x402 protocol marker) to query.\n    appliesTo:\n      options.appliesTo ??\n      ((subject: Hcs25Subject): boolean => {\n        if (hasX402Config(subject)) {\n          return true;\n        }\n        if (\n          !isHttpSource &&\n          !isUrlFn &&\n          options.fetchUsageState === undefined\n        ) {\n          return false;\n        }\n        return readString(subject.metadata ?? {}, 'payTo') !== null;\n      }),\n    collect,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;AAyEA,MAAM,gBAAgB,CACpB,aACoC;AAAA,EACpC,kBAAkB,UACd;AAAA,IACE,aAAa,QAAQ,eAAe;AAAA,IACpC,cAAc,QAAQ,gBAAgB;AAAA,IACtC,iBAAiB,QAAQ,mBAAmB;AAAA,IAC5C,kBAAkB,QAAQ,oBAAoB;AAAA,EAAA,IAEhD;AACN;AAEA,SAAS,YAAY,SAAuB,QAAyB;AACnE,QAAM,aAAa,OAAO,YAAA;AAC1B,QAAM,SAAS,QAAQ,UAAU,YAAA;AACjC,MAAI,WAAW,YAAY;AACzB,WAAO;AAAA,EACT;AACA,QAAM,mBACJ,OAAO,QAAQ,UAAU,aAAa,WAClC,QAAQ,SAAS,SAAS,YAAA,IAC1B;AACN,MAAI,qBAAqB,YAAY;AACnC,WAAO;AAAA,EACT;AACA,QAAM,OAAQ,QAAoC;AAClD,SACE,MAAM,QAAQ,IAAI,KAClB,KAAK;AAAA,IACH,WAAS,OAAO,UAAU,YAAY,MAAM,kBAAkB;AAAA,EAAA;AAGpE;AAEA,SAAS,cAAc,SAAgC;AACrD,QAAM,WAAW,QAAQ,YAAY,CAAA;AACrC,QAAM,aACJ,WAAW,UAAU,OAAO,MAAM,QAClC,WAAW,UAAU,OAAO,MAAM,QAClC,WAAW,UAAU,SAAS,MAAM;AACtC,SAAO,cAAc,YAAY,SAAS,MAAM;AAClD;AAEA,SAAS,WAAW,SAAmD;AACrE,QAAM,MAAM,QAAQ,UAAU;AAC9B,SAAO,QAAQ,SAAY,SAAY;AACzC;AASO,SAAS,wBACd,UAAyC,IACrB;AACpB,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,QAAQ,QAAQ,SAAS,IAAI,KAAK,KAAK;AAC7C,QAAM,eAAe,QAAQ,gBAAgB,IAAI,KAAK,KAAK;AAE3D,QAAM,aACJ,QAAQ,mBAAmB;AAC7B,QAAM,eAAe,OAAO,WAAW,YAAY,WAAW;AAC9D,QAAM,UAAU,OAAO,WAAW;AAElC,QAAM,UAAU,OACd,SACA,YACwC;AACxC,UAAM,MAAM,QAAQ,IAAI,YAAA;AACxB,UAAM,WAAW,QAAQ,YAAY,CAAA;AACrC,UAAM,QAAQ,WAAW,UAAU,OAAO;AAC1C,UAAM,QAAQ,WAAW,UAAU,OAAO;AAC1C,UAAM,UAAU,WAAW,UAAU,SAAS;AAC9C,UAAM,SAAS,WAAW,OAAO;AAIjC,QAAI,CAAC,QAAQ,OAAO;AAClB,YAAM,eAAe,WAAW,UAAU,iBAAiB;AAC3D,YAAM,kBAAkB,iBAAiB,SAAS,kBAAkB;AACpE,UAAI,gBAAgB,oBAAoB,MAAM;AAC5C,cAAM,MAAM,iBAAiB,OAAO,QAAQ;AAC5C,YAAI,QAAQ,IAAI,QAAA,IAAY,kBAAkB,KAAK;AACjD,gBAAM,gBAAgB,aAAa,SAAS,gBAAgB,IACvD,SAAS,mBACV;AACJ,iBAAO;AAAA,YACL;AAAA,cACE,UAAU;AAAA,cACV,QAAQ,iBAAiB,OAAO,OAAO;AAAA,cACvC,OACE,iBAAiB,OAAO,cAAc,gBAAgB,WAClD,cAAc,cACd;AAAA,cACN,YAAY;AAAA,gBACV,QAAQ;AAAA,gBACR,WAAW,SAAS,QAAQ;AAAA,gBAC5B,WAAW,SAAS;AAAA,cAAA;AAAA,YACtB;AAAA,UACF;AAAA,QAEJ;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,QAAQ,oBAAoB,gBAAgB,UAAU;AACzD,YAAM,WAAW,UACZ,OAA8C,OAAO,IACrD,OACE,QAAQ,WAAW,mBAAmB,SAAS,EAAE,CAAC,EAClD,QAAQ,WAAW,mBAAmB,SAAS,EAAE,CAAC,EAClD,QAAQ,aAAa,mBAAmB,WAAW,EAAE,CAAC;AAC7D,YAAM,MAAM,OAAO,aAAa,WAAW,WAAW;AAEtD,UAAI,CAAC,KAAK;AACR,eAAO,CAAC,EAAE,UAAU,cAAc,QAAQ,WAAW;AAAA,MACvD;AACA,YAAM,gBACJ,UAAU,aAAa,MAAM,KAAK,OAAO,OAAO,WAAW,WACvD,GAAG,GAAG,GAAG,IAAI,SAAS,GAAG,IAAI,MAAM,GAAG,UAAU,mBAAmB,OAAO,MAAM,CAAC,KACjF;AACN,UAAI;AACF,cAAM,OAAO,MAAM,YAAiC,eAAe;AAAA,UACjE,OAAO,QAAQ;AAAA,UACf,WAAW,QAAQ;AAAA,UACnB,QAAQ,QAAQ;AAAA,QAAA,CACjB;AACD,cAAM,UAAU,KAAK,WAAW;AAChC,cAAM,SAAyC;AAAA,UAC7C,iBAAiB;AAAA,UACjB,oBAAoB;AAAA,UACpB,iBAAiB;AAAA,UACjB,GAAG,cAAc,OAAO;AAAA,QAAA;AAE1B,cAAM,aAAa,KAAK,UAAU;AAClC,YAAI,eAAe,QAAW;AAC5B,iBAAO,kBAAkB;AAAA,QAC3B;AACA,eAAO;AAAA,UACL;AAAA,YACE,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,OAAO,QAAQ,eAAe;AAAA,YAC9B,QAAQ,CAAC,EAAE,OAAO,QAAQ,QAAQ;AAAA,YAClC,YAAY;AAAA,cACV,QAAQ;AAAA,cACR,WAAW;AAAA,cACX,WAAW,SAAS,QAAQ;AAAA,cAC5B,WAAW;AAAA,YAAA;AAAA,UACb;AAAA,QACF;AAAA,MAEJ,SAAS,OAAO;AACd,cAAM,UACJ,iBAAiB,2BAA2B,MAAM,WAAW;AAC/D,cAAM,SAAS,UACX,YACA,eAAe,KAAK,IAClB,YACA;AACN,eAAO;AAAA,UACL;AAAA,YACE,UAAU;AAAA,YACV;AAAA,YACA,QAAQ;AAAA,cACN;AAAA,gBACE,OAAO;AAAA,gBACP,QAAQ;AAAA,kBACN,iBAAiB,UAAU,YAAY;AAAA,kBACvC,oBAAoB;AAAA,kBACpB,iBAAiB;AAAA,gBAAA;AAAA,cACnB;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MAEJ;AAAA,IACF;AAGA,QAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS;AAChC,aAAO;AAAA,QACL;AAAA,UACE,UAAU;AAAA,UACV,QAAQ;AAAA,UACR,QAAQ;AAAA,YACN;AAAA,cACE,OAAO;AAAA,cACP,QAAQ;AAAA,gBACN,iBAAiB;AAAA,gBACjB,oBAAoB;AAAA,gBACpB,iBAAiB;AAAA,gBACjB,kBAAkB;AAAA,cAAA;AAAA,YACpB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IAEJ;AAEA,QAAI;AACF,YAAM,EAAE,SAAS,QAAQ,WAAA,IAAe,MAAM;AAAA,QAC5C,EAAE,SAAS,OAAO,OAAO,OAAA;AAAA,QACzB;AAAA,UACE,MAAM,QAAQ;AAAA,UACd,OAAO,QAAQ;AAAA,UACf,YAAY,QAAQ;AAAA,UACpB,iBAAiB,QAAQ;AAAA,UACzB,SAAS,QAAQ;AAAA,QAAA;AAAA,MACnB;AAEF,YAAM,SAAyC;AAAA,QAC7C,iBAAiB,UAAU,OAAO;AAAA,QAClC,oBAAoB;AAAA,QACpB,iBAAiB;AAAA,QACjB,GAAG,cAAc,OAAO;AAAA,MAAA;AAE1B,UAAI,eAAe,MAAM;AACvB,eAAO,kBAAkB;AAAA,MAC3B,WAAW,WAAW,QAAW;AAC/B,eAAO,kBAAkB;AAAA,MAC3B;AACA,aAAO;AAAA,QACL;AAAA,UACE,UAAU;AAAA,UACV,QAAQ,UAAU,OAAO;AAAA,UACzB,OAAO,SAAS,eAAe;AAAA,UAC/B,QAAQ,CAAC,EAAE,OAAO,QAAQ,QAAQ;AAAA,UAClC,YAAY;AAAA,YACV,QAAQ;AAAA,YACR,WAAW;AAAA,YACX,WAAW;AAAA,YACX,QAAQ,EAAE,SAAS,OAAO,QAAQ,UAAA;AAAA,UAAU;AAAA,QAC9C;AAAA,MACF;AAAA,IAEJ,SAAS,OAAO;AACd,aAAO;AAAA,QACL;AAAA,UACE,UAAU;AAAA,UACV,QAAQ,eAAe,KAAK,IAAI,YAAY;AAAA,UAC5C,QAAQ;AAAA,YACN;AAAA,cACE,OAAO;AAAA,cACP,QAAQ;AAAA,gBACN,iBAAiB;AAAA,gBACjB,oBAAoB;AAAA,gBACpB,iBAAiB;AAAA,gBACjB,kBAAkB;AAAA,gBAClB,GAAI,WAAW,SAAY,EAAE,iBAAiB,OAAA,IAAW,CAAA;AAAA,cAAC;AAAA,YAC5D;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IAEJ;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,UAAU,CAAC,YAAY;AAAA,IACvB,WAAW,QAAQ;AAAA;AAAA;AAAA,IAGnB,WACE,QAAQ,cACP,CAAC,YAAmC;AACnC,UAAI,cAAc,OAAO,GAAG;AAC1B,eAAO;AAAA,MACT;AACA,UACE,CAAC,gBACD,CAAC,WACD,QAAQ,oBAAoB,QAC5B;AACA,eAAO;AAAA,MACT;AACA,aAAO,WAAW,QAAQ,YAAY,CAAA,GAAI,OAAO,MAAM;AAAA,IACzD;AAAA,IACF;AAAA,EAAA;AAEJ;"}

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

@@ -1,16 +1,382 @@
-class TransactionParsingError extends Error {
-  constructor(message, code = "PARSING_FAILED", originalError, transactionBytes) {
-    super(message);
-    this.name = "TransactionParsingError";
-    this.code = code;
-    this.originalError = originalError;
-    this.transactionBytes = transactionBytes;
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, TransactionParsingError);
+import { getAddress, http, createPublicClient, fallback, formatUnits } from "viem";
+import { baseSepolia, base } from "viem/chains";
+const TRANSFER_EVENT_ABI = [
+  {
+    type: "event",
+    name: "Transfer",
+    inputs: [
+      { indexed: true, name: "from", type: "address" },
+      { indexed: true, name: "to", type: "address" },
+      { indexed: false, name: "value", type: "uint256" }
+    ],
+    anonymous: false
+  }
+];
+const DECIMALS_ABI = [
+  {
+    type: "function",
+    name: "decimals",
+    inputs: [],
+    outputs: [{ name: "", type: "uint8" }],
+    stateMutability: "view"
+  }
+];
+const NETWORK_CONFIG = {
+  base: {
+    chain: base,
+    rpcUrls: [
+      "https://mainnet.base.org",
+      "https://1rpc.io/base",
+      "https://base.llamarpc.com",
+      "https://base-rpc.publicnode.com"
+    ],
+    usdcAddresses: /* @__PURE__ */ new Set(["0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"])
+  },
+  "base-sepolia": {
+    chain: baseSepolia,
+    rpcUrls: [
+      "https://sepolia.base.org",
+      "https://1rpc.io/base-sepolia",
+      "https://base-sepolia-rpc.publicnode.com"
+    ],
+    usdcAddresses: /* @__PURE__ */ new Set(["0x036cbd53842c5426634e7929541ec2318f3dcf7e"])
+  }
+};
+const toNetwork = (value) => {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "base") {
+    return "base";
+  }
+  if (normalized === "base-sepolia" || normalized === "basesepolia") {
+    return "base-sepolia";
+  }
+  return null;
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const round6 = (value) => Math.round(value * 1e6) / 1e6;
+const toDayStringUtc = (timestampMs) => {
+  const date = new Date(timestampMs);
+  return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, "0")}-${String(
+    date.getUTCDate()
+  ).padStart(2, "0")}`;
+};
+const decimalsCache = /* @__PURE__ */ new Map();
+const fromBlockCache = /* @__PURE__ */ new Map();
+const blockDayCache = /* @__PURE__ */ new Map();
+async function withRetries(operation, maxRetries, baseDelayMs) {
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+    try {
+      return await operation();
+    } catch (error) {
+      lastError = error;
+      if (attempt >= maxRetries) {
+        throw error;
+      }
+      await sleep(baseDelayMs * 2 ** attempt);
+    }
+  }
+  throw lastError;
+}
+const keepRollingDays = (buckets, keepDays) => {
+  const keep = /* @__PURE__ */ new Set();
+  const today = toDayStringUtc(Date.now());
+  const [year, month, day] = today.split("-").map((v) => Number.parseInt(v, 10));
+  const baseUtc = Date.UTC(year, month - 1, day);
+  for (let offset = 0; offset < keepDays; offset += 1) {
+    keep.add(toDayStringUtc(baseUtc - offset * 24 * 60 * 60 * 1e3));
+  }
+  return buckets.filter((bucket) => keep.has(bucket.day)).sort((a, b) => a.day < b.day ? -1 : a.day > b.day ? 1 : 0).slice(-keepDays);
+};
+function parseCursor(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const cursor = value;
+  if (typeof cursor.asset !== "string" || typeof cursor.payTo !== "string" || typeof cursor.lastScannedBlock !== "number" || !Number.isFinite(cursor.lastScannedBlock) || cursor.lastScannedBlock < 0 || !Array.isArray(cursor.daily)) {
+    return null;
+  }
+  const network = toNetwork(cursor.network);
+  if (!network) {
+    return null;
+  }
+  const daily = cursor.daily.filter(
+    (entry) => !!entry && typeof entry === "object" && typeof entry.day === "string" && typeof entry.inboundTrades === "number" && Number.isFinite(entry.inboundTrades) && typeof entry.outboundTrades === "number" && Number.isFinite(entry.outboundTrades) && typeof entry.volumeUsd === "number" && Number.isFinite(entry.volumeUsd)
+  ).map((entry) => ({
+    day: entry.day,
+    inboundTrades: Math.max(0, Math.floor(entry.inboundTrades)),
+    outboundTrades: Math.max(0, Math.floor(entry.outboundTrades)),
+    volumeUsd: round6(Math.max(0, entry.volumeUsd))
+  }));
+  return {
+    network,
+    asset: cursor.asset,
+    payTo: cursor.payTo,
+    lastScannedBlock: Math.floor(cursor.lastScannedBlock),
+    daily
+  };
+}
+async function resolveDecimals(params) {
+  if (params.isUsdc) {
+    return 6;
+  }
+  const cacheKey = `${params.client.chain?.id ?? "unknown"}:${params.asset}:decimals`;
+  const cached = decimalsCache.get(cacheKey);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.value;
+  }
+  const decimals = await withRetries(
+    async () => {
+      const value = await params.client.readContract({
+        address: params.asset,
+        abi: DECIMALS_ABI,
+        functionName: "decimals"
+      });
+      return Number(value);
+    },
+    params.maxRetries,
+    200
+  );
+  const normalized = Number.isFinite(decimals) ? Math.max(0, Math.min(255, Math.floor(decimals))) : 18;
+  decimalsCache.set(cacheKey, {
+    value: normalized,
+    expiresAt: Date.now() + params.cacheTtlMs
+  });
+  return normalized;
+}
+async function estimateFromBlockByTimestamp(params) {
+  const cached = fromBlockCache.get(params.cacheKey);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.value;
+  }
+  const latestBlockNumber = await withRetries(
+    () => params.client.getBlockNumber(),
+    params.maxRetries,
+    200
+  );
+  const latest = await withRetries(
+    () => params.client.getBlock({ blockNumber: latestBlockNumber }),
+    params.maxRetries,
+    200
+  );
+  const probeDelta = 5000n;
+  const probeBlockNumber = latestBlockNumber > probeDelta ? latestBlockNumber - probeDelta : 0n;
+  const probe = await withRetries(
+    () => params.client.getBlock({ blockNumber: probeBlockNumber }),
+    params.maxRetries,
+    200
+  );
+  const latestTs = BigInt(latest.timestamp);
+  const probeTs = BigInt(probe.timestamp);
+  const deltaSeconds = latestTs > probeTs ? latestTs - probeTs : 0n;
+  const secondsPerBlock = deltaSeconds > 0n ? Number(deltaSeconds) / Number(latestBlockNumber - probeBlockNumber || 1n) : 2;
+  const secondsAgo = latestTs > params.targetTimestampSec ? latestTs - params.targetTimestampSec : 0n;
+  const approxBlocksAgo = secondsPerBlock > 0 ? BigInt(Math.ceil(Number(secondsAgo) / secondsPerBlock)) : 0n;
+  const margin = 1000n;
+  let low = latestBlockNumber > approxBlocksAgo + margin ? latestBlockNumber - approxBlocksAgo - margin : 0n;
+  let high = latestBlockNumber;
+  while (low < high) {
+    const mid = (low + high) / 2n;
+    const block = await withRetries(
+      () => params.client.getBlock({ blockNumber: mid }),
+      params.maxRetries,
+      200
+    );
+    if (BigInt(block.timestamp) >= params.targetTimestampSec) {
+      high = mid;
+    } else {
+      low = mid + 1n;
+    }
+  }
+  fromBlockCache.set(params.cacheKey, {
+    value: low,
+    expiresAt: Date.now() + params.cacheTtlMs
+  });
+  return low;
+}
+async function resolveBlockDay(params) {
+  const cacheKey = `${params.client.chain?.id ?? "unknown"}:${params.blockNumber.toString()}:day`;
+  const cached = blockDayCache.get(cacheKey);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached.value;
+  }
+  const block = await withRetries(
+    () => params.client.getBlock({ blockNumber: params.blockNumber }),
+    params.maxRetries,
+    200
+  );
+  const day = toDayStringUtc(Number(block.timestamp) * 1e3);
+  blockDayCache.set(cacheKey, {
+    value: day,
+    expiresAt: Date.now() + params.cacheTtlMs
+  });
+  return day;
+}
+async function fetchX402OnchainUsageState(params, options = {}) {
+  const network = toNetwork(params.network);
+  if (!network) {
+    return { summary: null, cursor: null };
+  }
+  const config = NETWORK_CONFIG[network];
+  if (typeof params.asset !== "string" || typeof params.payTo !== "string") {
+    return { summary: null, cursor: null };
+  }
+  let asset;
+  let payTo;
+  try {
+    asset = getAddress(params.asset.trim());
+    payTo = getAddress(params.payTo.trim());
+  } catch {
+    return { summary: null, cursor: null };
+  }
+  const now = Date.now();
+  const ttlMs = typeof options.ttlMs === "number" && Number.isFinite(options.ttlMs) && options.ttlMs > 0 ? options.ttlMs : 30 * 60 * 1e3;
+  const maxRetries = typeof options.maxRetries === "number" && Number.isFinite(options.maxRetries) && options.maxRetries >= 0 ? Math.floor(options.maxRetries) : 2;
+  const chunkSizeBlocks = typeof options.chunkSizeBlocks === "number" && Number.isFinite(options.chunkSizeBlocks) && options.chunkSizeBlocks > 0 ? BigInt(Math.floor(options.chunkSizeBlocks)) : 50000n;
+  const rpcUrls = options.rpcUrls?.[network]?.length ? [...options.rpcUrls[network]] : config.rpcUrls;
+  const transports = rpcUrls.map((url) => http(url));
+  if (transports.length === 0) {
+    return { summary: null, cursor: null };
+  }
+  const client = createPublicClient({
+    chain: config.chain,
+    transport: transports.length > 1 ? fallback(transports) : transports[0]
+  });
+  const assetLower = asset.toLowerCase();
+  const payToLower = payTo.toLowerCase();
+  const decimals = await resolveDecimals({
+    client,
+    asset,
+    isUsdc: config.usdcAddresses.has(assetLower),
+    cacheTtlMs: ttlMs,
+    maxRetries
+  });
+  const days = typeof options.days === "number" && Number.isFinite(options.days) && options.days > 0 ? Math.min(14, Math.max(1, Math.floor(options.days))) : 7;
+  const targetTimestampSec = BigInt(
+    Math.floor((now - days * 24 * 60 * 60 * 1e3) / 1e3)
+  );
+  const windowFromBlock = await estimateFromBlockByTimestamp({
+    client,
+    targetTimestampSec,
+    cacheKey: `${network}:${assetLower}:${payToLower}:fromBlock:${days}`,
+    cacheTtlMs: ttlMs,
+    maxRetries
+  });
+  const toBlock = await client.getBlockNumber();
+  const parsedCursor = parseCursor(params.cursor);
+  const hasMatchingCursor = parsedCursor !== null && parsedCursor.network === network && parsedCursor.asset.toLowerCase() === assetLower && parsedCursor.payTo.toLowerCase() === payToLower;
+  const cursorFromBlock = hasMatchingCursor && parsedCursor ? BigInt(Math.max(0, parsedCursor.lastScannedBlock + 1)) : windowFromBlock;
+  const fromBlock = cursorFromBlock < windowFromBlock ? windowFromBlock : cursorFromBlock;
+  const shouldResync = !hasMatchingCursor || cursorFromBlock < windowFromBlock;
+  const bucketsByDay = /* @__PURE__ */ new Map();
+  if (!shouldResync && parsedCursor) {
+    for (const bucket of keepRollingDays(parsedCursor.daily, days)) {
+      bucketsByDay.set(bucket.day, { ...bucket });
+    }
+  }
+  const ensureBucket = (day) => {
+    const existing = bucketsByDay.get(day);
+    if (existing) {
+      return existing;
+    }
+    const created = {
+      day,
+      inboundTrades: 0,
+      outboundTrades: 0,
+      volumeUsd: 0
+    };
+    bucketsByDay.set(day, created);
+    return created;
+  };
+  const aggregateLogs = async (direction) => {
+    if (toBlock < fromBlock) {
+      return;
+    }
+    for (let start = fromBlock; start <= toBlock; ) {
+      const end = start + chunkSizeBlocks - 1n <= toBlock ? start + chunkSizeBlocks - 1n : toBlock;
+      const args = direction === "inbound" ? { to: payTo } : { from: payTo };
+      const logs = await withRetries(
+        () => client.getLogs({
+          address: asset,
+          event: TRANSFER_EVENT_ABI[0],
+          args,
+          fromBlock: start,
+          toBlock: end
+        }),
+        maxRetries,
+        200
+      );
+      for (const log of logs) {
+        const blockNumber = log.blockNumber ?? null;
+        if (!blockNumber) {
+          continue;
+        }
+        const value = log.args.value ?? 0n;
+        if (value <= 0n) {
+          continue;
+        }
+        const day = await resolveBlockDay({
+          client,
+          blockNumber,
+          cacheTtlMs: ttlMs,
+          maxRetries
+        });
+        const bucket = ensureBucket(day);
+        if (direction === "inbound") {
+          bucket.inboundTrades += 1;
+        } else {
+          bucket.outboundTrades += 1;
+        }
+        const amount = Number.parseFloat(formatUnits(value, decimals));
+        if (Number.isFinite(amount) && amount > 0) {
+          bucket.volumeUsd = round6(bucket.volumeUsd + amount);
+        }
+      }
+      start = end + 1n;
     }
+  };
+  await aggregateLogs("inbound");
+  await aggregateLogs("outbound");
+  const mergedDaily = keepRollingDays(Array.from(bucketsByDay.values()), days);
+  const inboundTrades7d = mergedDaily.reduce(
+    (sum, bucket) => sum + bucket.inboundTrades,
+    0
+  );
+  const outboundTrades7d = mergedDaily.reduce(
+    (sum, bucket) => sum + bucket.outboundTrades,
+    0
+  );
+  const volume7dUsd = round6(
+    mergedDaily.reduce((sum, bucket) => sum + bucket.volumeUsd, 0)
+  );
+  const today = toDayStringUtc(now);
+  const volume24hUsd = round6(
+    mergedDaily.filter((bucket) => bucket.day === today).reduce((sum, bucket) => sum + bucket.volumeUsd, 0)
+  );
+  const cursor = {
+    network,
+    asset: assetLower,
+    payTo: payToLower,
+    lastScannedBlock: Number(toBlock),
+    daily: mergedDaily
+  };
+  if (inboundTrades7d + outboundTrades7d <= 0) {
+    return { summary: null, cursor };
   }
+  return {
+    summary: {
+      volume7dUsd,
+      volume24hUsd,
+      inboundTrades7d,
+      outboundTrades7d
+    },
+    cursor
+  };
 }
 export {
-  TransactionParsingError
+  fetchX402OnchainUsageState
 };
 //# sourceMappingURL=standards-sdk.es134.js.map