Quickstart - ArcPay Somnia

Install

npm install
npm run install:frontend
npm run install:mcp
npm run install:worker
npm run install:x402

Configure

Create .env from .env.example or the deployment notes and include:

SOMNIA_RPC_URL=https://dream-rpc.somnia.network
PRIVATE_KEY=0x...
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...
X402_SERVER_PORT=4032

Use a funded Somnia Testnet wallet for live smoke tests.

Public Developer Surfaces

curl https://arcpay-somnia.vercel.app/openapi.json
curl https://arcpay-somnia.vercel.app/llms.txt
curl https://arcpay-somnia.vercel.app/api/developer/tools
curl "https://arcpay-somnia.vercel.app/api/developer/tools/derive_agent_id?slug=research-agent"

Run

npm run dev:frontend
npm run x402
npm run worker

Verify

npm run build:frontend
npm test
npm run smoke:auth
npm run smoke:live
npm run smoke:x402

Operator Flow

Connect an EVM wallet and switch to Somnia Testnet.
Register an agent in Agents.
Set policies and allowlists in Policies.
Quote and pay a protected resource in x402.
Create invoices, cards, and privacy intents.
Export audit records.