@hashgraphonline/standards-sdk 0.1.188 → 0.1.190

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

@@ -1,793 +1,233 @@
-import { proto } from "@hashgraph/proto";
-import { Buffer } from "buffer";
-import { Hbar, Long, HbarUnit, Transaction } from "@hashgraph/sdk";
-import { ethers } from "ethers";
-import { TransactionParsingError } from "./standards-sdk.es134.js";
-import { resolveTransactionSummary } from "./standards-sdk.es135.js";
-import { HTSParser } from "./standards-sdk.es143.js";
-import { HCSParser } from "./standards-sdk.es192.js";
-import { FileParser } from "./standards-sdk.es193.js";
-import { CryptoParser } from "./standards-sdk.es194.js";
-import { SCSParser } from "./standards-sdk.es195.js";
-import { UtilParser } from "./standards-sdk.es196.js";
-import { ScheduleParser } from "./standards-sdk.es144.js";
-import { transactionParserRegistry } from "./standards-sdk.es145.js";
-import { getTransactionTypeFromBody, getHumanReadableTransactionType } from "./standards-sdk.es146.js";
-class TransactionParser {
-  /**
-   * Parse transaction bytes in any supported format (base64 or hex, regular or scheduled)
-   * This is the main entry point for transaction parsing with enhanced retry logic
-   *
-   * @param transactionBytes - Transaction bytes in base64 or hex format
-   * @param options - Parsing options and configuration
-   * @returns Promise resolving to ParsedTransaction
-   */
-  static async parseTransactionBytes(transactionBytes, options = {}) {
-    const {
-      enableFallback = true,
-      strictMode = false,
-      includeRaw = true,
-      maxRetries = 2
-    } = options;
-    const validation = this.validateTransactionBytes(transactionBytes);
-    if (!validation.isValid && strictMode) {
-      throw new TransactionParsingError(
-        `Invalid transaction bytes format: ${validation.error}`,
-        "INVALID_FORMAT",
-        void 0,
-        transactionBytes
-      );
+import { readString, isJsonObject } from "./standards-sdk.es198.js";
+import "./standards-sdk.es182.js";
+import "./standards-sdk.es195.js";
+import "./standards-sdk.es196.js";
+import "./standards-sdk.es197.js";
+import { parseTimestampMs } from "./standards-sdk.es123.js";
+import { requestJson, Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
+import { fetchX402OnchainUsageState } from "./standards-sdk.es134.js";
+const summaryValues = (summary) => ({
+  x402UsageSummary: summary ? {
+    volume7dUsd: summary.volume7dUsd ?? 0,
+    volume24hUsd: summary.volume24hUsd ?? 0,
+    inboundTrades7d: summary.inboundTrades7d ?? 0,
+    outboundTrades7d: summary.outboundTrades7d ?? 0
+  } : null
+});
+function hasProtocol(subject, wanted) {
+  const normalized = wanted.toLowerCase();
+  const direct = subject.protocol?.toLowerCase();
+  if (direct === normalized) {
+    return true;
+  }
+  const metadataProtocol = typeof subject.metadata?.protocol === "string" ? subject.metadata.protocol.toLowerCase() : null;
+  if (metadataProtocol === normalized) {
+    return true;
+  }
+  const list = subject.protocols;
+  return Array.isArray(list) && list.some(
+    (entry) => typeof entry === "string" && entry.toLowerCase() === normalized
+  );
+}
+function hasX402Config(subject) {
+  const metadata = subject.metadata ?? {};
+  const configured = readString(metadata, "payTo") !== null && readString(metadata, "asset") !== null && readString(metadata, "network") !== null;
+  return configured || hasProtocol(subject, "x402");
+}
+function readCursor(subject) {
+  const raw = subject.metadata?.x402UsageCursor;
+  return raw === void 0 ? void 0 : raw;
+}
+function createX402SignalAdapter(options = {}) {
+  const source = options.source ?? "onchain";
+  const ttlMs = options.ttlMs ?? 6 * 60 * 60 * 1e3;
+  const failureTtlMs = options.failureTtlMs ?? 3 * 60 * 60 * 1e3;
+  const fetchUsage = options.fetchUsageState ?? fetchX402OnchainUsageState;
+  const isHttpSource = typeof source === "string" && source !== "onchain";
+  const isUrlFn = typeof source === "function";
+  const collect = async (subject, context) => {
+    const now = context.now.toISOString();
+    const metadata = subject.metadata ?? {};
+    const payTo = readString(metadata, "payTo");
+    const asset = readString(metadata, "asset");
+    const network = readString(metadata, "network");
+    const cursor = readCursor(subject);
+    if (!context.force) {
+      const storedStatus = readString(metadata, "x402UsageStatus");
+      const storedUpdatedMs = parseTimestampMs(metadata.x402UsageUpdatedAt);
+      if (storedStatus && storedUpdatedMs !== null) {
+        const ttl = storedStatus === "ok" ? ttlMs : failureTtlMs;
+        if (context.now.getTime() - storedUpdatedMs < ttl) {
+          const storedSummary = isJsonObject(metadata.x402UsageSummary) ? metadata.x402UsageSummary : null;
+          return [
+            {
+              signalId: "x402.usage",
+              status: storedStatus === "ok" ? "ok" : "missing",
+              value: storedSummary && typeof storedSummary.volume7dUsd === "number" ? storedSummary.volume7dUsd : null,
+              provenance: {
+                source: "x402",
+                subjectId: payTo ?? subject.id,
+                fetchedAt: metadata.x402UsageUpdatedAt
+              }
+            }
+          ];
+        }
+      }
     }
-    let lastError;
-    let retryCount = 0;
-    while (retryCount <= maxRetries) {
+    if (!options.fetchUsageState && (isHttpSource || isUrlFn)) {
+      const resolved = isUrlFn ? source(subject) : source.replace("{payTo}", encodeURIComponent(payTo ?? "")).replace("{asset}", encodeURIComponent(asset ?? "")).replace("{network}", encodeURIComponent(network ?? ""));
+      const url = typeof resolved === "string" ? resolved : null;
+      if (!url) {
+        return [{ signalId: "x402.usage", status: "missing" }];
+      }
+      const urlWithCursor = cursor && isJsonObject(cursor) && typeof cursor.cursor === "string" ? `${url}${url.includes("?") ? "&" : "?"}cursor=${encodeURIComponent(cursor.cursor)}` : url;
       try {
-        const result = await this.parseTransaction(transactionBytes, options);
-        result.formatDetection = {
-          originalFormat: validation.format || "base64",
-          wasConverted: validation.format === "hex",
-          length: transactionBytes.length
+        const data = await requestJson(urlWithCursor, {
+          fetch: context.fetch,
+          timeoutMs: context.timeoutMs,
+          signal: context.signal
+        });
+        const summary = data.summary ?? data;
+        const values = {
+          x402UsageStatus: "ok",
+          x402UsageUpdatedAt: now,
+          x402UsageSource: "indexer",
+          ...summaryValues(summary)
         };
-        return result;
-      } catch (error) {
-        lastError = error instanceof Error ? error : new Error(String(error));
-        retryCount++;
-        if (!enableFallback || retryCount > maxRetries) {
-          if (strictMode) {
-            throw new TransactionParsingError(
-              "Failed to parse transaction after all attempts",
-              "PARSING_FAILED",
-              lastError,
-              transactionBytes
-            );
-          }
-          break;
-        }
-        try {
-          const result = this.parseScheduledTransaction(
-            transactionBytes,
-            options
-          );
-          result.formatDetection = {
-            originalFormat: validation.format || "base64",
-            wasConverted: false,
-            length: transactionBytes.length
-          };
-          return result;
-        } catch (scheduledError) {
+        const nextCursor = data.cursor ?? cursor;
+        if (nextCursor !== void 0) {
+          values.x402UsageCursor = nextCursor;
         }
-      }
-    }
-    const fallbackResult = this.createFallbackResult(
-      transactionBytes,
-      lastError,
-      void 0
-    );
-    if (fallbackResult.details) {
-      fallbackResult.details.parseAttempts = Math.max(retryCount, 1);
-    }
-    return fallbackResult;
-  }
-  /**
-   * Parse a Transaction object directly using unified delegation approach
-   * This method delegates to specialized parsers for clean separation of concerns
-   *
-   * @param transaction - The Transaction object to parse
-   * @param originalBytes - The original transaction bytes (optional, for protobuf parsing)
-   * @param options - Parsing options
-   * @returns Parsed transaction data
-   */
-  static parseTransactionObject(transaction, originalBytesOrOptions, options = {}) {
-    let originalBytes;
-    let actualOptions;
-    if (originalBytesOrOptions && !Buffer.isBuffer(originalBytesOrOptions) && !(originalBytesOrOptions instanceof Uint8Array)) {
-      actualOptions = originalBytesOrOptions;
-      originalBytes = void 0;
-    } else {
-      originalBytes = originalBytesOrOptions;
-      actualOptions = options;
-    }
-    try {
-      const metadata = this.extractTransactionMetadata(transaction);
-      const htsResult = HTSParser.parseFromTransactionObject(transaction);
-      const cryptoResult = CryptoParser.parseFromTransactionObject(transaction);
-      const hcsResult = HCSParser.parseFromTransactionObject(transaction);
-      const fileResult = FileParser.parseFromTransactionObject(transaction);
-      const scsResult = SCSParser.parseFromTransactionObject(transaction);
-      const scheduleResult = ScheduleParser.parseFromTransactionObject(transaction);
-      const utilResult = UtilParser.parseFromTransactionObject(transaction);
-      const results = [
-        htsResult,
-        cryptoResult,
-        hcsResult,
-        fileResult,
-        scsResult,
-        scheduleResult,
-        utilResult
-      ];
-      const primaryResult = results.find((result2) => result2.type && result2.type !== "UNKNOWN") || {};
-      let finalType = "UNKNOWN";
-      let finalHumanReadableType = "Unknown Transaction";
-      let parsedTokenCreation;
-      let protoParsingResult = {};
-      if (originalBytes || transaction.toBytes) {
-        try {
-          const bytesToParse = originalBytes || transaction.toBytes();
-          const decoded = proto.TransactionList.decode(bytesToParse);
-          if (decoded.transactionList && decoded.transactionList.length > 0) {
-            const tx = decoded.transactionList[0];
-            if (tx.bodyBytes && tx.bodyBytes.length > 0) {
-              const txBody = proto.TransactionBody.decode(tx.bodyBytes);
-              const typeResult = this.detectTransactionTypeFromBody(txBody);
-              finalType = typeResult.type;
-              finalHumanReadableType = typeResult.humanReadableType;
-              protoParsingResult = this.parseTransactionBodyDetails(
-                txBody,
-                finalType
-              );
-              if (protoParsingResult.tokenCreation) {
-                parsedTokenCreation = protoParsingResult.tokenCreation;
-              }
-            } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
-              const signedTx = proto.SignedTransaction.decode(
-                tx.signedTransactionBytes
-              );
-              if (signedTx.bodyBytes) {
-                const txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
-                const typeResult = this.detectTransactionTypeFromBody(txBody);
-                finalType = typeResult.type;
-                finalHumanReadableType = typeResult.humanReadableType;
-                protoParsingResult = this.parseTransactionBodyDetails(
-                  txBody,
-                  finalType
-                );
-                if (protoParsingResult.tokenCreation) {
-                  parsedTokenCreation = protoParsingResult.tokenCreation;
+        return [
+          {
+            signalId: "x402.usage",
+            status: "ok",
+            value: summary.volume7dUsd ?? null,
+            fields: [{ scope: "root", values }],
+            provenance: {
+              source: "x402",
+              sourceUrl: url,
+              subjectId: payTo ?? subject.id,
+              fetchedAt: now
+            }
+          }
+        ];
+      } catch (error) {
+        const missing = error instanceof Hcs25CollectorHttpError && error.status === 404;
+        const status = missing ? "missing" : isTimeoutError(error) ? "timeout" : "error";
+        return [
+          {
+            signalId: "x402.usage",
+            status,
+            fields: [
+              {
+                scope: "root",
+                values: {
+                  x402UsageStatus: missing ? "missing" : "error",
+                  x402UsageUpdatedAt: now,
+                  x402UsageSource: "indexer"
                 }
               }
-            }
+            ]
           }
-        } catch (protoError) {
-        }
-      }
-      if (finalType === "UNKNOWN" && primaryResult.type) {
-        finalType = primaryResult.type;
-        finalHumanReadableType = primaryResult.humanReadableType || finalHumanReadableType;
-      }
-      const result = {
-        type: finalType,
-        humanReadableType: finalHumanReadableType,
-        transfers: [],
-        tokenTransfers: [],
-        ...metadata,
-        ...primaryResult,
-        raw: actualOptions.includeRaw ? transaction._transactionBody || {} : void 0
-      };
-      this.mergeProtoParsingResults(
-        result,
-        protoParsingResult,
-        htsResult,
-        transaction,
-        originalBytes
-      );
-      result.transfers = cryptoResult.transfers || result.transfers || [];
-      result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
-      return result;
-    } catch (error) {
-      return {
-        type: "UNKNOWN",
-        humanReadableType: "Unknown Transaction",
-        transfers: [],
-        tokenTransfers: [],
-        raw: actualOptions.includeRaw ? {} : void 0,
-        details: {
-          error: `Failed to parse Transaction object: ${error instanceof Error ? error.message : String(error)}`
+        ];
+      }
+    }
+    if (!payTo || !asset || !network) {
+      return [
+        {
+          signalId: "x402.usage",
+          status: "missing",
+          fields: [
+            {
+              scope: "root",
+              values: {
+                x402UsageStatus: "missing",
+                x402UsageUpdatedAt: now,
+                x402UsageSource: "onchain",
+                x402UsageSummary: null
+              }
+            }
+          ]
         }
-      };
+      ];
     }
-  }
-  /**
-   * Parse a base64 encoded transaction body using registry pattern
-   * @param transactionBodyBase64 - The base64 encoded transaction body
-   * @returns The parsed transaction
-   */
-  static parseTransactionBody(transactionBodyBase64) {
     try {
-      const buffer = ethers.decodeBase64(transactionBodyBase64);
-      const txBody = proto.SchedulableTransactionBody.decode(buffer);
-      const transactionType = this.getTransactionType(txBody);
-      const result = {
-        type: transactionType,
-        humanReadableType: this.getHumanReadableType(transactionType),
-        transfers: [],
-        tokenTransfers: [],
-        raw: txBody
-      };
-      if (txBody.memo) {
-        result.memo = txBody.memo;
-      }
-      if (txBody.transactionFee) {
-        const hbarAmount = Hbar.fromTinybars(
-          Long.fromValue(txBody.transactionFee)
-        );
-        result.transactionFee = hbarAmount.toString(HbarUnit.Hbar);
-      }
-      this.applySchedulableTransactionParsing(txBody, result);
-      return result;
-    } catch (error) {
-      return {
-        type: "UNKNOWN",
-        humanReadableType: "Unknown Transaction",
-        transfers: [],
-        tokenTransfers: [],
-        raw: void 0,
-        details: {
-          error: `Failed to parse transaction body: ${error instanceof Error ? error.message : String(error)}`
-        }
-      };
-    }
-  }
-  /**
-   * Detect transaction type and human-readable type from transaction body protobuf
-   * Uses registry pattern to eliminate massive if-else chain
-   */
-  static detectTransactionTypeFromBody(txBody) {
-    return getTransactionTypeFromBody(txBody);
-  }
-  /**
-   * Parse details from a complete schedule response
-   * @param scheduleResponse - The schedule response to parse
-   * @returns The parsed transaction
-   */
-  static parseScheduleResponse(scheduleResponse) {
-    if (!scheduleResponse.transaction_body) {
-      return {
-        type: "UNKNOWN",
-        humanReadableType: "Unknown Transaction",
-        transfers: [],
-        tokenTransfers: [],
-        raw: void 0,
-        details: {
-          error: "Schedule response missing transaction_body"
+      const { summary, cursor: nextCursor } = await fetchUsage(
+        { network, asset, payTo, cursor },
+        {
+          days: options.days,
+          ttlMs: options.ttlMs,
+          maxRetries: options.maxRetries,
+          chunkSizeBlocks: options.chunkSizeBlocks,
+          rpcUrls: options.rpcUrls
         }
-      };
-    }
-    const parsed = this.parseTransactionBody(scheduleResponse.transaction_body);
-    if (scheduleResponse.memo) {
-      parsed.memo = scheduleResponse.memo;
-    }
-    return parsed;
-  }
-  /**
-   * Determine the transaction type using registry pattern
-   * @param txBody - The transaction body to determine the type of
-   * @returns The type of the transaction
-   */
-  static getTransactionType(txBody) {
-    return getTransactionTypeFromBody(txBody).type;
-  }
-  /**
-   * Convert technical transaction type to human-readable format using registry pattern
-   * @param type - The technical transaction type
-   * @returns The human-readable transaction type
-   */
-  static getHumanReadableType(type) {
-    return getHumanReadableTransactionType(type);
-  }
-  /**
-   * Get a human-readable summary of the transaction
-   * @param parsedTx - The parsed transaction
-   * @returns The human-readable summary of the transaction
-   */
-  static getTransactionSummary(parsedTx) {
-    return resolveTransactionSummary(parsedTx);
-  }
-  /**
-   * Validate transaction bytes format and encoding
-   * Enhanced validation with better format detection
-   */
-  static validateTransactionBytes(transactionBytes) {
-    if (!transactionBytes || typeof transactionBytes !== "string") {
-      return {
-        isValid: false,
-        error: "Transaction bytes must be a non-empty string"
-      };
-    }
-    const format = this.detectTransactionFormat(transactionBytes);
-    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
-    const hexRegex = /^0x[0-9a-fA-F]+$/;
-    let isValid = false;
-    let error;
-    if (format === "hex") {
-      isValid = hexRegex.test(transactionBytes) && transactionBytes.length > 2;
-      if (!isValid) {
-        error = "Invalid hex format";
-      }
-    } else {
-      isValid = base64Regex.test(transactionBytes) && transactionBytes.length > 0;
-      if (!isValid) {
-        error = "Invalid base64 format";
-      }
-    }
-    return {
-      isValid,
-      format,
-      error,
-      length: transactionBytes.length
-    };
-  }
-  /**
-   * Detects the format of transaction bytes
-   * @param transactionBytes - The transaction bytes to analyze
-   * @returns The detected format ('base64' or 'hex')
-   */
-  static detectTransactionFormat(transactionBytes) {
-    return transactionBytes.startsWith("0x") ? "hex" : "base64";
-  }
-  /**
-   * Decodes transaction bytes from string to Uint8Array
-   * @param transactionBytes - The transaction bytes string (base64 or hex)
-   * @returns Decoded Uint8Array
-   * @throws TransactionParsingError if decoding fails
-   */
-  static decodeTransactionBytes(transactionBytes) {
-    try {
-      const format = this.detectTransactionFormat(transactionBytes);
-      if (format === "hex") {
-        const hexString = transactionBytes.slice(2);
-        return new Uint8Array(Buffer.from(hexString, "hex"));
-      } else {
-        return new Uint8Array(Buffer.from(transactionBytes, "base64"));
-      }
-    } catch (error) {
-      throw new TransactionParsingError(
-        "Failed to decode transaction bytes",
-        "DECODE_ERROR",
-        error instanceof Error ? error : void 0,
-        transactionBytes
-      );
-    }
-  }
-  /**
-   * Check if transaction bytes represent a valid Hedera transaction
-   */
-  static async isValidHederaTransaction(transactionBytes) {
-    try {
-      if (!this.validateTransactionBytes(transactionBytes).isValid) {
-        return false;
-      }
-      const bytes = this.decodeTransactionBytes(transactionBytes);
-      Transaction.fromBytes(bytes);
-      return true;
-    } catch {
-      return false;
-    }
-  }
-  /**
-   * Legacy alias for decodeTransactionBytes - keeping for backward compatibility
-   */
-  static decodeBytesLegacy(transactionBytes) {
-    return this.decodeTransactionBytes(transactionBytes);
-  }
-  /**
-   * Parse transaction bytes into structured data using thin orchestration
-   * Delegates to specialized parsers for clean separation of concerns
-   */
-  static async parseTransaction(transactionBytes, options = {}) {
-    try {
-      const bytes = this.decodeTransactionBytes(transactionBytes);
-      const transaction = Transaction.fromBytes(bytes);
-      const metadata = this.extractTransactionMetadataEnhanced(transaction);
-      const parserResults = this.runAllParsers(transaction);
-      const primaryResult = parserResults.find(
-        (result2) => result2.type && result2.type !== "UNKNOWN"
-      ) || {};
-      const protoParsingResult = this.parseFromProtobuf(bytes);
-      const finalType = protoParsingResult.type || primaryResult.type || "UNKNOWN";
-      const finalHumanReadableType = protoParsingResult.humanReadableType || primaryResult.humanReadableType || "Unknown Transaction";
-      const result = {
-        type: finalType,
-        humanReadableType: finalHumanReadableType,
-        transfers: [],
-        tokenTransfers: [],
-        details: { ...metadata },
-        memo: typeof metadata.memo === "string" ? metadata.memo : void 0,
-        transactionId: typeof metadata.transactionId === "string" ? metadata.transactionId : void 0,
-        nodeAccountIds: Array.isArray(metadata.nodeAccountIds) ? metadata.nodeAccountIds : [],
-        maxTransactionFee: typeof metadata.maxTransactionFee === "string" ? metadata.maxTransactionFee : void 0,
-        validStart: typeof metadata.validStart === "string" ? metadata.validStart : void 0,
-        validDuration: typeof metadata.validDuration === "string" ? metadata.validDuration : void 0,
-        raw: options.includeRaw ? {} : void 0
-      };
-      this.mergeAllResults(
-        result,
-        protoParsingResult,
-        primaryResult,
-        parserResults
       );
-      return result;
-    } catch (error) {
-      throw new TransactionParsingError(
-        "Failed to parse as regular transaction",
-        "REGULAR_PARSING_FAILED",
-        error instanceof Error ? error : void 0,
-        transactionBytes
-      );
-    }
-  }
-  /**
-   * Parse scheduled transaction body
-   */
-  static parseScheduledTransaction(transactionBytes, options = {}) {
-    try {
-      const parsedTx = this.parseTransactionBody(transactionBytes);
-      const validation = this.validateTransactionBytes(transactionBytes);
-      const enhancedResult = {
-        ...parsedTx,
-        details: {
-          ...parsedTx.details || {},
-          parseMethod: "scheduled",
-          validation,
-          parseAttempts: parsedTx.details?.parseAttempts || 1
-        },
-        formatDetection: {
-          originalFormat: validation.format || "base64",
-          wasConverted: false,
-          length: transactionBytes.length
-        }
+      const values = {
+        x402UsageStatus: summary ? "ok" : "missing",
+        x402UsageUpdatedAt: now,
+        x402UsageSource: "onchain",
+        ...summaryValues(summary)
       };
-      return enhancedResult;
-    } catch (error) {
-      throw new TransactionParsingError(
-        "Failed to parse as scheduled transaction",
-        "SCHEDULED_PARSING_FAILED",
-        error instanceof Error ? error : void 0,
-        transactionBytes
-      );
-    }
-  }
-  /**
-   * Extract metadata from Transaction object (legacy method - keeping for backward compatibility)
-   */
-  static extractTransactionMetadata(transaction) {
-    return {
-      transactionId: transaction.transactionId?.toString(),
-      nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
-      maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
-      memo: transaction._transactionMemo || void 0,
-      transfers: [],
-      tokenTransfers: []
-    };
-  }
-  /**
-   * Extract enhanced metadata from Transaction object
-   */
-  static extractTransactionMetadataEnhanced(transaction) {
-    return {
-      transactionId: transaction.transactionId?.toString(),
-      nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
-      maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
-      memo: transaction._transactionMemo || void 0,
-      validStart: transaction._transactionValidStart?.toString(),
-      validDuration: transaction._transactionValidDuration?.toString()
-    };
-  }
-  /**
-   * Run all available parsers on a transaction
-   */
-  static runAllParsers(transaction) {
-    return [
-      HTSParser.parseFromTransactionObject(transaction),
-      CryptoParser.parseFromTransactionObject(transaction),
-      HCSParser.parseFromTransactionObject(transaction),
-      FileParser.parseFromTransactionObject(transaction),
-      SCSParser.parseFromTransactionObject(transaction),
-      ScheduleParser.parseFromTransactionObject(transaction),
-      UtilParser.parseFromTransactionObject(transaction)
-    ];
-  }
-  /**
-   * Parse transaction from protobuf bytes
-   */
-  static parseFromProtobuf(bytes) {
-    const result = {};
-    try {
-      const decoded = proto.TransactionList.decode(bytes);
-      if (decoded.transactionList && decoded.transactionList.length > 0) {
-        const tx = decoded.transactionList[0];
-        let txBody = null;
-        if (tx.bodyBytes && tx.bodyBytes.length > 0) {
-          txBody = proto.TransactionBody.decode(tx.bodyBytes);
-        } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
-          const signedTx = proto.SignedTransaction.decode(
-            tx.signedTransactionBytes
-          );
-          if (signedTx.bodyBytes) {
-            txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
+      if (nextCursor !== null) {
+        values.x402UsageCursor = nextCursor;
+      } else if (cursor !== void 0) {
+        values.x402UsageCursor = cursor;
+      }
+      return [
+        {
+          signalId: "x402.usage",
+          status: summary ? "ok" : "missing",
+          value: summary?.volume7dUsd ?? null,
+          fields: [{ scope: "root", values }],
+          provenance: {
+            source: "x402",
+            subjectId: payTo,
+            fetchedAt: now,
+            params: { network, asset, source: "onchain" }
           }
         }
-        if (txBody) {
-          const typeResult = this.detectTransactionTypeFromBody(txBody);
-          result.type = typeResult.type;
-          result.humanReadableType = typeResult.humanReadableType;
-          const details = this.parseTransactionBodyDetails(
-            txBody,
-            typeResult.type
-          );
-          Object.assign(result, details);
-        }
-      }
+      ];
     } catch (error) {
-    }
-    return result;
-  }
-  /**
-   * Intelligently merge all parsing results
-   */
-  static mergeAllResults(result, protoResult, primaryResult, parserResults) {
-    const cryptoResult = parserResults.find((r) => r.transfers || r.tokenTransfers) || {};
-    result.transfers = cryptoResult.transfers || result.transfers || [];
-    result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
-    Object.keys(protoResult).forEach((key) => {
-      if (protoResult[key] !== void 0 && key !== "type" && key !== "humanReadableType") {
-        result[key] = protoResult[key];
-      }
-    });
-    Object.keys(primaryResult).forEach((key) => {
-      if (primaryResult[key] !== void 0 && !(key in result) && key !== "type" && key !== "humanReadableType") {
-        result[key] = primaryResult[key];
-      }
-    });
-  }
-  /**
-   * Apply schedulable transaction parsing using registry pattern
-   * Eliminates conditional logic in parseTransactionBody
-   */
-  static applySchedulableTransactionParsing(txBody, result) {
-    if (txBody.cryptoTransfer) {
-      CryptoParser.parseCryptoTransfers(txBody.cryptoTransfer, result);
-    }
-    if (txBody.cryptoDelete) {
-      result.cryptoDelete = CryptoParser.parseCryptoDelete(txBody.cryptoDelete);
-    }
-    if (txBody.cryptoCreateAccount) {
-      result.cryptoCreateAccount = CryptoParser.parseCryptoCreateAccount(
-        txBody.cryptoCreateAccount
-      );
-    }
-    if (txBody.cryptoUpdateAccount) {
-      result.cryptoUpdateAccount = CryptoParser.parseCryptoUpdateAccount(
-        txBody.cryptoUpdateAccount
-      );
-    }
-    if (txBody.cryptoApproveAllowance) {
-      result.cryptoApproveAllowance = CryptoParser.parseCryptoApproveAllowance(
-        txBody.cryptoApproveAllowance
-      );
-    }
-    if (txBody.cryptoDeleteAllowance) {
-      result.cryptoDeleteAllowance = CryptoParser.parseCryptoDeleteAllowance(
-        txBody.cryptoDeleteAllowance
-      );
-    }
-    if (txBody.contractCall) {
-      result.contractCall = SCSParser.parseContractCall(txBody.contractCall);
-    }
-    if (txBody.contractCreateInstance) {
-      result.contractCreate = SCSParser.parseContractCreate(
-        txBody.contractCreateInstance
-      );
-    }
-    if (txBody.contractUpdateInstance) {
-      result.contractUpdate = SCSParser.parseContractUpdate(
-        txBody.contractUpdateInstance
-      );
-    }
-    if (txBody.contractDeleteInstance) {
-      result.contractDelete = SCSParser.parseContractDelete(
-        txBody.contractDeleteInstance
-      );
-    }
-    if (txBody.tokenCreation) {
-      result.tokenCreation = HTSParser.parseTokenCreate(txBody.tokenCreation);
-    }
-    if (txBody.tokenMint) {
-      result.tokenMint = HTSParser.parseTokenMint(txBody.tokenMint);
-    }
-    if (txBody.tokenBurn) {
-      result.tokenBurn = HTSParser.parseTokenBurn(txBody.tokenBurn);
-    }
-    if (txBody.tokenUpdate) {
-      result.tokenUpdate = HTSParser.parseTokenUpdate(txBody.tokenUpdate);
-    }
-    if (txBody.tokenFeeScheduleUpdate) {
-      result.tokenFeeScheduleUpdate = HTSParser.parseTokenFeeScheduleUpdate(
-        txBody.tokenFeeScheduleUpdate
-      );
-    }
-    if (txBody.tokenFreeze) {
-      result.tokenFreeze = HTSParser.parseTokenFreeze(txBody.tokenFreeze);
-    }
-    if (txBody.tokenUnfreeze) {
-      result.tokenUnfreeze = HTSParser.parseTokenUnfreeze(txBody.tokenUnfreeze);
-    }
-    if (txBody.tokenGrantKyc) {
-      result.tokenGrantKyc = HTSParser.parseTokenGrantKyc(txBody.tokenGrantKyc);
-    }
-    if (txBody.tokenRevokeKyc) {
-      result.tokenRevokeKyc = HTSParser.parseTokenRevokeKyc(
-        txBody.tokenRevokeKyc
-      );
-    }
-    if (txBody.tokenPause) {
-      result.tokenPause = HTSParser.parseTokenPause(txBody.tokenPause);
-    }
-    if (txBody.tokenUnpause) {
-      result.tokenUnpause = HTSParser.parseTokenUnpause(txBody.tokenUnpause);
-    }
-    if (txBody.tokenWipe) {
-      result.tokenWipeAccount = HTSParser.parseTokenWipeAccount(
-        txBody.tokenWipe
-      );
-    }
-    if (txBody.tokenDeletion) {
-      result.tokenDelete = HTSParser.parseTokenDelete(txBody.tokenDeletion);
-    }
-    if (txBody.tokenAssociate) {
-      result.tokenAssociate = HTSParser.parseTokenAssociate(
-        txBody.tokenAssociate
-      );
-    }
-    if (txBody.tokenDissociate) {
-      result.tokenDissociate = HTSParser.parseTokenDissociate(
-        txBody.tokenDissociate
-      );
-    }
-    if (txBody.tokenAirdrop) {
-      result.tokenAirdrop = HTSParser.parseTokenAirdropFromProto(
-        txBody.tokenAirdrop
-      );
-    }
-    if (txBody.consensusCreateTopic) {
-      result.consensusCreateTopic = HCSParser.parseConsensusCreateTopic(
-        txBody.consensusCreateTopic
-      );
-    }
-    if (txBody.consensusSubmitMessage) {
-      result.consensusSubmitMessage = HCSParser.parseConsensusSubmitMessage(
-        txBody.consensusSubmitMessage
-      );
-    }
-    if (txBody.consensusUpdateTopic) {
-      result.consensusUpdateTopic = HCSParser.parseConsensusUpdateTopic(
-        txBody.consensusUpdateTopic
-      );
-    }
-    if (txBody.consensusDeleteTopic) {
-      result.consensusDeleteTopic = HCSParser.parseConsensusDeleteTopic(
-        txBody.consensusDeleteTopic
-      );
-    }
-    if (txBody.fileCreate) {
-      result.fileCreate = FileParser.parseFileCreate(txBody.fileCreate);
-    }
-    if (txBody.fileAppend) {
-      result.fileAppend = FileParser.parseFileAppend(txBody.fileAppend);
-    }
-    if (txBody.fileUpdate) {
-      result.fileUpdate = FileParser.parseFileUpdate(txBody.fileUpdate);
-    }
-    if (txBody.fileDelete) {
-      result.fileDelete = FileParser.parseFileDelete(txBody.fileDelete);
-    }
-    if (txBody.utilPrng) {
-      result.utilPrng = UtilParser.parseUtilPrng(txBody.utilPrng);
-    }
-  }
-  /**
-   * Parse transaction body details for all supported transaction types
-   * Uses a scalable registry pattern instead of if-else chains
-   */
-  static parseTransactionBodyDetails(txBody, transactionType) {
-    const result = {};
-    const parserConfig = transactionParserRegistry[transactionType];
-    if (parserConfig) {
-      const bodyData = txBody[parserConfig.bodyField];
-      if (bodyData) {
-        const parserResult = parserConfig.parser(bodyData);
-        if (parserConfig.spreadResult) {
-          Object.assign(result, parserResult);
-        } else {
-          result[parserConfig.resultField] = parserResult;
+      return [
+        {
+          signalId: "x402.usage",
+          status: isTimeoutError(error) ? "timeout" : "error",
+          fields: [
+            {
+              scope: "root",
+              values: {
+                x402UsageStatus: "error",
+                x402UsageUpdatedAt: now,
+                x402UsageSource: "onchain",
+                x402UsageSummary: null,
+                ...cursor !== void 0 ? { x402UsageCursor: cursor } : {}
+              }
+            }
+          ]
         }
-      }
-    }
-    return result;
-  }
-  /**
-   * Merge protobuf parsing results with parser results using registry pattern
-   * Eliminates transactionFields array and forEach logic
-   */
-  static mergeProtoParsingResults(result, protoResult, htsResult, transaction, originalBytes) {
-    const fieldsToMerge = Object.values(transactionParserRegistry).map(
-      (config) => config.resultField
-    );
-    for (const field of fieldsToMerge) {
-      const protoValue = protoResult[field];
-      const htsValue = htsResult[field];
-      if (protoValue !== void 0) {
-        result[field] = protoValue;
-      } else if (htsValue !== void 0) {
-        result[field] = htsValue;
-      } else {
-        this.handleSpecialFieldExtraction(result, field, transaction);
-      }
+      ];
     }
-  }
-  /**
-   * Handle special field extraction cases using registry pattern
-   */
-  static handleSpecialFieldExtraction(result, field, transaction) {
-    if (field === "tokenCreation" && result.type === "TOKENCREATE") {
-      const extracted = HTSParser.extractTokenCreationFromTransaction(transaction);
-      if (extracted) {
-        result[field] = extracted;
-      }
-    } else if (field === "tokenAirdrop" && result.type === "TOKENAIRDROP") {
-      const extracted = HTSParser.extractTokenAirdropFromTransaction(transaction);
-      if (extracted) {
-        result[field] = extracted;
+  };
+  return {
+    id: "x402",
+    produces: ["x402.usage"],
+    timeoutMs: options.timeoutMs,
+    // On-chain scans need network+asset+payTo; HTTP/custom sources only
+    // need a payTo (or the x402 protocol marker) to query.
+    appliesTo: options.appliesTo ?? ((subject) => {
+      if (hasX402Config(subject)) {
+        return true;
+      }
+      if (!isHttpSource && !isUrlFn && options.fetchUsageState === void 0) {
+        return false;
       }
-    }
-  }
-  /**
-   * Create fallback result when all parsing methods fail
-   */
-  static createFallbackResult(transactionBytes, primaryError, secondaryError) {
-    const validation = this.validateTransactionBytes(transactionBytes);
-    return {
-      type: "UNKNOWN",
-      humanReadableType: "Unknown Transaction",
-      transfers: [],
-      tokenTransfers: [],
-      details: {
-        rawBytes: transactionBytes.length > 100 ? transactionBytes.substring(0, 100) + "..." : transactionBytes,
-        primaryError: primaryError?.message,
-        secondaryError: secondaryError?.message,
-        parseAttempts: secondaryError ? 2 : 1,
-        validation
-      },
-      formatDetection: {
-        originalFormat: validation.format || "base64",
-        wasConverted: false,
-        length: transactionBytes.length
-      },
-      raw: {}
-    };
-  }
+      return readString(subject.metadata ?? {}, "payTo") !== null;
+    }),
+    collect
+  };
 }
 export {
-  TransactionParser,
-  TransactionParsingError
+  createX402SignalAdapter
 };
 //# sourceMappingURL=standards-sdk.es133.js.map