@blockrun/clawrouter 0.12.270 → 0.12.272

package/docs/configuration.md

@@ -209,7 +209,8 @@ Per-request alternative: send `x-clawrouter-debug: false` on the request.
 
 ### CLAWROUTER_SOLANA_RPC_URL
 
-Override the Solana RPC endpoint used for USDC balance checks (Solana chain only):
+Override the Solana RPC endpoint used for USDC balance checks **and for signing
+payments** (Solana chain only):
 
 ```bash
 export CLAWROUTER_SOLANA_RPC_URL=https://your-rpc-provider.com
@@ -218,6 +219,21 @@ openclaw gateway restart
 
 Public RPC may rate-limit on heavy usage. Use a dedicated RPC for production.
 
+Unlike Base, where the EIP-3009 signature is produced entirely offline, signing
+a Solana payment reads the payment asset's mint account over RPC. A host that
+cannot reach `api.mainnet-beta.solana.com` therefore fails **every** paid Solana
+call with `fetch failed` while `sol.blockrun.ai` itself answers normally. Check
+egress before blaming the gateway:
+
+```bash
+curl -s -m 10 -X POST https://api.mainnet-beta.solana.com \
+  -H 'content-type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"getAccountInfo","params":["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",{"encoding":"base64"}]}'
+```
+
+If that hangs or is refused, point this variable at an endpoint the host can
+reach.
+
 ---
 
 ## Wallet Configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/clawrouter",
-  "version": "0.12.270",
+  "version": "0.12.272",
   "description": "Smart LLM router — save 84% on inference costs. 76 models (7 free). Pay by credit card (API key) or USDC (x402 wallet).",
   "type": "module",
   "main": "dist/index.js",

package/skills/surf/SKILL.md

@@ -26,11 +26,38 @@ license: MIT
 
 Surf bundles **83 endpoints across 12 domains** into one paid HTTP API. ClawRouter exposes them at `http://127.0.0.1:8402/v1/surf/*`, paid the same way ClawRouter pays for LLM calls — an x402 USDC micropayment from the local wallet, or a draw on BlockRun account credit if an API key is configured (verified working on both, 2026-09-05). **No Surf account and no Surf API key either way.** Upstream lives at `api.asksurf.ai/gateway/v1` — ClawRouter forwards transparently.
 
-**Pricing tiers (per call):**
-
-- **Tier 1 — $0.001** — prices, rankings, lists, news, simple reads
-- **Tier 2 — $0.005** — orderbooks, candles, search, wallet details, social
-- **Tier 3 — $0.020** — on-chain SQL queries, structured queries, schema introspection
+**Pricing — flat per call, the same for every endpoint.**
+
+Surf used to be tiered at $0.001 / $0.005 / $0.020. It is not any more: upstream
+now prices all three tiers identically (`SURF_TIER_{1,2,3}_PRICE` are equal). The
+`Tier` column in the catalog below still describes endpoint weight, but it no
+longer affects what you pay. Anything quoting the old tier prices is stale.
+
+| Rail                        | Price per call                              |
+| --------------------------- | ------------------------------------------- |
+| API key (`api.blockrun.ai`) | **$0.0075** — base rate, no transaction fee |
+| Wallet, Solana              | **$0.0075**                                 |
+| Wallet, Base                | **$0.0085**                                 |
+
+Verified 2026-09-05 by measurement, not from a price page: the API-key figure by
+diffing the account ledger across one call, the wallet figures by reading the
+`amount` in the x402 402 challenge, which quotes the price before anything is
+signed. Base and Solana genuinely differ for the same endpoint.
+
+**A 402 quote is authoritative for the rail that issued it — and only that rail.**
+On the wallet rail the price arrives in the challenge before you pay, so if this
+table disagrees with it, believe the challenge and treat the table as stale.
+
+Do NOT carry a wallet-rail 402 figure over to the API-key rail. The key rail
+issues no 402 at all, and the wallet quote includes the chain's transaction fee
+that account credit does not pay — on Base that is $0.0085 quoted against
+$0.0075 actually billed to an account. Reading across rails turns a correct
+number into a wrong one; it has already happened once.
+
+The Base/Solana difference is deliberate, not drift: the $0.001 is the Base
+transaction fee, and Solana omitting it is a migration incentive. Solana being
+cheaper is expected — Solana priced _above_ Base would be the bug worth
+reporting, since estimates generally assume the Base figure is the ceiling.
 
 > The legacy **surf-1.5 chat** surface is intentionally NOT exposed yet — it's held until per-token settlement is wired. Trying `/v1/surf/chat/completions` returns 404 ("Unknown Surf endpoint"), no payment is taken.