@ch4r10teer41/clawpass 1.0.1

package/openclaw-plugin.ts

@@ -0,0 +1,270 @@
+/**
+ * Clawpass OpenClaw plugin
+ *
+ * Exposes ERC-8004 identity, reputation, and validation as agent tools and CLI.
+ * Config: plugins.entries.clawpass.config
+ *
+ * @see https://docs.openclaw.ai/cli/plugins
+ * @see https://docs.openclaw.ai/plugins/manifest
+ * @see https://docs.openclaw.ai/plugins/agent-tools
+ */
+
+import { ClawpassClient, toFixedPoint, calculateHash } from '@ch4r10teer41/clawpass';
+import { ethers } from 'ethers';
+
+type Api = {
+  config: Record<string, unknown>;
+  logger: { info: (msg: string) => void; warn: (msg: string) => void; error: (msg: string) => void };
+  registerTool: (tool: ToolDef, opts?: { optional?: boolean }) => void;
+  registerGatewayMethod?: (name: string, handler: (ctx: { respond: (ok: boolean, data: unknown) => void }) => void) => void;
+  registerCli?: (fn: (ctx: { program: { command: (name: string) => { description: (d: string) => { action: (fn: () => void) => void } } } }) => void, opts: { commands: string[] }) => void;
+};
+
+type ToolDef = {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>;
+  execute: (id: string, params: Record<string, unknown>) => Promise<{ content: Array<{ type: string; text: string }> }>;
+};
+
+function getPluginConfig(api: Api): Record<string, unknown> | null {
+  const entries = api.config?.plugins as Record<string, unknown> | undefined;
+  const pluginsEntries = entries?.entries as Record<string, unknown> | undefined;
+  const clawpassEntry = pluginsEntries?.clawpass as Record<string, unknown> | undefined;
+  return clawpassEntry?.config as Record<string, unknown> | null ?? null;
+}
+
+function createClient(api: Api): ClawpassClient | null {
+  const cfg = getPluginConfig(api);
+  if (!cfg?.rpcUrl || !cfg?.identityRegistryAddress || !cfg?.reputationRegistryAddress || !cfg?.validationRegistryAddress) {
+    return null;
+  }
+  const provider = new ethers.JsonRpcProvider(cfg.rpcUrl as string);
+  const signer = cfg.privateKey
+    ? new ethers.Wallet(cfg.privateKey as string, provider)
+    : provider;
+  return new ClawpassClient({
+    identityRegistryAddress: cfg.identityRegistryAddress as string,
+    reputationRegistryAddress: cfg.reputationRegistryAddress as string,
+    validationRegistryAddress: cfg.validationRegistryAddress as string,
+    providerOrSigner: signer,
+  });
+}
+
+let clientInstance: ClawpassClient | null = null;
+
+function getClient(api: Api): ClawpassClient | null {
+  if (!clientInstance) {
+    clientInstance = createClient(api);
+  }
+  return clientInstance;
+}
+
+export default function register(api: Api): void {
+  api.logger?.info?.('Clawpass plugin registering');
+
+  // Optional agent tools (opt-in via tools.allow)
+  api.registerTool(
+    {
+      name: 'clawpass_get_agent_info',
+      description: 'Get ERC-8004 agent info: registration, owner, wallet. Requires agentId (number).',
+      parameters: {
+        type: 'object',
+        properties: { agentId: { type: 'number', description: 'ERC-8004 agent ID' } },
+        required: ['agentId'],
+      },
+      async execute(_id, params) {
+        const client = getClient(api);
+        if (!client) {
+          return { content: [{ type: 'text', text: 'Clawpass not configured. Set plugins.entries.clawpass.config (rpcUrl, identityRegistryAddress, reputationRegistryAddress, validationRegistryAddress).' }] };
+        }
+        try {
+          const agentId = BigInt(Number(params.agentId));
+          const info = await client.getAgentInfo(agentId);
+          return { content: [{ type: 'text', text: JSON.stringify({ agentId: String(agentId), owner: info.owner, wallet: info.wallet, name: info.registration.name, description: info.registration.description, services: info.registration.services }, null, 2) }] };
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return { content: [{ type: 'text', text: `Error: ${msg}` }] };
+        }
+      },
+    },
+    { optional: true }
+  );
+
+  api.registerTool(
+    {
+      name: 'clawpass_get_reputation',
+      description: 'Get agent reputation from trusted clients. Requires agentId (number) and trustedClients (array of Ethereum addresses). Optional tag1, tag2.',
+      parameters: {
+        type: 'object',
+        properties: {
+          agentId: { type: 'number', description: 'ERC-8004 agent ID' },
+          trustedClients: { type: 'array', items: { type: 'string' }, description: 'Addresses of trusted reviewers' },
+          tag1: { type: 'string' },
+          tag2: { type: 'string' },
+        },
+        required: ['agentId', 'trustedClients'],
+      },
+      async execute(_id, params) {
+        const client = getClient(api);
+        if (!client) {
+          return { content: [{ type: 'text', text: 'Clawpass not configured.' }] };
+        }
+        try {
+          const agentId = BigInt(Number(params.agentId));
+          const trustedClients = (params.trustedClients as string[]) || [];
+          if (trustedClients.length === 0) {
+            return { content: [{ type: 'text', text: 'trustedClients must be a non-empty array (Sybil protection).' }] };
+          }
+          const rep = await client.getAgentReputation(agentId, trustedClients, params.tag1 as string, params.tag2 as string);
+          return { content: [{ type: 'text', text: JSON.stringify({ summary: { count: String(rep.summary.count), summaryValue: String(rep.summary.summaryValue), summaryValueDecimals: rep.summary.summaryValueDecimals }, feedbackCount: rep.feedback.length }, null, 2) }] };
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return { content: [{ type: 'text', text: `Error: ${msg}` }] };
+        }
+      },
+    },
+    { optional: true }
+  );
+
+  api.registerTool(
+    {
+      name: 'clawpass_give_feedback',
+      description: 'Submit feedback for an agent (requires privateKey in plugin config). Params: agentId (number), value (number, e.g. 4.5), valueDecimals (0-18), optional tag1, tag2, endpoint.',
+      parameters: {
+        type: 'object',
+        properties: {
+          agentId: { type: 'number' },
+          value: { type: 'number', description: 'e.g. 4.5 for 4.5 stars' },
+          valueDecimals: { type: 'number', description: '0-18' },
+          tag1: { type: 'string' },
+          tag2: { type: 'string' },
+          endpoint: { type: 'string' },
+        },
+        required: ['agentId', 'value', 'valueDecimals'],
+      },
+      async execute(_id, params) {
+        const client = getClient(api);
+        if (!client) {
+          return { content: [{ type: 'text', text: 'Clawpass not configured.' }] };
+        }
+        try {
+          const value = toFixedPoint(Number(params.value), Number(params.valueDecimals) || 1);
+          await client.reputation.giveFeedback({
+            agentId: BigInt(Number(params.agentId)),
+            value,
+            valueDecimals: Number(params.valueDecimals) || 1,
+            tag1: params.tag1 as string,
+            tag2: params.tag2 as string,
+            endpoint: params.endpoint as string,
+          });
+          return { content: [{ type: 'text', text: 'Feedback submitted successfully.' }] };
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return { content: [{ type: 'text', text: `Error: ${msg}` }] };
+        }
+      },
+    },
+    { optional: true }
+  );
+
+  api.registerTool(
+    {
+      name: 'clawpass_request_validation',
+      description: 'Request validation for an agent (requires privateKey). Params: validatorAddress (string), agentId (number), requestURI (string), requestData (string, will be hashed) or requestHash (string).',
+      parameters: {
+        type: 'object',
+        properties: {
+          validatorAddress: { type: 'string' },
+          agentId: { type: 'number' },
+          requestURI: { type: 'string' },
+          requestData: { type: 'string', description: 'Payload to hash if requestHash not provided' },
+          requestHash: { type: 'string' },
+        },
+        required: ['validatorAddress', 'agentId', 'requestURI'],
+      },
+      async execute(_id, params) {
+        const client = getClient(api);
+        if (!client) {
+          return { content: [{ type: 'text', text: 'Clawpass not configured.' }] };
+        }
+        try {
+          const requestHash = (params.requestHash as string) || (params.requestData ? calculateHash(String(params.requestData)) : '');
+          if (!requestHash) {
+            return { content: [{ type: 'text', text: 'Provide requestHash or requestData.' }] };
+          }
+          await client.validation.validationRequest({
+            validatorAddress: params.validatorAddress as string,
+            agentId: Number(params.agentId),
+            requestURI: params.requestURI as string,
+            requestHash,
+          });
+          return { content: [{ type: 'text', text: 'Validation requested successfully.' }] };
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return { content: [{ type: 'text', text: `Error: ${msg}` }] };
+        }
+      },
+    },
+    { optional: true }
+  );
+
+  api.registerTool(
+    {
+      name: 'clawpass_validation_status',
+      description: 'Get validation status for a request. Requires requestHash (string).',
+      parameters: {
+        type: 'object',
+        properties: { requestHash: { type: 'string' } },
+        required: ['requestHash'],
+      },
+      async execute(_id, params) {
+        const client = getClient(api);
+        if (!client) {
+          return { content: [{ type: 'text', text: 'Clawpass not configured.' }] };
+        }
+        try {
+          const status = await client.validation.getValidationStatus(params.requestHash as string);
+          return { content: [{ type: 'text', text: JSON.stringify({ validatorAddress: status.validatorAddress, agentId: String(status.agentId), response: status.response, tag: status.tag, lastUpdate: String(status.lastUpdate) }, null, 2) }] };
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return { content: [{ type: 'text', text: `Error: ${msg}` }] };
+        }
+      },
+    },
+    { optional: true }
+  );
+
+  if (api.registerGatewayMethod) {
+    api.registerGatewayMethod('clawpass.status', ({ respond }) => {
+      const client = getClient(api);
+      respond(!!client, { configured: !!client });
+    });
+  }
+
+  if (api.registerCli) {
+    api.registerCli(
+      ({ program }) => {
+        program
+          .command('clawpass')
+          .description('Clawpass ERC-8004 status')
+          .action(() => {
+            const client = getClient(api);
+            const cfg = getPluginConfig(api);
+            if (!cfg) {
+              console.log('Clawpass: not configured (plugins.entries.clawpass.config)');
+              return;
+            }
+            if (!client) {
+              console.log('Clawpass: invalid or incomplete config (rpcUrl + all three registry addresses required)');
+              return;
+            }
+            console.log('Clawpass: configured and ready');
+          });
+      },
+      { commands: ['clawpass'] }
+    );
+  }
+
+  api.logger?.info?.('Clawpass plugin registered (optional tools: clawpass_get_agent_info, clawpass_get_reputation, clawpass_give_feedback, clawpass_request_validation, clawpass_validation_status)');
+}

package/openclaw.plugin.json

@@ -0,0 +1,64 @@
+{
+  "id": "clawpass",
+  "name": "Clawpass",
+  "description": "ERC-8004 interface: agent identity, reputation, and validation on blockchain. Register agents, give/query feedback, request validation.",
+  "version": "1.0.0",
+  "kind": "tools",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "rpcUrl": {
+        "type": "string",
+        "description": "EVM JSON-RPC URL (e.g. Alchemy, Infura)"
+      },
+      "identityRegistryAddress": {
+        "type": "string",
+        "description": "ERC-8004 Identity Registry contract address"
+      },
+      "reputationRegistryAddress": {
+        "type": "string",
+        "description": "ERC-8004 Reputation Registry contract address"
+      },
+      "validationRegistryAddress": {
+        "type": "string",
+        "description": "ERC-8004 Validation Registry contract address"
+      },
+      "privateKey": {
+        "type": "string",
+        "description": "Optional wallet private key for write operations (register, give feedback, validation request)"
+      },
+      "chainId": {
+        "type": "number",
+        "description": "Chain ID (e.g. 1 for mainnet)"
+      }
+    },
+    "required": ["rpcUrl", "identityRegistryAddress", "reputationRegistryAddress", "validationRegistryAddress"]
+  },
+  "uiHints": {
+    "rpcUrl": {
+      "label": "RPC URL",
+      "placeholder": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+    },
+    "identityRegistryAddress": {
+      "label": "Identity Registry Address",
+      "placeholder": "0x..."
+    },
+    "reputationRegistryAddress": {
+      "label": "Reputation Registry Address",
+      "placeholder": "0x..."
+    },
+    "validationRegistryAddress": {
+      "label": "Validation Registry Address",
+      "placeholder": "0x..."
+    },
+    "privateKey": {
+      "label": "Private Key (optional)",
+      "sensitive": true
+    },
+    "chainId": {
+      "label": "Chain ID",
+      "placeholder": "1"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@ch4r10teer41/clawpass",
+  "version": "1.0.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ch4r10t33r/clawpass.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "description": "ERC-8004 interface module for AI agent identity, reputation, and validation on blockchain",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./openclaw-plugin.ts"
+    ]
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "erc-8004",
+    "ethereum",
+    "ai-agents",
+    "identity",
+    "reputation",
+    "validation",
+    "blockchain",
+    "web3",
+    "moltbook",
+    "moltx",
+    "openclaw",
+    "openclaw-plugin"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.19",
+    "@typescript-eslint/eslint-plugin": "^7.0.1",
+    "@typescript-eslint/parser": "^7.0.1",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "ts-jest": "^29.1.2",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "ethers": "^6.11.1",
+    "zod": "^3.22.4"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  }
+}

package/setup.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+
+# Clawpass Setup Script
+# This script helps you set up the Clawpass development environment
+
+set -e
+
+echo "🔧 Setting up Clawpass..."
+echo ""
+
+# Check Node.js version
+echo "📦 Checking Node.js version..."
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo "❌ Error: Node.js 18 or higher is required"
+    echo "   Current version: $(node -v)"
+    echo "   Please upgrade Node.js: https://nodejs.org/"
+    exit 1
+fi
+echo "✅ Node.js version: $(node -v)"
+echo ""
+
+# Install dependencies
+echo "📥 Installing dependencies..."
+npm install
+echo "✅ Dependencies installed"
+echo ""
+
+# Build the project
+echo "🔨 Building the project..."
+npm run build
+echo "✅ Project built successfully"
+echo ""
+
+# Run tests
+echo "🧪 Running tests..."
+npm test
+echo "✅ Tests passed"
+echo ""
+
+# Run linter
+echo "🔍 Running linter..."
+npm run lint
+echo "✅ Linting passed"
+echo ""
+
+# Run type checker
+echo "📝 Running type checker..."
+npm run typecheck
+echo "✅ Type checking passed"
+echo ""
+
+echo "✨ Setup complete!"
+echo ""
+echo "Next steps:"
+echo "  1. Copy .env.example to .env and configure your settings"
+echo "  2. Read QUICKSTART.md for usage examples"
+echo "  3. Check out examples/ for integration patterns"
+echo "  4. Run 'npm run dev' to start development mode"
+echo ""
+echo "Happy coding! 🚀"