@agether/agether 2.6.0 → 2.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agether/agether",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "OpenClaw plugin for Agether — onchain credit for AI agents on Ethereum & Base",
   "main": "src/index.ts",
   "openclaw": {

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

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);