Developer documentation
Installation & availability
Install the public npm and host-native GitHub alphas, verify their sources, and understand the remaining release boundaries.
Page tools
Fastest safe start
Requirements: Node.js 20.18 or newer, macOS or Linux, and a human-controlled terminal.
npm install --global @agenticfi/onchain-router-cli@alpha
onchain-router --version
onchain-router setup
onchain-router policy show
onchain-router unlock
onchain-router modelsVersion 0.1.2 is the current bounded public alpha. Install with the explicit npm alpha tag so your configuration communicates that release boundary. Before installation, verify that the package is under the @agenticfi scope and links to AgenticFI/onchain-router-clients.
Setup, wallet import, funding, unlock, and policy widening are human-authority actions. Run them yourself in a direct terminal. Never put a private key, seed phrase, passphrase, payment payload, proxy bearer, or receipt capability in a prompt, command argument, environment variable, log, screenshot, or issue.
Choose a public package
| Product | Install | Status |
|---|---|---|
| TypeScript SDK | npm install @agenticfi/onchain-router@alpha | Public npm alpha 0.1.2 |
| Buyer CLI | npm install --global @agenticfi/onchain-router-cli@alpha | Public npm alpha 0.1.2 |
| MCP server | npm install --global @agenticfi/onchain-router-mcp@alpha | Public npm alpha 0.1.2 |
| Local proxy | npm install --global @agenticfi/onchain-router-proxy@alpha | Public npm alpha 0.1.2 |
| Buyer Runtime | npm install @agenticfi/onchain-router-buyer-core@alpha | Public npm alpha 0.1.2; trusted-adapter authors |
| Smart routing | npm install @agenticfi/onchain-router-routing@alpha | Public npm alpha 0.1.2; experimental |
The Python SDK remains a source package that delegates paid execution to the matching CLI. It is not on PyPI.
| Integration | Best for | Availability | Source |
|---|---|---|---|
| Direct API | You already have an x402 buyer | Public API | Use the public API |
| TypeScript SDK | You are building a Node.js application | npm alpha · 0.1.2 | GitHub |
| Buyer CLI | You work in a terminal | npm alpha · 0.1.2 | GitHub |
| MCP | Your agent uses native tools | npm alpha · 0.1.2 | GitHub |
| Local OpenAI proxy | Your app accepts an OpenAI base URL | npm alpha · 0.1.2 | GitHub |
| Agent Skill | Your coding agent follows reusable instructions | MIT source · alpha | GitHub |
| OpenClaw | You use OpenClaw agents | GitHub alpha · 0.1.0 | GitHub |
| Hermes Agent | You use Hermes Agent | GitHub alpha · 0.1.0 | GitHub |
Agent-host integrations
- OpenClaw
0.1.0is a public MIT alpha installed from its immutable GitHub release with OpenClaw's native Git installer:openclaw plugins install git:github.com/AgenticFI/onchain-router-openclaw@v0.1.0 --force. It is not yet listed on ClawHub. - Hermes Agent
0.1.0is a public MIT alpha installed from AgenticFI/onchain-router-hermes with Hermes' native Git installer:hermes plugins install AgenticFI/onchain-router-hermes --enable. It is not a PyPI release, and PyPI is not required for this host-native path. - The portable Agent Skill is public in the client repository and requires the matching Buyer CLI.
Verify the exact organization, repository, version, and release commit before installation. These public-alpha installs do not prove a funded request in either host; complete the human-owned Buyer Runtime setup and acceptance flow separately.
Browser Workbench
Open Workbench. This build includes the browser UI. A read-only local preview cannot submit paid requests; use only an explicitly enabled deployment for payments.
Update and verify
Pin the alpha tag or exact 0.1.2 version. Review release notes before updating, rerun onchain-router doctor, and confirm that the local wallet profile, policy, and receipts remain intact. The product manifest records current publication facts; the live models, pricing, and HTTP 402 challenge remain authoritative for service behavior.
