@agether/agether 2.5.1 → 2.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agether/agether",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "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.7.0",
+    "@agether/sdk": "^2.8.0",
     "axios": "^1.6.0",
     "ethers": "^6.9.0"
   },

package/skills/agether/SKILL.md

@@ -1,6 +1,21 @@
 ---
 name: agether
-description: On-chain credit protocol for AI agents on Base. Morpho credit & lending, x402 payments, ERC-8004 identity.
+description: On-chain credit protocol for AI a## 🔗 CHAIN RESOLUTION (CRITICAL — HARD REQUIREMENT)
+
+All on-chain tools (register, borrow, deposit, withdraw, pay, etc.) will **FAIL with an error** if chain is not configured. You MUST call `agether_set_chain` FIRST.
+
+If `agether_health` returns `chain: "?"`, the chain is NOT configured:
+
+```
+1. Ask user: "Which blockchain would you like to use? **Ethereum** or **Base**?"
+2. User chooses a chain
+3. Call `agether_set_chain(chain: "<ethereum or base>")`
+4. After set → call `agether_health` to confirm everything is working on that chain
+```
+
+`agether_set_chain` saves the chain to config permanently (survives restarts). Accepts: `ethereum`, `eth`, `1`, `base`, `8453`.
+
+**IMPORTANT:** Resolve chain BEFORE doing ANYTHING else — including `agether_register`. The agent identity is chain-specific. If you skip this step, all write tools will return an error. Morpho credit & lending, x402 payments, ERC-8004 identity.
 ---
 
 # Agether — On-Chain Credit for AI Agents
@@ -430,23 +445,45 @@ Wallet transfers:
 
 ## 📍 CONTRACT ADDRESSES
 
-Contracts are deployed on both **Ethereum** and **Base** mainnets. The SDK auto-resolves the correct addresses based on the configured chain. Key shared addresses:
+Contracts are deployed on both **Ethereum** and **Base** mainnets. The SDK auto-resolves the correct addresses based on the configured chain.
+
+### Base (Chain ID 8453)
+
+| Contract | Address |
+|----------|---------|
+| Agether4337Factory | `0x8aeE4961EfaA4a1D36e2b24C5b430C8613fB5b8C` |
+| Agether8004ValidationModule | `0x7B18a7E3D5B3d043FC3525Efcd9a2bB1aE1369Ab` |
+| AgetherHookMultiplexer | `0x2D98eff4b959F3dc76f14c5682A8546438406c4A` |
+| Agether7579Bootstrap | `0x5e8e4644c628CB464936981e338635476d012B5F` |
+| Agether8004Scorer | `0xA1a0B09147688a09A3027F960623Ae16d1ca7F69` |
+| TimelockController | `0x7f104DBe209E2a05FFc1700b27eaE1C397f011c4` |
+| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
+| WETH | `0x4200000000000000000000000000000000000006` |
+| wstETH | `0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452` |
+| cbETH | `0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22` |
+
+### Ethereum (Chain ID 1)
+
+| Contract | Address |
+|----------|---------|
+| Agether4337Factory | `0xE350660Ab3EA87b50233854eacCC6328e268fb48` |
+| Agether8004ValidationModule | `0x87Aa07Be4Ab4A2e8EeBf4a4e2451c775D0e3fbf1` |
+| AgetherHookMultiplexer | `0xC0b96e36B20d6689F4E4b8C7A0c19C28e8B45B8B` |
+| Agether7579Bootstrap | `0xD1268B50149e468591Bcba5f6fD3E87b49D43008` |
+| Agether8004Scorer | `0xd281a8ec667E406Fcf1097A64A65d1C88Fb0F7Fa` |
+| TimelockController | `0x2033CD354aAf19191F23211c6A6974fCE038AFBe` |
+| USDC | `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` |
+| WETH | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` |
+| wstETH | `0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0` |
+| cbETH | `0xBe9895146f7AF43049ca1c1AE358B0541Ea49704` |
+
+### Cross-chain (same address on both networks)
 
 | Contract | Address |
 |----------|---------|
-| Agether4337Factory | `0x67DE66D07ff3dba0092C21f070f8a0f53D657BC3` |
-| Agether8004ValidationModule | `0xde896C58163b5f6cAC5B16C1b0109843f26106F6` |
-| AgetherHookMultiplexer | `0x4AB6DaD0f7360fa8d8c75889A5c206B65d7CbeDb` |
-| Agether7579Bootstrap | `0xCc83AA714c05B7141B21a17e80EB21bD09652b27` |
-| Agether8004Scorer | `0x56c7D35A976fac67b1993b66b861fCA32f59104F` |
-| TimelockController | `0xc600e7AAB8a230326C714CE66f356fdf6aC021d8` |
 | Safe Singleton | `0x41675C099F32341bf84BFc5382aF534df5C7461a` |
 | SafeProxyFactory | `0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67` |
 | Safe7579 | `0x7579EE8307284F293B1927136486880611F20002` |
 | EntryPoint v0.7 | `0x0000000071727De22E5E9d8BAf0edAc6f37da032` |
 | ERC-8004 Identity | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |
 | Morpho Blue | `0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb` |
-| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
-| WETH | `0x4200000000000000000000000000000000000006` |
-| wstETH | `0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452` |
-| cbETH | `0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22` |

package/src/index.ts

@@ -175,6 +175,20 @@ function getConfig(api: any): PluginConfig {
 let cachedAgentId: string | undefined;
 let activeChainId: ChainId = ChainId.Ethereum;
 
+/**
+ * Hard guardrail: refuse to proceed if chain was never explicitly configured.
+ * Prevents silent default-to-Ethereum when user hasn't chosen a chain.
+ * Throws an error that the LLM sees, forcing it to call agether_set_chain first.
+ */
+function requireChain(cfg: PluginConfig): void {
+  if (!cfg.chainConfigured) {
+    throw new Error(
+      "Chain not configured. Ask the user which chain to use (Ethereum or Base), " +
+      "then call agether_set_chain before proceeding."
+    );
+  }
+}
+
 function createClient(cfg: PluginConfig): MorphoClient {
   const agentId = cachedAgentId || cfg.agentId;
   return new MorphoClient({
@@ -258,7 +272,8 @@ export default function register(api: any) {
   api.registerTool({
     name: "agether_register",
     description:
-      "Register a new ERC-8004 agent identity and create a Safe smart account (via Safe7579). Returns the new agentId.",
+      "Register a new ERC-8004 agent identity and create a Safe smart account (via Safe7579). " +
+      "REQUIRES chain to be configured first — call agether_set_chain before this tool. Returns the new agentId.",
     parameters: {
       type: "object",
       properties: {
@@ -269,6 +284,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { name: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.register(params.name);
         const persistStatus = persistAgentId(result.agentId);
@@ -417,6 +433,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { registryAddress: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
 
         // Build the calldata for ERC8004ValidationModule.setValidationRegistry — the owner (Timelock) must execute it
@@ -526,6 +543,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string; token: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.supplyCollateral(params.token, params.amount);
         return ok(JSON.stringify({
@@ -558,6 +576,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { collateralAmount: string; token: string; borrowAmount: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.depositAndBorrow(
           params.token,
@@ -597,6 +616,7 @@ export default function register(api: any) {
       try {
         if (!params.agentId && !params.agentAddress) return fail("Provide either agentId or agentAddress");
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
 
         const target = params.agentId
@@ -634,6 +654,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string; token?: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.borrow(params.amount, params.token);
         return ok(JSON.stringify({
@@ -666,6 +687,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string; token?: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.repay(params.amount, params.token);
         return ok(JSON.stringify({
@@ -699,6 +721,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string; token: string; toEoa?: boolean }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         // Default: keep in AgentAccount. toEoa=true → send to EOA.
         const receiver = params.toEoa ? await client.getSignerAddress() : await client.getAccountAddress();
@@ -739,6 +762,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string; market?: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.supplyAsset(params.amount, params.market);
         return ok(JSON.stringify({
@@ -831,6 +855,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string; market?: string; toEoa?: boolean }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         // Default: keep in AgentAccount. toEoa=true → send to EOA.
         const receiver = params.toEoa ? await client.getSignerAddress() : await client.getAccountAddress();
@@ -903,6 +928,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { refresh?: boolean }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const agentId = client.getAgentId();
 
@@ -952,6 +978,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.fundAccount(params.amount);
         return ok(JSON.stringify({
@@ -984,6 +1011,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { token: string; amount: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.withdrawToken(params.token, params.amount);
         return ok(JSON.stringify({
@@ -1015,6 +1043,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { amount: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const client = createClient(cfg);
         const result = await client.withdrawEth(params.amount);
         return ok(JSON.stringify({
@@ -1049,6 +1078,7 @@ export default function register(api: any) {
     async execute(_id: string, params: { url: string; method?: string; body?: string }) {
       try {
         const cfg = getConfig(api);
+        requireChain(cfg);
         const agetherCfg = api.config?.plugins?.entries?.agether?.config || {};
         const client = createClient(cfg);