bankofai-x402-cli 0.1.0b8

x402-cli — one-shot BankofAI x402 CLI: serve a 402 payment endpoint, or pay one as a client.

x402-cli (Python)

One-shot BankofAI x402 CLI built on top of the bankofai-x402 SDK. Two commands:

• serve — start a local x402 payment server (advertises payment terms, accepts a signed payload, settles).
• pay <url> — pay an x402-protected URL when the server returns 402 Payment Required.

Full flag matrix and example output: FEATURES.md.

Install

pip install bankofai-x402-cli
x402-cli --help

Or from source:

cd x402-cli
pip install -e .
x402-cli --help

Quick start

# Start a server that charges 1.25 USDT on TRON Nile
x402-cli serve --pay-to TJWdoJk8KyrfxZ2iDUqz7fwpXaMkNqPehx \
  --rawAmount 1.25 --network tron:nile

# In another shell — pay it
x402-cli pay http://127.0.0.1:4020/pay \
  --max-rawAmount 1.25 --network tron:nile --token USDT

Design

Unlike the TypeScript version which implements its own HTTP server and facilitator client, the Python CLI directly uses the SDK's X402Server and FacilitatorClient from bankofai-x402:

from bankofai.x402.server import X402Server
from bankofai.x402.facilitator import FacilitatorClient

server = X402Server()  # No duplication
facilitator = FacilitatorClient(base_url)  # SDK provided

This avoids code duplication and keeps the CLI thin (just argument parsing + output formatting).

Environment variables

Var	Purpose
TRON_PRIVATE_KEY	TRON wallet key for --wallet env
EVM_PRIVATE_KEY	EVM wallet key for --wallet env
TRON_GRID_API_KEY	Optional, forwarded to SDK for TronGrid

Development

cd x402-cli
pip install -e .[dev]
pytest
python -m bankofai.x402_tools.cli server --help