@x402janus/elizaos-plugin 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# @x402janus/elizaos-plugin
+
+ElizaOS plugin for x402janus wallet security scans. Adds `SCAN_WALLET` and `CHECK_APPROVALS` actions to your ElizaOS agent.
+
+## Install
+
+```bash
+npm install @x402janus/elizaos-plugin
+```
+
+## Usage
+
+```typescript
+import { janusPlugin } from "@x402janus/elizaos-plugin";
+
+const agent = new Agent({
+  plugins: [janusPlugin],
+  settings: {
+    PRIVATE_KEY: process.env.PRIVATE_KEY, // Agent wallet for x402 payments
+  },
+});
+```
+
+Your agent can now respond to:
+- "Scan wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
+- "Is 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 safe?"
+- "Check approvals for 0x..."
+- "Do a deep security check on 0x..."
+
+## Actions
+
+### SCAN_WALLET
+
+Scans a wallet for security risks. Returns risk score, findings, and pre-built revoke transactions.
+
+**Triggers:** "scan wallet", "check security", "is this safe", "analyze wallet"
+
+### CHECK_APPROVALS
+
+Lists active token approvals with risk assessment.
+
+**Triggers:** "check approvals", "list approvals", "token approvals", "show allowances"
+
+## Payment
+
+All scans pay via x402 micropayment (USDC on Base). Your agent wallet needs:
+- USDC on Base ($0.01–$0.25 per scan)
+- No ETH required (facilitator pays gas)
+
+## License
+
+MIT

package/dist/actions/check-approvals.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module actions/check-approvals
+ * CHECK_APPROVALS action for ElizaOS.
+ */
+/**
+ * CHECK_APPROVALS action — lists token approvals for a wallet.
+ */
+export declare const checkApprovalsAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    validate: (_runtime: unknown, message: {
+        content: {
+            text: string;
+        };
+    }) => Promise<boolean>;
+    handler: (runtime: {
+        getSetting: (key: string) => string | undefined;
+    }, message: {
+        content: {
+            text: string;
+        };
+    }, _state: unknown, _options: unknown, callback: (response: {
+        text: string;
+        action?: string;
+    }) => void) => Promise<boolean>;
+    examples: ({
+        user: string;
+        content: {
+            text: string;
+            action?: undefined;
+        };
+    } | {
+        user: string;
+        content: {
+            text: string;
+            action: string;
+        };
+    })[][];
+};
+//# sourceMappingURL=check-approvals.d.ts.map

package/dist/actions/check-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-approvals.d.ts","sourceRoot":"","sources":["../../src/actions/check-approvals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8CH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;yBAWJ,OAAO,WAAW;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO,CAAC,OAAO,CAAC;uBAKlF;QAAE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;KAAE,WACnD;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,UAC9B,OAAO,YACL,OAAO,YACP,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,KAC9D,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;;;;CA0CpB,CAAC"}

package/dist/actions/check-approvals.js

@@ -0,0 +1,98 @@
+/**
+ * @module actions/check-approvals
+ * CHECK_APPROVALS action for ElizaOS.
+ */
+import { JanusClient } from "@x402janus/sdk";
+/** Ethereum address pattern */
+const ETH_ADDRESS_RE = /0x[a-fA-F0-9]{40}/;
+function extractAddress(text) {
+    const match = ETH_ADDRESS_RE.exec(text);
+    return match ? match[0] : null;
+}
+function formatApprovals(result) {
+    let output = `🔑 **Token Approvals for ${result.wallet.slice(0, 6)}...${result.wallet.slice(-4)}**\n\n`;
+    if (result.approvals.length === 0) {
+        output += "No active token approvals found. ✅\n";
+        return output;
+    }
+    output += `Found ${result.approvals.length} approval(s):\n\n`;
+    const riskCount = result.riskCount;
+    if (riskCount.critical > 0)
+        output += `🔴 Critical: ${riskCount.critical}\n`;
+    if (riskCount.high > 0)
+        output += `🟠 High: ${riskCount.high}\n`;
+    if (riskCount.medium > 0)
+        output += `🟡 Medium: ${riskCount.medium}\n`;
+    if (riskCount.low > 0)
+        output += `🟢 Low: ${riskCount.low}\n`;
+    output += "\n";
+    for (const approval of result.approvals.slice(0, 10)) {
+        const riskEmoji = approval.risk === "critical" ? "🔴" :
+            approval.risk === "high" ? "🟠" :
+                approval.risk === "medium" ? "🟡" : "🟢";
+        const symbol = approval.tokenSymbol ?? approval.token.slice(0, 8);
+        output += `${riskEmoji} **${symbol}** → ${approval.spender.slice(0, 8)}... (${approval.allowance})\n`;
+        if (approval.details)
+            output += `   ${approval.details}\n`;
+    }
+    if (result.approvals.length > 10) {
+        output += `\n...and ${result.approvals.length - 10} more.\n`;
+    }
+    return output;
+}
+/**
+ * CHECK_APPROVALS action — lists token approvals for a wallet.
+ */
+export const checkApprovalsAction = {
+    name: "CHECK_APPROVALS",
+    description: "List active token approvals for a wallet with risk assessment",
+    similes: [
+        "check approvals",
+        "list approvals",
+        "token approvals",
+        "what approvals does this wallet have",
+        "show allowances",
+    ],
+    validate: async (_runtime, message) => {
+        return ETH_ADDRESS_RE.test(message.content.text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const address = extractAddress(message.content.text);
+        if (!address) {
+            callback({ text: "I need a wallet address. Please provide an Ethereum address (0x...)." });
+            return false;
+        }
+        const privateKey = runtime.getSetting("PRIVATE_KEY") ?? process.env.PRIVATE_KEY;
+        if (!privateKey) {
+            callback({ text: "⚠️ Agent wallet not configured. Set PRIVATE_KEY for x402 payments." });
+            return false;
+        }
+        const baseUrl = runtime.getSetting("JANUS_API_URL") ?? process.env.JANUS_API_URL ?? "https://x402janus.com";
+        try {
+            const client = new JanusClient({ privateKey, baseUrl });
+            const result = await client.approvals(address);
+            callback({ text: formatApprovals(result), action: "CHECK_APPROVALS" });
+            return true;
+        }
+        catch (err) {
+            callback({ text: `❌ Failed to check approvals: ${err instanceof Error ? err.message : String(err)}` });
+            return false;
+        }
+    },
+    examples: [
+        [
+            {
+                user: "{{user1}}",
+                content: { text: "What approvals does 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 have?" },
+            },
+            {
+                user: "{{agent}}",
+                content: {
+                    text: "🔑 **Token Approvals for 0x742d...bD18**\n\nFound 3 approval(s):\n🟡 Medium: 2\n🟢 Low: 1",
+                    action: "CHECK_APPROVALS",
+                },
+            },
+        ],
+    ],
+};
+//# sourceMappingURL=check-approvals.js.map

package/dist/actions/check-approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-approvals.js","sourceRoot":"","sources":["../../src/actions/check-approvals.ts"],"names":[],"mappings":"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"}

package/dist/actions/scan-wallet.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @module actions/scan-wallet
+ * SCAN_WALLET action for ElizaOS.
+ */
+/**
+ * SCAN_WALLET action — scans a wallet for security risks.
+ *
+ * Triggers on messages like:
+ * - "scan wallet 0x..."
+ * - "check security of 0x..."
+ * - "is 0x... safe?"
+ * - "analyze wallet 0x..."
+ */
+export declare const scanWalletAction: {
+    name: string;
+    description: string;
+    similes: string[];
+    validate: (_runtime: unknown, message: {
+        content: {
+            text: string;
+        };
+    }) => Promise<boolean>;
+    handler: (runtime: {
+        getSetting: (key: string) => string | undefined;
+    }, message: {
+        content: {
+            text: string;
+        };
+    }, _state: unknown, _options: unknown, callback: (response: {
+        text: string;
+        action?: string;
+    }) => void) => Promise<boolean>;
+    examples: ({
+        user: string;
+        content: {
+            text: string;
+            action?: undefined;
+        };
+    } | {
+        user: string;
+        content: {
+            text: string;
+            action: string;
+        };
+    })[][];
+};
+//# sourceMappingURL=scan-wallet.d.ts.map

package/dist/actions/scan-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-wallet.d.ts","sourceRoot":"","sources":["../../src/actions/scan-wallet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4DH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;;yBAcA,OAAO,WAAW;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO,CAAC,OAAO,CAAC;uBAMlF;QAAE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;KAAE,WACnD;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,UAC9B,OAAO,YACL,OAAO,YACP,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,KAC9D,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;;;;;CAuFpB,CAAC"}

package/dist/actions/scan-wallet.js

@@ -0,0 +1,159 @@
+/**
+ * @module actions/scan-wallet
+ * SCAN_WALLET action for ElizaOS.
+ */
+import { JanusClient } from "@x402janus/sdk";
+/** Ethereum address pattern */
+const ETH_ADDRESS_RE = /0x[a-fA-F0-9]{40}/;
+/**
+ * Extract an Ethereum address from a message.
+ */
+function extractAddress(text) {
+    const match = ETH_ADDRESS_RE.exec(text);
+    return match ? match[0] : null;
+}
+/**
+ * Extract scan tier from message text.
+ */
+function extractTier(text) {
+    const lower = text.toLowerCase();
+    if (lower.includes("deep") || lower.includes("forensic") || lower.includes("thorough")) {
+        return "deep";
+    }
+    if (lower.includes("standard") || lower.includes("full")) {
+        return "standard";
+    }
+    return "quick";
+}
+/**
+ * Format scan results for human-readable output.
+ */
+function formatResults(result) {
+    const riskEmoji = result.risk >= 75 ? "🔴" : result.risk >= 50 ? "🟠" : result.risk >= 25 ? "🟡" : "🟢";
+    let output = `${riskEmoji} **Wallet Security Scan**\n\n`;
+    output += `**Status:** ${result.safe ? "✅ Safe" : "⚠️ Risks detected"}\n`;
+    output += `**Risk Score:** ${result.risk}/100\n\n`;
+    if (result.findings.length > 0) {
+        output += `**Findings (${result.findings.length}):**\n`;
+        for (const finding of result.findings) {
+            const sev = finding.severity === "critical" ? "🔴" :
+                finding.severity === "high" ? "🟠" :
+                    finding.severity === "medium" ? "🟡" : "🟢";
+            output += `${sev} [${finding.severity.toUpperCase()}] ${finding.description}\n`;
+        }
+        output += "\n";
+    }
+    if (result.revokeTxs.length > 0) {
+        output += `**Revoke Transactions (${result.revokeTxs.length}):**\n`;
+        for (const tx of result.revokeTxs) {
+            output += `• ${tx.description}\n`;
+        }
+    }
+    return output;
+}
+/**
+ * SCAN_WALLET action — scans a wallet for security risks.
+ *
+ * Triggers on messages like:
+ * - "scan wallet 0x..."
+ * - "check security of 0x..."
+ * - "is 0x... safe?"
+ * - "analyze wallet 0x..."
+ */
+export const scanWalletAction = {
+    name: "SCAN_WALLET",
+    description: "Scan a wallet for security risks using x402janus forensic analysis",
+    similes: [
+        "scan wallet",
+        "check wallet security",
+        "is this wallet safe",
+        "analyze wallet",
+        "wallet security scan",
+        "check approvals",
+        "scan address",
+        "security check",
+    ],
+    validate: async (_runtime, message) => {
+        const text = message.content.text;
+        return ETH_ADDRESS_RE.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const text = message.content.text;
+        const address = extractAddress(text);
+        if (!address) {
+            callback({
+                text: "I need a wallet address to scan. Please provide an Ethereum address (0x...).",
+            });
+            return false;
+        }
+        const tier = extractTier(text);
+        const privateKey = runtime.getSetting("PRIVATE_KEY") ?? process.env.PRIVATE_KEY;
+        if (!privateKey) {
+            callback({
+                text: "⚠️ Agent wallet not configured. Set PRIVATE_KEY to enable x402 payments for security scans.",
+            });
+            return false;
+        }
+        const baseUrl = runtime.getSetting("JANUS_API_URL") ?? process.env.JANUS_API_URL ?? "https://x402janus.com";
+        try {
+            callback({
+                text: `🔲 Scanning ${address.slice(0, 6)}...${address.slice(-4)} (${tier} tier)...`,
+            });
+            const client = new JanusClient({
+                privateKey,
+                baseUrl,
+                defaultTier: tier,
+            });
+            const result = await client.scan(address, { tier });
+            const formatted = formatResults(result);
+            callback({
+                text: formatted,
+                action: "SCAN_WALLET",
+            });
+            return true;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes("USDC") || msg.includes("payment") || msg.includes("balance")) {
+                callback({
+                    text: `⚠️ Agent wallet needs USDC on Base to pay for scans. Fund the wallet, then try again.`,
+                });
+            }
+            else {
+                callback({
+                    text: `❌ Scan failed: ${msg}`,
+                });
+            }
+            return false;
+        }
+    },
+    examples: [
+        [
+            {
+                user: "{{user1}}",
+                content: { text: "Can you scan this wallet? 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18" },
+            },
+            {
+                user: "{{agent}}",
+                content: {
+                    text: "🟢 **Wallet Security Scan**\n\n**Status:** ✅ Safe\n**Risk Score:** 12/100",
+                    action: "SCAN_WALLET",
+                },
+            },
+        ],
+        [
+            {
+                user: "{{user1}}",
+                content: { text: "Do a deep security check on 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" },
+            },
+            {
+                user: "{{agent}}",
+                content: {
+                    text: "🟡 **Wallet Security Scan**\n\n**Status:** ⚠️ Risks detected\n**Risk Score:** 35/100\n\n**Findings (2):**\n🟡 [MEDIUM] Unlimited approval to unknown spender",
+                    action: "SCAN_WALLET",
+                },
+            },
+        ],
+    ],
+};
+//# sourceMappingURL=scan-wallet.js.map

package/dist/actions/scan-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-wallet.js","sourceRoot":"","sources":["../../src/actions/scan-wallet.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @x402janus/elizaos-plugin
+ *
+ * ElizaOS plugin for x402janus wallet security scans.
+ * Adds SCAN_WALLET and CHECK_APPROVALS actions to any ElizaOS agent.
+ *
+ * @example
+ * ```typescript
+ * import { janusPlugin } from "@x402janus/elizaos-plugin";
+ *
+ * const agent = new Agent({
+ *   plugins: [janusPlugin],
+ * });
+ * ```
+ */
+export { janusPlugin, janusPlugin as default } from "./plugin.js";
+export { scanWalletAction } from "./actions/scan-wallet.js";
+export { checkApprovalsAction } from "./actions/check-approvals.js";
+export type { JanusPluginConfig } from "./plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @x402janus/elizaos-plugin
+ *
+ * ElizaOS plugin for x402janus wallet security scans.
+ * Adds SCAN_WALLET and CHECK_APPROVALS actions to any ElizaOS agent.
+ *
+ * @example
+ * ```typescript
+ * import { janusPlugin } from "@x402janus/elizaos-plugin";
+ *
+ * const agent = new Agent({
+ *   plugins: [janusPlugin],
+ * });
+ * ```
+ */
+export { janusPlugin, janusPlugin as default } from "./plugin.js";
+export { scanWalletAction } from "./actions/scan-wallet.js";
+export { checkApprovalsAction } from "./actions/check-approvals.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @module plugin
+ * ElizaOS plugin definition for x402janus.
+ */
+/**
+ * Configuration for the x402janus plugin.
+ */
+export interface JanusPluginConfig {
+    /**
+     * Agent wallet private key for signing x402 micropayments.
+     * Falls back to `process.env.PRIVATE_KEY`.
+     */
+    privateKey?: string;
+    /**
+     * x402janus API base URL.
+     * @default "https://x402janus.com"
+     */
+    baseUrl?: string;
+    /**
+     * Default scan tier.
+     * @default "quick"
+     */
+    defaultTier?: "quick" | "standard" | "deep";
+}
+/**
+ * x402janus ElizaOS plugin.
+ *
+ * Adds wallet security scanning actions to your ElizaOS agent.
+ * All scans are paid via x402 micropayment (USDC on Base).
+ *
+ * Actions added:
+ * - `SCAN_WALLET` — Scan a wallet for security risks
+ * - `CHECK_APPROVALS` — List active token approvals with risk assessment
+ *
+ * @example
+ * ```typescript
+ * import { janusPlugin } from "@x402janus/elizaos-plugin";
+ *
+ * const agent = new Agent({
+ *   plugins: [janusPlugin],
+ * });
+ * ```
+ */
+export declare const janusPlugin: {
+    name: string;
+    description: string;
+    actions: {
+        name: string;
+        description: string;
+        similes: string[];
+        validate: (_runtime: unknown, message: {
+            content: {
+                text: string;
+            };
+        }) => Promise<boolean>;
+        handler: (runtime: {
+            getSetting: (key: string) => string | undefined;
+        }, message: {
+            content: {
+                text: string;
+            };
+        }, _state: unknown, _options: unknown, callback: (response: {
+            text: string;
+            action?: string;
+        }) => void) => Promise<boolean>;
+        examples: ({
+            user: string;
+            content: {
+                text: string;
+                action?: undefined;
+            };
+        } | {
+            user: string;
+            content: {
+                text: string;
+                action: string;
+            };
+        })[][];
+    }[];
+    evaluators: never[];
+    providers: never[];
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;kBAOm6C,CAAC;;;;;;;;;;;;;;;;;;CAD37C,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,33 @@
+/**
+ * @module plugin
+ * ElizaOS plugin definition for x402janus.
+ */
+import { scanWalletAction } from "./actions/scan-wallet.js";
+import { checkApprovalsAction } from "./actions/check-approvals.js";
+/**
+ * x402janus ElizaOS plugin.
+ *
+ * Adds wallet security scanning actions to your ElizaOS agent.
+ * All scans are paid via x402 micropayment (USDC on Base).
+ *
+ * Actions added:
+ * - `SCAN_WALLET` — Scan a wallet for security risks
+ * - `CHECK_APPROVALS` — List active token approvals with risk assessment
+ *
+ * @example
+ * ```typescript
+ * import { janusPlugin } from "@x402janus/elizaos-plugin";
+ *
+ * const agent = new Agent({
+ *   plugins: [janusPlugin],
+ * });
+ * ```
+ */
+export const janusPlugin = {
+    name: "x402janus",
+    description: "Wallet security scanning for AI agents via x402 micropayment",
+    actions: [scanWalletAction, checkApprovalsAction],
+    evaluators: [],
+    providers: [],
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAyBpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,8DAA8D;IAC3E,OAAO,EAAE,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IACjD,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE;CACd,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@x402janus/elizaos-plugin",
+  "version": "0.1.0",
+  "description": "ElizaOS plugin for x402janus wallet security scans with x402 micropayment",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@x402janus/sdk": "file:../x402janus-sdk"
+  },
+  "peerDependencies": {
+    "@elizaos/core": ">=0.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "elizaos",
+    "plugin",
+    "x402janus",
+    "wallet",
+    "security",
+    "scan",
+    "x402",
+    "base"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/x402janus/elizaos-plugin"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}