agentic-x402 0.3.4 → 0.3.6

package/SKILL.md

@@ -4,7 +4,7 @@ description: Make x402 payments to access gated APIs and content. Fetch paid res
 license: MIT
 compatibility: Requires Node.js 20+, network access to x402 facilitators and EVM chains
 homepage: https://www.npmjs.com/package/agentic-x402
-metadata: {"author": "monemetrics", "version": "0.3.4", "openclaw": {"requires": {"bins": ["x402"], "env": ["EVM_PRIVATE_KEY"]}, "primaryEnv": "EVM_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "agentic-x402", "bins": ["x402"], "label": "Install agentic-x402 (npm)"}], "plugin": true}}
+metadata: {"author": "monemetrics", "version": "0.3.6", "openclaw": {"requires": {"bins": ["x402"], "env": ["EVM_PRIVATE_KEY"]}, "primaryEnv": "EVM_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "agentic-x402", "bins": ["x402"], "label": "Install agentic-x402 (npm)"}], "plugin": true}}
 allowed-tools: Bash(x402:*) Bash(npm:*) Read
 ---
 

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "agentic-x402",
   "name": "x402 Payments",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Agent skill for x402 payments — pay for and sell gated content with background payment watching",
   "skills": ["./skills/x402"],
   "configSchema": {
@@ -27,6 +27,10 @@
         "default": "https://21.cash",
         "description": "Base URL of the x402 links API (21.cash)"
       },
+      "hooksToken": {
+        "type": "string",
+        "description": "Bearer token for gateway hooks endpoint (must match hooks.token in gateway config). Falls back to OPENCLAW_HOOKS_TOKEN env var."
+      },
       "watcher": {
         "type": "object",
         "properties": {
@@ -68,6 +72,11 @@
     "x402LinksApiUrl": {
       "label": "21.cash API URL",
       "placeholder": "https://21.cash"
+    },
+    "hooksToken": {
+      "label": "Hooks Token",
+      "sensitive": true,
+      "placeholder": "your-hooks-secret"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-x402",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Agent skill for x402 payments - pay for and sell gated content",
   "type": "module",
   "bin": {

package/scripts/plugin/config-bridge.ts

@@ -3,7 +3,7 @@
 
 import type { X402PluginConfig } from './types.js';
 
-const CONFIG_MAP: Record<keyof Omit<X402PluginConfig, 'watcher'>, string> = {
+const CONFIG_MAP: Record<keyof Omit<X402PluginConfig, 'watcher' | 'hooksToken'>, string> = {
   evmPrivateKey: 'EVM_PRIVATE_KEY',
   network: 'X402_NETWORK',
   maxPaymentUsd: 'X402_MAX_PAYMENT_USD',
@@ -23,7 +23,7 @@ export function applyConfigBridge(pluginConfig: Record<string, unknown>): void {
   const config = pluginConfig as X402PluginConfig;
 
   for (const [key, envVar] of Object.entries(CONFIG_MAP)) {
-    const value = config[key as keyof Omit<X402PluginConfig, 'watcher'>];
+    const value = config[key as keyof Omit<X402PluginConfig, 'watcher' | 'hooksToken'>];
     if (value !== undefined && value !== null && !process.env[envVar]) {
       process.env[envVar] = String(value);
     }

package/scripts/plugin/index.ts

@@ -11,11 +11,11 @@ export default {
   name: 'x402 Payments',
 
   register(api: OpenClawPluginApi): void {
-    const { logger, config, gatewayPort } = api;
-    const pluginConfig = config as X402PluginConfig;
+    const { logger, gatewayPort } = api;
+    const pluginConfig = (api.pluginConfig ?? {}) as X402PluginConfig;
 
     // 1. Apply config bridge: inject plugin config → process.env
-    applyConfigBridge(config);
+    applyConfigBridge(pluginConfig);
     logger.debug('x402 config bridge applied');
 
     // 2. Register background watcher service (unless disabled)
@@ -26,6 +26,7 @@ export default {
       watcher = new PaymentWatcher({
         logger,
         gatewayPort,
+        hooksToken: pluginConfig.hooksToken,
         pollIntervalMs: pluginConfig.watcher?.pollIntervalMs,
         notifyOnPayment: pluginConfig.watcher?.notifyOnPayment,
       });

package/scripts/plugin/types.ts

@@ -52,6 +52,7 @@ export interface CliCommand {
 export interface OpenClawPluginApi {
   logger: PluginLogger;
   config: Record<string, unknown>;
+  pluginConfig?: Record<string, unknown>;
   gatewayPort: number;
   registerService(service: PluginService): void;
   registerTool(tool: PluginTool): void;
@@ -67,6 +68,7 @@ export interface X402PluginConfig {
   network?: 'mainnet' | 'testnet';
   maxPaymentUsd?: number;
   x402LinksApiUrl?: string;
+  hooksToken?: string;
   watcher?: {
     enabled?: boolean;
     pollIntervalMs?: number;

package/scripts/plugin/watcher.ts

@@ -20,6 +20,7 @@ const ERC20_BALANCE_ABI = [{
 interface WatcherOptions {
   logger: PluginLogger;
   gatewayPort: number;
+  hooksToken?: string;
   pollIntervalMs?: number;
   notifyOnPayment?: boolean;
 }
@@ -29,6 +30,7 @@ export class PaymentWatcher implements PluginService {
 
   private logger: PluginLogger;
   private gatewayPort: number;
+  private hooksToken: string | undefined;
   private pollIntervalMs: number;
   private notifyOnPayment: boolean;
 
@@ -42,6 +44,7 @@ export class PaymentWatcher implements PluginService {
   constructor(options: WatcherOptions) {
     this.logger = options.logger;
     this.gatewayPort = options.gatewayPort;
+    this.hooksToken = options.hooksToken || process.env.OPENCLAW_HOOKS_TOKEN;
     this.pollIntervalMs = options.pollIntervalMs ?? 30_000;
     this.notifyOnPayment = options.notifyOnPayment ?? true;
   }
@@ -208,23 +211,33 @@ export class PaymentWatcher implements PluginService {
 
   private async sendHook(event: PaymentEvent): Promise<void> {
     const port = this.gatewayPort || 18789;
+
+    if (!this.hooksToken) {
+      this.logger.warn('No hooks token configured — skipping hook delivery. Set hooksToken in plugin config or OPENCLAW_HOOKS_TOKEN env var.');
+      return;
+    }
+
     const hookUrl = `http://127.0.0.1:${port}/hooks/agent`;
 
     try {
       const response = await fetch(hookUrl, {
         method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${this.hooksToken}`,
+        },
         body: JSON.stringify({
+          message: `Payment detected on ${event.routerName}: +${event.increase} USDC (${event.previousBalance} → ${event.newBalance}). Router: ${event.routerAddress}`,
           name: 'x402-payment',
           wakeMode: 'now',
-          data: event,
         }),
       });
 
-      if (!response.ok) {
-        this.logger.warn(`Hook POST failed: ${response.status} ${response.statusText}`);
-      } else {
+      // /hooks/agent returns 202 on success (async run started)
+      if (response.status === 202 || response.ok) {
         this.logger.debug(`Hook delivered for payment on ${event.routerName}`);
+      } else {
+        this.logger.warn(`Hook POST failed: ${response.status} ${response.statusText}`);
       }
     } catch (err) {
       this.logger.warn(`Hook POST error: ${err instanceof Error ? err.message : String(err)}`);

package/skills/x402/SKILL.md

@@ -4,7 +4,7 @@ description: Make x402 payments to access gated APIs and content. Fetch paid res
 license: MIT
 compatibility: Requires Node.js 20+, network access to x402 facilitators and EVM chains
 homepage: https://www.npmjs.com/package/agentic-x402
-metadata: {"author": "monemetrics", "version": "0.3.4", "openclaw": {"requires": {"bins": ["x402"], "env": ["EVM_PRIVATE_KEY"]}, "primaryEnv": "EVM_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "agentic-x402", "bins": ["x402"], "label": "Install agentic-x402 (npm)"}], "plugin": true}}
+metadata: {"author": "monemetrics", "version": "0.3.6", "openclaw": {"requires": {"bins": ["x402"], "env": ["EVM_PRIVATE_KEY"]}, "primaryEnv": "EVM_PRIVATE_KEY", "install": [{"id": "node", "kind": "node", "package": "agentic-x402", "bins": ["x402"], "label": "Install agentic-x402 (npm)"}], "plugin": true}}
 allowed-tools: Bash(x402:*) Bash(npm:*) Read
 ---