@voidly/pay-cli

Command-line interface for Voidly Pay. Shell + CI + scripting access to every primitive on the rail.

Install

npm install -g @voidly/pay-cli
# or one-shot
npx @voidly/pay-cli help

Quickstart

# First run mints + persists a keypair to ~/.voidly-pay/keypair.json (mode 0600)
voidly-pay whoami

# Read state
voidly-pay balance
voidly-pay health
voidly-pay activity --limit 10
voidly-pay leaderboard --metric earned_24h

# Move money
voidly-pay transfer did:voidly:bob 0.5 --memo 'first payment'
voidly-pay batch did:voidly:a=1,did:voidly:b=2.5,did:voidly:c=0.1
voidly-pay history --limit 20

# Escrow
voidly-pay escrow open did:voidly:bob 1.0 --hours 24
voidly-pay escrow release <id>
voidly-pay escrow refund <id> --reason 'stale'

# Streams
voidly-pay stream open did:voidly:provider 5
voidly-pay stream meter <stream_id> 1 0.001 --units 100

# x402
voidly-pay x402 quote /api/expensive 0.01
voidly-pay x402 verify 'voidly-credit transfer_id=abc; quote_id=xyz'

# Pay-on-402
voidly-pay fetch https://api.example.com/data --max 0.05

# Webhooks
voidly-pay webhook subscribe https://my-server.com/voidly --events transfer.settled

# Webhook signature verify (body via stdin or arg)
echo '{"foo":"bar"}' | voidly-pay verify-sig <secret_hex> 't=1234,v1=...'

All commands output JSON to stdout. Pipe through jq for prettier output, or pass --pretty for pretty-printing.

Configuration

export VOIDLY_PAY_API_URL=https://api.voidly.ai     # default
export VOIDLY_PAY_KEY_PATH=$HOME/.voidly-pay/keypair.json

Or per-call:

voidly-pay whoami --api-url http://localhost:8787

License

MIT