@agether/agether 2.12.2 → 2.13.0

package/README.md

@@ -115,7 +115,9 @@ Once installed, the following tools are available to your AI agent:
 | `morpho_repay` | Repay USDC debt |
 | `morpho_withdraw` | Withdraw collateral back to EOA |
 | `morpho_sponsor` | Deposit collateral for another agent (by ID or address) |
-| `wallet_fund` | Transfer USDC from EOA into AgentAccount |
+| `wallet_fund_token` | Transfer any ERC-20 from EOA into AgentAccount |
+| `wallet_transfer` | Transfer any token/ETH from AgentAccount to any address or agent |
+| `wallet_approve` | Approve a spender for tokens in AgentAccount |
 | `x402_pay` | Make paid API calls via x402 protocol (supports auto-draw) |
 
 ## Slash Commands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agether/agether",
-  "version": "2.12.2",
+  "version": "2.13.0",
   "description": "OpenClaw plugin for Agether — onchain credit for AI agents on Ethereum & Base",
   "main": "src/index.ts",
   "openclaw": {
@@ -9,7 +9,7 @@
     ]
   },
   "dependencies": {
-    "@agether/sdk": "^2.14.0",
+    "@agether/sdk": "^2.15.0",
     "axios": "^1.6.0",
     "ethers": "^6.9.0"
   },

package/skills/agether/SKILL.md

@@ -127,7 +127,7 @@ Both `agether_set_agent` and `agether_register` save the agentId to config perma
 ### Wallet (move funds between EOA ↔ AgentAccount)
 | Tool | Params | What it does |
 |------|--------|-------------|
-| `wallet_fund` | `amount` | Transfer USDC from EOA → AgentAccount |
+| `wallet_fund_token` | `token`, `amount` | Transfer any ERC-20 token from EOA → AgentAccount |
 | `wallet_withdraw_token` | `token`, `amount` | Withdraw any ERC-20 token from AgentAccount → EOA. Use `amount: "all"` for full balance. |
 | `wallet_withdraw_eth` | `amount` | Withdraw ETH from AgentAccount → EOA. Use `amount: "all"` for full balance. |
 
@@ -251,7 +251,7 @@ IF no auto-funding configured:
 ```
 1. Check token availability:
    - agether_health for AgentAccount balances
-   - If no tokens in AgentAccount but exists in EOA → wallet_fund first
+   - If no tokens in AgentAccount but exists in EOA → wallet_fund_token first
 2. morpho_markets                ← show supply APYs to pick best market
 3. morpho_supply(amount, market?, loanToken?) ← supply tokens to earn yield
 4. Later: morpho_supply_status   ← check earned yield
@@ -450,7 +450,7 @@ If something **fails**:
 | `Payment rejected (402)` | No USDC for x402 payment | Borrow USDC first, or enable autoDraw/autoYield in config |
 | `No collateral deposited` | Trying to borrow without collateral | `morpho_deposit` first |
 | `Insufficient collateral` | EOA doesn't have enough of that token | Tell user to send collateral to EOA address |
-| `Insufficient USDC in AgentAccount` | Not enough loan token for repay/pay | Fund via borrow, yield withdrawal, or `wallet_fund` |
+| `Insufficient USDC in AgentAccount` | Not enough loan token for repay/pay | Fund via borrow, yield withdrawal, or `wallet_fund_token` |
 | `ExecutionFailed` | Smart contract call reverted | Check inner error, usually LTV or approval issue |
 | `PositionNotActive` | No collateral deposited for this token | Deposit collateral with `morpho_deposit` first |
 
@@ -494,7 +494,9 @@ Morpho Blue (direct lending, overcollateralized 125%)
         └── Yield tracked via Morpho GraphQL API (no database needed)
 
 Wallet transfers:
-  ├── wallet_fund           → USDC from EOA → AgentAccount
+  ├── wallet_fund_token     → any ERC-20 from EOA → AgentAccount
+  ├── wallet_transfer       → any ERC-20 or ETH from AgentAccount → any address/agent
+  ├── wallet_approve        → approve spender for tokens in AgentAccount
   ├── wallet_withdraw_token → any ERC-20 from AgentAccount → EOA
   └── wallet_withdraw_eth   → ETH from AgentAccount → EOA
 ```

package/src/index.ts

@@ -1180,34 +1180,6 @@ export default function register(api: any) {
     },
   });
 
-  // ═══════════════════════════════════════════════════════
-  //  TOOL: wallet_fund
-  // ═══════════════════════════════════════════════════════
-  api.registerTool({
-    name: "wallet_fund",
-    description: "Transfer USDC from EOA wallet into AgentAccount.",
-    parameters: {
-      type: "object",
-      properties: {
-        amount: { type: "string", description: "USDC amount (e.g. '50')" },
-      },
-      required: ["amount"],
-    },
-    async execute(_id: string, params: { amount: string }) {
-      try {
-        const cfg = getConfig(api);
-        requireChain(cfg);
-        const client = createAgetherClient(cfg);
-        const result = await client.fundAccount(params.amount);
-        return ok(JSON.stringify({
-          status: "funded",
-          amount: `$${params.amount}`,
-          tx: txLink(result.txHash),
-        }));
-      } catch (e) { return fail(e); }
-    },
-  });
-
   // ═══════════════════════════════════════════════════════
   //  TOOL: wallet_withdraw_token
   // ═══════════════════════════════════════════════════════
@@ -1274,6 +1246,126 @@ export default function register(api: any) {
     },
   });
 
+  // ═══════════════════════════════════════════════════════
+  //  TOOL: wallet_fund_token
+  // ═══════════════════════════════════════════════════════
+  api.registerTool({
+    name: "wallet_fund_token",
+    description:
+      "Transfer any ERC-20 token from EOA wallet into AgentAccount. " +
+      "Works with USDC, WETH, wstETH, cbBTC, or any token supported by Morpho markets.",
+    parameters: {
+      type: "object",
+      properties: {
+        token: { type: "string", description: "Token to transfer (e.g. 'USDC', 'WETH')" },
+        amount: { type: "string", description: "Amount to transfer (e.g. '100')" },
+      },
+      required: ["token", "amount"],
+    },
+    async execute(_id: string, params: { token: string; amount: string }) {
+      try {
+        const cfg = getConfig(api);
+        requireChain(cfg);
+        const client = createAgetherClient(cfg);
+        const result = await client.fundAccountToken(params.token, params.amount);
+        return ok(JSON.stringify({
+          status: "funded",
+          amount: `${params.amount} ${params.token}`,
+          tx: txLink(result.txHash),
+        }));
+      } catch (e) { return fail(e); }
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════
+  //  TOOL: wallet_transfer
+  // ═══════════════════════════════════════════════════════
+  api.registerTool({
+    name: "wallet_transfer",
+    description:
+      "Transfer any ERC-20 token or ETH from AgentAccount to any address or agent. " +
+      "Specify either 'address' (0x...) or 'agentId' as destination. " +
+      "Set token to 'ETH' for native ETH transfers. Use amount 'all' to send full balance.",
+    parameters: {
+      type: "object",
+      properties: {
+        token: { type: "string", description: "Token to send (e.g. 'USDC', 'WETH', 'ETH')" },
+        amount: { type: "string", description: "Amount to send (e.g. '100' or 'all')" },
+        address: { type: "string", description: "Destination address (0x...)" },
+        agentId: { type: "string", description: "Destination agent ID" },
+      },
+      required: ["token", "amount"],
+    },
+    async execute(_id: string, params: { token: string; amount: string; address?: string; agentId?: string }) {
+      try {
+        const cfg = getConfig(api);
+        requireChain(cfg);
+        const client = createAgetherClient(cfg);
+
+        if (!params.address && !params.agentId) {
+          return fail(new Error("Provide either 'address' or 'agentId' as destination"));
+        }
+        const to = params.address ? { address: params.address } : { agentId: params.agentId };
+
+        let result;
+        if (params.token.toUpperCase() === 'ETH') {
+          result = await client.transferEth(params.amount, to);
+        } else {
+          result = await client.transferToken(params.token, params.amount, to);
+        }
+
+        return ok(JSON.stringify({
+          status: "transferred",
+          amount: `${result.amount} ${result.token}`,
+          destination: result.destination,
+          tx: txLink(result.tx),
+        }));
+      } catch (e) { return fail(e); }
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════
+  //  TOOL: wallet_approve
+  // ═══════════════════════════════════════════════════════
+  api.registerTool({
+    name: "wallet_approve",
+    description:
+      "Approve a spender (address or agent) to use ERC-20 tokens from AgentAccount. " +
+      "Specify either 'address' (0x...) or 'agentId' as spender. " +
+      "Use amount 'max' for unlimited approval.",
+    parameters: {
+      type: "object",
+      properties: {
+        token: { type: "string", description: "Token to approve (e.g. 'USDC', 'WETH')" },
+        amount: { type: "string", description: "Allowance amount (e.g. '1000' or 'max')" },
+        address: { type: "string", description: "Spender address (0x...)" },
+        agentId: { type: "string", description: "Spender agent ID" },
+      },
+      required: ["token", "amount"],
+    },
+    async execute(_id: string, params: { token: string; amount: string; address?: string; agentId?: string }) {
+      try {
+        const cfg = getConfig(api);
+        requireChain(cfg);
+        const client = createAgetherClient(cfg);
+
+        if (!params.address && !params.agentId) {
+          return fail(new Error("Provide either 'address' or 'agentId' as spender"));
+        }
+        const spender = params.address ? { address: params.address } : { agentId: params.agentId };
+
+        const result = await client.approveToken(params.token, params.amount, spender);
+        return ok(JSON.stringify({
+          status: "approved",
+          token: result.token,
+          amount: result.amount,
+          spender: result.spender,
+          tx: txLink(result.tx),
+        }));
+      } catch (e) { return fail(e); }
+    },
+  });
+
   // ═══════════════════════════════════════════════════════
   //  TOOL: x402_pay (with auto-yield + auto-draw waterfall)
   // ═══════════════════════════════════════════════════════
@@ -1568,7 +1660,7 @@ export default function register(api: any) {
         if (safeUsdc > 0) {
           checks.push({ check: "USDC (AgentAccount)", status: `✅ $${safeUsdc.toFixed(2)}` });
         } else if (eoaUsdc > 0) {
-          checks.push({ check: "USDC", status: `⚠️ $${eoaUsdc.toFixed(2)} in EOA only`, detail: "Use wallet_fund or morpho_deposit_and_borrow to get USDC into AgentAccount" });
+          checks.push({ check: "USDC", status: `⚠️ $${eoaUsdc.toFixed(2)} in EOA only`, detail: "Use wallet_fund_token or morpho_deposit_and_borrow to get USDC into AgentAccount" });
         } else {
           checks.push({ check: "USDC", status: "❌ no USDC anywhere", detail: "Deposit collateral and borrow, or send USDC to EOA" });
         }