Skip to content

Indexer API ref update + x402 guide

Viet Tan Tran requested to merge github/fork/ihsraham/preview/WDKDOCS-211-213-combined into develop

Created by: ihsraham

Summary

This PR combines two documentation tasks for a single preview:

  1. WDKDOCS-211 — Indexer API reference update
  2. WDKDOCS-213 — x402 payments guide

WDKDOCS-211: Update Indexer API Reference

Problem

  • The /api/v1/chains endpoint was documented in api-reference.md and README.md but does not exist in the OpenAPI spec (returns 404).
  • Two batch endpoints (POST /api/v1/batch/token-transfers, POST /api/v1/batch/token-balances) exist in the OpenAPI spec but were not documented.

Changes

  • tools/indexer-api/api-reference.md: Removed ghost /api/v1/chains from the rate limiting table and OpenAPI block. Added {% openapi %} blocks and rate limits for both batch endpoints.
  • tools/indexer-api/README.md: Removed stale /api/v1/chains reference.

WDKDOCS-213: Create x402 Guide

What's New

New guide at ai/x402.md covering x402 HTTP payments with WDK. Based on PR #92 content..

Sections covered:

  • What is x402 (protocol overview, three roles, step-by-step flow)
  • Client (Buyer) — paying for resources with @tetherto/wdk-wallet-evm
  • Bridging USD₮ to Plasma / Stable
  • Server with Hosted Facilitator — using Semantic's facilitator service
  • Server with Self-Hosted Facilitator — using @semanticio/wdk-wallet-evm-x402-facilitator
  • Multi-chain support, lifecycle events, summary table

Content fixes over PR #92

  • new WalletAccountEvm() → new WalletManagerEvm().getAccount() (correct WDK pattern)
  • ethereum-rpc.publicnode.com → eth.drpc.org (per style guide)
  • Different syntax → GitBook (<Steps> → {% stepper %}, <Note> → {% hint %}, etc.)

Cross-references added

  • overview/changelog.md: Added February 18 entry for x402 guide. Removed broken link from Jan 23 /api/v1/chains entry (kept text).
  • sdk/community-modules/README.md: Added @semanticio/wdk-wallet-evm-x402-facilitator to the community modules table.
  • start-building/build-with-ai.md: Added hint box linking to x402 guide alongside the MCP Toolkit hint.
  • SUMMARY.md: Added x402 entry under the AI section.

Files Changed

File Task
tools/indexer-api/api-reference.md WDKDOCS-211
tools/indexer-api/README.md WDKDOCS-211
ai/x402.md (new) WDKDOCS-213
SUMMARY.md WDKDOCS-213
overview/changelog.md WDKDOCS-213
sdk/community-modules/README.md WDKDOCS-213
start-building/build-with-ai.md WDKDOCS-213

Merge request reports