@itzannetos/x402-tools 1.0.0

package/.opencode/plugins/x402-tools.ts

@@ -0,0 +1,106 @@
+import type { Plugin } from "@opencode-ai/plugin"
+import { tool } from "@opencode-ai/plugin"
+import axios from "axios"
+import { withPaymentInterceptor } from "x402-axios"
+import { config as loadEnv } from "dotenv"
+import { createWalletClient, http } from "viem"
+import { privateKeyToAccount } from "viem/accounts"
+import { base } from "viem/chains"
+import { readFile } from "fs/promises"
+import { join } from "path"
+
+const BASE_URL = "https://agents.402box.io"
+const X_SEARCHER_PATH = "/x_searcher"
+const FIND_PEOPLE_PATH = "/find_people"
+const TIMEOUT_MS = 300000
+
+const getPrivateKey = async (): Promise<`0x${string}`> => {
+  const configPath = join(process.cwd(), ".opencode", "x402-tools.json")
+  try {
+    const contents = await readFile(configPath, "utf-8")
+    const parsed = JSON.parse(contents) as { private_key?: string }
+    if (parsed.private_key) {
+      const key = parsed.private_key
+      return (key.startsWith("0x") ? key : `0x${key}`) as `0x${string}`
+    }
+  } catch (error) {
+    if (error instanceof Error && (error as NodeJS.ErrnoException).code !== "ENOENT") {
+      throw error
+    }
+  }
+
+  loadEnv({ path: join(process.cwd(), ".env") })
+  const key = process.env.X402_PRIVATE_KEY
+  if (!key) {
+    throw new Error(
+      "X402 private key missing. Set .opencode/x402-tools.json or X402_PRIVATE_KEY in .env."
+    )
+  }
+  return (key.startsWith("0x") ? key : `0x${key}`) as `0x${string}`
+}
+
+const createPaymentClient = (privateKey: `0x${string}`) => {
+  const account = privateKeyToAccount(privateKey)
+  const walletClient = createWalletClient({
+    account,
+    chain: base,
+    transport: http(),
+  })
+
+  return withPaymentInterceptor(
+    axios.create({
+      baseURL: BASE_URL,
+      timeout: TIMEOUT_MS,
+    }),
+    walletClient
+  )
+}
+
+export const X402ToolsPlugin: Plugin = async () => {
+  return {
+    tool: {
+      x_searcher: tool({
+        description:
+          "AI-powered X/Twitter search agent - Get real-time trends, news, and social media insights",
+        args: {
+          query: tool.schema.string(),
+        },
+        async execute(args) {
+          const privateKey = await getPrivateKey()
+          const client = createPaymentClient(privateKey)
+
+          const response = await client.post(X_SEARCHER_PATH, {
+            message: args.query,
+          })
+
+          if (!response.data?.data?.response) {
+            throw new Error("Unexpected response from X Searcher")
+          }
+
+          return response.data.data.response
+        },
+      }),
+      find_people: tool({
+        description:
+          "Find People is a real-time Open Source Intelligence (OSINT) agent specialized in researching individuals and professional entities.\n\n**What it does:**\n• Identifies people by name, role, or company affiliation\n• Retrieves verified career timelines and professional backgrounds\n• Finds similar professionals in any industry or domain\n• Synthesizes biographical information with source citations\n• Validates identities across LinkedIn, company sites, and public records\n\n**Best for:**\n→ Due diligence research on potential hires or partners\n→ Competitive intelligence on industry leaders\n→ Journalist & researcher background verification\n→ Sales prospecting and lead enrichment\n→ Investor research on startup founders and executives\n\n**Powered by:**\nNeural and deep search capabilities that go beyond standard search engines to find hard-to-reach biographical details, executive profiles, and professional networks.\n\n**Output format:**\nReturns structured summaries with key details (career, education, notable works) and numbered source citations for verification.",
+        args: {
+          query: tool.schema.string(),
+        },
+        async execute(args) {
+          const privateKey = await getPrivateKey()
+          const client = createPaymentClient(privateKey)
+
+          const response = await client.post(FIND_PEOPLE_PATH, {
+            message: args.query,
+          })
+
+          if (!response.data?.data?.response) {
+            throw new Error("Unexpected response from Find People")
+          }
+
+          return response.data.data.response
+        },
+      }),
+    },
+  }
+}

package/README.md

@@ -0,0 +1,93 @@
+# x402-tools-plugin
+
+Local OpenCode plugin that provides payment-gated tools via X402.
+
+## Tools
+
+- `x_searcher` - AI-powered X/Twitter search agent for real-time trends and social insights.
+- `find_people` - OSINT agent for researching individuals and professional entities.
+
+## Install from npm
+
+1. Add the plugin to `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@itzannetos/x402-tools"]
+}
+```
+
+2. Create `.opencode/x402-tools.json` with your key:
+
+```json
+{
+  "private_key": "0x..."
+}
+```
+
+3. Or set it in `.env` at the project root:
+
+```
+X402_PRIVATE_KEY=0x...
+```
+
+4. Restart OpenCode so the plugin is loaded.
+
+## Local Installation
+
+1. Ensure Bun is installed.
+2. Install dependencies for local plugins:
+
+```bash
+cd /Users/itzannet/Documents/GitHub/x402-tools-plugin/.opencode
+bun install
+```
+
+3. Create `.opencode/x402-tools.json` with your key:
+
+```json
+{
+  "private_key": "0x..."
+}
+```
+
+4. Or set it in `.env` at the project root:
+
+```
+X402_PRIVATE_KEY=0x...
+```
+
+5. Restart OpenCode so the plugin is loaded.
+
+## Usage
+
+In OpenCode, invoke the tools by name:
+
+```
+Use the x_searcher tool to search for "AI breakthroughs in 2026".
+```
+
+```
+Use the find_people tool to research "Jane Doe, head of AI at ExampleCorp".
+```
+
+## Local Plugin Location
+
+The plugin is loaded automatically from:
+
+```
+.opencode/plugins/x402-tools.ts
+```
+
+## Publishing and Updates
+
+- Publish to npm and reference the package in `opencode.json` using a version range, for example: `"@itzannetos/x402-tools": "^1.0.0"`.
+- OpenCode installs npm plugins at startup; with a semver range it will pick up compatible updates automatically.
+- Pin an exact version if you want to control upgrades manually.
+
+## Notes
+
+- The plugin reads `.opencode/x402-tools.json` first, then falls back to `X402_PRIVATE_KEY` in `.env`.
+- Do not commit your key file; keep `.opencode/x402-tools.json` local.
+- No account address or metadata is printed; only the markdown response is returned.

package/index.ts

@@ -0,0 +1 @@
+export { X402ToolsPlugin } from "./.opencode/plugins/x402-tools"

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@itzannetos/x402-tools",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.ts",
+  "files": [
+    "index.ts",
+    ".opencode/plugins/x402-tools.ts",
+    "README.md"
+  ],
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.25",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.5",
+    "viem": "^2.21.26",
+    "x402-axios": "^1.1.0"
+  }
+}