Skip to content

v0.14.0

Choose a tag to compare

@ryanio ryanio released this 05 Jun 20:39
· 33 commits to main since this release

What's Changed

Usage reporting reworked to match the os2-core POST /api/v2/tools/usage endpoint.

Breaking changes

  • Eip3009UsageReporterConfig now requires apiKey, operatorAddress, and the ERC-8257 composite key (toolChainId, toolRegistryAddress, toolOnchainId). The old tool_slug field is removed.
  • Default aggregator URL changed to https://api.opensea.io/api/v2/tools/usage.
  • Base Sepolia (84532) removed from NETWORK_USDC.

New features

  • ToolHandlerConfig.usageReporting: pass an Eip3009UsageReporterConfig and createToolHandler auto-fires the reporter on every successful invocation (both free EIP-3009 and paid x402 paths). Works alongside onInvocation.
  • createX402UsageReporter: standalone reporter for paid x402 tools (no wallet signing, just the settlement tx hash).
  • Per-event txHash hex-format validation in the x402 reporter.

Full Changelog: v0.13.0...v0.14.0