@agentwallex/openclaw 0.0.2 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @agentwallex/openclaw
 
-OpenClaw plugin for [AgentWallex](https://agentwallex.com) — gives AI agents the ability to send USDC payments, check balances, and query transactions.
+OpenClaw plugin for [AgentWallex](https://agentwallex.com) — gives AI agents the ability to manage agents, send USDC payments, check balances, and query transactions.
 
 ## Quick Start
 
@@ -38,6 +38,38 @@ Your agent now has payment tools available. Just ask naturally:
 "What's the status of transaction tx-abc123?"
 ```
 
+## Upgrade
+
+Update to the latest version:
+
+```bash
+openclaw plugins update agentwallex-payment
+```
+
+Or update all plugins at once:
+
+```bash
+openclaw plugins update --all
+```
+
+## Uninstall
+
+```bash
+openclaw plugins uninstall agentwallex-payment
+```
+
+To keep plugin files on disk:
+
+```bash
+openclaw plugins uninstall agentwallex-payment --keep-files
+```
+
+To also remove locally stored credentials:
+
+```bash
+rm -rf ~/.openclaw/agentwallex
+```
+
 ## Available Tools
 
 | Tool | Description |
@@ -46,10 +78,14 @@ Your agent now has payment tools available. Just ask naturally:
 | `agentwallex_configure` | Validate and save API credentials |
 | `agentwallex_create_agent` | Create a new AI agent with its own wallet |
 | `agentwallex_list_agents` | List all agents and their status |
+| `agentwallex_update_agent` | Update an agent's name or description |
+| `agentwallex_delete_agent` | Delete an agent |
+| `agentwallex_agent_status` | Update agent status (active / suspended) |
 | `agentwallex_create_wallet` | Get or create a deposit address for the agent |
+| `agentwallex_check_balance` | Check the agent's USDC balances (per chain) |
 | `agentwallex_pay` | Send a USDC payment to a recipient address |
-| `agentwallex_check_balance` | Check the agent's USDC balance |
 | `agentwallex_tx_status` | Query the status of a transaction |
+| `agentwallex_list_transactions` | List transactions with filtering |
 
 ## Usage Examples
 
@@ -103,6 +139,32 @@ Agent: Transaction tx-a1b2c3d4:
        Confirmed at: 2025-03-06T12:34:56Z
 ```
 
+### Update an Agent
+
+```
+You: Rename agent agent-a1b2c3d4 to "upgraded-bot"
+Agent: Agent updated successfully.
+       Agent ID: agent-a1b2c3d4
+       Name: upgraded-bot
+       Status: active
+```
+
+### Suspend / Activate an Agent
+
+```
+You: Suspend agent agent-a1b2c3d4
+Agent: Agent status updated.
+       Agent ID: agent-a1b2c3d4
+       Status: suspended
+```
+
+### Delete an Agent
+
+```
+You: Delete agent agent-e5f6
+Agent: Agent agent-e5f6 has been deleted.
+```
+
 ### Create a Wallet
 
 ```
@@ -112,6 +174,15 @@ Agent: Wallet created on base-sepolia.
        You can deposit testnet USDC to this address.
 ```
 
+### List Transactions
+
+```
+You: Show me my recent confirmed transactions
+Agent: You have 2 confirmed transactions:
+       1. tx-a1b2 — outbound — 10.00 USDC — confirmed
+       2. tx-c3d4 — inbound — 25.00 USDC — confirmed
+```
+
 ### Multi-step Workflow
 
 ```
@@ -139,14 +210,37 @@ Agent: I checked your balance first — you only have 150.00 USDC available,
 If you want to use the tool functions directly in code (without OpenClaw):
 
 ```typescript
-import { AgentWallex, checkBalance, pay } from '@agentwallex/openclaw';
+import {
+  AgentWallex,
+  createAgent, listAgents, updateAgent, deleteAgent, agentStatus,
+  createWallet, checkBalance, pay, txStatus, listTransactions,
+} from '@agentwallex/openclaw';
 
 const client = new AgentWallex({ apiKey: 'awx_...' });
 const agentId = 'your-agent-id';
 
-// Check balance
-const balance = await checkBalance(client, agentId, { chain: 'base' });
-console.log(balance.available); // "100.50"
+// Create an agent
+const agent = await createAgent(client, { agent_name: 'bot', chain: 'base' });
+
+// List agents
+const agents = await listAgents(client, { status: 'active' });
+
+// Update an agent
+const updated = await updateAgent(client, { agent_id: agentId, agent_name: 'new-name' });
+
+// Change agent status
+await agentStatus(client, { agent_id: agentId, status: 'suspended' });
+
+// Delete an agent
+await deleteAgent(client, { agent_id: 'agent-to-delete' });
+
+// Get deposit address
+const wallet = await createWallet(client, agentId, { chain: 'base' });
+console.log(wallet.address);
+
+// Check balance (returns one entry per chain)
+const result = await checkBalance(client, agentId, { chain: 'base' });
+console.log(result.balances[0].available); // "100.50"
 
 // Send payment
 const tx = await pay(client, agentId, {
@@ -154,6 +248,12 @@ const tx = await pay(client, agentId, {
   amount: '10.00',
 });
 console.log(tx.transaction_id); // "tx-abc123"
+
+// Check transaction status
+const status = await txStatus(client, agentId, { transaction_id: tx.transaction_id });
+
+// List transactions
+const txns = await listTransactions(client, { agent_id: agentId, status: 'confirmed' });
 ```
 
 ### Install as npm dependency
@@ -171,7 +271,10 @@ pnpm add @agentwallex/openclaw
 import register from '@agentwallex/openclaw';
 
 // Tool functions (for direct use)
-import { createAgent, listAgents, createWallet, pay, checkBalance, txStatus } from '@agentwallex/openclaw';
+import {
+  createAgent, listAgents, updateAgent, deleteAgent, agentStatus,
+  createWallet, pay, checkBalance, txStatus, listTransactions,
+} from '@agentwallex/openclaw';
 
 // Static tool schema (for custom integrations)
 import { openClawToolSchema } from '@agentwallex/openclaw';

package/dist/index.cjs

@@ -39,10 +39,39 @@ async function listAgents(client, input = {}) {
   };
 }
 
+// src/tools/update-agent.ts
+async function updateAgent(client, input) {
+  const agent = await client.agents.update(input.agent_id, {
+    agent_name: input.agent_name,
+    agent_description: input.agent_description
+  });
+  return {
+    agent_id: agent.agent_id,
+    agent_name: agent.agent_name,
+    chain: agent.chain,
+    status: agent.status
+  };
+}
+
+// src/tools/delete-agent.ts
+async function deleteAgent(client, input) {
+  await client.agents.delete(input.agent_id);
+}
+
+// src/tools/agent-status.ts
+async function agentStatus(client, input) {
+  const agent = await client.agents.updateStatus(input.agent_id, {
+    status: input.status
+  });
+  return {
+    agent_id: agent.agent_id,
+    status: agent.status
+  };
+}
+
 // src/tools/create-wallet.ts
 async function createWallet(client, agentId, input = {}) {
-  const result = await client.wallets.getDepositAddress({
-    agent_id: agentId,
+  const result = await client.agents.getDepositAddress(agentId, {
     chain: input.chain
   });
   return {
@@ -54,41 +83,32 @@ async function createWallet(client, agentId, input = {}) {
 
 // src/tools/pay.ts
 async function pay(client, agentId, input) {
-  const wallet = await client.wallets.getDepositAddress({
-    agent_id: agentId,
-    chain: input.chain
-  });
-  const tx = await client.transactions.create({
-    agent_id: agentId,
-    direction: "outbound",
-    type: "payment",
-    from_address: wallet.address,
-    to_address: input.to,
+  const result = await client.agents.withdraw(agentId, {
     amount: input.amount,
-    token: input.token ?? "USDC",
-    chain: input.chain ?? wallet.chain,
-    memo: input.memo
+    to_address: input.to,
+    chain: input.chain
   });
   return {
-    transaction_id: tx.transaction_id,
-    tx_hash: tx.tx_hash ?? void 0,
-    status: tx.status
+    transaction_id: result.ledger_id,
+    tx_hash: result.tx_hash || void 0,
+    status: result.status
   };
 }
 
 // src/tools/check-balance.ts
-async function checkBalance(client, agentId, input = {}) {
-  const balances = await client.wallets.listBalances({
-    agent_id: agentId,
-    chain: input.chain
-  });
-  const balance = balances[0];
-  if (!balance) {
-    return { available: "0", chain: input.chain ?? "base" };
-  }
+async function checkBalance(client, agentId, _input = {}) {
+  const balances = await client.agents.getBalance(agentId);
   return {
-    available: balance.available,
-    chain: balance.chain
+    balances: balances.map((b) => ({
+      chain: b.chain,
+      available: b.available,
+      locked: b.locked,
+      pending_income: b.pending_income,
+      total_deposited: b.total_deposited,
+      total_withdrawn: b.total_withdrawn,
+      total_paid: b.total_paid,
+      total_earned: b.total_earned
+    }))
   };
 }
 
@@ -106,6 +126,29 @@ async function txStatus(client, agentId, input) {
     confirmed_at: tx.confirmed_at ?? void 0
   };
 }
+
+// src/tools/list-transactions.ts
+async function listTransactions(client, input = {}) {
+  const page = await client.transactions.list({
+    agent_id: input.agent_id,
+    status: input.status,
+    direction: input.direction
+  });
+  return {
+    transactions: page.data.map((tx) => ({
+      transaction_id: tx.transaction_id,
+      agent_id: tx.agent_id,
+      direction: tx.direction,
+      status: tx.status,
+      amount: tx.amount,
+      token: tx.token,
+      chain: tx.chain,
+      tx_hash: tx.tx_hash ?? void 0,
+      confirmed_at: tx.confirmed_at ?? void 0
+    })),
+    total: page.total
+  };
+}
 function getConfigDir() {
   return path.join(os.homedir(), ".openclaw", "agentwallex");
 }
@@ -245,6 +288,67 @@ var openClawToolSchema = {
         required: ["agents", "total"]
       }
     },
+    {
+      name: "agentwallex_update_agent",
+      description: "Update an agent's name or description",
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_id: { type: "string", description: "Agent ID to update" },
+          agent_name: { type: "string", description: "New agent name" },
+          agent_description: { type: "string", description: "New description" }
+        },
+        required: ["agent_id"]
+      },
+      outputSchema: {
+        type: "object",
+        properties: {
+          agent_id: { type: "string" },
+          agent_name: { type: "string" },
+          chain: { type: "string" },
+          status: { type: "string" }
+        },
+        required: ["agent_id", "agent_name", "chain", "status"]
+      }
+    },
+    {
+      name: "agentwallex_delete_agent",
+      description: "Delete an agent",
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_id: { type: "string", description: "Agent ID to delete" }
+        },
+        required: ["agent_id"]
+      },
+      outputSchema: {
+        type: "object",
+        properties: {
+          success: { type: "boolean" }
+        },
+        required: ["success"]
+      }
+    },
+    {
+      name: "agentwallex_agent_status",
+      description: "Update agent status (active / suspended)",
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_id: { type: "string", description: "Agent ID" },
+          status: { type: "string", description: "New status: active, inactive, or suspended" }
+        },
+        required: ["agent_id", "status"]
+      },
+      outputSchema: {
+        type: "object",
+        properties: {
+          agent_id: { type: "string" },
+          status: { type: "string" }
+        },
+        required: ["agent_id", "status"]
+      }
+    },
     {
       name: "agentwallex_create_wallet",
       description: "Get or create a wallet deposit address for an agent",
@@ -302,10 +406,24 @@ var openClawToolSchema = {
       outputSchema: {
         type: "object",
         properties: {
-          available: { type: "string" },
-          chain: { type: "string" }
+          balances: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                chain: { type: "string" },
+                available: { type: "string" },
+                locked: { type: "string" },
+                pending_income: { type: "string" },
+                total_deposited: { type: "string" },
+                total_withdrawn: { type: "string" },
+                total_paid: { type: "string" },
+                total_earned: { type: "string" }
+              }
+            }
+          }
         },
-        required: ["available", "chain"]
+        required: ["balances"]
       }
     },
     {
@@ -327,6 +445,27 @@ var openClawToolSchema = {
         },
         required: ["status"]
       }
+    },
+    {
+      name: "agentwallex_list_transactions",
+      description: "List transactions with filtering",
+      inputSchema: {
+        type: "object",
+        properties: {
+          agent_id: { type: "string", description: "Filter by agent ID" },
+          status: { type: "string", description: "Filter by status (pending, confirmed, failed)" },
+          direction: { type: "string", description: "Filter by direction (inbound, outbound)" }
+        },
+        required: []
+      },
+      outputSchema: {
+        type: "object",
+        properties: {
+          transactions: { type: "array", items: { type: "object" } },
+          total: { type: "number" }
+        },
+        required: ["transactions", "total"]
+      }
     }
   ]
 };
@@ -465,6 +604,59 @@ function register(api) {
       });
     })
   });
+  api.registerTool({
+    name: "agentwallex_update_agent",
+    description: "Update an agent's name or description",
+    parameters: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "Agent ID to update" },
+        agent_name: { type: "string", description: "New agent name" },
+        agent_description: { type: "string", description: "New description" }
+      },
+      required: ["agent_id"]
+    },
+    execute: withConfig(async (client, _agentId, params) => {
+      return updateAgent(client, {
+        agent_id: params.agent_id,
+        agent_name: params.agent_name,
+        agent_description: params.agent_description
+      });
+    })
+  });
+  api.registerTool({
+    name: "agentwallex_delete_agent",
+    description: "Delete an agent",
+    parameters: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "Agent ID to delete" }
+      },
+      required: ["agent_id"]
+    },
+    execute: withConfig(async (client, _agentId, params) => {
+      await deleteAgent(client, { agent_id: params.agent_id });
+      return { success: true };
+    })
+  });
+  api.registerTool({
+    name: "agentwallex_agent_status",
+    description: "Update agent status (active / suspended)",
+    parameters: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "Agent ID" },
+        status: { type: "string", description: "New status: active, inactive, or suspended" }
+      },
+      required: ["agent_id", "status"]
+    },
+    execute: withConfig(async (client, _agentId, params) => {
+      return agentStatus(client, {
+        agent_id: params.agent_id,
+        status: params.status
+      });
+    })
+  });
   api.registerTool({
     name: "agentwallex_create_wallet",
     description: "Get or create a wallet deposit address for an agent",
@@ -535,17 +727,39 @@ function register(api) {
       });
     })
   });
+  api.registerTool({
+    name: "agentwallex_list_transactions",
+    description: "List transactions with filtering",
+    parameters: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "Filter by agent ID" },
+        status: { type: "string", description: "Filter by status (pending, confirmed, failed)" },
+        direction: { type: "string", description: "Filter by direction (inbound, outbound)" }
+      }
+    },
+    execute: withConfig(async (client, _agentId, params) => {
+      return listTransactions(client, {
+        agent_id: params.agent_id,
+        status: params.status,
+        direction: params.direction
+      });
+    })
+  });
 }
 
 Object.defineProperty(exports, "AgentWallex", {
   enumerable: true,
   get: function () { return sdk.AgentWallex; }
 });
+exports.agentStatus = agentStatus;
 exports.checkBalance = checkBalance;
 exports.createAgent = createAgent;
 exports.createWallet = createWallet;
+exports.deleteAgent = deleteAgent;
 exports.isConfigured = isConfigured;
 exports.listAgents = listAgents;
+exports.listTransactions = listTransactions;
 exports.loadConfig = loadConfig;
 exports.openClawToolSchema = openClawToolSchema;
 exports.pay = pay;
@@ -553,5 +767,6 @@ exports.register = register;
 exports.requireConfig = requireConfig;
 exports.saveConfig = saveConfig;
 exports.txStatus = txStatus;
+exports.updateAgent = updateAgent;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map