Quickstart

npm install @shulam/sdk

import express from "express";
import { createX402Paywall } from "@shulam/sdk/express";

const app = express();

// Protect any endpoint with x402 compliance-verified payments
app.use("/api/premium", createX402Paywall({
  price: 1_000_000n,       // 1 USDC (atomic units)
  payTo: "0xYourWallet",   // Your Base address
  network: "base",         // Base mainnet
}));

app.get("/api/premium/data", (req, res) => {
  // This endpoint requires payment
  res.json({ secret: "compliance-verified data" });
});

app.listen(3000);

# Install CLI
npm install -g @shulam/cli

# Screen an address
shulam screen 0x1234...abcd

# Get a settlement quote
shulam quote --from 0xBuyer --to 0xSeller --amount 1000000

# Test settlement (sandbox)
shulam settle --from 0xBuyer --to 0xSeller --amount 1000000 --env sandbox

// Change one line: sandbox → production
app.use("/api/premium", createX402Paywall({
  price: 1_000_000n,
  payTo: "0xYourWallet",
  network: "base",           // Base mainnet
  facilitator: "api.shulam.io",  // Production facilitator
}));