@agether/agether 1.1.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agether/agether",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "OpenClaw plugin for Agether — on-chain credit for AI agents",
   "main": "src/index.ts",
   "openclaw": {
@@ -9,7 +9,7 @@
     ]
   },
   "dependencies": {
-    "@agether/sdk": "^1.8.0",
+    "@agether/sdk": "^1.10.0",
     "axios": "^1.6.0",
     "ethers": "^6.9.0"
   },
@@ -23,8 +23,13 @@
     "credit",
     "defi"
   ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "license": "MIT",
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }

package/skills/agether/SKILL.md

@@ -230,9 +230,9 @@ Morpho Blue (direct lending, overcollateralized 125%)
 
 | Contract | Address |
 |----------|---------|
-| AccountFactory | `0xb5b09213d0718f3FD56F1b111C8A83FDFcBdd5d8` |
-| ValidationRegistry | `0x867F4F6f749Dc422aeFEcF4273cD22015d2CBCc2` |
-| AgentReputation | `0x352883c396bc7e88891a7D343ba550A7638256c0` |
+| AccountFactory | `0xFab8b924fb292a736BA05AF7b4AEC2c8d05cdcbF` |
+| ValidationRegistry | `0x493f1551cbbC75afb2127CDBD5375ad8e8959f42` |
+| AgentReputation | `0x1fcb28eE3E8F3234E653b0A7a6fb56dE11E3c203` |
 | ERC-8004 Identity | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |
 | Morpho Blue | `0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb` |
 | USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |

package/src/index.ts

@@ -129,11 +129,16 @@ export default function register(api: any) {
         const client = createClient(cfg);
         const result = await client.register(params.name);
         const persistStatus = persistAgentId(result.agentId);
+        const kyaMessage = result.kyaRequired
+          ? "⚠️ KYA required: submit your agent code hash for review before using credit"
+          : "✅ KYA gate disabled — agent can use credit immediately";
         return ok(JSON.stringify({
           status: result.alreadyRegistered ? "already_registered" : "registered",
           agentId: result.agentId,
           address: result.address,
           agentAccount: result.agentAccount,
+          kyaRequired: result.kyaRequired,
+          kyaMessage,
           tx: result.tx ? txLink(result.tx) : undefined,
           configSaved: persistStatus,
         }));
@@ -177,6 +182,86 @@ export default function register(api: any) {
     },
   });
 
+  // ═══════════════════════════════════════════════════════
+  //  TOOL: agether_kya_status
+  // ═══════════════════════════════════════════════════════
+  api.registerTool({
+    name: "agether_kya_status",
+    description:
+      "Check if KYA code verification is required for this deployment.",
+    parameters: { type: "object", properties: {}, required: [] },
+    async execute() {
+      try {
+        const cfg = getConfig(api);
+        const client = createClient(cfg);
+        const required = await client.isKyaRequired();
+        return ok(
+          required
+            ? "KYA verification is ENABLED — agents must have code approved before using credit"
+            : "KYA verification is DISABLED — agents can use credit immediately after registration",
+        );
+      } catch (e) { return fail(e); }
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════
+  //  TOOL: agether_set_kya
+  // ═══════════════════════════════════════════════════════
+  api.registerTool({
+    name: "agether_set_kya",
+    description:
+      "Enable or disable KYA verification gate (owner only). " +
+      "Pass the ValidationRegistry address to enable, or '0x0000000000000000000000000000000000000000' to disable. " +
+      "Note: the actual transaction must be executed by the owner (TimelockController).",
+    parameters: {
+      type: "object",
+      properties: {
+        registryAddress: {
+          type: "string",
+          description:
+            "Address of ValidationRegistry, or '0x0000000000000000000000000000000000000000' to disable",
+        },
+      },
+      required: ["registryAddress"],
+    },
+    async execute(_id: string, params: { registryAddress: string }) {
+      try {
+        const cfg = getConfig(api);
+        const client = createClient(cfg);
+
+        // Build the calldata for setValidationRegistry — the owner (Timelock) must execute it
+        const { ethers } = await import("ethers");
+        const iface = new ethers.Interface([
+          "function setValidationRegistry(address newRegistry)",
+        ]);
+        const calldata = iface.encodeFunctionData("setValidationRegistry", [
+          params.registryAddress,
+        ]);
+
+        const isDisabling =
+          params.registryAddress === ethers.ZeroAddress;
+        const action = isDisabling ? "DISABLE" : "ENABLE";
+
+        return ok(
+          JSON.stringify(
+            {
+              action: `${action} KYA gate`,
+              registryAddress: params.registryAddress,
+              calldata,
+              note:
+                "This calldata must be submitted to the TimelockController by the owner. " +
+                "Schedule via timelock.schedule(accountFactoryAddr, 0, calldata, predecessor, salt, delay).",
+            },
+            null,
+            2,
+          ),
+        );
+      } catch (e) {
+        return fail(e);
+      }
+    },
+  });
+
   // ═══════════════════════════════════════════════════════
   //  TOOL: morpho_status
   // ═══════════════════════════════════════════════════════

package/test/kya.test.ts

@@ -0,0 +1,157 @@
+/**
+ * KYA gate feature — unit tests for plugin tools.
+ *
+ * Mocks MorphoClient so no blockchain connection is needed.
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+// ── Mock state ──
+
+const mockIsKyaRequired = vi.fn<() => Promise<boolean>>();
+const mockRegister = vi.fn();
+const mockGetBalances = vi.fn();
+const mockGetAgentId = vi.fn().mockReturnValue('12345');
+const mockGetAccountAddress = vi.fn().mockResolvedValue('0xAGENTACCOUNT');
+
+vi.mock('@agether/sdk', () => {
+  // MorphoClient must work with `new` — use a class
+  class MockMorphoClient {
+    isKyaRequired = mockIsKyaRequired;
+    register = mockRegister;
+    getBalances = mockGetBalances;
+    getAgentId = mockGetAgentId;
+    getAccountAddress = mockGetAccountAddress;
+  }
+  class MockX402Client {}
+  return {
+    MorphoClient: MockMorphoClient,
+    X402Client: MockX402Client,
+  };
+});
+
+// Suppress fs.readFileSync for persistAgentId
+vi.mock('fs', async (importOriginal) => {
+  const orig = await importOriginal<typeof import('fs')>();
+  return {
+    ...orig,
+    default: {
+      ...orig,
+      readFileSync: vi.fn().mockReturnValue('{}'),
+      writeFileSync: vi.fn(),
+    },
+    readFileSync: vi.fn().mockReturnValue('{}'),
+    writeFileSync: vi.fn(),
+  };
+});
+
+import registerPlugin from '../src/index';
+
+// ── Helpers ──
+
+/** Minimal mock for the OpenClaw plugin API */
+function createMockApi(config?: Record<string, any>) {
+  const tools = new Map<string, { execute: Function }>();
+  return {
+    config: {
+      plugins: {
+        entries: {
+          agether: {
+            config: {
+              privateKey: '0x' + 'ab'.repeat(32),
+              agentId: '12345',
+              rpcUrl: 'http://127.0.0.1:8545',
+              backendUrl: 'http://localhost:3001',
+              ...config,
+            },
+          },
+        },
+      },
+    },
+    registerTool(def: { name: string; execute: Function }) {
+      tools.set(def.name, def);
+    },
+    registerCommand() { /* noop */ },
+    getTool(name: string) {
+      return tools.get(name);
+    },
+  };
+}
+
+// ── Tests ──
+
+describe('agether_kya_status tool', () => {
+  let api: ReturnType<typeof createMockApi>;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    api = createMockApi();
+    registerPlugin(api);
+  });
+
+  it('returns DISABLED message when isKyaRequired = false', async () => {
+    mockIsKyaRequired.mockResolvedValue(false);
+
+    const tool = api.getTool('agether_kya_status')!;
+    const result = await tool.execute();
+
+    expect(result.content[0].text).toContain('DISABLED');
+    expect(result.isError).toBeUndefined();
+  });
+
+  it('returns ENABLED message when isKyaRequired = true', async () => {
+    mockIsKyaRequired.mockResolvedValue(true);
+
+    const tool = api.getTool('agether_kya_status')!;
+    const result = await tool.execute();
+
+    expect(result.content[0].text).toContain('ENABLED');
+    expect(result.isError).toBeUndefined();
+  });
+});
+
+describe('agether_register kyaMessage', () => {
+  let api: ReturnType<typeof createMockApi>;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    api = createMockApi();
+    registerPlugin(api);
+  });
+
+  it('includes "gate disabled" kyaMessage when kyaRequired = false', async () => {
+    mockRegister.mockResolvedValue({
+      agentId: '99999',
+      address: '0xWALLET',
+      agentAccount: '0xACCOUNT',
+      alreadyRegistered: false,
+      kyaRequired: false,
+      tx: '0xTXHASH',
+    });
+
+    const tool = api.getTool('agether_register')!;
+    const result = await tool.execute('test-id', { name: 'TestAgent' });
+    const data = JSON.parse(result.content[0].text);
+
+    expect(data.kyaRequired).toBe(false);
+    expect(data.kyaMessage).toContain('gate disabled');
+  });
+
+  it('includes "KYA required" kyaMessage when kyaRequired = true', async () => {
+    mockRegister.mockResolvedValue({
+      agentId: '99999',
+      address: '0xWALLET',
+      agentAccount: '0xACCOUNT',
+      alreadyRegistered: false,
+      kyaRequired: true,
+      tx: '0xTXHASH',
+    });
+
+    const tool = api.getTool('agether_register')!;
+    const result = await tool.execute('test-id', { name: 'TestAgent' });
+    const data = JSON.parse(result.content[0].text);
+
+    expect(data.kyaRequired).toBe(true);
+    expect(data.kyaMessage).toContain('KYA required');
+  });
+});

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    testTimeout: 10_000,
+  },
+});