@agether/agether 1.4.2 → 1.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @agether/agether
 
-OpenClaw plugin for **Agether** — on-chain credit protocol for AI agents on Base.
+OpenClaw plugin for **Agether** — onchain credit protocol for AI agents on Base.
 
 ## Prerequisites
 

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "agether",
   "name": "Agether Credit",
-  "description": "On-chain credit protocol for AI agents — Morpho-backed overcollateralized credit, ERC-8004 identity, x402 payments",
+  "description": "Onchain credit protocol for AI agents — Morpho-backed overcollateralized credit, ERC-8004 identity, x402 payments",
   "version": "1.2.0",
   "skills": ["skills/agether"],
   "configSchema": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agether/agether",
-  "version": "1.4.2",
-  "description": "OpenClaw plugin for Agether — on-chain credit for AI agents",
+  "version": "1.5.0",
+  "description": "OpenClaw plugin for Agether — onchain credit for AI agents",
   "main": "src/index.ts",
   "openclaw": {
     "extensions": [
@@ -9,7 +9,7 @@
     ]
   },
   "dependencies": {
-    "@agether/sdk": "^1.11.2",
+    "@agether/sdk": "^2.1.0",
     "axios": "^1.6.0",
     "ethers": "^6.9.0"
   },

package/skills/agether/SKILL.md

@@ -33,7 +33,7 @@ If you don't paste it, the user sees NOTHING. An empty colon ":" with no data af
 8. **When user says "register" → ALWAYS call `agether_register`.** A wallet CAN have multiple ERC-8004 identities. The tool handles everything. Never refuse to register because the wallet "already has an identity". Just call the tool.
 9. **Never guess about blockchain state.** If you're unsure, call the tool. Don't tell the user something is impossible — try it first.
 10. **Your EOA wallet IS the user's wallet.** Same private key, same address. If the user says "I have WETH", call `agether_balance` — you'll see it in the `collateral` field. You already have access to those tokens.
-11. **`morpho_deposit` and `morpho_deposit_and_borrow` transfer collateral from your EOA automatically.** You do NOT need anyone to "send you" tokens. If your EOA has WETH, just call the deposit tool directly. The SDK handles EOA→AgentAccount→Morpho in one flow.
+11. **`morpho_deposit` and `morpho_deposit_and_borrow` transfer collateral from your EOA automatically.** You do NOT need anyone to "send you" tokens. If your EOA has WETH, just call the deposit tool directly. The SDK handles EOA→Safe account→Morpho in one flow.
 12. **To get USDC for x402:** call `morpho_deposit_and_borrow` with collateral from your EOA. Do NOT ask the user to send tokens — check your balance first.
 
 ---
@@ -62,11 +62,11 @@ Both `agether_set_agent` and `agether_register` save the agentId to config perma
 ### Identity & Wallet
 | Tool | What it does |
 |------|-------------|
-| `agether_balance` | Show ETH + USDC + collateral (WETH/wstETH/cbETH) balances for both EOA wallet and AgentAccount |
-| `agether_register` | Register on-chain: mints ERC-8004 identity NFT + creates AgentAccount. Auto-saves agentId to config. |
+| `agether_balance` | Show ETH + USDC + collateral (WETH/wstETH/cbETH) balances for both EOA wallet and Safe account |
+| `agether_register` | Register on-chain: mints ERC-8004 identity NFT + creates Safe account (via Safe7579). Auto-saves agentId to config. |
 | `agether_set_agent` | Set a known agentId (e.g. from memory) and save to config. Use when agentId is "?" but you remember it. |
 | `agether_score` | Get credit score. `refresh: false` = free read. `refresh: true` = pays x402, computes fresh score on-chain. **Always call this when user asks about score.** |
-| `wallet_fund` | Transfer USDC from EOA wallet → AgentAccount |
+| `wallet_fund` | Transfer USDC from EOA wallet → Safe account |
 
 ### Morpho Credit (Overcollateralized — instant, no approval)
 | Tool | Params | What it does |
@@ -75,8 +75,8 @@ Both `agether_set_agent` and `agether_register` save the agentId to config perma
 | `morpho_status` | none | Show all Morpho positions (collateral + debt) |
 | `morpho_deposit` | `amount`, `token` | Deposit collateral from EOA → Morpho (no borrow) |
 | `morpho_deposit_and_borrow` | `collateralAmount`, `token`, `borrowAmount` | Deposit + borrow in one flow. **Best for first-time setup** |
-| `morpho_borrow` | `amount` (USD) | Borrow USDC against existing collateral → lands in AgentAccount |
-| `morpho_repay` | `amount` (USD) | Repay USDC debt from AgentAccount → Morpho |
+| `morpho_borrow` | `amount` (USD) | Borrow USDC against existing collateral → lands in Safe account |
+| `morpho_repay` | `amount` (USD) | Repay USDC debt from Safe account → Morpho |
 | `morpho_withdraw` | `amount` (or "all"), `token` | Withdraw collateral back to EOA wallet |
 | `morpho_sponsor` | `agentId`/`agentAddress`, `amount`, `token`, `borrow?` | Deposit collateral for another agent |
 
@@ -97,8 +97,8 @@ Both `agether_set_agent` and `agether_register` save the agentId to config perma
 
 ### User asks to call a paid API (x402)
 ```
-1. agether_balance → check USDC in AgentAccount AND collateral on EOA
-2. IF AgentAccount has USDC ≥ $0.01:
+1. agether_balance → check USDC in Safe account AND collateral on EOA
+2. IF Safe account has USDC ≥ $0.01:
      → x402_pay(url)
 3. IF no USDC but has collateral deposited in Morpho:
      → morpho_borrow(amount: "1")    ← borrow $1
@@ -203,7 +203,7 @@ If something **fails**:
 | `Payment rejected (402)` | No USDC for x402 payment | Borrow USDC first: `morpho_borrow` or `morpho_deposit_and_borrow` |
 | `No collateral deposited` | Trying to borrow without collateral | `morpho_deposit` first |
 | `Insufficient WETH/wstETH/cbETH` | EOA doesn't have enough collateral | Tell user to send collateral to EOA address |
-| `Insufficient USDC in AgentAccount` | Not enough USDC for repay | Need to fund AgentAccount or borrow more |
+| `Insufficient USDC in AgentAccount` | Not enough USDC for repay | Need to fund Safe account or borrow more |
 | `ExecutionFailed` | Smart contract call reverted | Check inner error, usually LTV or approval issue |
 
 ---
@@ -213,14 +213,15 @@ If something **fails**:
 ```
 EOA Wallet (private key)
   ├── Owns ERC-8004 Identity NFT (agentId)  ← can own MULTIPLE
-  └── Owns AgentAccount (smart wallet, 1 per agentId)
+  └── Owns Safe Account (via Safe7579 + ERC-4337, 1 per agentId)
         ├── Holds USDC (from borrows)
-        └── Executes Morpho Blue operations via executeBatch()
+        ├── ERC8004ValidationModule validates ownership + KYA gate
+        └── Executes Morpho Blue operations via ERC-4337 UserOps through EntryPoint
 
 Morpho Blue (direct lending, overcollateralized 125%)
   ├── supplyCollateral() → collateral into Morpho Blue market
-  ├── borrow()           → USDC from Morpho Blue → AgentAccount
-  ├── repay()            → USDC from AgentAccount → Morpho Blue
+  ├── borrow()           → USDC from Morpho Blue → Safe Account
+  ├── repay()            → USDC from Safe Account → Morpho Blue
   └── withdrawCollateral() → collateral back to EOA
 ```
 
@@ -230,10 +231,17 @@ Morpho Blue (direct lending, overcollateralized 125%)
 
 | Contract | Address |
 |----------|---------|
-| AccountFactory | `0x89a8758E60A56EcB47247D92E05447eFd450d6Bf` |
-| KYAHook | `0x28e50Aa9eD517E369b2806928709B44062aD9821` |
-| ValidationRegistry | `0x6f76cF69B71Dc5F9A414BCEe4583b12738E47985` |
-| AgentReputation | `0xe88f3419a2dbac70e3aF6E487b0C63e8301C6A87` |
+| Agether4337Factory | `0x7B23470dCD65b8fEA3Bf49466860b3A55D56268C` |
+| Agether8004ValidationModule | `0xfC6ccFd12e163460C7Ef92d38DC0be6C6cA10f6C` |
+| AgetherHookMultiplexer | `0x094FE93a8b733a97a6945530cA83058CaCbf5278` |
+| Agether7579Bootstrap | `0x62d34D22D379367EEDcb7D1E4dE899A654E982D0` |
+| ValidationRegistry | Not deployed yet |
+| Agether8004Scorer | `0x9f0084E5c941365149c8953133cF062E33a19b8d` |
+| TimelockController | `0x2807912DA2a7278AF883a376bE15bBBf3ab99f52` |
+| Safe Singleton | `0x41675C099F32341bf84BFc5382aF534df5C7461a` |
+| SafeProxyFactory | `0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67` |
+| Safe7579 | `0x7579EE8307284F293B1927136486880611F20002` |
+| EntryPoint v0.7 | `0x0000000071727De22E5E9d8BAf0edAc6f37da032` |
 | ERC-8004 Identity | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |
 | Morpho Blue | `0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb` |
 | USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |

package/src/index.ts

@@ -115,7 +115,7 @@ export default function register(api: any) {
   api.registerTool({
     name: "agether_register",
     description:
-      "Register a new ERC-8004 agent identity on Base and create an AgentAccount. Returns the new agentId.",
+      "Register a new ERC-8004 agent identity on Base and create a Safe smart account (via Safe7579). Returns the new agentId.",
     parameters: {
       type: "object",
       properties: {
@@ -164,7 +164,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { agentId: string }) {
       try {
         const cfg = getConfig(api);
-        // Verify on-chain that this agentId exists and belongs to this wallet
+        // Verify onchain that this agentId exists and belongs to this wallet
         const client = new MorphoClient({
           privateKey: cfg.privateKey,
           rpcUrl: cfg.rpcUrl,
@@ -210,9 +210,9 @@ export default function register(api: any) {
   api.registerTool({
     name: "agether_set_kya",
     description:
-      "Enable or disable KYA verification gate on the KYAHook (owner only). " +
+      "Enable or disable KYA verification gate on the ERC8004ValidationModule (owner only). " +
       "Pass the ValidationRegistry address to enable, or '0x0000000000000000000000000000000000000000' to disable. " +
-      "Note: the actual transaction must be executed by the owner (TimelockController) targeting the KYAHook contract.",
+      "Note: the actual transaction must be executed by the owner (TimelockController) targeting the ERC8004ValidationModule.",
     parameters: {
       type: "object",
       properties: {
@@ -229,7 +229,7 @@ export default function register(api: any) {
         const cfg = getConfig(api);
         const client = createClient(cfg);
 
-        // Build the calldata for KYAHook.setValidationRegistry — the owner (Timelock) must execute it
+        // Build the calldata for ERC8004ValidationModule.setValidationRegistry — the owner (Timelock) must execute it
         const { ethers } = await import("ethers");
         const iface = new ethers.Interface([
           "function setValidationRegistry(address newRegistry)",
@@ -247,12 +247,12 @@ export default function register(api: any) {
             {
               action: `${action} KYA gate`,
               registryAddress: params.registryAddress,
-              target: "KYAHook contract (not AccountFactory)",
+              target: "ERC8004ValidationModule contract",
               calldata,
               note:
                 "This calldata must be submitted to the TimelockController by the owner. " +
-                "Schedule via timelock.schedule(kyaHookAddr, 0, calldata, predecessor, salt, delay). " +
-                "The target is the KYAHook contract, NOT the AccountFactory.",
+                "Schedule via timelock.schedule(validationModuleAddr, 0, calldata, predecessor, salt, delay). " +
+                "The target is the ERC8004ValidationModule contract.",
             },
             null,
             2,
@@ -522,7 +522,7 @@ export default function register(api: any) {
   api.registerTool({
     name: "agether_score",
     description:
-      "Get the agent's current on-chain credit score. " +
+      "Get the agent's current onchain credit score. " +
       "Use 'refresh' param to request a fresh score computation (costs USDC via x402).",
     parameters: {
       type: "object",
@@ -552,7 +552,7 @@ export default function register(api: any) {
           return ok(JSON.stringify(result.data, null, 2));
         }
 
-        // Free: read current on-chain score
+        // Free: read current onchain score
         const { data } = await axios.get(`${cfg.backendUrl}/score/${agentId}/current`);
         return ok(JSON.stringify(data, null, 2));
       } catch (e) { return fail(e); }