> ## Documentation Index
> Fetch the complete documentation index at: https://arcpay-somnia.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Run ArcPay Somnia locally and verify live Somnia testnet flows.

## Install

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
npm run dev:frontend
npm run x402
npm run worker
```

## Verify

```bash theme={null}
npm run build:frontend
npm test
npm run smoke:auth
npm run smoke:live
npm run smoke:x402
```

## Operator Flow

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