Onchain Routerby AgenticFI Base Mainnet

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.

bash
npm install --global @agenticfi/onchain-router-cli@alpha
onchain-router --version
onchain-router setup
onchain-router policy show
onchain-router unlock
onchain-router models

Version 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

ProductInstallStatus
TypeScript SDKnpm install @agenticfi/onchain-router@alphaPublic npm alpha 0.1.2
Buyer CLInpm install --global @agenticfi/onchain-router-cli@alphaPublic npm alpha 0.1.2
MCP servernpm install --global @agenticfi/onchain-router-mcp@alphaPublic npm alpha 0.1.2
Local proxynpm install --global @agenticfi/onchain-router-proxy@alphaPublic npm alpha 0.1.2
Buyer Runtimenpm install @agenticfi/onchain-router-buyer-core@alphaPublic npm alpha 0.1.2; trusted-adapter authors
Smart routingnpm install @agenticfi/onchain-router-routing@alphaPublic 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.

IntegrationBest forAvailabilitySource
Direct APIYou already have an x402 buyerPublic APIUse the public API
TypeScript SDKYou are building a Node.js applicationnpm alpha · 0.1.2GitHub
Buyer CLIYou work in a terminalnpm alpha · 0.1.2GitHub
MCPYour agent uses native toolsnpm alpha · 0.1.2GitHub
Local OpenAI proxyYour app accepts an OpenAI base URLnpm alpha · 0.1.2GitHub
Agent SkillYour coding agent follows reusable instructionsMIT source · alphaGitHub
OpenClawYou use OpenClaw agentsGitHub alpha · 0.1.0GitHub
Hermes AgentYou use Hermes AgentGitHub alpha · 0.1.0GitHub

Agent-host integrations

  • OpenClaw 0.1.0 is 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.0 is 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.

Reviewed 2026-09-04Catalog c1f92fac4f1d

Search guides, endpoint references, models, and pricing.