agent402-openclaw 0.5.5 → 0.5.7

package/README.md

@@ -5,8 +5,10 @@ Part of [Agent402](https://agent402.tools), the open-source paid door for AI age
 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
-prepaid credits key already issued (new credits are not on sale). The same key
-and gateway reach Agent402's 500+ pay-per-call tools.
+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
+(the route-execute tiers, `seller-payability`, `decide-execute` and the flight routes) need a wallet.
 
 Guide: https://agent402.tools/guides/openclaw-model-provider
 
@@ -22,7 +24,7 @@ With no credits key and no `AGENT402_WALLET_KEY`, `setup` generates an EVM
 wallet into `~/.openclaw/agent402/wallet.key` (0600, the only copy, never
 printed) and prints its address: send it USDC on Base and every call is paid
 from it over x402. `agent402-openclaw wallet` shows the address and balance;
-`--no-wallet` skips the generation. Holding a credits key already issued? Run
+`--no-wallet` skips the generation. Holding a credits key? Run
 `AGENT402_CREDITS_KEY=a402_... npx agent402-openclaw setup --write` (key by env,
 or `--credits-key -` on stdin).
 
@@ -105,7 +107,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/cli.js

@@ -100,7 +100,7 @@ async function main() {
           out(`  key:     ${WALLET_KEY_FILE()} (0600; back it up, it is the only copy)`);
           out(`fund it with USDC on Base (any amount; a call costs from $0.001), then every call is paid from it over x402.`);
           out(`optional: \`agent402-openclaw permit2-approve\` once (needs a little ETH on Base for gas) to pay actual usage instead of the per-request quote.`);
-          out(`holding a credits key already issued? rerun with --credits-key a402_... instead`);
+          out(`holding a credits key? rerun with --credits-key a402_... instead`);
         } else {
           out(`no payment method yet: install viem + @x402/fetch + @x402/evm and rerun to generate a wallet, set AGENT402_WALLET_KEY, or rerun with --credits-key a402_... if you hold a credits key`);
         }

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,7 +1,7 @@
 {
   "name": "agent402-openclaw",
-  "version": "0.5.5",
-  "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 already issued, through a local proxy. Zero dependencies; x402 wallet payment is an optional peer.",
+  "version": "0.5.7",
+  "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",
   "exports": {

package/proxy.js

@@ -243,7 +243,7 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
           return json(res, 400, { error: { message: `Unknown model "${requested}". Use "auto" or an id from GET /v1/models (${table.size} available).`, type: "invalid_request_error", code: "model_not_found" } });
         }
         if (!paid) {
-          return json(res, 402, { error: { message: "No payment method configured. Run `agent402-openclaw setup` to generate an x402 wallet, set AGENT402_WALLET_KEY, or set AGENT402_CREDITS_KEY to a credits key already issued.", type: "payment_required", code: "agent402_unconfigured" }, topup: `${upstream}/credits`, priceUsd: route.priceUsd });
+          return json(res, 402, { error: { message: "No payment method configured. Run `agent402-openclaw setup` to generate an x402 wallet, set AGENT402_WALLET_KEY, or set AGENT402_CREDITS_KEY to a prepaid credits key.", type: "payment_required", code: "agent402_unconfigured" }, topup: `${upstream}/credits`, priceUsd: route.priceUsd });
         }
         const outbound = { ...body };
         if (requested === AUTO_ID) delete outbound.model; else outbound.model = route.id;
@@ -257,7 +257,7 @@ export async function startProxy({ upstream = DEFAULT_UPSTREAM, creditsKey = nul
           return json(res, 400, { type: "error", error: { type: "invalid_request_error", message: "\"model\" is required (any id from GET /v1/models, or a Claude id such as claude-sonnet-5)" } });
         }
         if (!paid) {
-          return json(res, 402, { type: "error", error: { type: "payment_required", message: "No payment method configured. Set AGENT402_WALLET_KEY to an EVM key holding USDC on Base (or run `agent402-openclaw setup`), or set AGENT402_CREDITS_KEY to a credits key already issued." } });
+          return json(res, 402, { type: "error", error: { type: "payment_required", message: "No payment method configured. Set AGENT402_WALLET_KEY to an EVM key holding USDC on Base (or run `agent402-openclaw setup`), or set AGENT402_CREDITS_KEY to a prepaid credits key." } });
         }
         const outbound = { ...body, model: body.model.trim().replace(/^agent402\//, "") };
         const extra = {};