shulam CLI

Developer tools for x402 payment integration. Initialize projects, run test payments, and validate compliance flows.

Install

npm install -g shulam

Commands

shulam init

Scaffold x402 payment integration in your project. Detects Express or Next.js and generates the appropriate boilerplate.

shulam init

Creates:

• shulam.json — project configuration
• Example integration code for your framework
• .env.example with required environment variables

shulam test-payment

Send a test x402 payment against a local or remote facilitator.

shulam test-payment --url http://localhost:3000 --amount 1000000

shulam test-compliance

Test OFAC compliance screening for a wallet address.

shulam test-compliance --address 0x1234...

shulam health

Check facilitator health and version.

shulam health --url http://localhost:3000

shulam auth

Configure API key authentication.

shulam auth --key sk_test_...

Configuration

The CLI reads from shulam.json in the project root:

{
  "facilitatorUrl": "https://pay.shulam.com",
  "network": "base-sepolia",
  "merchantAddress": "0xYourWallet"
}

Environment Variables

| Variable | Description | |----------|-------------| | SHULAM_API_KEY | Merchant API key | | SHULAM_FACILITATOR_URL | Facilitator endpoint |

License

PROPRIETARY — Shulam, Inc.