Buyer-controlled client for x402 API payments in USDC on Base.
★ 4,751⑂ 163👁 38⑃ 32● 9▤ 0
+114
Daily
+1,214
Weekly
4,751
stars
163
forks
38
watchers
32
prs
9
issues
0
releases
README
vAPI Network vAPI Network builds payment and trust infrastructure for AI agents on Base, with x402 API payments in USDC. One wallet, every x402 API. vapi-network is its open-source, non-custodial TypeScript client for discovering and paying x402 services from a terminal, an MCP client, or your own code. The device vault encrypts your keys on this machine, using an OS-stored device key with optional password protection. vAPI applies spend policy before signing, sends the payment straight to the service, and writes a local receipt. Local runs keep keys on this machine; experimental Railway runs require explicit member-key export. Every payment identifies this client as vapi through x402 builder-code; when an API advertises payment-identifier, the generated id is kept on that receipt. vAPI Call takes no fee. Providers are paid directly. Call, Router, Stake and Agents are live on production. Tasks is coming soon. See vapinetwork.ai and the documentation. vAPI Network is not related to Vapi.ai, the voice AI company. Install This README describes client 0.13.0. npm view vapi-network version shows the latest published release. bash npm i -g vapi-network No install? Prefix any command with npx vapi-network, for example npx vapi-network init. (npx vapi cannot work: the bare vapi name on npm belongs to an unrelated package.) An agent can set itself up from the agent skill. Tell it: "Read https://vapinetwork.ai/SKILL.md and follow it to set up vAPI." The same file ships in this package as SKILL.md, with the CLI version it describes in its frontmatter. Interactive CLI runs check for a newer release at most once a day and cache the result in ~/.vapi/update-check.json. JSON, MCP server, CI and non-TTY runs skip the check. Set VAPI_NO_UPDATE_CHECK=1 to disable it. Quickstart bash npm i -g vapi-network vapi setup [--no-cloud-backup] creates or restores the vault, derives main, links it to your owner wallet; safe to rerun vapi fund opens the hosted funding page for your address vapi search "weather" every catalogue, merged, with provenance vapi pay --max 0.02 vapi receipts one line per paid call: quote, settlement, latency Back up the recovery phrase only in a terminal; vAPI cannot recover it. Turn on encrypted cloud backup with vapi backup --cloud; only the owner can approve a restore. Headless Linux On Linux without a working keyring (servers, containers, GitHub Codespaces), set VAPI_VAULT_PASSWORD before vapi setup; the device key and agent link are then kept in ~/.vapi/secrets.json, encrypted with that password. The choice is made once per vault. bash read -rs -p 'Vault password (at least 12 characters): ' VAPI_VAULT_PASSWORD export VAPI_VAULT_PASSWORD vapi setup In GitHub Codespaces, add VAPI_VAULT_PASSWORD as a Codespaces secret with at least 12 characters before running setup. What you can do | Surface | What it does
Top issues
#18Proposal: external x402-v2 POST source adapter compatibility test on Base4 comments · 2026-10-28#42Agent link: owner approved the link code on their phone and the vAPI web page showed 'Agent linked', but the CLI token exchange keeps failing. Every POST /oauth/token poll is answered HTTP 502 with error refresh_rejected and message 'token refresh not allo0 comments · 2026-11-15#41vapi login agent-link step fails in 6/6 attempts — 'agent link could not be stored consistently' (5x) and 'link request expired' (1x)0 comments · 2026-11-14#37Git0 comments · 2026-11-07#30Laporan untuk support vAPI — login CLI gagal (device authorization ditolak)0 comments · 2026-11-06#29Claiming indexed listings whose payTo is a custodial deposit address0 comments · 2026-11-05#28Example proposal: optional read-only CEX execution gate ($0.10 x402) before a buyer client acts on trade intent0 comments · 2026-11-05#27Windows DPAPI vault decrypt fails on v0.11.0; login and MCP fail0 comments · 2026-11-05