@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es134.js","sources":["../../src/hcs-25/collectors/x402-onchain.ts"],"sourcesContent":["import {\n  createPublicClient,\n  fallback,\n  formatUnits,\n  getAddress,\n  http as httpTransport,\n  type Address,\n  type Chain,\n} from 'viem';\nimport { base, baseSepolia } from 'viem/chains';\n\n/**\n * Aggregated on-chain x402 payment usage for a `payTo` address.\n */\nexport interface Hcs25X402UsageSummary {\n  volume7dUsd: number;\n  volume24hUsd: number;\n  inboundTrades7d: number;\n  outboundTrades7d: number;\n}\n\n/**\n * One UTC day of scanned payment activity.\n */\nexport interface Hcs25X402UsageDailyBucket {\n  /** UTC day, `YYYY-MM-DD`. */\n  day: string;\n  inboundTrades: number;\n  outboundTrades: number;\n  volumeUsd: number;\n}\n\n/**\n * Incremental scan checkpoint. Stored on the subject record\n * (`metadata.x402UsageCursor`) so subsequent refreshes only scan blocks\n * produced since the last run.\n */\nexport interface Hcs25X402UsageCursor {\n  network: string;\n  asset: string;\n  payTo: string;\n  lastScannedBlock: number;\n  daily: Hcs25X402UsageDailyBucket[];\n}\n\nexport interface Hcs25X402UsageStateParams {\n  /** x402 network identifier (`base` or `base-sepolia`). */\n  network: unknown;\n  /** Payment asset contract address (e.g. USDC). */\n  asset: unknown;\n  /** Recipient address whose inbound/outbound transfers are scanned. */\n  payTo: unknown;\n  /** Previously stored `x402UsageCursor` for incremental refresh. */\n  cursor?: unknown;\n}\n\nexport interface Hcs25X402OnchainUsageOptions {\n  /** Rolling window in days (1–14). Default 7. */\n  days?: number;\n  /** Cache TTL applied to per-block/per-contract lookups. Default 30 min. */\n  ttlMs?: number;\n  /** Retries per RPC call with exponential backoff. Default 2. */\n  maxRetries?: number;\n  /** getLogs range chunk size in blocks. Default 50000. */\n  chunkSizeBlocks?: number;\n  /** RPC endpoint overrides per network (replaces the built-in lists). */\n  rpcUrls?: Partial<Record<string, readonly string[]>>;\n}\n\nexport interface Hcs25X402UsageStateResult {\n  summary: Hcs25X402UsageSummary | null;\n  cursor: Hcs25X402UsageCursor | null;\n}\n\ntype X402Network = 'base' | 'base-sepolia';\n\ninterface NetworkConfig {\n  chain: Chain;\n  rpcUrls: string[];\n  usdcAddresses: Set<string>;\n}\n\nconst TRANSFER_EVENT_ABI = [\n  {\n    type: 'event',\n    name: 'Transfer',\n    inputs: [\n      { indexed: true, name: 'from', type: 'address' },\n      { indexed: true, name: 'to', type: 'address' },\n      { indexed: false, name: 'value', type: 'uint256' },\n    ],\n    anonymous: false,\n  },\n] as const;\n\nconst DECIMALS_ABI = [\n  {\n    type: 'function',\n    name: 'decimals',\n    inputs: [],\n    outputs: [{ name: '', type: 'uint8' }],\n    stateMutability: 'view',\n  },\n] as const;\n\nconst NETWORK_CONFIG: Record<X402Network, NetworkConfig> = {\n  base: {\n    chain: base,\n    rpcUrls: [\n      'https://mainnet.base.org',\n      'https://1rpc.io/base',\n      'https://base.llamarpc.com',\n      'https://base-rpc.publicnode.com',\n    ],\n    usdcAddresses: new Set(['0x833589fcd6edb6e08f4c7c32d4f71b54bda02913']),\n  },\n  'base-sepolia': {\n    chain: baseSepolia,\n    rpcUrls: [\n      'https://sepolia.base.org',\n      'https://1rpc.io/base-sepolia',\n      'https://base-sepolia-rpc.publicnode.com',\n    ],\n    usdcAddresses: new Set(['0x036cbd53842c5426634e7929541ec2318f3dcf7e']),\n  },\n};\n\nconst toNetwork = (value: unknown): X402Network | null => {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const normalized = value.trim().toLowerCase();\n  if (normalized === 'base') {\n    return 'base';\n  }\n  if (normalized === 'base-sepolia' || normalized === 'basesepolia') {\n    return 'base-sepolia';\n  }\n  return null;\n};\n\nconst sleep = (ms: number): Promise<void> =>\n  new Promise(resolve => setTimeout(resolve, ms));\n\nconst round6 = (value: number): number => Math.round(value * 1e6) / 1e6;\n\nconst toDayStringUtc = (timestampMs: number): string => {\n  const date = new Date(timestampMs);\n  return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, '0')}-${String(\n    date.getUTCDate(),\n  ).padStart(2, '0')}`;\n};\n\ninterface CachedValue<T> {\n  value: T;\n  expiresAt: number;\n}\n\nconst decimalsCache = new Map<string, CachedValue<number>>();\nconst fromBlockCache = new Map<string, CachedValue<bigint>>();\nconst blockDayCache = new Map<string, CachedValue<string>>();\n\n/**\n * Minimal structural view of a viem `PublicClient` — keeps the scanner's\n * type surface shallow (viem's full client type is too deep for tsc) and\n * makes the client mockable in tests.\n */\nexport interface X402PublicClient {\n  chain?: { id?: number } | undefined;\n  getBlockNumber(): Promise<bigint>;\n  getBlock(params: { blockNumber: bigint }): Promise<{ timestamp: bigint }>;\n  getLogs(params: {\n    address: Address;\n    event: unknown;\n    args?: { from?: Address; to?: Address };\n    fromBlock: bigint;\n    toBlock: bigint;\n  }): Promise<\n    readonly { blockNumber: bigint | null; args: { value?: bigint } }[]\n  >;\n  readContract(params: {\n    address: Address;\n    abi: readonly unknown[];\n    functionName: string;\n  }): Promise<unknown>;\n}\n\ntype PublicClient = X402PublicClient;\n\nasync function withRetries<T>(\n  operation: () => Promise<T>,\n  maxRetries: number,\n  baseDelayMs: number,\n): Promise<T> {\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= maxRetries; attempt += 1) {\n    try {\n      return await operation();\n    } catch (error) {\n      lastError = error;\n      if (attempt >= maxRetries) {\n        throw error;\n      }\n      await sleep(baseDelayMs * 2 ** attempt);\n    }\n  }\n  throw lastError;\n}\n\nconst keepRollingDays = (\n  buckets: Hcs25X402UsageDailyBucket[],\n  keepDays: number,\n): Hcs25X402UsageDailyBucket[] => {\n  const keep = new Set<string>();\n  const today = toDayStringUtc(Date.now());\n  const [year, month, day] = today.split('-').map(v => Number.parseInt(v, 10));\n  const baseUtc = Date.UTC(year, month - 1, day);\n  for (let offset = 0; offset < keepDays; offset += 1) {\n    keep.add(toDayStringUtc(baseUtc - offset * 24 * 60 * 60 * 1000));\n  }\n  return buckets\n    .filter(bucket => keep.has(bucket.day))\n    .sort((a, b) => (a.day < b.day ? -1 : a.day > b.day ? 1 : 0))\n    .slice(-keepDays);\n};\n\nfunction parseCursor(value: unknown): Hcs25X402UsageCursor | null {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return null;\n  }\n  const cursor = value as Partial<Hcs25X402UsageCursor>;\n  if (\n    typeof cursor.asset !== 'string' ||\n    typeof cursor.payTo !== 'string' ||\n    typeof cursor.lastScannedBlock !== 'number' ||\n    !Number.isFinite(cursor.lastScannedBlock) ||\n    cursor.lastScannedBlock < 0 ||\n    !Array.isArray(cursor.daily)\n  ) {\n    return null;\n  }\n  const network = toNetwork(cursor.network);\n  if (!network) {\n    return null;\n  }\n  const daily = cursor.daily\n    .filter(\n      (entry): entry is Hcs25X402UsageDailyBucket =>\n        !!entry &&\n        typeof entry === 'object' &&\n        typeof entry.day === 'string' &&\n        typeof entry.inboundTrades === 'number' &&\n        Number.isFinite(entry.inboundTrades) &&\n        typeof entry.outboundTrades === 'number' &&\n        Number.isFinite(entry.outboundTrades) &&\n        typeof entry.volumeUsd === 'number' &&\n        Number.isFinite(entry.volumeUsd),\n    )\n    .map(entry => ({\n      day: entry.day,\n      inboundTrades: Math.max(0, Math.floor(entry.inboundTrades)),\n      outboundTrades: Math.max(0, Math.floor(entry.outboundTrades)),\n      volumeUsd: round6(Math.max(0, entry.volumeUsd)),\n    }));\n  return {\n    network,\n    asset: cursor.asset,\n    payTo: cursor.payTo,\n    lastScannedBlock: Math.floor(cursor.lastScannedBlock),\n    daily,\n  };\n}\n\nasync function resolveDecimals(params: {\n  client: PublicClient;\n  asset: Address;\n  isUsdc: boolean;\n  cacheTtlMs: number;\n  maxRetries: number;\n}): Promise<number> {\n  if (params.isUsdc) {\n    return 6;\n  }\n  const cacheKey = `${params.client.chain?.id ?? 'unknown'}:${params.asset}:decimals`;\n  const cached = decimalsCache.get(cacheKey);\n  if (cached && cached.expiresAt > Date.now()) {\n    return cached.value;\n  }\n  const decimals = await withRetries(\n    async () => {\n      const value = await params.client.readContract({\n        address: params.asset,\n        abi: DECIMALS_ABI,\n        functionName: 'decimals',\n      });\n      return Number(value);\n    },\n    params.maxRetries,\n    200,\n  );\n  const normalized = Number.isFinite(decimals)\n    ? Math.max(0, Math.min(255, Math.floor(decimals)))\n    : 18;\n  decimalsCache.set(cacheKey, {\n    value: normalized,\n    expiresAt: Date.now() + params.cacheTtlMs,\n  });\n  return normalized;\n}\n\nasync function estimateFromBlockByTimestamp(params: {\n  client: PublicClient;\n  targetTimestampSec: bigint;\n  cacheKey: string;\n  cacheTtlMs: number;\n  maxRetries: number;\n}): Promise<bigint> {\n  const cached = fromBlockCache.get(params.cacheKey);\n  if (cached && cached.expiresAt > Date.now()) {\n    return cached.value;\n  }\n\n  const latestBlockNumber = await withRetries(\n    () => params.client.getBlockNumber(),\n    params.maxRetries,\n    200,\n  );\n  const latest = await withRetries(\n    () => params.client.getBlock({ blockNumber: latestBlockNumber }),\n    params.maxRetries,\n    200,\n  );\n\n  const probeDelta = 5000n;\n  const probeBlockNumber =\n    latestBlockNumber > probeDelta ? latestBlockNumber - probeDelta : 0n;\n  const probe = await withRetries(\n    () => params.client.getBlock({ blockNumber: probeBlockNumber }),\n    params.maxRetries,\n    200,\n  );\n\n  const latestTs = BigInt(latest.timestamp);\n  const probeTs = BigInt(probe.timestamp);\n  const deltaSeconds = latestTs > probeTs ? latestTs - probeTs : 0n;\n  const secondsPerBlock =\n    deltaSeconds > 0n\n      ? Number(deltaSeconds) /\n        Number(latestBlockNumber - probeBlockNumber || 1n)\n      : 2;\n\n  const secondsAgo =\n    latestTs > params.targetTimestampSec\n      ? latestTs - params.targetTimestampSec\n      : 0n;\n  const approxBlocksAgo =\n    secondsPerBlock > 0\n      ? BigInt(Math.ceil(Number(secondsAgo) / secondsPerBlock))\n      : 0n;\n  const margin = 1000n;\n  let low =\n    latestBlockNumber > approxBlocksAgo + margin\n      ? latestBlockNumber - approxBlocksAgo - margin\n      : 0n;\n  let high = latestBlockNumber;\n  while (low < high) {\n    const mid = (low + high) / 2n;\n    const block = await withRetries(\n      () => params.client.getBlock({ blockNumber: mid }),\n      params.maxRetries,\n      200,\n    );\n    if (BigInt(block.timestamp) >= params.targetTimestampSec) {\n      high = mid;\n    } else {\n      low = mid + 1n;\n    }\n  }\n\n  fromBlockCache.set(params.cacheKey, {\n    value: low,\n    expiresAt: Date.now() + params.cacheTtlMs,\n  });\n  return low;\n}\n\nasync function resolveBlockDay(params: {\n  client: PublicClient;\n  blockNumber: bigint;\n  cacheTtlMs: number;\n  maxRetries: number;\n}): Promise<string> {\n  const cacheKey = `${params.client.chain?.id ?? 'unknown'}:${params.blockNumber.toString()}:day`;\n  const cached = blockDayCache.get(cacheKey);\n  if (cached && cached.expiresAt > Date.now()) {\n    return cached.value;\n  }\n  const block = await withRetries(\n    () => params.client.getBlock({ blockNumber: params.blockNumber }),\n    params.maxRetries,\n    200,\n  );\n  const day = toDayStringUtc(Number(block.timestamp) * 1000);\n  blockDayCache.set(cacheKey, {\n    value: day,\n    expiresAt: Date.now() + params.cacheTtlMs,\n  });\n  return day;\n}\n\n/**\n * Scans ERC-20 `Transfer` events to/from `payTo` on the configured x402\n * network and aggregates daily inbound/outbound trade counts and USD\n * volume, resuming from a stored cursor when possible.\n *\n * Ported from Registry Broker's `fetchX402OnchainUsageState`: chunked\n * `getLogs` ranges, per-block day resolution caching, binary-search window\n * estimation, and retry/backoff on RPC failures.\n */\nexport async function fetchX402OnchainUsageState(\n  params: Hcs25X402UsageStateParams,\n  options: Hcs25X402OnchainUsageOptions = {},\n): Promise<Hcs25X402UsageStateResult> {\n  const network = toNetwork(params.network);\n  if (!network) {\n    return { summary: null, cursor: null };\n  }\n  const config = NETWORK_CONFIG[network];\n\n  if (typeof params.asset !== 'string' || typeof params.payTo !== 'string') {\n    return { summary: null, cursor: null };\n  }\n  let asset: Address;\n  let payTo: Address;\n  try {\n    asset = getAddress(params.asset.trim());\n    payTo = getAddress(params.payTo.trim());\n  } catch {\n    return { summary: null, cursor: null };\n  }\n\n  const now = Date.now();\n  const ttlMs =\n    typeof options.ttlMs === 'number' &&\n    Number.isFinite(options.ttlMs) &&\n    options.ttlMs > 0\n      ? options.ttlMs\n      : 30 * 60 * 1000;\n  const maxRetries =\n    typeof options.maxRetries === 'number' &&\n    Number.isFinite(options.maxRetries) &&\n    options.maxRetries >= 0\n      ? Math.floor(options.maxRetries)\n      : 2;\n  const chunkSizeBlocks =\n    typeof options.chunkSizeBlocks === 'number' &&\n    Number.isFinite(options.chunkSizeBlocks) &&\n    options.chunkSizeBlocks > 0\n      ? BigInt(Math.floor(options.chunkSizeBlocks))\n      : 50_000n;\n\n  const rpcUrls = options.rpcUrls?.[network]?.length\n    ? [...options.rpcUrls[network]!]\n    : config.rpcUrls;\n  const transports = rpcUrls.map(url => httpTransport(url));\n  if (transports.length === 0) {\n    return { summary: null, cursor: null };\n  }\n  const client = createPublicClient({\n    chain: config.chain,\n    transport: transports.length > 1 ? fallback(transports) : transports[0],\n  }) as unknown as PublicClient;\n\n  const assetLower = asset.toLowerCase();\n  const payToLower = payTo.toLowerCase();\n  const decimals = await resolveDecimals({\n    client,\n    asset,\n    isUsdc: config.usdcAddresses.has(assetLower),\n    cacheTtlMs: ttlMs,\n    maxRetries,\n  });\n\n  const days =\n    typeof options.days === 'number' &&\n    Number.isFinite(options.days) &&\n    options.days > 0\n      ? Math.min(14, Math.max(1, Math.floor(options.days)))\n      : 7;\n\n  const targetTimestampSec = BigInt(\n    Math.floor((now - days * 24 * 60 * 60 * 1000) / 1000),\n  );\n  const windowFromBlock = await estimateFromBlockByTimestamp({\n    client,\n    targetTimestampSec,\n    cacheKey: `${network}:${assetLower}:${payToLower}:fromBlock:${days}`,\n    cacheTtlMs: ttlMs,\n    maxRetries,\n  });\n  const toBlock = await client.getBlockNumber();\n\n  const parsedCursor = parseCursor(params.cursor);\n  const hasMatchingCursor =\n    parsedCursor !== null &&\n    parsedCursor.network === network &&\n    parsedCursor.asset.toLowerCase() === assetLower &&\n    parsedCursor.payTo.toLowerCase() === payToLower;\n\n  const cursorFromBlock =\n    hasMatchingCursor && parsedCursor\n      ? BigInt(Math.max(0, parsedCursor.lastScannedBlock + 1))\n      : windowFromBlock;\n  const fromBlock =\n    cursorFromBlock < windowFromBlock ? windowFromBlock : cursorFromBlock;\n  const shouldResync = !hasMatchingCursor || cursorFromBlock < windowFromBlock;\n\n  const bucketsByDay = new Map<string, Hcs25X402UsageDailyBucket>();\n  if (!shouldResync && parsedCursor) {\n    for (const bucket of keepRollingDays(parsedCursor.daily, days)) {\n      bucketsByDay.set(bucket.day, { ...bucket });\n    }\n  }\n  const ensureBucket = (day: string): Hcs25X402UsageDailyBucket => {\n    const existing = bucketsByDay.get(day);\n    if (existing) {\n      return existing;\n    }\n    const created: Hcs25X402UsageDailyBucket = {\n      day,\n      inboundTrades: 0,\n      outboundTrades: 0,\n      volumeUsd: 0,\n    };\n    bucketsByDay.set(day, created);\n    return created;\n  };\n\n  const aggregateLogs = async (\n    direction: 'inbound' | 'outbound',\n  ): Promise<void> => {\n    if (toBlock < fromBlock) {\n      return;\n    }\n    for (let start = fromBlock; start <= toBlock; ) {\n      const end =\n        start + chunkSizeBlocks - 1n <= toBlock\n          ? start + chunkSizeBlocks - 1n\n          : toBlock;\n      const args =\n        direction === 'inbound'\n          ? ({ to: payTo } as const)\n          : ({ from: payTo } as const);\n      const logs = await withRetries(\n        () =>\n          client.getLogs({\n            address: asset,\n            event: TRANSFER_EVENT_ABI[0],\n            args,\n            fromBlock: start,\n            toBlock: end,\n          }),\n        maxRetries,\n        200,\n      );\n      for (const log of logs) {\n        const blockNumber = log.blockNumber ?? null;\n        if (!blockNumber) {\n          continue;\n        }\n        const value = (log.args as { value?: bigint }).value ?? 0n;\n        if (value <= 0n) {\n          continue;\n        }\n        const day = await resolveBlockDay({\n          client,\n          blockNumber,\n          cacheTtlMs: ttlMs,\n          maxRetries,\n        });\n        const bucket = ensureBucket(day);\n        if (direction === 'inbound') {\n          bucket.inboundTrades += 1;\n        } else {\n          bucket.outboundTrades += 1;\n        }\n        const amount = Number.parseFloat(formatUnits(value, decimals));\n        if (Number.isFinite(amount) && amount > 0) {\n          bucket.volumeUsd = round6(bucket.volumeUsd + amount);\n        }\n      }\n      start = end + 1n;\n    }\n  };\n\n  await aggregateLogs('inbound');\n  await aggregateLogs('outbound');\n\n  const mergedDaily = keepRollingDays(Array.from(bucketsByDay.values()), days);\n  const inboundTrades7d = mergedDaily.reduce(\n    (sum, bucket) => sum + bucket.inboundTrades,\n    0,\n  );\n  const outboundTrades7d = mergedDaily.reduce(\n    (sum, bucket) => sum + bucket.outboundTrades,\n    0,\n  );\n  const volume7dUsd = round6(\n    mergedDaily.reduce((sum, bucket) => sum + bucket.volumeUsd, 0),\n  );\n  const today = toDayStringUtc(now);\n  const volume24hUsd = round6(\n    mergedDaily\n      .filter(bucket => bucket.day === today)\n      .reduce((sum, bucket) => sum + bucket.volumeUsd, 0),\n  );\n\n  const cursor: Hcs25X402UsageCursor = {\n    network,\n    asset: assetLower,\n    payTo: payToLower,\n    lastScannedBlock: Number(toBlock),\n    daily: mergedDaily,\n  };\n\n  if (inboundTrades7d + outboundTrades7d <= 0) {\n    return { summary: null, cursor };\n  }\n\n  return {\n    summary: {\n      volume7dUsd,\n      volume24hUsd,\n      inboundTrades7d,\n      outboundTrades7d,\n    },\n    cursor,\n  };\n}\n"],"names":["httpTransport"],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es134.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.es135.js

@@ -1,124 +1,382 @@
-import { readString } 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 { requestJson, Hcs25CollectorHttpError, isTimeoutError } from "./standards-sdk.es122.js";
-const DEFAULT_INCLUDED_REGISTRIES = ["virtuals-protocol"];
-const METRIC_KEYS = [
-  "successRate",
-  "successfulJobCount",
-  "totalJobCount",
-  "volume",
-  "revenue",
-  "rating"
+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"
+  }
 ];
-function pickMetrics(record) {
-  if (typeof record !== "object" || record === null) {
+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 source = record;
-  const metrics = {};
-  let found = false;
-  for (const key of METRIC_KEYS) {
-    const value = source[key];
-    if (typeof value === "number" && Number.isFinite(value)) {
-      metrics[key] = value;
-      found = true;
+  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);
     }
   }
-  return found ? metrics : null;
+  throw lastError;
 }
-function defaultMapResponse(data) {
-  if (typeof data !== "object" || data === null) {
+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 root = data;
-  return pickMetrics(root.metrics) ?? pickMetrics(root.agent) ?? pickMetrics(root);
+  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;
 }
-function resolveAgentAddress(subject) {
-  const metadata = subject.metadata ?? {};
-  for (const key of ["nativeId", "address", "uid"]) {
-    const value = readString(metadata, key);
-    if (value) {
-      return value;
+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;
     }
   }
-  return null;
+  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;
 }
-function createAcpSignalAdapter(options) {
-  const mapResponse = options.mapResponse ?? defaultMapResponse;
-  const collect = async (subject, context) => {
-    const now = context.now.toISOString();
-    const address = resolveAgentAddress(subject) ?? subject.id;
-    const url = typeof options.endpoint === "function" ? options.endpoint(subject) : options.endpoint.replace("{address}", encodeURIComponent(address)).replace("{nativeId}", encodeURIComponent(address));
-    if (!url) {
-      return [{ signalId: "acp.metrics", status: "missing" }];
+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 });
     }
-    try {
-      const data = await requestJson(url, {
-        fetch: context.fetch,
-        timeoutMs: context.timeoutMs,
-        signal: context.signal
-      });
-      const metrics = mapResponse(data);
-      if (!metrics) {
-        return [{ signalId: "acp.metrics", status: "missing" }];
-      }
-      const metricsValues = {};
-      for (const key of METRIC_KEYS) {
-        const value = metrics[key];
-        if (value !== void 0) {
-          metricsValues[key] = value;
+  }
+  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 rootValues = {};
-      if (metrics.successRate !== void 0) {
-        rootValues.successRate = metrics.successRate;
-      }
-      if (metrics.successfulJobCount !== void 0) {
-        rootValues.successfulJobCount = metrics.successfulJobCount;
-      }
-      return [
-        {
-          signalId: "acp.metrics",
-          status: "ok",
-          value: metrics.successRate ?? null,
-          fields: [
-            { scope: "metrics", values: metricsValues },
-            { scope: "root", values: rootValues }
-          ],
-          provenance: {
-            source: "acp",
-            sourceUrl: url,
-            subjectId: address,
-            fetchedAt: now
-          }
+        const value = log.args.value ?? 0n;
+        if (value <= 0n) {
+          continue;
         }
-      ];
-    } catch (error) {
-      if (error instanceof Hcs25CollectorHttpError && error.status === 404) {
-        return [{ signalId: "acp.metrics", status: "missing" }];
-      }
-      return [
-        {
-          signalId: "acp.metrics",
-          status: isTimeoutError(error) ? "timeout" : "error"
+        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 {
-    id: "acp",
-    produces: ["acp.metrics"],
-    timeoutMs: options.timeoutMs,
-    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
-    excludeRegistries: options.excludeRegistries,
-    appliesTo: options.appliesTo,
-    collect
+    summary: {
+      volume7dUsd,
+      volume24hUsd,
+      inboundTrades7d,
+      outboundTrades7d
+    },
+    cursor
   };
 }
 export {
-  createAcpSignalAdapter
+  fetchX402OnchainUsageState
 };
 //# sourceMappingURL=standards-sdk.es135.js.map