Skip to content

Add x402 top-up documentation#301

Open
mmurrs wants to merge 1 commit into
mainfrom
docs/x402-topup
Open

Add x402 top-up documentation#301
mmurrs wants to merge 1 commit into
mainfrom
docs/x402-topup

Conversation

@mmurrs

@mmurrs mmurrs commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

What

Documents the x402 credit-purchase path that went live on prod (billingapi.eigencloud.xyz) this week:

  • docs/eigencompute/get-started/billing.md — new "Top up with x402" section: CLI usage (ecloud billing top-up --method x402), creator-pool vs per-app crediting, $5 minimum, no-gas-needed note, plus the raw HTTP endpoints (/.well-known/x402.json discovery, POST /creators/{addr}/x402-credits, POST /apps/{addr}/x402-credits) so agents and third-party x402 clients can purchase credits programmatically.
  • docs/eigencompute/reference/ecloud-cli/billing.md — fleshed out the top-up command entry with the --method, --amount, --chain, --creator, --app flags (reference previously had no flags listed).

Why

x402 purchasing shipped in ecloud-platform (PR #272 + #304 interop fix) and is now enabled on mainnet, but has zero user-facing docs. This gives users and agent builders enough to actually try it.

Verification

Flow verified end-to-end 2026-07-14: prod challenge + PAYMENT-REQUIRED header interop confirmed against billingapi.eigencloud.xyz (Base mainnet, spec-compliant v2), and a full settlement ($5, HTTP 201, credits granted, on-chain tx confirmed) exercised via ecloud billing top-up --method x402 against the dev host on Base Sepolia.

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
eigencloud-docs Ready Ready Preview Jul 14, 2026 3:49pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant