plugin-x402-endpoints 0.3.0 → 0.5.0

package/dist/index.js

@@ -2119,6 +2119,416 @@ var catalog_default = {
           "content"
         ]
       }
+    },
+    {
+      tool: "crypto_pre_trade_verdict",
+      action: "X402_CRYPTO_PRE_TRADE_VERDICT",
+      path: "/crypto/pre-trade-verdict",
+      method: "GET",
+      price: "$0.05",
+      description: "One-call GO/CAUTION/NO-GO pre-trade verdict for AI trading agents: fuses token safety (honeypot, rug, tax, holders), counterparty wallet sanctions screening (OFAC/mixer) and cross-exchange market signal into a single decision with a signed, offline-verifiable receipt. Should I buy this token now? Replaces three separate calls (token-safety + wallet-screen + signal) with one fused GO/NO-GO verdict. EVM chains and Solana. Price: $0.05 per call (x402 payment, USDC on Base mainnet). One-call GO/CAUTION/NO-GO pre-trade verdict fusing token safety (honeypot/rug/tax) + counterparty sanctions screening (OFAC/mixer) + cross-exchange market signal, with a signed receipt. Replaces three calls. EVM + Solana. Input: token (+chain, optional wallet).",
+      llm_usage_prompt: "One-call GO/CAUTION/NO-GO pre-trade verdict fusing token safety (honeypot/rug/tax) + counterparty sanctions screening (OFAC/mixer) + cross-exchange market signal, with a signed receipt. Replaces three calls. EVM + Solana. Input: token (+chain, optional wallet).",
+      tags: [
+        "pre-trade-verdict",
+        "token-safety",
+        "go-no-go",
+        "counterparty-screen",
+        "trading-decision"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          token: {
+            type: "string",
+            description: "Token contract (EVM 0x+40hex) or SPL mint (base58) to evaluate"
+          },
+          chain: {
+            type: "string",
+            description: "base | ethereum | bsc | polygon | arbitrum | optimism | avalanche | solana (default base)"
+          },
+          wallet: {
+            type: "string",
+            description: "Optional counterparty wallet to screen (OFAC/mixer)"
+          }
+        },
+        required: [
+          "token"
+        ]
+      }
+    },
+    {
+      tool: "agent_ledger",
+      action: "X402_AGENT_LEDGER",
+      path: "/agent/ledger",
+      method: "GET",
+      price: "$0.04",
+      description: "Your AI agent's books in one call: structured USDC accounting for any wallet on Base (the x402 settlement asset) \u2014 revenue (incoming) vs expenses (outgoing), net, transaction count, top paying counterparties and payees, and a weekly breakdown over a 7d/30d/90d window. Turnkey bookkeeping / expense and revenue report an agent can drop straight into its accounting. The value is the structuring, not raw data access. Price: $0.04 per call (x402 payment, USDC on Base mainnet). Structured USDC accounting for a wallet on Base: revenue vs expenses, net, tx count, top payers/payees, weekly breakdown. Your agent's books in one call. Input: wallet (+period 7d/30d/90d).",
+      llm_usage_prompt: "Structured USDC accounting for a wallet on Base: revenue vs expenses, net, tx count, top payers/payees, weekly breakdown. Your agent's books in one call. Input: wallet (+period 7d/30d/90d).",
+      tags: [
+        "agent-ledger",
+        "x402-accounting",
+        "usdc-bookkeeping",
+        "revenue-expenses",
+        "onchain-ledger"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          wallet: {
+            type: "string",
+            description: "EVM wallet address (0x + 40 hex) to report on",
+            pattern: "^0x[a-fA-F0-9]{40}$"
+          },
+          period: {
+            type: "string",
+            description: "Reporting window: 7d | 30d | 90d | all (default 30d)"
+          }
+        },
+        required: [
+          "wallet"
+        ]
+      }
+    },
+    {
+      tool: "proof_notarize",
+      action: "X402_PROOF_NOTARIZE",
+      path: "/proof/notarize",
+      method: "GET",
+      price: "$0.01",
+      description: "Notarize a document or data hash for AI agents: submit a SHA-256 hash (or short content hashed server-side) and get a timestamped, Ed25519-signed proof-of-existence receipt, verifiable offline with no callback. Prove an artifact, agent output or decision existed at a point in time. Honest scope: this is a SIGNED proof-of-existence receipt, NOT a blockchain-anchored or eIDAS/RFC-3161 legal timestamp. The issuer never sees your content when you send only a hash. Price: $0.01 per call (x402 payment, USDC on Base mainnet). Notarize a SHA-256 hash (or short content hashed server-side) into a timestamped, Ed25519-signed proof-of-existence receipt, verifiable offline. Signed proof, NOT a blockchain-anchored or legal (eIDAS/RFC 3161) timestamp. Input: hash or content (+memo).",
+      llm_usage_prompt: "Notarize a SHA-256 hash (or short content hashed server-side) into a timestamped, Ed25519-signed proof-of-existence receipt, verifiable offline. Signed proof, NOT a blockchain-anchored or legal (eIDAS/RFC 3161) timestamp. Input: hash or content (+memo).",
+      tags: [
+        "notary",
+        "proof-of-existence",
+        "timestamp",
+        "ed25519-signature",
+        "hash-attestation"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          hash: {
+            type: "string",
+            description: "SHA-256 hex digest (64 hex chars) to notarize",
+            pattern: "^[0-9a-fA-F]{64}$"
+          },
+          content: {
+            type: "string",
+            description: "Alternative to hash: short content hashed server-side (SHA-256), max 100000 chars"
+          },
+          memo: {
+            type: "string",
+            description: "Optional label bound into the signed proof, e.g. 'invoice #42'"
+          }
+        }
+      }
+    },
+    {
+      tool: "crypto_token_dossier",
+      action: "X402_CRYPTO_TOKEN_DOSSIER",
+      path: "/crypto/token-dossier",
+      method: "GET",
+      price: "$0.10",
+      description: "Full degen token dossier in one call: safety score + honeypot/tax + detailed TOP HOLDERS and concentration + liquidity/FDV/volume/pool-age + contract control (owner, creator, mintable, open-source) + an AI red-flag narrative. Deep due-diligence report on a token before aping \u2014 the premium tier above a plain safety check. EVM chains and Solana. Price: $0.10 per call (x402 payment, USDC on Base mainnet). Full token dossier: safety score + top holders + concentration + liquidity/FDV/pool-age + contract control (owner/creator/mintable) + AI red-flag narrative. Premium tier above a plain safety check. EVM + Solana. Input: token (+chain).",
+      llm_usage_prompt: "Full token dossier: safety score + top holders + concentration + liquidity/FDV/pool-age + contract control (owner/creator/mintable) + AI red-flag narrative. Premium tier above a plain safety check. EVM + Solana. Input: token (+chain).",
+      tags: [
+        "token-dossier",
+        "holders",
+        "liquidity",
+        "rug-check",
+        "red-flags"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          token: {
+            type: "string",
+            description: "Token contract (EVM 0x+40hex) or SPL mint (base58)"
+          },
+          chain: {
+            type: "string",
+            description: "base | ethereum | bsc | polygon | arbitrum | optimism | avalanche | solana (default base)"
+          }
+        },
+        required: [
+          "token"
+        ]
+      }
+    },
+    {
+      tool: "market_intel",
+      action: "X402_MARKET_INTEL",
+      path: "/market/intel",
+      method: "GET",
+      price: "$0.10",
+      description: "AI market intelligence report in one call for research and trading agents: cross-exchange perp derivatives (funding, open interest, long/short), fused directional signals and the euro-area macro snapshot (ECB inflation, policy rates, unemployment, EUR FX) synthesized into a headline, crypto and macro outlook, key signals, risks and opportunities. Multi-source market research report with a crypto + macro/EU lens. Price: $0.10 per call (x402 payment, USDC on Base mainnet). AI market intelligence report: cross-exchange perp derivatives (funding/OI/long-short) + fused directional signals + euro-area ECB macro (inflation, rates, unemployment, FX) synthesized into headline, crypto and macro outlook, key signals, risks, opportunities. Input: focus (crypto/macro/all), depth.",
+      llm_usage_prompt: "AI market intelligence report: cross-exchange perp derivatives (funding/OI/long-short) + fused directional signals + euro-area ECB macro (inflation, rates, unemployment, FX) synthesized into headline, crypto and macro outlook, key signals, risks, opportunities. Input: focus (crypto/macro/all), depth.",
+      tags: [
+        "market-intelligence",
+        "crypto-market-report",
+        "macro",
+        "derivatives",
+        "research"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          focus: {
+            type: "string",
+            description: "crypto | macro | all (default all)"
+          },
+          depth: {
+            type: "string",
+            description: "quick | deep \u2014 deep adds SOL and more web signals (default quick)"
+          }
+        }
+      }
+    },
+    {
+      tool: "crypto_wallet_forensics",
+      action: "X402_CRYPTO_WALLET_FORENSICS",
+      path: "/crypto/wallet-forensics",
+      method: "GET",
+      price: "$0.15",
+      description: "Multi-hop wallet forensics for AI agents: traverse an address's ERC-20 counterparty graph across 1-3 hops and get the flow graph (nodes + edges), ranked counterparties (direction, tokens, activity) and detected patterns \u2014 flow concentration, circular flows, linked/clustered wallets and high-degree hubs (exchange/mixer/deployer) \u2014 plus a signed receipt. Trace where funds move and who is connected. EVM chains. Price: $0.15 per call (x402 payment, USDC on Base mainnet). Multi-hop wallet forensics: ERC-20 counterparty flow graph (1-3 hops), ranked counterparties, pattern detection (flow concentration, circular flows, linked wallets, high-degree hubs) + signed receipt. Input: wallet (+depth 1-3, chain).",
+      llm_usage_prompt: "Multi-hop wallet forensics: ERC-20 counterparty flow graph (1-3 hops), ranked counterparties, pattern detection (flow concentration, circular flows, linked wallets, high-degree hubs) + signed receipt. Input: wallet (+depth 1-3, chain).",
+      tags: [
+        "wallet-forensics",
+        "flow-graph",
+        "counterparties",
+        "multi-hop",
+        "pattern-detection"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          wallet: {
+            type: "string",
+            description: "EVM wallet address (0x + 40 hex) to investigate",
+            pattern: "^0x[a-fA-F0-9]{40}$"
+          },
+          depth: {
+            type: "integer",
+            description: "Graph hops to traverse: 1, 2 or 3 (default 2)"
+          },
+          chain: {
+            type: "string",
+            description: "base | ethereum | optimism | polygon | arbitrum | gnosis (default base)"
+          }
+        },
+        required: [
+          "wallet"
+        ]
+      }
+    },
+    {
+      tool: "chain_events",
+      action: "X402_CHAIN_EVENTS",
+      path: "/chain/events",
+      method: "GET",
+      price: "$0.05",
+      description: "On-demand, decoded on-chain events for AI agents: query a contract's event logs on Base (eth_getLogs) and get normalized, human-readable events \u2014 Transfer, Approval, ERC-1155 TransferSingle/Batch, Uniswap V2/V3 Swap, Sync, Mint, Burn \u2014 with raw topics for unknown signatures. Filter by event name, full signature or topic0, and by block range or lookback. Decoded event feed with no RPC setup, block span capped. Price: $0.05 per call (x402 payment, USDC on Base mainnet). Decoded, normalized on-chain events via eth_getLogs on Base: Transfer, Approval, ERC-1155 TransferSingle/Batch, Uniswap V2/V3 Swap, Sync, Mint, Burn \u2014 raw topics for unknown signatures. Filter by event name/signature/topic0 and block range. Input: contract (+event, block range/lookback).",
+      llm_usage_prompt: "Decoded, normalized on-chain events via eth_getLogs on Base: Transfer, Approval, ERC-1155 TransferSingle/Batch, Uniswap V2/V3 Swap, Sync, Mint, Burn \u2014 raw topics for unknown signatures. Filter by event name/signature/topic0 and block range. Input: contract (+event, block range/lookback).",
+      tags: [
+        "onchain-events",
+        "eth-getlogs",
+        "event-logs",
+        "decoded-events",
+        "base"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          contract: {
+            type: "string",
+            description: "Contract address to read logs from (0x + 40 hex)",
+            pattern: "^0x[a-fA-F0-9]{40}$"
+          },
+          event: {
+            type: "string",
+            description: "Event name (Transfer/Approval/Swap/Mint/Burn/TransferSingle/Sync), full signature 'Transfer(address,address,uint256)', or 0x topic0. Omit for all."
+          },
+          from_block: {
+            type: "integer",
+            description: "Start block (inclusive). Omit to use lookback."
+          },
+          to_block: {
+            type: "integer",
+            description: "End block (inclusive). Omit for latest."
+          },
+          lookback: {
+            type: "integer",
+            description: "If from/to omitted, scan the last N blocks (1-5000, default 2000)"
+          },
+          limit: {
+            type: "integer",
+            description: "Max events (1-100, most recent in range)"
+          }
+        },
+        required: [
+          "contract"
+        ]
+      }
+    },
+    {
+      tool: "x402_seller_audit",
+      action: "X402_X402_SELLER_AUDIT",
+      path: "/x402/seller-audit",
+      method: "GET",
+      price: "$0.50",
+      description: "Deep audit of an x402/ACP seller before trusting it: give a seller wallet or domain and get a full report \u2014 on-chain settlement reputation (settlements, unique counterparties, wash-trade/sybil, OFAC), the seller's advertised endpoints (from its /.well-known/x402.json), on-chain liveness, web reputation and red flags \u2014 fused into a TRUSTED/CAUTION/AVOID verdict with a signed, offline-verifiable receipt. Deeper than a pass/fail badge: the full seller due-diligence dossier for agentic payments. Price: $0.50 per call (x402 payment, USDC on Base mainnet). Deep x402 seller audit: on-chain settlement reputation (wash-trade/sybil/OFAC) + advertised endpoints from its /.well-known/x402.json + on-chain liveness + web reputation fused into TRUSTED/CAUTION/AVOID with a signed receipt. Deeper than a pass/fail badge. Input: seller wallet or domain.",
+      llm_usage_prompt: "Deep x402 seller audit: on-chain settlement reputation (wash-trade/sybil/OFAC) + advertised endpoints from its /.well-known/x402.json + on-chain liveness + web reputation fused into TRUSTED/CAUTION/AVOID with a signed receipt. Deeper than a pass/fail badge. Input: seller wallet or domain.",
+      tags: [
+        "x402-seller-audit",
+        "seller-reputation",
+        "endpoint-audit",
+        "due-diligence",
+        "counterparty-risk"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          seller: {
+            type: "string",
+            description: "Seller wallet (0x + 40 hex) or domain, e.g. 'api.example.com'"
+          },
+          depth: {
+            type: "string",
+            description: "On-chain depth: 'shallow' (~200 settlements) or 'deep' (~500)"
+          }
+        },
+        required: [
+          "seller"
+        ]
+      }
+    },
+    {
+      tool: "agent_clearance_packet",
+      action: "X402_AGENT_CLEARANCE_PACKET",
+      path: "/agent/clearance-packet",
+      method: "GET",
+      price: "$1.50",
+      description: "Signed clearance packet an AI agent buys BEFORE moving significant capital to a counterparty wallet: one call fuses OFAC/sanctions + mixer screening, multi-hop fund-flow forensics (circular/layering, concentration, hubs) and on-chain counterparty settlement trust into a single CLEAR/REVIEW/BLOCK verdict with the evaluated amount, a policy-bounded APPROVED amount, structured reasons, a short expiry and an Ed25519 signature verifiable offline. Can I send this capital to THIS wallet? Amount-scoped; the packet expires and is re-bought at the next move. Pre-payment AML/KYT clearance and counterparty due-diligence for autonomous agents. Price: $1.50 per call (x402 payment, USDC on Base mainnet). Signed clearance packet before an agent moves significant capital to a wallet: fuses OFAC/sanctions + mixer screening, multi-hop fund-flow forensics (circular/layering, concentration, hubs) and on-chain counterparty settlement trust into one CLEAR/REVIEW/BLOCK verdict with the evaluated amount, a policy-bounded approved amount, a short expiry and an Ed25519 signature verifiable offline. Pre-payment AML/KYT clearance and counterparty due-diligence for autonomous agents. Input: to (counterparty wallet) + amount_usd (+ optional depth).",
+      llm_usage_prompt: "Signed clearance packet before an agent moves significant capital to a wallet: fuses OFAC/mixer screening + multi-hop fund-flow forensics + on-chain counterparty settlement trust into one CLEAR/REVIEW/BLOCK verdict with the evaluated amount, a policy-bounded approved amount, a short expiry and an Ed25519 signature. Input: to + amount_usd (+depth).",
+      tags: [
+        "clearance-packet",
+        "pre-transaction-compliance",
+        "aml-screening",
+        "wallet-forensics",
+        "counterparty-risk"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          to: {
+            type: "string",
+            description: "Counterparty EVM wallet the capital will move to (0x + 40 hex)",
+            pattern: "^0x[a-fA-F0-9]{40}$"
+          },
+          amount_usd: {
+            type: "number",
+            description: "Capital about to move, in USD, e.g. 800 \u2014 scopes the verdict and approved amount"
+          },
+          depth: {
+            type: "integer",
+            description: "Forensics graph hops: 1, 2 or 3 (default 2)"
+          }
+        },
+        required: [
+          "to",
+          "amount_usd"
+        ]
+      }
+    },
+    {
+      tool: "agent_visibility_audit",
+      action: "X402_AGENT_VISIBILITY_AUDIT",
+      path: "/agent/visibility-audit",
+      method: "GET",
+      price: "$1.00",
+      description: "Audit how discoverable an x402 agent/seller is across the agent registries (CDP Bazaar, 402index) and get the exact fixes: keyword-RELEVANCE rank per category (not the raw settled-volume rank the free explorers show), a metadata-quality score of your advertised endpoints (description density, typed input schema, real output.example, tags, llm_usage_prompt), on-chain settle activity, a top-3 competitor benchmark, impact-prioritized fixes, and a DELTA vs a previous signed snapshot you carry back ('+N places since <date>'). Why am I not being found, and how do I climb? Discovery/GEO/AEO audit for x402 sellers, signed Ed25519. Price: $1.00 per call (x402 payment, USDC on Base mainnet). Discoverability audit of an x402 agent/seller across the agent registries (CDP Bazaar, 402index): keyword-relevance rank per category (not raw settled-volume rank), metadata-quality score of advertised endpoints (description density, typed input schema, output.example, tags, llm_usage_prompt), on-chain settle activity, top-3 competitor benchmark, impact-prioritized fixes, and a signed delta vs a previous snapshot you carry back. Why am I not being found and how do I climb? Discovery/GEO/AEO audit for x402 sellers. Input: seller (wallet or origin domain) (+ optional prior signed snapshot).",
+      llm_usage_prompt: "Discoverability audit of an x402 seller across the agent registries: keyword-relevance rank per category, metadata-quality score, on-chain settle activity, top-3 benchmark, prioritized fixes, and a signed delta vs a prior snapshot. GEO/AEO for x402 sellers. Input: seller (wallet or domain) (+snapshot).",
+      tags: [
+        "visibility-audit",
+        "x402-discoverability",
+        "bazaar-ranking",
+        "aeo-geo",
+        "registry-optimization"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          seller: {
+            type: "string",
+            description: "Seller to audit: wallet (0x + 40 hex) or origin URL/domain, e.g. 'api.example.com' or '0x1D1B...620f'"
+          },
+          snapshot: {
+            type: "string",
+            description: "Optional: the signed_snapshot JSON from a previous audit, to compute a dated delta"
+          }
+        },
+        required: [
+          "seller"
+        ]
+      }
+    },
+    {
+      tool: "agent_rank_check",
+      action: "X402_AGENT_RANK_CHECK",
+      path: "/agent/rank-check",
+      method: "GET",
+      price: "$0.10",
+      description: "Quick check of where an x402 seller ranks RIGHT NOW by keyword-relevance in the CDP Bazaar discovery (not the raw settled-volume rank the free explorers show): best rank + per-category-keyword rank in one cheap call, plus a pointer to the full /agent/visibility-audit when the rank slips. The frequent pulse for monitoring your x402 discoverability. Where do I rank now? Am I being out-ranked on my category keywords? Price: $0.10 per call (x402 payment, USDC on Base mainnet). Quick keyword-relevance rank of an x402 seller in CDP Bazaar discovery (not the raw settled-volume rank the free explorers show): best rank + per-category-keyword rank in one cheap call, plus a pointer to the full visibility-audit when the rank slips. The frequent pulse for monitoring x402 discoverability. Input: seller (wallet or origin domain).",
+      llm_usage_prompt: "Quick keyword-relevance rank of an x402 seller in CDP Bazaar discovery (not raw settled-volume rank) + a pointer to the full visibility-audit when the rank slips. Input: seller (wallet or domain).",
+      tags: [
+        "rank-check",
+        "x402-discoverability",
+        "bazaar-ranking",
+        "keyword-rank",
+        "discovery-monitor"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          seller: {
+            type: "string",
+            description: "Seller to check: wallet (0x + 40 hex) or origin URL/domain, e.g. 'api.example.com'"
+          }
+        },
+        required: [
+          "seller"
+        ]
+      }
+    },
+    {
+      tool: "agent_passport",
+      action: "X402_AGENT_PASSPORT",
+      path: "/agent/passport",
+      method: "GET",
+      price: "$1.00",
+      description: "Measured-vs-declared reputation dossier for an AI agent, corrected for Sybil manipulation. Give an ERC-8004 agent id or a wallet: reads the on-chain ERC-8004 Identity + Reputation registries on Base, computes the DECLARED reputation (review count/reviewers/values) then the MEASURED, Sybil-corrected reputation (deterministic signals: owner agent-farming, reviewers with no economic footprint, review concentration, value uniformity, placeholder tags, and whether real on-chain settlements back the reviews), and returns the DELTA + a signed, offline-verifiable verdict. Is this agent's reputation real or inflated? ERC-8004 reputation is widely Sybil-manipulated (arXiv:2606.26028); the declared-vs-measured gap is the product. Audit-grade, not a score lookup. Price: $1.00 per call (x402 payment, USDC on Base mainnet). Measured-vs-declared ERC-8004 agent reputation dossier, Sybil-corrected: reads the on-chain ERC-8004 Identity + Reputation registries on Base, computes the declared reputation (review count/reviewers/values) then the measured, Sybil-corrected reputation (owner agent-farming, footprint-less reviewers, review concentration, value uniformity, placeholder tags, unbacked-by-settlement), and returns the delta + a signed offline-verifiable verdict. Is this agent's reputation real or inflated? Audit-grade counterparty due-diligence. Input: agent_id (ERC-8004 tokenId) OR wallet.",
+      llm_usage_prompt: "Measured-vs-declared ERC-8004 agent reputation dossier, Sybil-corrected: reads on-chain ERC-8004 Identity + Reputation registries, computes declared then measured (Sybil signals) reputation, returns the delta + a signed verdict. Is this agent's reputation real or inflated? Input: agent_id (ERC-8004 tokenId) OR wallet.",
+      tags: [
+        "agent-passport",
+        "erc-8004",
+        "agent-reputation",
+        "sybil-detection",
+        "counterparty-due-diligence"
+      ],
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_id: {
+            type: "integer",
+            description: "ERC-8004 agent identity tokenId (IdentityRegistry). Provide this OR wallet."
+          },
+          wallet: {
+            type: "string",
+            description: "Agent wallet (0x + 40 hex); resolved to its ERC-8004 agentId. Provide this OR agent_id.",
+            pattern: "^0x[a-fA-F0-9]{40}$"
+          }
+        }
+      }
     }
   ]
 };