@raycashxyz/mpp-pay

CLI for making paid API requests via the Machine Payments Protocol with Raycash private payments.

Install

npm install -g @raycashxyz/mpp-pay

Or use directly with npx:

npx @raycashxyz/mpp-pay <url>

Usage

# Create a signing wallet (first time only — no ETH needed)
mpp-pay --create-wallet

# Make a paid request
mpp-pay "https://your-api.com/endpoint"

# POST with body
mpp-pay "https://your-api.com/endpoint" --method POST --body '{"input":"hello"}'

# Check wallet
mpp-pay --wallet

How It Works

1. You request a paid endpoint → gets 402 Payment Required
2. mpp-pay reads the payment challenge, creates a channel (first time), signs a voucher
3. Retries with payment → returns the response
4. If the channel needs funding, shows the address to send tokens to

The wallet is a local signing key (~/.mpp-wallet.json). It never needs gas or on-chain transactions — it only signs payment vouchers off-chain.

License

MIT