agentic-x402 0.3.3 → 0.3.5

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.3", "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.5", "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.3",
+  "version": "0.3.5",
   "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.3",
+  "version": "0.3.5",
   "description": "Agent skill for x402 payments - pay for and sell gated content",
   "type": "module",
   "bin": {

package/scripts/plugin/index.ts

@@ -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

@@ -67,6 +67,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;
   }
@@ -207,23 +210,34 @@ export class PaymentWatcher implements PluginService {
   }
 
   private async sendHook(event: PaymentEvent): Promise<void> {
-    const hookUrl = `http://127.0.0.1:${this.gatewayPort}/hooks/agent`;
+    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.3", "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.5", "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
 ---