agent402-openclaw 0.5.6 → 0.5.8

package/README.md

@@ -2,9 +2,9 @@
 
 Part of [Agent402](https://agent402.tools), the open-source paid door for AI agents.
 
-Agent402 as an [OpenClaw](https://openclaw.ai) model provider: the auto-routed
-tier at a **flat per-call price** and explicit frontier models **priced per
-request** from the body, paid in **USDC over x402** from a wallet or with a
+Agent402 as an [OpenClaw](https://openclaw.ai) model provider: explicit models
+**priced per request** from the body by default (metered), and the auto-routed
+tier at a **flat per-call price**, paid in **USDC over x402** from a wallet or with a
 prepaid credits key (agent402.tools/credits says whether packs are on sale). The
 same key and gateway reach Agent402's 500+ pay-per-call tools; credits pay
 Agent402's own services, so the routes that buy from an outside seller
@@ -57,7 +57,9 @@ install from a packed archive and from the npm registry, doctor, setup, model
 listing, gateway boot and one agent turn (`test-real-install.js`).
 
 No OpenClaw? `agent402-openclaw proxy` runs the proxy alone; point any OpenAI
-client at `http://127.0.0.1:8412/v1` with model `auto`.
+client at `http://127.0.0.1:8412/v1`. An explicit model rides the metered route
+by default (each request quoted from its body, and settlement never exceeds the
+quote); model `auto` takes the flat routed tier.
 
 **Claude Code and other Anthropic-wire clients** (0.5.0): the proxy also answers
 `POST /v1/messages` and forwards it to the gateway's metered Messages route,
@@ -107,7 +109,7 @@ of a cent and a long one pays for what it asks. `--flat` (or
 Either way OpenClaw's per-token cost fields stay zero; the price is per call. A model sent to another flat
 tier's route is priced at its home tier: the 402 quotes that tier's price, and the paid call is served under
 that tier's caps (the answer says so in `agent402_tier`). The router, grounded and stealth tiers still answer a
-400 naming the right route; nothing is charged. A client-supplied `Idempotency-Key`
+400 naming the right route; nothing is charged on x402. A client-supplied `Idempotency-Key`
 is passed through: on a credits key, a retry with the same key replays the paid
 answer; on a wallet, each forwarded call signs a fresh payment, which the server
 treats as a new purchase. Without a key, each call is its own payment.

package/index.js

@@ -130,7 +130,7 @@ let registeredOnce = false;
 const plugin = {
   id: PLUGIN_ID,
   name: "Agent402",
-  description: "Agent402 model provider: routed + explicit models at a flat per-call price, paid by card or USDC.",
+  description: "Agent402 model provider: routed + explicit models at a flat per-call price, paid in USDC from a wallet, or with a credits key already issued.",
   register(api) {
     const cfg = api.pluginConfig || {};
     const port = Number(cfg.port) || DEFAULT_PORT;
@@ -149,7 +149,7 @@ const plugin = {
           try { setCachedRoutes(await loadRoutes(upstream, fetch, { pricing })); } catch (e) { log(`[agent402-openclaw] could not read ${upstream}/v1/models yet: ${e?.message || e}`); }
           started = await startProxy({ upstream, creditsKey, payFetch, port, pricing, log });
           setActiveProxy(started);
-          if (started.mode === "unpaid") log("[agent402-openclaw] no payment configured: run `agent402-openclaw setup` (card credits key) - paid calls will answer 402 until then");
+          if (started.mode === "unpaid") log("[agent402-openclaw] no payment configured: run `agent402-openclaw setup` (a wallet key, or a credits key already issued) - paid calls will answer 402 until then");
         },
         stop: async () => { if (started) { await started.close(); started = null; setActiveProxy(null); } },
       });

package/known-assets.js

@@ -32,10 +32,46 @@ export const KNOWN_ASSETS = Object.freeze({
   "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": [{ asset: "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU", decimals: 6, symbol: "USDC" }], // devnet
   // Stellar: the USDC Stellar Asset Contract (7 decimals on Stellar).
   "stellar:pubnet": [{ asset: "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75", decimals: 7, symbol: "USDC" }],
-  // Algorand: USDC is ASA 31566704.
+  // Algorand: USDC is ASA 31566704. Mainnet is named by its CAIP-2 id (the
+  // first 32 characters of the base64 genesis hash) and, by sellers that
+  // predate it, by the full hash.
+  "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k": [{ asset: "31566704", decimals: 6, symbol: "USDC" }],
   "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=": [{ asset: "31566704", decimals: 6, symbol: "USDC" }],
 });
 
+/** Chain name -> every network id in the table that names that chain. A
+ *  chain spelled two ways on the wire lists both, so a buyer's preference by
+ *  name, or by either spelling, matches a seller's accept in the other. */
+export const NETWORK_NAMES = Object.freeze({
+  base: ["eip155:8453"],
+  "base-sepolia": ["eip155:84532"],
+  polygon: ["eip155:137"],
+  arbitrum: ["eip155:42161"],
+  monad: ["eip155:143"],
+  celo: ["eip155:42220"],
+  avalanche: ["eip155:43114"],
+  sei: ["eip155:1329"],
+  optimism: ["eip155:10"],
+  arc: ["eip155:5042"],
+  robinhood: ["eip155:4663"],
+  solana: ["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],
+  "solana-devnet": ["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"],
+  stellar: ["stellar:pubnet"],
+  algorand: ["algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k", "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8="],
+});
+
+/** The network ids a preference names: a chain name's ids; for an id, every
+ *  id of the chain it belongs to (so either spelling matches the other); an
+ *  id the table does not know passes through as itself. */
+export function networkIdsOf(pref) {
+  const p = String(pref || "").trim();
+  if (!p) return [];
+  const byName = NETWORK_NAMES[p.toLowerCase()];
+  if (byName) return [...byName];
+  for (const ids of Object.values(NETWORK_NAMES)) if (ids.some((id) => id.toLowerCase() === p.toLowerCase())) return [...ids];
+  return [p];
+}
+
 const EVM_ADDRESS = /^0x[0-9a-fA-F]{40}$/;
 // EVM addresses compare without case (checksum casing is presentation);
 // base58, Stellar and Algorand identifiers compare exactly.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-openclaw",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "OpenClaw model provider for Agent402: an auto-routed tier at a flat per-call price and explicit LLM models priced per request, paid in USDC over x402, or with a prepaid credits key, through a local proxy. Zero dependencies; x402 wallet payment is an optional peer.",
   "type": "module",
   "main": "index.js",
@@ -44,9 +44,9 @@
     "test": "node test.js"
   },
   "peerDependencies": {
-    "@x402/evm": ">=2.20.0",
-    "@x402/fetch": ">=2.20.0",
-    "viem": ">=2.48.11"
+    "@x402/evm": ">=2.20.0 <3",
+    "@x402/fetch": ">=2.20.0 <3",
+    "viem": ">=2.48.11 <3"
   },
   "peerDependenciesMeta": {
     "@x402/evm": {

package/proxy.js

@@ -6,7 +6,7 @@
 //              SDK pay from a wallet too (ANTHROPIC_BASE_URL=http://127.0.0.1:<port>).
 //
 // Two ways to pay, chosen at start:
-//   creditsKey  - a prepaid card-credits key (a402_...) sent as a Bearer; the
+//   creditsKey  - a prepaid credits key (a402_...) sent as a Bearer; the
 //                 gateway authorizes against the balance before the handler and
 //                 debits only on a final 200. No wallet, no chain.
 //   payFetch    - an x402-paying fetch (e.g. @x402/fetch wrapped around a
@@ -45,6 +45,8 @@ import { AUTO_ID, routesFromCatalog, stripTrailingSlashes } from "./models.js";
 
 export const DEFAULT_UPSTREAM = "https://agent402.tools";
 export const PKG_VERSION = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf8")).version;
+// The User-Agent product token that names this package on every request.
+const USER_AGENT = `agent402-openclaw/${PKG_VERSION}`;
 const MAX_BODY = 2 * 1024 * 1024;
 
 // The model catalog read (GET /v1/models) settles nothing, so a 503 the
@@ -78,7 +80,8 @@ async function discoveryFetch(fetchImpl, label, url, init) {
   let attempts = 0;
   for (;;) {
     attempts++;
-    r = await fetchImpl(url, typeof init === "function" ? init() : init);
+    const i = (typeof init === "function" ? init() : init) || {};
+    r = await fetchImpl(url, { ...i, headers: { "User-Agent": USER_AGENT, ...(i.headers || {}) } });
     if (r.ok) return r;
     if (attempts >= DISCOVERY_ATTEMPTS) break;
     const wait = await shedRetryWaitMs(r);
@@ -177,7 +180,7 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
   // error shape (wire.mapRefusal); every other upstream body is relayed as sent.
   async function forward(req, res, endpoint, outbound, extraHeaders, wire) {
     const clientIdem = typeof req.headers["idempotency-key"] === "string" && /^[\w.:-]{8,128}$/.test(req.headers["idempotency-key"]) ? req.headers["idempotency-key"] : null;
-    const headers = { "content-type": "application/json", accept: req.headers.accept || "application/json", "idempotency-key": clientIdem || randomUUID(), "user-agent": `agent402-openclaw/${PKG_VERSION}`, ...extraHeaders };
+    const headers = { "content-type": "application/json", accept: req.headers.accept || "application/json", "idempotency-key": clientIdem || randomUUID(), "user-agent": USER_AGENT, ...extraHeaders };
     if (key) headers.authorization = `Bearer ${key}`;
     // A paid request never follows a redirect: followed, it would pay another
     // origin's 402 or carry a signature (or the credits key) to another host.