Overview and installation

The CLI combines a persistent signing runner, Privy managed agents, Relay funding, a packaged agent skill, and paper trading against real mainnet market data. Master custody stays external.

InstallCopy Anchor Link

npm install -g @bloxwap/agent-cli
agent-cli --help
# Or run with Bun:
bunx @bloxwap/agent-cli --help

The published CLI requires Node.js 22.12+ or current Bun. It has no postinstall script. The repository and docs use Node.js 24+.

JSON contractCopy Anchor Link

Arguments can be flags, --json '{...}', or a JSON object on stdin. Ordinary commands return {ok:true,data} or {ok:false,code,message,retryable,details}. QR output and logs use stderr. events --follow and logs stream JSON lines. Global flags: --config PATH, --network mainnet|testnet, --pretty, --json OBJECT.

agent-cli schema order
agent-cli market --coin BTC --network testnet

Start with Quickstart, inspect the Command reference, and read Custody before operating a funded account.

Local state always lives in ~/.bloxwap. Environment variables use BLOXWAP_. The default Bloxwap builder rate is f=10, 0.01%, and requires master approval.