A professional CLI tool for simulating and testing Solana x402 payments (micropayments between agents and APIs)
x402-cli is a production-ready TypeScript CLI tool designed to help developers simulate, test, and interact with Solana x402 payment protocols. It provides a clean, intuitive interface for sending micropayments on Solana networks and will support advanced features like signature verification, mock API servers, and facilitator services.
- ✅ Send SOL Payments - Transfer SOL tokens on devnet, mainnet-beta, or testnet
- ✅ Verify Signatures - Confirm transaction status, amounts, memos, and recipients
- 🔄 Configuration Management - Persistent CLI configuration with
initcommand - 🎨 Beautiful CLI Output - Color-coded logs and progress indicators
- 🔒 Wallet Integration - Secure keypair management (file-based)
- 📋 Transaction Details - Links to Solana Explorer for transaction verification
- 🚧 Coming Soon:
- Mock API server for testing (
mock-servercommand) - Agent payment workflows (
agent-paycommand) - Facilitator services integration
- Mock API server for testing (
npm install -g @solwarrior/x402-clinpx @solwarrior/x402-cli --helpgit clone https://github.com/sol-warrior/x402-cli.git
cd x402-cli
npm install
npm run build
npm linkx402-cli init --network devnet --rpc-url https://api.devnet.solana.comx402-cli pay \
--recipient <RECIPIENT_ADDRESS> \
--amount 0.1 \
--from ~/.config/solana/id.json \
--network devnetx402-cli --help
x402-cli pay --helpSend SOL to a recipient address on Solana.
x402-cli pay [options]
Options:
-r, --recipient <address> Recipient Solana address (required)
-a, --amount <amount> Amount in SOL (required)
-f, --from <path> Path to keypair JSON file
-n, --network <network> Network: devnet, mainnet-beta, or testnet (default: devnet)
--skip-preflight Skip transaction preflight checks
-h, --help Display help for commandExample:
x402-cli pay \
--recipient So11111111111111111111111111111111111111112 \
--amount 0.5 \
--from ~/.config/solana/id.json \
--network devnetConfigure default settings for the CLI.
x402-cli init [options]
Options:
-n, --network <network> Default network: devnet, mainnet-beta, or testnet
-r, --rpc-url <url> Custom RPC URL
-w, --wallet <path> Default wallet keypair path
-h, --help Display help for commandExample:
x402-cli init --network devnet --wallet ~/.config/solana/id.jsonVerify Solana transaction signatures and display payment details.
x402-cli verify <signature> [options]
Options:
-n, --network <network> Network: devnet, mainnet-beta, or testnet (default: devnet)
--rpc-url <url> Custom RPC URL
-c, --commitment <level> Commitment level: processed, confirmed, or finalized (default: confirmed)
--json Output JSON payload for scripting
-h, --help Display help for commandExample:
x402-cli verify 5dKq...abc123 --network devnet
# Output as JSON for automation
x402-cli verify 5dKq...abc123 --jsonStart a local mock API server for testing x402 payments.
x402-cli mock-server [options]Configuration is stored in ~/.x402-cli/config.json. You can modify it directly or use the init command.
Example config:
{
"rpcUrl": "https://api.devnet.solana.com",
"network": "devnet",
"defaultWallet": "~/.config/solana/id.json"
}See ARCHITECTURE.md for detailed architecture documentation.
- Node.js >= 18.0.0
- npm >= 9.0.0
git clone https://github.com/sol-warrior/x402-cli.git
cd x402-cli
npm installnpm run buildnpm test
npm run test:watch
npm run test:coveragenpm run lint
npm run lint:fix
npm run format
npm run format:check# Build and link locally
npm run build
npm link
# Test the CLI
x402-cli --helpSee ROADMAP.md for planned features and improvements.
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
- Never commit private keys or keypair files to version control
- This CLI uses file-based keypair management for development/testing
- For production use, integrate with proper wallet adapters (Phantom, Solflare, etc.)
- Always use testnet/devnet for development and testing
MIT License - see LICENSE for details.
Built with ❤️ by Nishant
Inspired by the Solana x402 protocol and micropayment innovations in the Web3 ecosystem.
- @solana/web3.js - Solana JavaScript SDK
- Solana CLI - Official Solana CLI tool