@rileycraig/plugin-x402-agentstore 1.1.0 → 1.2.0

package/README.md

@@ -1,34 +1,48 @@
 # @rileycraig/plugin-x402-agentstore
 
-**Put paid AI data tools inside any ElizaOS agent.** This plugin gives ElizaOS agents native actions that call the [x402 Agent Store](https://store.agentexchange.work) and pay per request in USDC via [x402](https://www.x402.org) — no API keys, no subscriptions.
+**Pay-per-call data tools for ElizaOS agents — settled in USDC over [x402](https://x402.org) on Base. No API keys. No signup. Payment is the auth.**
 
-This is how high-volume x402 services actually get called: not by being listed in a registry, but by being a **pre-installed tool inside the agents people run.** (BlockRun gets its volume by being ClawRouter inside OpenClaw; this puts our tools inside ElizaOS the same way.)
+Install once; your agent can search the web, read on-chain state, rug-check tokens, and check brand AI-visibility — paying per call in USDC automatically. Same model as BlockRun / Exa / Firecrawl, on independent rails, often cheaper.
 
-## Actions
-
-| Action | What it does | Price |
-|---|---|---|
-| `AI_VISIBILITY_CHECK` | Does AI recommend a brand/token? Score 0–100 + who AI names instead | free teaser / $0.95 full |
-| `DEX_TOKEN_DATA` | Live DEX price, volume, liquidity, buy/sell flow for any token | $0.002 |
-| `TOKEN_SECURITY_CHECK` | Pre-trade rug check: honeypot, sell tax, mint/owner risk + verdict | $0.002 |
-| `AI_CATEGORY_RANKING` | Who AI recommends across a whole category, ranked | $0.02 |
-| `COUNTRY_ECONOMICS` | GDP, inflation, unemployment for 200+ countries | $0.005 |
-
-Paid calls settle from the agent's own x402 wallet on Base. Free teasers work with no payment.
-
-## Install
+This is how high-volume x402 services actually get called: not by being listed in a registry, but by being a **pre-installed tool inside the agents people run.** (BlockRun gets its volume by being ClawRouter inside OpenClaw; this puts the same kind of tools inside ElizaOS.)
 
 ```bash
 npm install @rileycraig/plugin-x402-agentstore
 ```
 
 ```ts
-import { x402AgentStorePlugin } from "@rileycraig/plugin-x402-agentstore";
-
-// add to your ElizaOS character / runtime plugins:
-plugins: [x402AgentStorePlugin]
+import x402AgentStore from "@rileycraig/plugin-x402-agentstore";
+// add to your ElizaOS character's plugins: [ x402AgentStore ]
 ```
 
+## What your agent gets
+
+| Action | What it does | Price (USDC) |
+|---|---|---|
+| `WEB_SEARCH` | One call → Hacker News + GitHub + Stack Overflow + Wikipedia, unified & ranked | ~$0.004 |
+| `WIKIPEDIA_LOOKUP` | Fast factual grounding | ~$0.001 |
+| `ONCHAIN_BALANCE` | Native + ERC-20 balance, any address, 6 chains | ~$0.001 |
+| `ONCHAIN_GAS` | Live gas price, 6 chains | ~$0.001 |
+| `ONCHAIN_TX_STATUS` | Tx status + receipt by hash | ~$0.001 |
+| `TOKEN_SECURITY_CHECK` | Pre-trade rug check (honeypot, tax, mint/owner risk) | ~$0.002 |
+| `DEX_TOKEN_DATA` | Live DEX price / liquidity / flow | ~$0.002 |
+| `TOKEN_LAUNCHES_FEED` | New & trending token feed for sniping agents | ~$0.003 |
+| `AI_VISIBILITY_CHECK` | Does ChatGPT/Perplexity recommend a brand? (unique) | free teaser / paid |
+| `AI_CATEGORY_RANKING` | Which brands AI recommends in a category | ~$0.02 |
+
+**Cheaper than the field:** `WEB_SEARCH` bundles 4 sources for ~$0.004 vs Firecrawl's $0.01/search; on-chain reads from $0.001.
+
+## How payment works (x402)
+
+Every paid call returns `HTTP 402` with the price. If your ElizaOS runtime has an x402-enabled fetch, it signs a USDC payment locally (your key never leaves the machine) and retries with the `X-PAYMENT` header — you get live data. No accounts, no cards, no KYC. Free teasers (`/samples`, `/score`) work with no payment.
+
+## Trust & verification (check us before you pay)
+
+- **Live store:** https://store.agentexchange.work — `/status`, `/healthz`, free `/samples` of every product.
+- **Discovery:** A2A agent card at `/.well-known/agent.json`, x402 catalog at `/.well-known/x402`, full `/openapi.json`, MCP at `/mcp`.
+- **On-chain proof:** every payment is a public USDC transfer on Base → `0xc91cE6291eDC0713ec753BAFBA002506ffb2b95c` (audit on BaseScan).
+- **Indexed:** Coinbase x402 Bazaar + x402scan.
+
 ## Build & publish
 
 ```bash
@@ -38,9 +52,6 @@ npm publish --access public
 # then submit to the ElizaOS plugin registry so every ElizaOS agent can discover it
 ```
 
-## Why
-The agent economy runs on agents calling tools inside their frameworks. This plugin makes the x402 Agent Store's unique data — especially **AI-visibility** (does AI recommend you?), which nothing else offers — a one-line install for the entire ElizaOS ecosystem.
+## License
 
-- Store: https://store.agentexchange.work · Free samples: https://store.agentexchange.work/samples
-- MCP (Claude/Cursor/Windsurf): https://store.agentexchange.work/mcp
-- License: MIT
+MIT © Riley Craig

package/dist/index.js

@@ -13,106 +13,181 @@ async function callStore(runtime, path) {
   }
   return res.json();
 }
-var aiVisibility = {
-  name: "AI_VISIBILITY_CHECK",
-  similes: ["DOES_AI_RECOMMEND", "BRAND_VISIBILITY", "GEO_CHECK", "AI_REPUTATION"],
-  description: "Check whether AI assistants (ChatGPT/Perplexity/Gemini) recommend a brand or token in its category. Returns a 0-100 AI-visibility score, mention rate, and which competitors AI names instead. Free teaser via /score; full audit via paid /brands/check.",
+var lastText = (message) => {
+  var _a;
+  return (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").trim();
+};
+var webSearch = {
+  name: "WEB_SEARCH",
+  similes: ["SEARCH_THE_WEB", "RESEARCH", "FIND_CODE", "LOOK_IT_UP", "GROUND_ANSWER", "FIND_SOURCES"],
+  description: "Search the web in ONE paid call \u2014 returns unified, ranked results from Hacker News, GitHub, Stack Overflow and Wikipedia. The call research/coding/answer agents make to ground a response or find code/sources. Pay-per-call (~$0.004) in USDC via x402, no API key.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    const q = lastText(message).replace(/^(search( the web)?( for)?|research|find|look up)\s+/i, "").trim();
+    if (!q) {
+      if (callback) callback({ text: "Provide a search query.", content: { error: "query required" } });
+      return;
+    }
+    const data = await callStore(runtime, `/web/search?q=${encodeURIComponent(q)}`);
+    if (callback) callback({ text: `Web search results for "${q}": ${JSON.stringify(data)}`, content: data });
+    return;
+  },
+  examples: []
+};
+var wikipedia = {
+  name: "WIKIPEDIA_LOOKUP",
+  similes: ["FACT_CHECK", "DEFINE", "WHAT_IS", "ENCYCLOPEDIA", "GROUND_FACT"],
+  description: "Fast factual grounding: pull the Wikipedia summary for any topic/person/place to fact-check or ground an answer. Pay-per-call (~$0.001) in USDC via x402, no API key.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    const q = lastText(message).replace(/^(what is|who is|define|wikipedia|look up)\s+/i, "").trim();
+    if (!q) {
+      if (callback) callback({ text: "Provide a topic to look up.", content: { error: "topic required" } });
+      return;
+    }
+    const data = await callStore(runtime, `/web/wikipedia?q=${encodeURIComponent(q)}`);
+    if (callback) callback({ text: `Wikipedia: ${JSON.stringify(data)}`, content: data });
+    return;
+  },
+  examples: []
+};
+var CHAINS = "base|ethereum|eth|optimism|arbitrum|polygon|matic|bsc|bnb";
+var pickChain = (t, d = "base") => {
+  var _a;
+  return (((_a = t.match(new RegExp(`\\b(${CHAINS})\\b`, "i"))) == null ? void 0 : _a[1]) || d).toLowerCase();
+};
+var chainBalance = {
+  name: "ONCHAIN_BALANCE",
+  similes: ["WALLET_BALANCE", "TOKEN_BALANCE", "CHECK_BALANCE", "HOW_MUCH_USDC", "ADDRESS_HOLDINGS"],
+  description: "Read the native + ERC-20 token balance of any wallet address across Base, Ethereum, Optimism, Arbitrum, Polygon and BSC. No RPC node needed. The balance read wallet/payment/treasury agents make constantly. Pay-per-call (~$0.001) in USDC via x402, no API key.",
   validate: async () => true,
   handler: async (runtime, message, _state, _o, callback) => {
     var _a;
-    const text = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").trim();
-    const m = text.match(/(.+?)\s+(?:in|for)\s+(.+)/i);
-    const brand = ((m == null ? void 0 : m[1]) || text).replace(/^(check|is|does ai recommend)\s+/i, "").trim();
-    const category = ((m == null ? void 0 : m[2]) || "its category").trim();
-    const data = await callStore(runtime, `/score?brand=${encodeURIComponent(brand)}&category=${encodeURIComponent(category)}`);
-    if (callback) callback({ text: `AI-visibility for ${brand}: ${JSON.stringify(data)}`, content: data });
-    return true;
+    const text = lastText(message);
+    const addr = (((_a = text.match(/0x[0-9a-fA-F]{40}/)) == null ? void 0 : _a[0]) || "").toLowerCase();
+    if (!addr) {
+      if (callback) callback({ text: "Provide a wallet address (0x...).", content: { error: "address required" } });
+      return;
+    }
+    const data = await callStore(runtime, `/chain/balance?address=${addr}&chain=${pickChain(text)}`);
+    if (callback) callback({ text: `Balance for ${addr}: ${JSON.stringify(data)}`, content: data });
+    return;
+  },
+  examples: []
+};
+var chainGas = {
+  name: "ONCHAIN_GAS",
+  similes: ["GAS_PRICE", "GWEI", "NETWORK_FEE", "IS_GAS_HIGH", "WHEN_TO_TX"],
+  description: "Live gas price for Base, Ethereum, Optimism, Arbitrum, Polygon or BSC \u2014 the read agents make before sending a transaction to time it cheaply. Pay-per-call (~$0.001) in USDC via x402, no API key.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    const data = await callStore(runtime, `/chain/gas?chain=${pickChain(lastText(message))}`);
+    if (callback) callback({ text: `Gas: ${JSON.stringify(data)}`, content: data });
+    return;
+  },
+  examples: []
+};
+var chainTx = {
+  name: "ONCHAIN_TX_STATUS",
+  similes: ["TX_STATUS", "DID_IT_CONFIRM", "TRANSACTION_RECEIPT", "CHECK_TX"],
+  description: "Look up the status and receipt of any transaction hash (confirmed/failed, block, gas used) across Base, Ethereum, Optimism, Arbitrum, Polygon or BSC \u2014 the read settlement/payment agents make to confirm a transfer landed. Pay-per-call (~$0.001) in USDC via x402, no API key.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    var _a;
+    const text = lastText(message);
+    const hash = ((_a = text.match(/0x[0-9a-fA-F]{64}/)) == null ? void 0 : _a[0]) || "";
+    if (!hash) {
+      if (callback) callback({ text: "Provide a transaction hash (0x... 64 hex chars).", content: { error: "tx hash required" } });
+      return;
+    }
+    const data = await callStore(runtime, `/chain/tx?hash=${hash}&chain=${pickChain(text)}`);
+    if (callback) callback({ text: `Tx ${hash}: ${JSON.stringify(data)}`, content: data });
+    return;
+  },
+  examples: []
+};
+var tokenSecurity = {
+  name: "TOKEN_SECURITY_CHECK",
+  similes: ["RUG_CHECK", "HONEYPOT_CHECK", "IS_TOKEN_SAFE", "PRE_TRADE_SAFETY", "CAN_I_SELL"],
+  description: "Pre-trade rug check for any token contract: honeypot, buy/sell tax, mintable, owner-can-reclaim, transfer-pausable, blacklist, holder count + a DANGER/HIGH_RISK/CAUTION/OK verdict. The call to make BEFORE buying any token. Pay-per-call (~$0.002) in USDC via x402.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    var _a;
+    const text = lastText(message);
+    const addr = (((_a = text.match(/0x[0-9a-fA-F]{40}/)) == null ? void 0 : _a[0]) || "").toLowerCase();
+    const chain = pickChain(text, "ethereum");
+    if (!addr) {
+      if (callback) callback({ text: "Provide a token contract address (0x...) to run a rug check.", content: { error: "address required" } });
+      return;
+    }
+    const data = await callStore(runtime, `/crypto/security?address=${addr}&chain=${chain}`);
+    if (callback) callback({ text: `Token security for ${addr} on ${chain}: ${JSON.stringify(data)}`, content: data });
+    return;
   },
   examples: []
 };
 var dexToken = {
   name: "DEX_TOKEN_DATA",
   similes: ["TOKEN_PRICE", "CRYPTO_DEX", "TOKEN_LIQUIDITY", "TOKEN_VOLUME"],
-  description: "Live decentralized-exchange data for any token (price, 24h volume, liquidity, buy/sell flow, momentum) across every chain. Paid per call ($0.002) via x402.",
+  description: "Live decentralized-exchange data for any token (price, 24h volume, liquidity, buy/sell flow, momentum) across every chain. Pay-per-call (~$0.002) in USDC via x402.",
   validate: async () => true,
   handler: async (runtime, message, _state, _o, callback) => {
-    var _a;
-    const q = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").replace(/^(price|token|dex)\s+(of\s+)?/i, "").trim();
+    const q = lastText(message).replace(/^(price|token|dex)\s+(of\s+)?/i, "").trim();
     const data = await callStore(runtime, `/crypto/dex?q=${encodeURIComponent(q)}`);
     if (callback) callback({ text: `DEX data for ${q}: ${JSON.stringify(data)}`, content: data });
-    return true;
+    return;
   },
   examples: []
 };
 var tokenLaunches = {
   name: "TOKEN_LAUNCHES_FEED",
   similes: ["NEW_TOKENS", "TRENDING_TOKENS", "WHAT_LAUNCHED", "FIND_NEW_COINS", "SNIPE_FEED"],
-  description: "Discovery feed for trading/sniping agents: newest token launches plus the most-boosted/promoted tokens across Solana, Base, Ethereum, BSC and more. Each item includes chain, contract, socials and next_calls that chain into TOKEN_SECURITY_CHECK (rug check) and DEX_TOKEN_DATA (market data). Poll on a loop to find candidates. Paid per call ($0.003) via x402.",
+  description: "Discovery feed for trading/sniping agents: newest + most-boosted tokens across Solana, Base, Ethereum, BSC and more. Each item chains into TOKEN_SECURITY_CHECK (rug check) and DEX_TOKEN_DATA. Poll on a loop to find candidates. Pay-per-call (~$0.003) in USDC via x402.",
   validate: async () => true,
   handler: async (runtime, message, _state, _o, callback) => {
-    var _a;
-    const text = ((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "";
+    const text = lastText(message);
     const chainM = text.match(/\b(solana|base|ethereum|eth|bsc|bnb|polygon|arbitrum)\b/i);
     const chain = chainM ? `&chain=${chainM[1].toLowerCase()}` : "";
     const data = await callStore(runtime, `/crypto/launches?limit=15${chain}`);
     if (callback) callback({ text: `New & trending token launches: ${JSON.stringify(data)}`, content: data });
-    return true;
+    return;
   },
   examples: []
 };
-var tokenSecurity = {
-  name: "TOKEN_SECURITY_CHECK",
-  similes: ["RUG_CHECK", "HONEYPOT_CHECK", "IS_TOKEN_SAFE", "PRE_TRADE_SAFETY", "CAN_I_SELL"],
-  description: "Pre-trade safety / rug check for any token contract: honeypot status, buy/sell tax, mintable, owner-can-reclaim, transfer-pausable, blacklist, holder count, plus a DANGER/HIGH_RISK/CAUTION/OK verdict. The call to make BEFORE buying any token. Paid per call ($0.002) via x402.",
+var aiVisibility = {
+  name: "AI_VISIBILITY_CHECK",
+  similes: ["DOES_AI_RECOMMEND", "BRAND_VISIBILITY", "GEO_CHECK", "AI_REPUTATION"],
+  description: "Check whether AI assistants (ChatGPT/Perplexity/Gemini) recommend a brand or token in its category. Returns a 0-100 AI-visibility score, mention rate, and which competitors AI names instead. Free teaser via /score; full audit via paid /brands/check. Unique to this store.",
   validate: async () => true,
   handler: async (runtime, message, _state, _o, callback) => {
-    var _a, _b;
-    const text = ((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "";
-    const addr = (((_b = text.match(/0x[0-9a-fA-F]{40}/)) == null ? void 0 : _b[0]) || "").toLowerCase();
-    const chainM = text.match(/\b(ethereum|eth|base|bsc|bnb|polygon|matic|arbitrum|optimism|avalanche|avax)\b/i);
-    const chain = ((chainM == null ? void 0 : chainM[1]) || "ethereum").toLowerCase();
-    if (!addr) {
-      if (callback) callback({ text: "Provide a token contract address (0x...) to run a rug check.", content: { error: "address required" } });
-      return false;
-    }
-    const data = await callStore(runtime, `/crypto/security?address=${addr}&chain=${chain}`);
-    if (callback) callback({ text: `Token security for ${addr} on ${chain}: ${JSON.stringify(data)}`, content: data });
-    return true;
+    const text = lastText(message);
+    const m = text.match(/(.+?)\s+(?:in|for)\s+(.+)/i);
+    const brand = ((m == null ? void 0 : m[1]) || text).replace(/^(check|is|does ai recommend)\s+/i, "").trim();
+    const category = ((m == null ? void 0 : m[2]) || "its category").trim();
+    const data = await callStore(runtime, `/score?brand=${encodeURIComponent(brand)}&category=${encodeURIComponent(category)}`);
+    if (callback) callback({ text: `AI-visibility for ${brand}: ${JSON.stringify(data)}`, content: data });
+    return;
   },
   examples: []
 };
 var categoryRanking = {
   name: "AI_CATEGORY_RANKING",
   similes: ["WHO_DOES_AI_RECOMMEND", "CATEGORY_LEADERBOARD", "BEST_IN_CATEGORY"],
-  description: "Ask which brands AI recommends across a whole category right now, ranked by mention share. Paid per call ($0.02) via x402.",
+  description: "Ask which brands AI recommends across a whole category right now, ranked by mention share. Pay-per-call (~$0.02) in USDC via x402.",
   validate: async () => true,
   handler: async (runtime, message, _state, _o, callback) => {
-    var _a;
-    const category = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").replace(/^(who does ai recommend (for|in)|best|ranking for)\s+/i, "").trim();
+    const category = lastText(message).replace(/^(who does ai recommend (for|in)|best|ranking for)\s+/i, "").trim();
     const data = await callStore(runtime, `/category/ranking?category=${encodeURIComponent(category)}`);
     if (callback) callback({ text: `AI category ranking for ${category}: ${JSON.stringify(data)}`, content: data });
-    return true;
-  },
-  examples: []
-};
-var countryEconomics = {
-  name: "COUNTRY_ECONOMICS",
-  similes: ["GDP", "INFLATION", "MACRO_DATA", "COUNTRY_FINANCE"],
-  description: "Economic indicators (GDP, growth, inflation, unemployment, GDP/capita, population) for 200+ countries. Paid per call ($0.005) via x402.",
-  validate: async () => true,
-  handler: async (runtime, message, _state, _o, callback) => {
-    var _a;
-    const country = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "USA").replace(/[^A-Za-z ]/g, "").trim().slice(0, 40) || "USA";
-    const data = await callStore(runtime, `/macro/country?country=${encodeURIComponent(country)}`);
-    if (callback) callback({ text: `Economic indicators for ${country}: ${JSON.stringify(data)}`, content: data });
-    return true;
+    return;
   },
   examples: []
 };
 var x402AgentStorePlugin = {
   name: "x402-agentstore",
-  description: "x402 Agent Store data tools for ElizaOS: AI-visibility/GEO, live DEX token data, AI category rankings, prediction-market odds, and country economics \u2014 pay-per-call in USDC via x402, no API keys.",
-  actions: [aiVisibility, dexToken, tokenLaunches, tokenSecurity, categoryRanking, countryEconomics],
+  description: "Pay-per-call data tools for ElizaOS agents over x402 (USDC on Base, no API key): WEB SEARCH (HN+GitHub+StackOverflow+Wikipedia in one call), ON-CHAIN READS (balance, gas, tx status across Base/Ethereum/Optimism/Arbitrum/Polygon/BSC), a trading lane (token rug-check, live DEX data, new-token feed), and unique AI-visibility/GEO data. Free samples at /samples.",
+  // Headline demand lanes first (web search + on-chain reads), then trading, then unique AI-visibility.
+  actions: [webSearch, wikipedia, chainBalance, chainGas, chainTx, tokenSecurity, dexToken, tokenLaunches, aiVisibility, categoryRanking],
   providers: [],
   evaluators: []
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rileycraig/plugin-x402-agentstore",
-  "version": "1.1.0",
-  "description": "ElizaOS plugin: x402 Agent Store data tools — AI-visibility/GEO, live DEX token data, AI category rankings, prediction-market odds, country economics. Pay-per-call in USDC via x402, no API keys.",
+  "version": "1.2.0",
+  "description": "ElizaOS plugin: pay-per-call data tools over x402 (USDC on Base, no API key). WEB SEARCH (Hacker News + GitHub + Stack Overflow + Wikipedia in one call) for research/coding/grounding agents, ON-CHAIN READS (wallet balance, gas, tx status across Base/Ethereum/Optimism/Arbitrum/Polygon/BSC), a trading lane (token rug-check, live DEX data, new-token feed), and unique AI-visibility/GEO data.",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -12,7 +12,9 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format esm --clean"
   },
@@ -23,10 +25,37 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0"
   },
-  "keywords": ["elizaos", "elizaos-plugin", "x402", "ai-visibility", "geo", "crypto", "dex", "agent", "base", "usdc"],
+  "keywords": [
+    "elizaos",
+    "elizaos-plugin",
+    "x402",
+    "web-search",
+    "search",
+    "research",
+    "grounding",
+    "onchain",
+    "rpc",
+    "wallet-balance",
+    "gas",
+    "transaction",
+    "rug-check",
+    "honeypot",
+    "dex",
+    "trading",
+    "ai-visibility",
+    "geo",
+    "agent",
+    "agentic",
+    "base",
+    "usdc",
+    "micropayments",
+    "pay-per-call"
+  ],
   "author": "Riley Craig <rileycraig14@gmail.com>",
   "license": "MIT",
   "agentConfig": {
     "pluginType": "elizaos:plugin:1.0.0"
-  }
-}
+  },
+  "packageType": "plugin",
+  "platform": "node"
+}