@goplausible/openclaw-algorand-plugin 1.8.7 → 1.8.8

package/index.ts

@@ -184,6 +184,96 @@ function writeMemoryFile(workspacePath: string): { success: boolean; message: st
   return { success: true, message: `Plugin memory written to ${targetFile}` };
 }
 
+function ensureWorkspaceMemoryIndex(workspacePath: string): { success: boolean; message: string } {
+  const templateFile = join(__dirname, "memory", "MEMORY.md");
+
+  if (!existsSync(templateFile)) {
+    return { success: false, message: "Template MEMORY.md not found in plugin" };
+  }
+
+  const templateContent = readFileSync(templateFile, "utf-8");
+
+  // Extract NEVER FORGET section from template (everything between ## NEVER FORGET and next ## or EOF)
+  const neverForgetMatch = templateContent.match(/## NEVER FORGET\n([\s\S]*?)(?=\n## (?!NEVER)|$)/);
+  if (!neverForgetMatch) {
+    return { success: false, message: "No NEVER FORGET section found in template MEMORY.md" };
+  }
+  const templateNeverForget = neverForgetMatch[1].trimEnd();
+
+  // Check for MEMORY.md or memory.md at workspace root
+  const memoryMdPath = join(workspacePath, "MEMORY.md");
+  const memoryMdLower = join(workspacePath, "memory.md");
+
+  const existingPath = existsSync(memoryMdPath) ? memoryMdPath
+    : existsSync(memoryMdLower) ? memoryMdLower
+    : null;
+
+  if (!existingPath) {
+    // No MEMORY.md exists — create from template
+    writeFileSync(memoryMdPath, templateContent);
+    return { success: true, message: `Created ${memoryMdPath} with NEVER FORGET section` };
+  }
+
+  // MEMORY.md exists — check for NEVER FORGET header
+  let existing = readFileSync(existingPath, "utf-8");
+
+  if (!/## NEVER FORGET/i.test(existing)) {
+    // No NEVER FORGET section — insert after first # heading
+    const firstHeadingEnd = existing.match(/^# .+\n/m);
+    if (firstHeadingEnd) {
+      const insertPos = (firstHeadingEnd.index ?? 0) + firstHeadingEnd[0].length;
+      existing = existing.slice(0, insertPos) + "\n## NEVER FORGET\n" + templateNeverForget + "\n\n" + existing.slice(insertPos);
+    } else {
+      // No heading at all — prepend
+      existing = "# OpenClaw Agent Long-Term Memory\n\n## NEVER FORGET\n" + templateNeverForget + "\n\n" + existing;
+    }
+    writeFileSync(existingPath, existing);
+    return { success: true, message: `Added NEVER FORGET section to ${existingPath}` };
+  }
+
+  // NEVER FORGET exists — merge template items that are missing
+  // Extract existing NEVER FORGET section content
+  const existingNFMatch = existing.match(/## NEVER FORGET\n([\s\S]*?)(?=\n## (?!#)|$)/);
+  const existingNFContent = existingNFMatch ? existingNFMatch[1] : "";
+
+  // Extract individual items (lines starting with *) from template, grouped by subsection
+  const templateLines = templateNeverForget.split("\n");
+  const newLines: string[] = [];
+
+  for (const line of templateLines) {
+    // Add subsection headers and bullet items that don't exist in existing content
+    if (line.startsWith("### ")) {
+      if (!existingNFContent.includes(line)) {
+        newLines.push(line);
+      }
+    } else if (line.startsWith("* ")) {
+      // Check if this bullet's key content already exists (first 50 chars as fingerprint)
+      const fingerprint = line.slice(2, 52).trim();
+      if (!existingNFContent.includes(fingerprint)) {
+        newLines.push(line);
+      }
+    }
+  }
+
+  if (newLines.length === 0) {
+    return { success: true, message: `NEVER FORGET section in ${existingPath} is up to date` };
+  }
+
+  // Append new items at the end of existing NEVER FORGET section
+  const nfEnd = existing.search(/## NEVER FORGET\n[\s\S]*?(?=\n## (?!#)|$)/);
+  if (nfEnd !== -1) {
+    const sectionMatch = existing.match(/## NEVER FORGET\n([\s\S]*?)(?=\n## (?!#)|$)/);
+    if (sectionMatch) {
+      const sectionEnd = (sectionMatch.index ?? 0) + sectionMatch[0].length;
+      const insertion = "\n" + newLines.join("\n") + "\n";
+      existing = existing.slice(0, sectionEnd) + insertion + existing.slice(sectionEnd);
+      writeFileSync(existingPath, existing);
+    }
+  }
+
+  return { success: true, message: `Updated NEVER FORGET section in ${existingPath} (added ${newLines.length} items)` };
+}
+
 function checkMcpBinary(): { available: boolean; path?: string } {
   try {
     const path = execSync("which algorand-mcp", { encoding: "utf-8" }).trim();
@@ -281,6 +371,14 @@ export default function register(api: PluginApi) {
             console.error(`  ❌ ${memResult.message}`);
           }
 
+          // Step 1b: Ensure MEMORY.md exists at workspace root with NEVER FORGET section
+          const memIndexResult = ensureWorkspaceMemoryIndex(workspacePath);
+          if (memIndexResult.success) {
+            console.log(`  ✅ ${memIndexResult.message}`);
+          } else {
+            console.error(`  ❌ ${memIndexResult.message}`);
+          }
+
           // Step 2: Stop any existing algorand-mcp processes
           const stopResult = stopExistingMcpProcesses();
           if (stopResult.stopped > 0) {
@@ -415,6 +513,14 @@ export default function register(api: PluginApi) {
       console.log("   This plugin provides:");
       console.log("   • 9 Algorand skills (Algorand development in TS and Python, x402, MCP interaction, alpha arcade interaction, haystack router development and interaction)");
       console.log("   • algorand-mcp server (~100 blockchain tools via mcporter)\n");
+
+      // Ensure MEMORY.md exists at workspace root
+      const workspacePath = getWorkspacePath(api);
+      const memIndexResult = ensureWorkspaceMemoryIndex(workspacePath);
+      if (memIndexResult.success) {
+        console.log(`   ✅ ${memIndexResult.message}`);
+      }
+
       // Keyring persistence warning for headless Linux
       try {
         const scriptPath = join(__dirname, "scripts", "setup-keyring.sh");

package/memory/MEMORY.md

@@ -0,0 +1,38 @@
+# OpenClaw Agent Long-Term Memory
+
+## NEVER FORGET
+
+### Algorand Plugin Memory
+* ALWAYS read `memory/algorand-plugin.md` first for anything Algorand-related — it contains skill routing, MCP tool categories, common workflows, asset tables, and external resources.
+
+### Wallet
+* ALWAYS check wallet with `wallet_get_info` before any blockchain operation.
+* `create_account` only generates a keypair and returns it — nothing is stored. Use `wallet_add_account` to create a persistent agent wallet account with a nickname and spending limits. Make sure you notify user about this if they prompt for account creation without mentioning wallet.
+* Default network is mainnet. ALWAYS remind users to specify `testnet` in their prompts if they intend to work on testnet.
+
+### Skill Routing — Load the Right Skill
+* `algorand-interaction` — ALWAYS load when using Algorand MCP tools for blockchain queries, transactions, swaps, x402 payments, or wallet operations.
+* `algorand-development` — Load for AlgoKit CLI, project setup, example search, and general development workflows.
+* `algorand-typescript` — Load for TypeScript/PuyaTs smart contract development, testing with Vitest, typed clients, React frontends.
+* `algorand-python` — Load for Python/PuyaPy smart contract development, algopy decorators, Python AlgoKit Utils.
+* `algorand-x402-typescript` — Load for building x402 payment apps in TypeScript (clients, servers, facilitators, paywalls, Next.js).
+* `algorand-x402-python` — Load for building x402 payment apps in Python (clients, servers, facilitators, Bazaar discovery).
+* `algorand-interaction` also covers x402 payment workflows — ALWAYS load it on HTTP 402 responses to follow the atomic group payment pattern.
+* `haystack-router-interaction` — Load for best-price token swaps via MCP tools (DEX aggregation across Tinyman, Pact, Folks).
+* `haystack-router-development` — Load for building swap UIs with `@txnlab/haystack-router` SDK (React, Node.js).
+* `alpha-arcade-interaction` — Load for prediction market trading via MCP tools (browse markets, place orders, manage positions).
+
+### QR Codes
+* When calling `generate_algorand_qrcode`, **USE THE --RAW FLAG** with mcporter to get full output including base64 PNG. Always include UTF-8 QR block, PNG image, and URI string in your response. Copy the ENTIRE base64 string exactly — do not reformat or edit.
+
+### Documentation
+* Use `get_knowledge_doc` MCP tool for Algorand developer documentation (categories: arcs, sdks, algokit, algokit-utils, tealscript, puya, liquid-auth, python, developers, clis, nodes, details).
+
+### Never Do This
+* NEVER attempt any Algorand blockchain interaction without loading and reading the `algorand-interaction` skill first.
+* NEVER use PyTEAL or Beaker — these are legacy. Use Algorand TypeScript (PuyaTs) or Algorand Python (PuyaPy).
+* NEVER use AlgoExplorer — it is obsolete. Use Allo.info for block/account/transaction/asset/application explorer.
+* NEVER attempt x402 payments without loading the `algorand-interaction` skill first — the x402 payment workflow and atomic group pattern are documented there.
+
+
+

package/memory/algorand-plugin.md

@@ -33,7 +33,7 @@ mcporter list algorand-mcp
 
 # Call a tool
 mcporter call algorand-mcp.wallet_get_info
-mcporter call algorand-mcp.get_account_info address=XXXXX network=testnet
+mcporter call algorand-mcp.generate_algorand_qrcode --raw address=XXXXX network=testnet asset=0 amount=1000000
 mcporter call algorand-mcp.search_assets name=USDC network=mainnet
 ```
 

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-algorand-plugin",
   "name": "Algorand Integration",
   "description": "Algorand blockchain integration with MCP and skills — by GoPlausible",
-  "version": "1.8.7",
+  "version": "1.8.8",
   "skills": [
     "skills/algorand-development",
     "skills/algorand-typescript",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goplausible/openclaw-algorand-plugin",
-  "version": "1.8.7",
+  "version": "1.8.8",
   "publishConfig": {
     "access": "public"
   },