ZBD Agents

Build agent-native Bitcoin flows with zbdw, agent-pay, and agent-fetch.

The ZBD Agents toolkit gives you an end-to-end stack for agentic payments: a wallet CLI (zbdw), an L402 client (agent-fetch), an L402 server middleware (agent-pay), and supporting apps for identity and operations.

Want the fastest hands-on path? Start with the runnable scripts in agent-pay/examples/http-server.mjs and agent-fetch/examples/zbd-agent-fetch.mjs.

Start in Minutes

Install one package, run zbdw init, and execute your first paid request.

Monetize Any Endpoint

Add payment gates to Express, Hono, and Next.js route handlers.

Pay 402 Automatically

Auto-handle L402 challenges with max payment guardrails and token caching.

Operate with Confidence

Use the dashboard to inspect balances, payment history, and local wallet state.

Ship Agent Skills

Package zbdw workflows into reusable skills for IDE agents and OpenClaw-compatible runtimes.

Choose Your Path

Developer

Goal: launch a working agent payment flow fast.

1. Start with the Quick Start
2. Add payment-gated routes with agent-pay
3. Pay those routes with agent-fetch or zbdw fetch

Product & PM

Goal: validate monetization and ops fit.

• Map capabilities in Architecture
• Review deployment surfaces in Repo Map
• Track live wallet activity in Agent Wallet Dashboard

Platform Team

Goal: standardize identity and payments infrastructure.

• Set up zbd.ai Registry for stable Lightning addresses
• Standardize env vars and shared file paths
• Adopt workspace verification scripts for CI

Core Repositories

agent-wallet

CLI wallet and command router for ZBD agent payments (zbdw).

agent-fetch

L402-aware fetch client for paid HTTP resources.

agent-pay

L402 middleware for Express, Hono, and Next.js.

agent-wallet-dashboard

Local dashboard for wallet balances and payments history.

zbdw is the binary shipped by @zbdpay/agent-wallet. It is designed for JSON-first CLI interoperability with agent runners.

What You Can Build

Paid API products

Gate premium API routes with agent-pay, then let autonomous clients unlock access via agent-fetch.

Autonomous data acquisition

Use zbdw fetch to allow agents to pay per request and retrieve premium content in one command.

Agent-to-agent commerce

Combine wallet send/receive primitives with L402 middleware to create closed-loop service economies.

Operations and observability

Track local wallet activity in ~/.zbd-wallet and visualize it with the dashboard.