x402 Facilitator

Build on the compliance-native payment network.

Everything you need to integrate x402 payments with OFAC screening, ACS credit scoring, and BARUCH compliance receipts.

Quick Start Full Reference →

Quick Start

Three paths into the Shulam network — pick the one that matches your role.

BUYR

BUYR — Buyer Integration

Provision wallets, set spending policies, make x402 payments.

npm install @shulam/sdk

Read the docs

SELLR

SELLR — Seller Integration

npm install @shulam/sdk

Read the docs

CaaS

CaaS — Compliance API

Screen addresses, generate receipts, query ACS scores.

curl https://api.shulam.io/api/v1/screen

Read the docs

API Reference

Core endpoints at https://api.shulam.io. Full spec at docs.shulam.io.

POST

/v1/verify

Verify x402 payment — validate EIP-3009 signature

POST

/v1/settle

Settle x402 payment — execute on-chain USDC transfer

GET

/v1/agent/:address

Agent profile — trust score, ACS grade, network position

GET

/v1/trust/:address

Trust score — 5-factor model, compliance grade

The Agentgorithm Pipeline

Every x402 payment flows through 8 deterministic steps — each executed by a dedicated compliance soul.

Discover

Agent discovers a service endpoint via the Bazaar or trust graph.

Request

HTTP GET → server returns 402 Payment Required with price.

Screen

SAMUEL soul screens buyer and seller addresses against OFAC SDN.

Authorize

Buyer signs an EIP-3009 transferWithAuthorization for the exact amount.

Verify

JAMES soul validates the signature and checks spending policy.

Settle

LEVI soul submits the on-chain USDC transfer (gas sponsored by Shulam).

Receipt

BARUCH soul issues a compliance receipt — EIP-712 signed, chain-anchored.

Score

DEBORAH-C updates the Agent Credit Score (300–850) and trust graph.

NOTE

Steps 3–4 (SAMUEL screen + JAMES verify) run in parallel. Gas for step 6 is sponsored by Shulam on Base — zero cost to the buyer agent.

SDKs & Tools

Official packages and CLI for building on Shulam.

@shulam/sdk

Main SDK — ShulamClient with verify, settle, screen, trust, and discover methods. Zero runtime deps. MIT.

View docs →

@shulam/x402

x402 protocol primitives — paywall middleware, auto-payment client, token registry, fee calculator.

View docs →

Shulam CLI

Command-line interface for provisioning wallets, running settlements, and managing spending policies.

View docs →

Agent Skills

16 pre-built agent skills (npm) — buyr-pay, buyr-discover, create-sellr-service, shulam-screen, and more.

View docs →

Resources

API Reference

Full REST API — all endpoints, schemas, error codes.

OpenAPI Spec

Machine-readable OpenAPI 3.1 spec for Bedrock AgentCore.

Status Page

Live uptime and incident history for api.shulam.io.

GitHub

Open-source SDKs, agent skills, and example projects.

Ready to build on x402?

Join the compliance-first payment network. OFAC screening on every transaction, gas sponsored by Shulam.

Get API Key Read the Docs