@kurox_real/plugin-rugshield-402 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @kurox_real/plugin-rugshield-402 🛡️
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Autonomous Pre-Swap Honeypot Detection & Tax Verification Plugin for ElizaOS Agents on Base**
+
+Gated by the **x402 Payment Protocol** ($0.005 USDC per scan on Base Mainnet).
+
+## Overview
+This plugin provides the `PRE_SWAP_RISK_CHECK` action for ElizaOS agents. Before an agent swaps any token on Base (Aerodrome, Uniswap v3), it automatically queries the RugShield 402 engine to:
+- Detect buy/sell honeypots and non-transferable token traps
+- Calculate real buy & sell taxes (bps)
+- Verify pool liquidity depth
+- Block swaps if honeypots or high-tax drainers are detected
+
+## Installation
+```bash
+npm install @kurox_real/plugin-rugshield-402
+# or
+bun add @kurox_real/plugin-rugshield-402
+# or
+pnpm add @kurox_real/plugin-rugshield-402
+```
+
+## Agent Configuration
+Import and add `rugshieldPlugin` to your ElizaOS agent's character file:
+
+```typescript
+import { rugshieldPlugin } from "@kurox_real/plugin-rugshield-402";
+
+export const defaultCharacter = {
+  name: "DeFiTrader",
+  plugins: [rugshieldPlugin],
+  // ...
+};
+```
+
+Or in JSON character configuration:
+```json
+{
+  "name": "DeFiTrader",
+  "plugins": ["@kurox_real/plugin-rugshield-402"]
+}
+```
+
+## Environment Variables
+- `RUGSHIELD_URL`: (Optional) Custom RugShield 402 host. Defaults to `https://rugshield-402.onrender.com`.
+
+## License
+MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export interface ElizaAction {
+    name: string;
+    similes: string[];
+    description: string;
+    validate: (runtime: any, message: any) => Promise<boolean>;
+    handler: (runtime: any, message: any, state?: any, options?: any, callback?: any) => Promise<any>;
+    examples: any[][];
+}
+/**
+ * ElizaOS Action: PRE_SWAP_RISK_CHECK
+ * Automatically intercepts swap requests and calls RugShield 402 on Base
+ * to protect the agent's wallet from honeypots, malicious taxes, and liquidity drains.
+ */
+export declare const preSwapRiskCheckAction: ElizaAction;
+export declare const rugshieldPlugin: {
+    name: string;
+    description: string;
+    actions: ElizaAction[];
+};
+export default rugshieldPlugin;

package/dist/index.js

@@ -0,0 +1,84 @@
+/**
+ * ElizaOS Action: PRE_SWAP_RISK_CHECK
+ * Automatically intercepts swap requests and calls RugShield 402 on Base
+ * to protect the agent's wallet from honeypots, malicious taxes, and liquidity drains.
+ */
+export const preSwapRiskCheckAction = {
+    name: "PRE_SWAP_RISK_CHECK",
+    similes: [
+        "CHECK_HONEYPOT",
+        "VERIFY_TOKEN_SAFETY",
+        "SIMULATE_TOKEN_TAX",
+        "AUDIT_BASE_TOKEN",
+        "RUGSHIELD_CHECK"
+    ],
+    description: "MANDATORY check before executing DEX swaps on Base. Queries RugShield 402 to detect honeypots, high buy/sell taxes, and drained liquidity. Cost: 0.005 USDC on Base.",
+    validate: async (_runtime, message) => {
+        const text = message.content?.text || "";
+        // Matches 0x addresses on Base
+        return /0x[a-fA-F0-9]{40}/i.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const text = message.content?.text || "";
+        const match = text.match(/0x[a-fA-F0-9]{40}/i);
+        if (!match)
+            return false;
+        const tokenAddress = match[0];
+        const endpoint = process.env.RUGSHIELD_URL || "https://rugshield-402.onrender.com";
+        try {
+            const response = await fetch(`${endpoint}/v1/scan`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    token_address: tokenAddress,
+                    chain_id: 8453,
+                    simulate_sell: true
+                })
+            });
+            if (response.status === 402) {
+                const challenge = await response.json();
+                if (callback) {
+                    callback({
+                        text: `RugShield 402 payment required ($0.005 USDC on Base). PayTo: ${challenge.payTo}`,
+                        action: "X402_PAYMENT_REQUIRED",
+                        challenge
+                    });
+                }
+                return false;
+            }
+            const report = await response.json();
+            const isSafe = report.recommendation === "SAFE_TO_SWAP";
+            if (callback) {
+                callback({
+                    text: `RugShield Security Report for ${report.symbol} (${tokenAddress}):\n` +
+                        `• Recommendation: ${report.recommendation}\n` +
+                        `• Honeypot: ${report.is_honeypot ? "YES (DO NOT BUY)" : "NO"}\n` +
+                        `• Buy Tax: ${report.buy_tax_bps / 100}%\n` +
+                        `• Sell Tax: ${report.sell_tax_bps / 100}%\n` +
+                        `• Pool Liquidity: $${report.liquidity_usd.toLocaleString()}\n` +
+                        `• Risk Score: ${report.risk_score}`,
+                    report
+                });
+            }
+            return isSafe;
+        }
+        catch (err) {
+            if (callback) {
+                callback({ text: `Failed to query RugShield: ${err.message}` });
+            }
+            return false;
+        }
+    },
+    examples: [
+        [
+            { user: "{{user1}}", content: { text: "Swap 0.05 ETH for 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base" } },
+            { user: "{{agent}}", content: { text: "Running pre-swap risk check via RugShield 402...", action: "PRE_SWAP_RISK_CHECK" } }
+        ]
+    ]
+};
+export const rugshieldPlugin = {
+    name: "plugin-rugshield-402",
+    description: "RugShield 402 DEX Honeypot & Tax Protection Plugin for ElizaOS Agents on Base",
+    actions: [preSwapRiskCheckAction]
+};
+export default rugshieldPlugin;

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@kurox_real/plugin-rugshield-402",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "RugShield 402 DEX honeypot detection, buy/sell tax simulation, and pool liquidity verification action for ElizaOS agents on Base (x402 gated).",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "elizaos",
+    "eliza",
+    "plugin",
+    "rugshield",
+    "x402",
+    "base",
+    "usdc",
+    "honeypot",
+    "defi",
+    "security"
+  ],
+  "author": "kurox_real",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ak10082247-max/rugshield-402.git",
+    "directory": "plugins/eliza-rugshield"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}