Skip to content

docs: align product docs with merged code (x402 2.1.0, wallet-cli 4.15.1, 8004 1.2.1, Agent Wallet 3.0.0) - #124

Merged
zerodevblock-cyber merged 15 commits into
mainfrom
wallet-cli
Oct 29, 2026
Merged

zerodevblock-cyber merged 15 commits into
mainfrom
wallet-cli

Conversation

@jizhen181-dot

@jizhen181-dot jizhen181-dot commented Oct 28, 2026 •

Copy link
Copy Markdown
Collaborator

Aligns the docs with the merged code in each product repository: main branches, or develop for wallet-cli. Unmerged work is not documented. EN and zh-Hans are updated together, and the site builds cleanly.

Changes by area

  • x402: SDK 2.1.0 on official @x402/* 2.28.0, facilitator v2.2.2 behaviour (error codes, rate limits, Nile-only sponsoring with API key), decimal TRON CAIP-2 IDs, corrected diagrams.
  • wallet-cli: 4.15.1 error-code table, spend cap and --dry-run details, B.AI recharge rules.
  • 8004: SDK 1.2.1 network aliases, subgraph defaults, new Common Contract Errors section.
  • OpenClaw / MCP: installer output and behaviour, notice that recharge.bankofai.io/mcp is offline (use wallet-cli bai recharge), TRON MCP npm 1.1.7 vs v1.1.8 differences, add-mcp usage.
  • Agent Wallet / Skills: Agent Wallet rewritten for 3.0.0; Skills install from /tree/main, per-skill credentials, setup steps.
  • Changelog: entries for Oct 21–27.
  • Version: bumped to 1.5.0.

Verification

  • Claims checked against source code and published npm packages.
  • About 120 documented CLI commands run against the published CLIs in a sandbox, with no real keys or payments.
  • External links, diagrams and EN/zh parity checked.

Not changed

  • Best Practices (devnotes) articles.
  • The LLM Service section.

jizhen181-dot and others added 8 commits October 28, 2026 17:02
- Packages, imports and samples follow @bankofai/x402-tron 2.1.0 on official @x402/* 2.28.0; Node.js 24.22.1+.
- Facilitator error codes, rate limits, /sponsoring/ready, sponsoring scope (Nile, API key) and GasFree proxy behaviour match v2.2.2.
- TRON resource sponsoring now notes the 2.1.0 client extension requirement.
- Decimal TRON CAIP-2 IDs; the API Catalog keeps hex IDs; catalog CI rules.
- Diagrams: catalog consumer is wallet-cli, MCP catalog lookup not shipped, zh permitTransferFrom.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
- Common error-code table with exit codes.
- Spend cap, --dry-run, route filters and paymentStatus details.
- B.AI recharge: routes, token default, minimums and check order.
- Skills pin 4.14.0; Node.js security baselines.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
- Subgraph defaults per language, aliases (bsc/evm resolve to 97 without chainId 56), feeLimit and embeddings.
- New Common Contract Errors section, by contract function.
- getAgent/loadAgent/registerIPFS behaviour without a subgraph or uploader.
- agentWallet is cleared on transfer; Quick Start sample notes.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
- OpenClaw: installer prompts and output (skills 1.4.6 copy mode), first-install-only configuration, Clean mode scope, Node.js error text.
- Recharge MCP (recharge.bankofai.io/mcp) is offline; point to wallet-cli bai recharge.
- TRON MCP: npm 1.1.7 vs v1.1.8, endpoints and rate limits, Docker --readonly, 405 on GET/DELETE /mcp, agent-wallet 2.x reset.
- add-mcp -y installs project-level config; walkthrough includes the scope prompt.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…ills setup

- Agent Wallet 3.0.0: wallet types, exec-script credentials, canonical CAIP-2 networks, error codes, signAndBroadcast timeouts, wallet_cli TRON payload requirements, config schema.
- Skills: install from /tree/main, per-skill credentials, npm install after install and update, sun-cli 1.2.2, Permit2 approval per swap.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@boboliu-1010 boboliu-1010 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed commit b47367d. Seven complete TypeScript examples pass strict type checking with the documented npm versions, and the hosted facilitator /supported response matches the documented networks and extensions. No blocking documentation issues found. Full site build and live on-chain payments were not independently rerun.

jizhen181-dot and others added 7 commits October 29, 2026 14:31
- Gateway: run your own gateway with the v1.0.4 Docker image (npm still has 1.0.2 with hex TRON IDs): provider.yml, .env, check, start, health and 402 checks.
- List Your Service and wallet-cli overview link to the new section.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The four x402 CLI pages moved to /wallet-cli/ in b11a7a1 without redirects. Add client redirects for both locales.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Unknown paths fell back to the locale index with HTTP 200. Return 404 and serve the locale's Docusaurus 404 page.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
custom.css hid the collapsible TOC button, leaving narrow screens with no in-page navigation.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
- Add ESLint 9 with typescript-eslint and React plugins, plus eslint.config.mjs; yarn lint failed with "eslint not found".
- CI: lint job on Node 22.23.4 before the Docker build.
- llmservice.js: list hook dependencies.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Skills 3.0 has no x402-payment skill; point agents to Skills and wallet-cli, and keep OpenClaw and TRON MCP as existing integrations.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@zerodevblock-cyber
zerodevblock-cyber merged commit be11522 into main Oct 29, 2026
4 checks passed
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.

3 participants