git:20260831.f41835a to git:20260903.20459eb

5 added, 1 removed. Audit A to A.

# ClawRouter

- Smart LLM router for autonomous agents. 76 models. Wallet-based auth. USDC micropayments via x402.

+ Smart LLM router for autonomous agents. 76 models. Two ways to pay:

+ - **Wallet (default)** — x402 USDC micropayments signed per call, against `blockrun.ai/api` (Base) or `sol.blockrun.ai/api` (Solana). New installs default to Solana.

+ - **API key** — `brk_live_…` from [user.blockrun.ai](https://user.blockrun.ai), billed against card-funded account credit, against `api.blockrun.ai`. `src/api-key.ts` resolves it (env → `~/.blockrun/.api-key` → `~/.openclaw/blockrun/api-key`); a key present anywhere wins over a wallet, and no wallet is generated or read in that mode.

## Commands

```bash

npm install # install dependencies

npm run build # compile with tsup

npm run dev # watch mode

npm test # run vitest

npm run typecheck # type checking

npm run lint # eslint

npm run format # prettier

npm run test:resilience:quick # error + lifecycle resilience tests

npm run test:resilience:full # full resilience suite (4hr stability)

npm run test:e2e:tool-ids # end-to-end tool ID sanitization

npm run test:docker:install # Docker install test

npm run test:docker:edge-cases # Docker edge case tests

npm run test:docker:integration # Docker integration tests

```

## Project structure

```

src/

├── index.ts # Library entry point

├── cli.ts # CLI entry point

├── auth.ts # Wallet-based authentication

+ ├── api-key.ts # BlockRun API-key auth (api.blockrun.ai)

├── balance.ts # USDC balance management

├── models.ts # Model registry and scoring

├── config.ts # Configuration

├── errors.ts # Error classification

├── logger.ts # Logging

├── journal.ts # Request journaling

├── exclude-models.ts # Model exclusion logic

├── dedup.ts # Request deduplication

├── fs-read.ts # Filesystem reading

├── compression/ # Request/response compression

├── doctor.ts # Diagnostic tool

└── partners/ # Partner integrations

```

## Key dependencies

- `@x402/fetch`, `@x402/evm`, `@x402/svm` — x402 payment protocol

- `viem` — Ethereum interaction

- `@solana/kit` — Solana interaction

- `@scure/bip32`, `@scure/bip39` — Wallet key derivation

## Conventions

- TypeScript strict mode, ESM

- Build with tsup, test with vitest

- Lint with eslint, format with prettier

- Node >= 22

- MIT license

- npm registry: `@blockrun/clawrouter`

- 15-dimension scoring for model routing (all local, < 1ms)