npm.io
1.2.0 • Published 6d ago

@rileycraig/plugin-x402-agentstore

Licence
MIT
Version
1.2.0
Deps
0
Size
15 kB
Vulns
0
Weekly
259

@rileycraig/plugin-x402-agentstore

Pay-per-call data tools for ElizaOS agents — settled in USDC over x402 on Base. No API keys. No signup. Payment is the auth.

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.

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.)

npm install @rileycraig/plugin-x402-agentstore
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

npm install
npm run build
npm publish --access public
# then submit to the ElizaOS plugin registry so every ElizaOS agent can discover it

License

MIT Riley Craig

Keywords